Panoramica: campagne pianificate e messaggistica automatizzata
Passinstance permette ai team di accodare in anticipo aggiornamenti ai pass legati a specifiche finestre temporali, broadcast promozionali, notifiche massive guidate da CSV e promemoria automatici di scadenza. I job pianificati vengono salvati su database ed eseguiti da code worker ritardate background job queue, garantendo una distribuzione affidabile verso Apple APNs e gli endpoint REST di Google Wallet all'esatto istante programmato.
Pianificare le campagne in anticipo
Utilizzi Notifiche batch (/batch-notifications sotto Operazioni batch nella barra laterale della Dashboard) oppure la REST API per accodare in modo ordinato gli aggiornamenti futuri ai pass:
-
1
Scelta dell'audience di destinazione (
mode): Inrequest payload, selezioni pass espliciti (manual), segmenti o ricerche salvate (filter/segment), tutti i pass idonei (all) oppure carichi un file CSV di recordserialNumber/externalId(csvtramite/api/v1/batch-notifications/csv). -
2
Composizione del messaggio: Inserisca
message(<=200caratteri nelle notifiche batch, con supporto ai segnaposti{attributeKey}, oppure<=85caratteri inPush Notifications API). -
3
Configurazione di data, ora e fuso orario: Imposti
publicationDate(YYYY-MM-DD HH:mmo ISO 8601), risolto rispetto al fuso orario IANA del workspace. Finché il batch resta in statoSCHEDULED(batch notification status:SCHEDULED,PROCESSING,SUCCESSFUL,FAILED,CANCELLED), è possibile aggiornarlo (PATCH), inviarlo subito (POST /:batchId/send-now), ritentarlo (POST /:batchId/retry) o annullarlo (DELETE). -
4
Verifica dell'esecuzione e dei log di audit: Monitori l'avanzamento ed esporti eventuali errori riga per riga tramite
GET /api/v1/batch-notifications/:batchId/errors.csv.
Importante: Solo i pass Installati con almeno una registrazione attiva su Apple Wallet (
deviceLibraryIdentifier) o un oggetto Google Wallet attivo possono visualizzare notifiche push sulla schermata di blocco. Verifichi Registrazioni dispositivi attive in Analytics prima della pianificazione.
Endpoint API per notifiche pianificate e batch
| Metodo | Percorso endpoint | Controller | Descrizione | ||||
|---|---|---|---|---|---|---|---|
| POST | /api/v1/push-notifications/templates/:id | Push Notifications API | Pianifica una notifica push (request payload) su un modello (con segmentIds / savedSearchIds opzionali). | ||||
| POST | /api/v1/push-notifications/templates/:id/send | Push Notifications API | Invia immediatamente in broadcast una notifica push del modello (request payload). | ||||
| POST | /api/v1/push-notifications/segmentation | Push Notifications API | Invia una notifica immediata a una ricerca salvata (request payload). | ||||
| POST | /api/v1/batch-notifications | Batch Notifications API | Crea una notifica batch pianificata (request payload: `manual \ | filter \ | csv \ | all \ | segment`). |
| GET | /api/v1/batch-notifications/:batchId | Batch Notifications API | Recupera avanzamento esecuzione (SCHEDULED, PROCESSING, SUCCESSFUL, CANCELLED, FAILED) e telemetria. | ||||
| DELETE | /api/v1/batch-notifications/:batchId | Batch Notifications API | Annulla un job batch pianificato in stato SCHEDULED prima dell'invio. |
Esempio: pianificare una notifica batch (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"]
}
}
Risposta (201 Created):
{
"id": "bn_8831a9c0",
"status": "SCHEDULED",
"publicationDate": "2026-11-20T16:00:00.000Z"
}
Promemoria automatici di scadenza e conto alla rovescia eventi
Oltre alle campagne manuali e pianificate via CSV, è possibile collegare trigger automatici temporali sotto Workflow e automazioni:
-
Promemoria pre-scadenza: Aggiornano automaticamente un campo di avviso (ad esempio
"Your pass expires in 3 days — tap to renew")Ngiorni prima dellaexpirationDatedi un pass. -
Conto alla rovescia check-in evento: Combinano l'emersione in schermata di blocco tramite
RelevantDatecon una notifica push programmata 24 ore prima dell'evento per confermare varco, posto o indicazioni di parcheggio.
Approfondisca in Notifiche push, Configurazione dei workflow e Analytics di distribuzione e interazione.
