Skip to content
Guía del Centro de ayuda · Actualizaciones y notificacionesFase de incorporación 6
3 min de lecturaVerificado 2026-11-16

Actualizaciones y mensajes programados

Programa campañas de aviso por lotes, segmenta audiencias antes de eventos o caducidades y audita los envíos.

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

Registro de actividad — Actualizaciones y push (Ampliado)

Verifica que las publicaciones de plantilla y notificaciones push se ejecuten correctamente en pases Apple y Google activos.

Descripción general: campañas programadas y mensajería automatizada

Passinstance permite a los equipos encolar con antelación actualizaciones de pases con fecha límite, difusiones promocionales, notificaciones masivas desde CSV y recordatorios automáticos de vencimiento. Los trabajos programados se persisten en database y se ejecutan mediante colas diferidas de workers background job queue, asegurando una distribución fiable hacia APNs de Apple y endpoints REST de Google Wallet en la hora exacta prevista.

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
MOTOR DE NOTIFICACIONES PROGRAMADAS Y POR LOTES
ETAPA 01 PROGRAMACIÓN E INGESTA DE CAMPAÑAS
Push programado en plantilla (POST/api/v1/push-notifications/templates/:id)
Campaña por búsqueda guardada (POST/api/v1/push-notifications/segmentation)
Notificación por lotes / CSV (POST/api/v1/batch-notifications y /csv)
Cron automático ciclo vida (Recordatorios vencimiento y renovación de nivel)
ETAPA 02 RESOLUCIÓN DE ZONA HORARIA Y COLA DIFERIDA ASYNC QUEUE
1
Resuelve hora objetivo mediante resolveCustomerTimeZone (Zona horaria IANA)
2
Guarda lote (batch notification status: SCHEDULED)
3
Encola trabajo diferido background job queue (delay = scheduledAt - now())
Al llegar la hora publicationDate
ETAPA 03 DISTRIBUCIÓN DE WORKERS Y PROPAGACIÓN AL MONEDERO
1
Consulta pases ACTIVE aptos con registros activos en APNs / Google Wallet
2
Modifica el campo designado de notificación e incrementa versión del pase
3
Envía pushes silenciosos APNs HTTP/2 y parches walletobjects Google Wallet
4
Registra resultados por pase (SUCCESSFUL, FAILED, CANCELLED)

Programación anticipada de campañas

Utilice Notificaciones por lotes (/batch-notifications bajo Lotes en la barra lateral del panel) o la API REST para encolar de forma ordenada actualizaciones futuras de pases:

  1. 1
    Elegir audiencia objetivo (mode): En request payload, seleccione pases explícitos (manual), segmentos o búsquedas guardadas (filter / segment), todos los pases aptos (all) o suba un archivo CSV con serialNumber / externalId (csv vía /api/v1/batch-notifications/csv).
  2. 2
    Redactar el mensaje: Indique message (<=200 caracteres en notificaciones por lotes, compatible con marcadores {attributeKey}, o <=85 caracteres en Push Notifications API).
  3. 3
    Configurar fecha, hora y zona horaria: Proporcione publicationDate (YYYY-MM-DD HH:mm o ISO 8601), interpretada según la zona horaria IANA del espacio de trabajo. Mientras el lote permanezca en estado SCHEDULED (batch notification status: SCHEDULED, PROCESSING, SUCCESSFUL, FAILED, CANCELLED), podrá editarlo (PATCH), lanzarlo de inmediato (POST /:batchId/send-now), reintentarlo (POST /:batchId/retry) o cancelarlo (DELETE).
  4. 4
    Verificar ejecución y registros de auditoría: Supervise el progreso y exporte los errores por fila mediante GET /api/v1/batch-notifications/:batchId/errors.csv.

Importante: Solo los pases Instalados con al menos un registro de dispositivo activo en Apple Wallet (deviceLibraryIdentifier) o un objeto activo en Google Wallet pueden mostrar notificaciones push en la pantalla de bloqueo. Revise Registros de dispositivos activos en Analíticas antes de programar un envío.

Endpoints de la API de notificaciones programadas y por lotes

MétodoRuta del endpointControladorDescripción
POST/api/v1/push-notifications/templates/:idPush Notifications APIPrograma una notificación push (request payload) sobre una plantilla (con segmentIds / savedSearchIds opcionales).
POST/api/v1/push-notifications/templates/:id/sendPush Notifications APIDifunde de inmediato una notificación push sobre una plantilla (request payload).
POST/api/v1/push-notifications/segmentationPush Notifications APIEnvía una notificación inmediata a una búsqueda guardada (request payload).
POST/api/v1/batch-notificationsBatch Notifications APICrea una notificación por lotes programada (request payload: `manual \filter \csv \all \segment`).
GET/api/v1/batch-notifications/:batchIdBatch Notifications APIRecupera el progreso de ejecución (SCHEDULED, PROCESSING, SUCCESSFUL, CANCELLED, FAILED) y la telemetría.
DELETE/api/v1/batch-notifications/:batchIdBatch Notifications APICancela un trabajo de notificación por lotes pendiente en estado SCHEDULED antes de su envío.

Ejemplo: programar una notificación por lotes (request payload)

JSON
POST /api/v1/batch-notifications
{
  "name": "Winter Flash Sale Push",
  "message": "Hi {firstName}, enjoy 25% off today with your {memberTier} card!",
  "publicationDate": "2026-11-20 17:00",
  "mode": "filter",
  "filters": {
    "templateId": "7b9e4c12-3f81-4a90-b8d2-19c48a70e112",
    "segmentIds": ["seg_vip_tier_01"]
  }
}

Respuesta (201 Created):

JSON
{
  "id": "bn_8831a9c0",
  "status": "SCHEDULED",
  "publicationDate": "2026-11-20T16:00:00.000Z"
}

Recordatorios automáticos de vencimiento y cuenta atrás de eventos

Además de campañas manuales y programadas por CSV, puede adjuntar disparadores temporales automáticos en Flujos de trabajo y automatización:

  • Recordatorios previos al vencimiento: Actualizan automáticamente un campo de aviso (por ejemplo, "Su pase caduca en 3 días — pulse para renovar") N días antes de la fecha expirationDate de un pase.
  • Cuentas atrás de acceso a eventos: Combinan la aparición en pantalla de bloqueo mediante RelevantDate con una notificación push programada 24 horas antes del evento confirmando puerta, asiento o indicaciones de aparcamiento.

Aprenda más en Notificaciones push, Configuración de flujos de trabajo y Analíticas de distribución e interacción.

¿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.