Überblick: Geplante Kampagnen & automatisiertes Messaging
Mit Passinstance können Teams zeitkritische Pass-Updates, Aktions-Broadcasts, CSV-gestützte Massenbenachrichtigungen sowie automatische Ablauferinnerungen im Voraus einplanen. Geplante Jobs werden in database gespeichert und über verzögerte background job queue-Worker-Queues abgearbeitet — so erfolgt der Versand über Apple APNs und die Google Wallet REST-Endpunkte zuverlässig exakt zum festgelegten Zielzeitpunkt.
Kampagnen im Voraus planen
Nutzen Sie Stapelbenachrichtigungen (Batch Notifications) (/batch-notifications unter Stapelverarbeitung in der Dashboard-Seitenleiste) oder die REST-API, um künftige Pass-Updates sauber einzuplanen:
-
1
Zielgruppe auswählen (
mode): Adressieren Sie inrequest payloadausgewählte Pässe (manual), gespeicherte Segmente/Suchen (filter/segment), alle berechtigten Pässe (all) oder laden Sie eine CSV-Datei mitserialNumber-/externalId-Datensätzen hoch (csvüber/api/v1/batch-notifications/csv). -
2
Nachricht verfassen: Übergeben Sie
message(<=200Zeichen bei Stapelbenachrichtigungen inklusive{attributeKey}-Platzhaltern bzw.<=85Zeichen imPush Notifications API). -
3
Datum, Uhrzeit & Zeitzone festlegen: Geben Sie
publicationDate(YYYY-MM-DD HH:mmoder ISO 8601) an, aufgelöst in der IANA-Zeitzone Ihres Workspaces. Solange der Batch im StatusSCHEDULEDverbleibt (batch notification status:SCHEDULED,PROCESSING,SUCCESSFUL,FAILED,CANCELLED), können Sie ihn bearbeiten (PATCH), sofort auslösen (POST /:batchId/send-now), erneut versuchen (POST /:batchId/retry) oder abbrechen (DELETE). -
4
Ausführung & Audit-Protokolle prüfen: Verfolgen Sie den Fortschritt und exportieren Sie zeilenweise Fehler über
GET /api/v1/batch-notifications/:batchId/errors.csv.
Wichtig: Nur installierte Pässe mit mindestens einer aktiven Apple-Wallet-Geräteregistrierung (
deviceLibraryIdentifier) oder einem aktiven Google-Wallet-Objekt können Sperrbildschirm-Push-Benachrichtigungen anzeigen. Prüfen Sie vor der Planung die Aktiven Geräteregistrierungen in den Analysen.
API-Endpunkte für geplante & Stapelbenachrichtigungen
| Methode | Endpunkt-Pfad | Controller | Beschreibung | ||||
|---|---|---|---|---|---|---|---|
| POST | /api/v1/push-notifications/templates/:id | Push Notifications API | Plant eine Push-Benachrichtigung (request payload) über eine Vorlage (optional mit segmentIds / savedSearchIds). | ||||
| POST | /api/v1/push-notifications/templates/:id/send | Push Notifications API | Sendet sofort eine Vorlagen-Push-Benachrichtigung (request payload). | ||||
| POST | /api/v1/push-notifications/segmentation | Push Notifications API | Sendet sofort eine Benachrichtigung an eine gespeicherte Suche (request payload). | ||||
| POST | /api/v1/batch-notifications | Batch Notifications API | Erstellt eine geplante Stapelbenachrichtigung (request payload: `manual \ | filter \ | csv \ | all \ | segment`). |
| GET | /api/v1/batch-notifications/:batchId | Batch Notifications API | Ruft den Ausführungsfortschritt (SCHEDULED, PROCESSING, SUCCESSFUL, CANCELLED, FAILED) und Telemetriedaten ab. | ||||
| DELETE | /api/v1/batch-notifications/:batchId | Batch Notifications API | Bricht einen noch ausstehenden SCHEDULED-Stapelbenachrichtigungsjob vor dem Versand ab. |
Beispiel: Geplante Stapelbenachrichtigung anlegen (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"]
}
}
Antwort (201 Created):
{
"id": "bn_8831a9c0",
"status": "SCHEDULED",
"publicationDate": "2026-11-20T16:00:00.000Z"
}
Automatisierte Ablauf- & Event-Countdown-Erinnerungen
Zusätzlich zu manuellen und CSV-geplanten Kampagnen lassen sich unter Workflows & Automation zeitbasierte Auslöser einrichten:
-
Vor-Ablauf-Erinnerungen: Aktualisieren Sie automatisch ein Hinweisfeld (z. B.
"Ihr Pass läuft in 3 Tagen ab — tippen zum Verlängern"),NTage vor demexpirationDateeines Passes. -
Event-Check-in-Countdowns: Kombinieren Sie das automatische Einblenden über
RelevantDatemit einem 24 Stunden vor Veranstaltungsbeginn geplanten Push zur Bestätigung von Eingang, Sitzplatz oder Parkhinweisen.
Erfahren Sie mehr unter Push-Benachrichtigungen, Workflow-Konfiguration und Verteilungs- & Interaktionsanalysen.
