Skip to content
Guia da Central de Ajuda · Visão geral do painelFase de integração 1
4 min de leituraVerificado 2026-11-16

Navegar no painel

Localize Modelos, Passes, Wallet Experiences, Centro de Envios, Scanner, Operações em lote e Definições.

Neste guia

Inspecione capturas de ecrã exatas do painel e detalhes ampliados relacionados com este guia.

Foco ampliado da interface
Elementos-chave da interface

Painel Principal — KPIs ao vivo e Tendências (Ampliado)

Com o fluxo no ar, monitore Active in Wallets, Removed, Not Installed além das curvas de criação e registro.

O painel administrativo da Passinstance fornece uma interface unificada para monitorização operacional, estúdio de design de cartões, processamento em lote e configuração para programadores. A barra lateral esquerda organiza os fluxos diários em áreas funcionais especializadas:

Navegação na barra lateral do espaço de trabalho
Navegação na barra lateral do espaço de trabalho
Área de navegação e rotaResponsabilidades principaisCapacidades e entidades de suporte no backend
Painel (Dashboard) (/dashboard)KPIs ao vivo do espaço de trabalho, telemetria de eventos em tempo real e métricas de saúde dos passesSuportado por Dashboard Analytics API (/api/v1/dashboards/analytics), linhas multi-widget e fluxos de eventos em tempo real.
Modelos (Templates) (/templates)Estúdio visual de passes com 7 separadores de detalhe (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings)Implementa versionamento em tabela única (Template), verificações de risco pré-publicação, regras regex de identificador personalizado e definições de pacotes.
Passes (/passes)Diretório de todos os passes emitidos, pesquisa por externalId, agrupamento por bundleId, cronologias de histórico e edições em painel lateralDiretório de elevada concorrência suportado por atributos structured JSON, transições de ciclo de vida (PassLifecycleStatus) e desativação/anulação instantânea.
Distribuição (/templates/download-pages, /delivery-center, /pass-flows)Agrupa Páginas de Download (DownloadPage), Centro de Entrega (EmailSendCampaign) e Pass Flows (PassFlow)Gere páginas públicas de obtenção (/d/:slug), campanhas de entrega por E-mail/SMS e registo/pagamento em múltiplas etapas (/f/:url).
Automações (/automations, /workflows)Regras de automação orientadas a eventos e e-commerceAvalia regras UniversalAutomation e gatilhos Workflow (workflow trigger type, workflow action type).
Scanner (/scanner/configs)Validação ao balcão, check-in à entrada, locais de validação e configuração de leitores físicosGere ValidationPlace, ScannerConfiguration, emparelhamentos de scanner móvel (ScannerKey) e adaptadores NFC/POS.
Lote (Batch) (/batch-processing, /batch-notifications)Assistente assíncrono de emissão em massa por CSV e notificações agendadas para carteirasConduz Batch Jobs API (/api/v1/batch-processing) e Batch Notifications API (/api/v1/batch-notifications).
Wallet Experiences (/wallet-experiences / /pass-projects)Centro de projetos multi-cartão (Overview, Cards, Audience, Automations, Distribution, Analytics, Settings)Gere PassProject, PassProjectTemplateRole, pacotes .pkpasses e automações entre passes.
Integrações e Analítica (/settings/workspace/integrations, /analytics)Conectores CRM/POS ligados, webhooks, chaves API e relatóriosGere webhooks (/api/v1/webhooks/*), chaves API com escopo e relatórios /api/v1/analytics/*.

Arquitetura do painel e endpoints de telemetria

O motor de métricas do painel baseia-se numa arquitetura modular de widgets e cache (Dashboard, Row, Widget e SharedDashboard no Passinstance database). O backend coordena com o Cache Manager para entregar analítica responsiva sem impor carga de consultas às tabelas transacionais de passes:

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
PIPELINE DE TELEMETRIA DO PAINEL
ETAPA 01 Painel Cliente
(React / Vite)
ETAPA 02 Dashboard Analytics API
(/api/v1/dashboards/analytics
/metrics/realtime)
ETAPA 03 | Cache Manager
(Cache com escopo RBAC e Invalidação Eventos)
ETAPA 02 Agregados database
Contagens Passes/Disp.

Principais endpoints de telemetria

Programadores e plataformas de dados podem consultar estes endpoints de analítica com autenticação padrão Bearer ou cookie de sessão:

  • GET /api/v1/dashboards/analytics: Devolve métricas agregadas do espaço de trabalho suportadas por Dashboard Analytics Engine.getDashboardAnalytics e Cache Manager.
  • GET /api/v1/dashboards/metrics/realtime: Fornece contagens de atividade de alta frequência do espaço de trabalho e telemetria recente de instalações/leituras.
  • GET /api/v1/dashboards/analytics/range?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD: Devolve coortes em séries temporais ao longo de um período personalizado.
  • GET /api/v1/dashboards/performance: Monitoriza métricas operacionais de desempenho de leitura e entrega de passes.
  • GET /api/v1/dashboards/insights: Apresenta recomendações operacionais automatizadas no espaço de trabalho.
  • GET /api/v1/dashboards/export?format=csv|json|pdf: Exporta tabelas brutas de métricas do painel para BI e reconciliação.

Áreas funcionais e vistas do espaço de trabalho

1. Estúdio de Modelos (/templates/:id/*)

Crie e edite modelos visuais através de 7 separadores (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings). Configure slots image asset slot, verifique o contraste de cores WCAG, gira regras de identificadores personalizados e itere num estado isolado DRAFT antes de publicar.

2. Diretório e cronologia de Passes (/passes)

Pesquise nos passes emitidos utilizando pesquisa em texto completo e filtros (status, templateId, externalId, bundleId). Abra qualquer linha de passe no Pass Details panel para inspecionar a respetiva cronologia (GET /api/v1/passes/:id/history e /timeline), ver dispositivos emparelhados ou acionar atualizações push.

3. Centro de Operações em Lote (/batch-processing)

Siga as etapas do assistente (Modelo -> Carregar CSV -> Mapear Campos -> Opções de envio -> Processar) para emitir ou atualizar passes em massa a partir de ficheiros CSV. Descarregue esquemas de exemplo (GET /api/v1/batch-processing/templates/:templateId/sample-csv), consulte recomendações de mapeamento de campos (POST /api/v1/batch-processing/templates/:templateId/field-mapping-recommendations) e descarregue /result.csv contendo cada URL de passe gerado e externalId.

Importante: Toda a telemetria e todas as pesquisas do painel são estritamente delimitadas ao seu tenant ativo de espaço de trabalho (customerId). Espaços de trabalho irmãos na mesma organização permanecem totalmente isolados.

Explore cada vista de forma interativa na nossa Visita interativa ao espaço de trabalho.

Documentação de produto e API relacionada

Pronto para lançar o seu primeiro programa de cartões Wallet?

Crie o seu espaço de trabalho, configure o seu modelo e teste um cartão real na Apple Wallet e Google Wallet antes de escalar.