Skip to content
Guide du centre d'aide · Mises à jour & notificationsPhase d'intégration 6
3 min de lectureVérifié 2026-11-16

Mises à jour & messages planifiés

Programmez des envois par lots, ciblez vos segments avant un événement ou une expiration et auditez les journaux.

Dans ce guide

Visites interactives de l'interface

Ouvrir dans le guide en 6 phases

Inspectez les écrans exacts du tableau de bord et les zooms annotés liés à ce guide.

Focus interface zoomé
Éléments clés de l'interface

Journal d'activité — Mises à jour & pushs (Zoom)

Vérifiez que les publications de version et notifications push s'exécutent proprement sur tous les pass Apple et Google actifs.

Aperçu : campagnes programmées & messagerie automatisée

Passinstance permet aux équipes de programmer à l'avance des mises à jour de passes sensibles au calendrier, des diffusions promotionnelles, des alertes de masse pilotées par CSV ainsi que des rappels automatiques avant expiration. Les tâches planifiées sont persistées dans database et exécutées par les files différées background job queue, garantissant une diffusion fiable vers Apple APNs et l'API REST Google Wallet à l'horaire exact configuré.

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
MOTEUR DE NOTIFICATIONS PLANIFIÉES & PAR LOTS
ÉTAPE 01 PLANIFICATION & INGESTION DE CAMPAGNE
Push planifié de modèle (POST/api/v1/push-notifications/templates/:id)
Campagne recherche sauvée (POST/api/v1/push-notifications/segmentation)
Notification par lot / CSV (POST/api/v1/batch-notifications & /csv)
Tâche cron de cycle de vie (rappels d'expiration & alertes renouvellement)
ÉTAPE 02 RÉSOLUTION DU FUSEAU HORAIRE & FILE DIFFÉRÉE ASYNC QUEUE
1
Résoudre l'heure cible via resolveCustomerTimeZone (fuseau IANA)
2
Enregistrer le lot (batch notification status : SCHEDULED)
3
Mettre en file différée background job queue (delay = scheduledAt - now())
À l'horodatage publicationDate
ÉTAPE 03 VENTILATION WORKER & PIPELINE DE PROPAGATION WALLET
1
Interroger les passes ACTIVE éligibles (APNs / Google Wallet actifs)
2
Modifier la valeur du champ cible & incrémenter la révision du passe
3
Envoyer push silencieux APNs HTTP/2 & patchs Google walletobjects
4
Enregistrer les statuts par passe (SUCCESSFUL, FAILED, CANCELLED)

Planifier vos campagnes à l'avance

Utilisez Batch Notifications (/batch-notifications sous Batch dans la barre latérale du tableau de bord) ou l'API REST pour programmer proprement vos diffusions futures :

  1. 1
    Choisir l'audience cible (mode) : Dans request payload, ciblez des passes explicites (manual), des segments ou recherches sauvegardées (filter / segment), l'ensemble des passes éligibles (all), ou importez un fichier CSV listant des serialNumber / externalId (csv via /api/v1/batch-notifications/csv).
  2. 2
    Rédiger le message : Saisissez message (<=200 caractères pour les notifications par lots, avec prise en charge des variables {attributeKey}, ou <=85 caractères sur Push Notifications API).
  3. 3
    Définir la date, l'heure & le fuseau horaire : Indiquez publicationDate (YYYY-MM-DD HH:mm ou ISO 8601), interprété selon le fuseau IANA de votre espace de travail. Tant que le lot reste à l'état SCHEDULED (batch notification status : SCHEDULED, PROCESSING, SUCCESSFUL, FAILED, CANCELLED), vous pouvez le modifier (PATCH), le déclencher immédiatement (POST /:batchId/send-now), le relancer (POST /:batchId/retry) ou l'annuler (DELETE).
  4. 4
    Vérifier l'exécution & les journaux d'audit : Suivez la progression en direct et exportez les erreurs ligne par ligne via GET /api/v1/batch-notifications/:batchId/errors.csv.

Important : Seuls les passes installés disposant d'au moins un enregistrement d'appareil Apple Wallet actif (deviceLibraryIdentifier) ou d'un objet Google Wallet actif peuvent afficher une notification push sur écran verrouillé. Vérifiez la métrique Active Device Registrations dans Analytics avant toute campagne.

Points d'entrée API des notifications planifiées & par lots

MéthodeChemin du point d'entréeContrôleurDescription
POST/api/v1/push-notifications/templates/:idPush Notifications APIPlanifie une notification push (request payload) pour tout un modèle (avec segmentIds / savedSearchIds optionnels).
POST/api/v1/push-notifications/templates/:id/sendPush Notifications APIDiffuse immédiatement une notification push de modèle (request payload).
POST/api/v1/push-notifications/segmentationPush Notifications APIEnvoie immédiatement une notification vers une recherche enregistrée (request payload).
POST/api/v1/batch-notificationsBatch Notifications APICrée une notification par lot planifiée (request payload : `manual \filter \csv \all \segment`).
GET/api/v1/batch-notifications/:batchIdBatch Notifications APIRécupère l'état d'avancement (SCHEDULED, PROCESSING, SUCCESSFUL, CANCELLED, FAILED) et la télémétrie.
DELETE/api/v1/batch-notifications/:batchIdBatch Notifications APIAnnule une notification par lot encore à l'état SCHEDULED avant son envoi.

Exemple : planifier une notification par lot (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"]
  }
}

Réponse (201 Created) :

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

Rappels automatisés d'expiration & comptes à rebours d'événement

En plus des campagnes manuelles et CSV, vous pouvez associer des déclencheurs temporels automatisés sous Workflows & Automation :

  • Rappels avant expiration : Actualisez automatiquement un champ d'alerte (ex. "Your pass expires in 3 days — tap to renew") N jours avant la date expirationDate d'un passe.
  • Comptes à rebours avant événement : Associez l'affichage automatique RelevantDate sur l'écran verrouillé à une notification push planifiée 24 heures avant l'ouverture des portes précisant l'accès, le siège ou le parking.

Approfondissez ces réglages dans Notifications push, Configuration des workflows et Analytique de distribution & d'engagement.

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.