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é.
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
Choisir l'audience cible (
mode) : Dansrequest 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 desserialNumber/externalId(csvvia/api/v1/batch-notifications/csv). -
2
Rédiger le message : Saisissez
message(<=200caractères pour les notifications par lots, avec prise en charge des variables{attributeKey}, ou<=85caractères surPush Notifications API). -
3
Définir la date, l'heure & le fuseau horaire : Indiquez
publicationDate(YYYY-MM-DD HH:mmou ISO 8601), interprété selon le fuseau IANA de votre espace de travail. Tant que le lot reste à l'étatSCHEDULED(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
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éthode | Chemin du point d'entrée | Contrôleur | Description | ||||
|---|---|---|---|---|---|---|---|
| POST | /api/v1/push-notifications/templates/:id | Push Notifications API | Planifie une notification push (request payload) pour tout un modèle (avec segmentIds / savedSearchIds optionnels). | ||||
| POST | /api/v1/push-notifications/templates/:id/send | Push Notifications API | Diffuse immédiatement une notification push de modèle (request payload). | ||||
| POST | /api/v1/push-notifications/segmentation | Push Notifications API | Envoie immédiatement une notification vers une recherche enregistrée (request payload). | ||||
| POST | /api/v1/batch-notifications | Batch Notifications API | Crée une notification par lot planifiée (request payload : `manual \ | filter \ | csv \ | all \ | segment`). |
| GET | /api/v1/batch-notifications/:batchId | Batch Notifications API | Récupère l'état d'avancement (SCHEDULED, PROCESSING, SUCCESSFUL, CANCELLED, FAILED) et la télémétrie. | ||||
| DELETE | /api/v1/batch-notifications/:batchId | Batch Notifications API | Annule une notification par lot encore à l'état SCHEDULED avant son envoi. |
Exemple : planifier une notification par lot (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"]
}
}
Réponse (201 Created) :
{
"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")Njours avant la dateexpirationDated'un passe. -
Comptes à rebours avant événement : Associez l'affichage automatique
RelevantDatesur 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.
