Skip to content
Helpcentrum-gids · Wallet-updates & meldingenOnboardingfase 6
3 min leestijdGecontroleerd 2026-11-16

Geplande updates & berichten

Plan periodieke updates en segmentberichten voor evenementen of verlengingen en bekijk verzendlogs.

In deze gids

Interactieve UI-weergaven

Openen in onboardinggids (6 fasen)

Bekijk de exacte dashboardpanelen, knoppen en ingezoomde toelichtingen bij deze gids.

Ingezoomde UI-focus
Belangrijke UI-onderdelen

Sjabloon-activiteitenlog — Updates & push (Ingezoomd)

Controleer of sjabloonupdates en pushmeldingen foutloos worden uitgevoerd op alle actieve Apple- & Google Wallet-passen.

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.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
ENGINE VOOR GEPLANDE & BATCHMELDINGEN
FASE 01 CAMPAGNEPLANNING & INNAME
Geplande sjabloonpush (POST/api/v1/push-notifications/templates/:id)
Opgeslagen zoekopdracht (POST/api/v1/push-notifications/segmentation)
Batch- / CSV-melding (POST/api/v1/batch-notifications & /csv)
Geautomatiseerde levenscyclus-cron (Vervalherinneringen & verlengingsalerts)
FASE 02 TIJDZONEBEPALING & ASYNC VERTRAGINGSWACHTRIJ
1
Bepaal uitvoeringstijd via resolveCustomerTimeZone (IANA-tijdzone)
2
Sla batch op (batch notification status: SCHEDULED)
3
Plaats vertraagde background job queue-taak (delay = scheduledAt - now())
Op tijdstip publicationDate
FASE 03 WORKERUITROL & PIPELINE VOOR WALLET-PROPAGATIE
1
Selecteer geschikte ACTIVE-passen met actieve APNs-/Google Wallet-reg.
2
Wijzig aangewezen meldingsveldwaarde & verhoog pasrevisie
3
Verstuur stille APNs HTTP/2-pushes & Google Wallet walletobjects-patches
4
Leg resultaten per pas vast (SUCCESSFUL, FAILED, CANCELLED status)

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. 1
    Kies de doelgroep (mode): Richt u in request payload op specifieke passen (manual), opgeslagen segmenten/zoekopdrachten (filter / segment), alle in aanmerking komende passen (all), of upload een CSV-bestand met serialNumber-/externalId-records (csv via /api/v1/batch-notifications/csv).
  2. 2
    Stel het bericht op: Geef message op (<=200 tekens in batchmeldingen, met ondersteuning voor {attributeKey}-placeholders, of <=85 tekens in Push Notifications API).
  3. 3
    Configureer datum, tijd & tijdzone: Geef publicationDate (YYYY-MM-DD HH:mm of ISO 8601) op, wat wordt verwerkt op basis van de IANA-tijdzone van de workspace. Zolang de batch in status SCHEDULED blijft (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. 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

MethodeEndpointpadControllerBeschrijving
POST/api/v1/push-notifications/templates/:idPush Notifications APIPlant een pushmelding (request payload) voor een sjabloon (met optioneel segmentIds / savedSearchIds).
POST/api/v1/push-notifications/templates/:id/sendPush Notifications APIVerstuurt onmiddellijk een sjabloon-pushmelding (request payload).
POST/api/v1/push-notifications/segmentationPush Notifications APIVerstuurt onmiddellijk een melding naar een opgeslagen zoekopdracht (request payload).
POST/api/v1/batch-notificationsBatch Notifications APIMaakt een geplande batchmelding aan (request payload: `manual \filter \csv \all \segment`).
GET/api/v1/batch-notifications/:batchIdBatch Notifications APIHaalt uitvoeringsvoortgang (SCHEDULED, PROCESSING, SUCCESSFUL, CANCELLED, FAILED) en telemetrie op.
DELETE/api/v1/batch-notifications/:batchIdBatch Notifications APIAnnuleert een openstaande SCHEDULED batchmeldingstaak vóór verzending.

Voorbeeld: een batchmelding inplannen (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"]
  }
}

Respons (201 Created):

JSON
{
  "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") N dagen vóór de expirationDate van 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.

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.