Overzicht: geplande campagnes & geautomatiseerde berichten
Met Passinstance kunnen teams tijdgevoelige pasupdates, promotieberichten, CSV-gestuurde massameldingen en geautomatiseerde vervalherinneringen vooraf in de wachtrij plaatsen. Geplande taken worden vastgelegd in database en uitgevoerd door background job queue vertraagde workerwachtrijen, wat zorgt voor betrouwbare uitrol over Apple APNs en Google Wallet REST-endpoints precies op het ingestelde tijdstip.
Campagnes vooraf inplannen
Gebruik Batchmeldingen (/batch-notifications onder Batch in de zijbalk van het Dashboard) of de REST API om toekomstige pasupdates nauwkeurig in te plannen:
-
1
Kies de doelgroep (
mode): Richt u inrequest payloadop specifieke passen (manual), opgeslagen segmenten/zoekopdrachten (filter/segment), alle in aanmerking komende passen (all), of upload een CSV-bestand metserialNumber-/externalId-records (csvvia/api/v1/batch-notifications/csv). -
2
Stel het bericht op: Geef
messageop (<=200tekens in batchmeldingen, met ondersteuning voor{attributeKey}-placeholders, of<=85tekens inPush Notifications API). -
3
Configureer datum, tijd & tijdzone: Geef
publicationDate(YYYY-MM-DD HH:mmof ISO 8601) op, wat wordt verwerkt op basis van de IANA-tijdzone van de workspace. Zolang de batch in statusSCHEDULEDblijft (batch notification status:SCHEDULED,PROCESSING,SUCCESSFUL,FAILED,CANCELLED), kunt u deze bijwerken (PATCH), direct versturen (POST /:batchId/send-now), opnieuw proberen (POST /:batchId/retry) of annuleren (DELETE). -
4
Controleer uitvoering & auditlogboeken: Volg de voortgang en exporteer fouten per rij via
GET /api/v1/batch-notifications/:batchId/errors.csv.
Belangrijk: Alleen Geïnstalleerde passen met ten minste één actieve Apple Wallet-apparaatregistratie (
deviceLibraryIdentifier) of een actief Google Wallet-object kunnen pushmeldingen op het toegangsscherm weergeven. Controleer eerst Actieve apparaatregistraties in Analytics voordat u inplant.
API-endpoints voor geplande & batchmeldingen
| Methode | Endpointpad | Controller | Beschrijving | ||||
|---|---|---|---|---|---|---|---|
| POST | /api/v1/push-notifications/templates/:id | Push Notifications API | Plant een pushmelding (request payload) voor een sjabloon (met optioneel segmentIds / savedSearchIds). | ||||
| POST | /api/v1/push-notifications/templates/:id/send | Push Notifications API | Verstuurt onmiddellijk een sjabloon-pushmelding (request payload). | ||||
| POST | /api/v1/push-notifications/segmentation | Push Notifications API | Verstuurt onmiddellijk een melding naar een opgeslagen zoekopdracht (request payload). | ||||
| POST | /api/v1/batch-notifications | Batch Notifications API | Maakt een geplande batchmelding aan (request payload: `manual \ | filter \ | csv \ | all \ | segment`). |
| GET | /api/v1/batch-notifications/:batchId | Batch Notifications API | Haalt uitvoeringsvoortgang (SCHEDULED, PROCESSING, SUCCESSFUL, CANCELLED, FAILED) en telemetrie op. | ||||
| DELETE | /api/v1/batch-notifications/:batchId | Batch Notifications API | Annuleert een openstaande SCHEDULED batchmeldingstaak vóór verzending. |
Voorbeeld: een batchmelding inplannen (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"]
}
}
Respons (201 Created):
{
"id": "bn_8831a9c0",
"status": "SCHEDULED",
"publicationDate": "2026-11-20T16:00:00.000Z"
}
Geautomatiseerde verval- & aftelherinneringen voor evenementen
Naast handmatige en per CSV geplande campagnes kunt u geautomatiseerde tijdgebonden triggers koppelen onder Workflows & automatisering:
-
Herinneringen vóór vervaldatum: Werk automatisch een waarschuwingsveld bij (bijv.
"Uw pas verloopt over 3 dagen — tik om te verlengen")Ndagen vóór deexpirationDatevan een pas. -
Aftellen naar evenementcheck-in: Combineer
RelevantDate-weergave op het toegangsscherm met een geplande pushmelding 24 uur vóór het evenement om poort-, stoel- of parkeerinstructies te bevestigen.
Lees meer in Pushmeldingen, Workflowconfiguratie en Distributie- & interactieanalyses.
