Skip to content
Guida del Centro assistenza · Aggiornamenti e notifiche WalletFase di onboarding 6
3 min di letturaVerificato 2026-11-16

Aggiornamenti e messaggi pianificati

Pianifica invii programmati, segmenta il pubblico prima di eventi o scadenze e controlla i log d'esecuzione.

In questa guida

Guide visive interattive UI

Apri nella guida in 6 fasi

Esplora schermate reali della dashboard e dettagli ingranditi collegati a questa guida.

Focus UI ingrandito
Elementi chiave dell'interfaccia

Registro attività Template — Aggiornamenti e push (Ingrandito)

Verifica che pubblicazioni di versione e notifiche push vengano eseguite su tutti i pass Apple e Google attivi.

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.

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
MOTORE NOTIFICHE PIANIFICATE E BATCH
FASE 01 PIANIFICAZIONE E ACQUISIZIONE CAMPAGNE
Push modello pianificato (POST/api/v1/push-notifications/templates/:id)
Campagna su ricerca salvata (POST/api/v1/push-notifications/segmentation)
Notifica Batch / CSV (POST/api/v1/batch-notifications e /csv)
Cron automatico ciclo di vita (Avvisi scadenza e promemoria rinnovo livello)
FASE 02 RISOLUZIONE FUSO ORARIO E CODA RITARDATA ASYNC QUEUE
1
Risolve l'orario di esecuzione tramite resolveCustomerTimeZone (IANA TZ)
2
Salva il batch (batch notification status: SCHEDULED)
3
Accoda job ritardato background job queue (delay = scheduledAt - now())
Al timestamp publicationDate
FASE 03 FAN-OUT WORKER E PIPELINE DI PROPAGAZIONE WALLET
1
Interroga i pass ACTIVE idonei con registrazioni APNs / Google Wallet attive
2
Modifica il valore del campo notifica designato e incrementa la revisione
3
Invia push silenziose HTTP/2 APNs e patch Google Wallet walletobjects
4
Registra gli esiti per pass (stati SUCCESSFUL, FAILED, CANCELLED)

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. 1
    Scelta dell'audience di destinazione (mode): In request payload, selezioni pass espliciti (manual), segmenti o ricerche salvate (filter / segment), tutti i pass idonei (all) oppure carichi un file CSV di record serialNumber / externalId (csv tramite /api/v1/batch-notifications/csv).
  2. 2
    Composizione del messaggio: Inserisca message (<=200 caratteri nelle notifiche batch, con supporto ai segnaposti {attributeKey}, oppure <=85 caratteri in Push Notifications API).
  3. 3
    Configurazione di data, ora e fuso orario: Imposti publicationDate (YYYY-MM-DD HH:mm o ISO 8601), risolto rispetto al fuso orario IANA del workspace. Finché il batch resta in stato SCHEDULED (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. 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

MetodoPercorso endpointControllerDescrizione
POST/api/v1/push-notifications/templates/:idPush Notifications APIPianifica una notifica push (request payload) su un modello (con segmentIds / savedSearchIds opzionali).
POST/api/v1/push-notifications/templates/:id/sendPush Notifications APIInvia immediatamente in broadcast una notifica push del modello (request payload).
POST/api/v1/push-notifications/segmentationPush Notifications APIInvia una notifica immediata a una ricerca salvata (request payload).
POST/api/v1/batch-notificationsBatch Notifications APICrea una notifica batch pianificata (request payload: `manual \filter \csv \all \segment`).
GET/api/v1/batch-notifications/:batchIdBatch Notifications APIRecupera avanzamento esecuzione (SCHEDULED, PROCESSING, SUCCESSFUL, CANCELLED, FAILED) e telemetria.
DELETE/api/v1/batch-notifications/:batchIdBatch Notifications APIAnnulla un job batch pianificato in stato SCHEDULED prima dell'invio.

Esempio: pianificare una notifica batch (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"]
  }
}

Risposta (201 Created):

JSON
{
  "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") N giorni prima della expirationDate di un pass.
  • Conto alla rovescia check-in evento: Combinano l'emersione in schermata di blocco tramite RelevantDate con 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.

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.