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.
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
Elegir audiencia objetivo (
mode): Enrequest payload, seleccione pases explícitos (manual), segmentos o búsquedas guardadas (filter/segment), todos los pases aptos (all) o suba un archivo CSV conserialNumber/externalId(csvvía/api/v1/batch-notifications/csv). -
2
Redactar el mensaje: Indique
message(<=200caracteres en notificaciones por lotes, compatible con marcadores{attributeKey}, o<=85caracteres enPush Notifications API). -
3
Configurar fecha, hora y zona horaria: Proporcione
publicationDate(YYYY-MM-DD HH:mmo ISO 8601), interpretada según la zona horaria IANA del espacio de trabajo. Mientras el lote permanezca en estadoSCHEDULED(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
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étodo | Ruta del endpoint | Controlador | Descripción | ||||
|---|---|---|---|---|---|---|---|
| POST | /api/v1/push-notifications/templates/:id | Push Notifications API | Programa una notificación push (request payload) sobre una plantilla (con segmentIds / savedSearchIds opcionales). | ||||
| POST | /api/v1/push-notifications/templates/:id/send | Push Notifications API | Difunde de inmediato una notificación push sobre una plantilla (request payload). | ||||
| POST | /api/v1/push-notifications/segmentation | Push Notifications API | Envía una notificación inmediata a una búsqueda guardada (request payload). | ||||
| POST | /api/v1/batch-notifications | Batch Notifications API | Crea una notificación por lotes programada (request payload: `manual \ | filter \ | csv \ | all \ | segment`). |
| GET | /api/v1/batch-notifications/:batchId | Batch Notifications API | Recupera el progreso de ejecución (SCHEDULED, PROCESSING, SUCCESSFUL, CANCELLED, FAILED) y la telemetría. | ||||
| DELETE | /api/v1/batch-notifications/:batchId | Batch Notifications API | Cancela 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)
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):
{
"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")Ndías antes de la fechaexpirationDatede un pase. -
Cuentas atrás de acceso a eventos: Combinan la aparición en pantalla de bloqueo mediante
RelevantDatecon 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.
