Skip to content
Guía del Centro de ayuda · Vista general del panelFase de incorporación 1
4 min de lecturaVerificado 2026-11-16

Navegar por el panel

Encuentra Plantillas, Pases, Wallet Experiences, Centro de envíos, Escáner, Acciones masivas y Ajustes al instante.

En esta guía

Recorridos visuales interactivos

Abrir en la guía de 6 fases

Inspecciona las pantallas reales del panel y las anotaciones ampliadas de esta guía.

Enfoque de interfaz ampliado
Elementos clave de la interfaz

Panel Principal — KPIs y Tendencias en vivo (Ampliado)

Ya en marcha, monitoriza Active in Wallets, Removed, Not Installed y curvas de creación y registro.

El panel administrativo de Passinstance ofrece una interfaz unificada para la supervisión operativa, el estudio de diseño de tarjetas, el procesamiento masivo por lotes y la configuración para desarrolladores. La barra lateral izquierda organiza los flujos diarios en áreas funcionales especializadas:

Navegación en la barra lateral del espacio de trabajo
Navegación en la barra lateral del espacio de trabajo
Área de navegación y rutaResponsabilidades principalesCapacidades y entidades de respaldo en backend
Dashboard (/dashboard)KPI en directo del espacio de trabajo, telemetría de eventos en tiempo real y métricas de salud de los pasesRespaldado por Dashboard Analytics API (/api/v1/dashboards/analytics), filas multi-widget y flujos de eventos en tiempo real.
Templates (/templates)Estudio visual de pases con 7 pestañas de detalle (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings)Implementa versionado en una sola tabla (Template), comprobaciones de riesgo previas a la publicación, reglas regex de identificadores personalizados y ajustes de agrupación.
Passes (/passes)Directorio de todos los pases emitidos, búsqueda por externalId, agrupación por bundleId, líneas temporales de historial y edición en panel lateralDirectorio de alta concurrencia respaldado por atributos structured JSON, transiciones de ciclo de vida (PassLifecycleStatus) y desactivación o anulación instantánea.
Distribution (/templates/download-pages, /delivery-center, /pass-flows)Agrupa Páginas de descarga (DownloadPage), Delivery Center (EmailSendCampaign) y Pass Flows (PassFlow)Gestiona páginas públicas de descarga (/d/:slug), campañas de envío por correo/SMS y registros multipaso o cobros (/f/:url).
Automations (/automations, /workflows)Reglas de automatización basadas en eventos y comercio electrónicoEvalúa reglas UniversalAutomation y disparadores Workflow (workflow trigger type, workflow action type).
Scanner (/scanner/configs)Validación en mostrador, control de acceso en puertas, lugares de validación y configuración de lectores físicosGestiona ValidationPlace, ScannerConfiguration, emparejamientos de escáner móvil (ScannerKey) y adaptadores NFC/POS.
Batch (/batch-processing, /batch-notifications)Asistente asíncrono de emisión masiva mediante CSV y notificaciones programadas para monederosControla Batch Jobs API (/api/v1/batch-processing) y Batch Notifications API (/api/v1/batch-notifications).
Wallet Experiences (/wallet-experiences / /pass-projects)Centro de proyectos multi-tarjeta (Overview, Cards, Audience, Automations, Distribution, Analytics, Settings)Gestiona PassProject, PassProjectTemplateRole, paquetes .pkpasses y automatizaciones entre pases.
Integrations & Analytics (/settings/workspace/integrations, /analytics)Conectores CRM/POS conectados, webhooks, claves API y paquetes de informesAdministra webhooks (/api/v1/webhooks/*), claves de API con ámbito específico e informes /api/v1/analytics/*.

Arquitectura del panel y endpoints de telemetría

El motor de métricas del panel se apoya en una arquitectura modular de widgets y caché (Dashboard, Row, Widget y SharedDashboard en Passinstance database). El backend coordina con Cache Manager para ofrecer analíticas ágiles sin sobrecargar con consultas las tablas transaccionales de pases:

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
TUBERÍA DE TELEMETRÍA DEL PANEL
ETAPA 01 Panel del cliente
(React / Vite)
ETAPA 02 Dashboard Analytics API
(/api/v1/dashboards/analytics
/metrics/realtime)
ETAPA 03 | Cache Manager
(Caché aislada por RBAC con invalidación real)
ETAPA 02 Agregados database
Conteos pase/dispos.

Endpoints clave de telemetría

Los desarrolladores y plataformas de datos pueden consultar estos endpoints analíticos utilizando autenticación estándar con token Bearer o cookie de sesión:

  • GET /api/v1/dashboards/analytics: Devuelve métricas agregadas del espacio de trabajo respaldadas por Dashboard Analytics Engine.getDashboardAnalytics y Cache Manager.
  • GET /api/v1/dashboards/metrics/realtime: Proporciona recuentos de actividad de alta frecuencia y telemetría reciente de instalaciones y escaneos.
  • GET /api/v1/dashboards/analytics/range?startDate=YYYY-MM-DD&endDate=YYYY-MM-DD: Devuelve series temporales por cohortes en un periodo personalizado.
  • GET /api/v1/dashboards/performance: Supervisa métricas operativas de rendimiento de escaneo y entrega de pases.
  • GET /api/v1/dashboards/insights: Muestra recomendaciones operativas automatizadas en todo su espacio de trabajo.
  • GET /api/v1/dashboards/export?format=csv|json|pdf: Exporta tablas de métricas sin procesar del panel para BI y conciliación.

Centros funcionales y vistas del espacio de trabajo

1. Estudio de plantillas (/templates/:id/*)

Cree y edite plantillas visuales en 7 pestañas (Overview, Passes, Distribution, Scanner, Analytics, Activity log, Settings). Configure ranuras image asset slot, verifique el contraste de color WCAG, gestione reglas de identificadores personalizados e itere en un estado DRAFT aislado antes de publicar.

2. Directorio de pases y línea temporal (/passes)

Busque entre los pases emitidos utilizando búsqueda de texto completo y filtros (status, templateId, externalId, bundleId). Abra cualquier fila en Pass Details panel para inspeccionar su cronología (GET /api/v1/passes/:id/history y /timeline), ver dispositivos emparejados o lanzar actualizaciones push.

3. Centro de operaciones por lotes (/batch-processing)

Siga los pasos del asistente (Plantilla -> Subir CSV -> Mapear campos -> Opciones de envío -> Procesar) para emitir o actualizar pases masivamente desde archivos CSV. Descargue esquemas de ejemplo (GET /api/v1/batch-processing/templates/:templateId/sample-csv), revise recomendaciones de mapeo de campos (POST /api/v1/batch-processing/templates/:templateId/field-mapping-recommendations) y descargue /result.csv con cada URL de pase generada y su externalId.

Importante: Toda la telemetría del panel y las consultas de búsqueda están estrictamente aisladas al inquilino activo de su espacio de trabajo (customerId). Los espacios de trabajo hermanos dentro de la misma organización permanecen completamente aislados.

Explore cada vista de forma interactiva en nuestro Recorrido interactivo por el espacio de trabajo.

Documentación de producto y API relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.