Skip to content
Helpcentrum-gids · Workflows & automatisering
4 min leestijdGecontroleerd 2026-11-16

Geautomatiseerde pass-acties

Automatiseer vervolgvouchers na installatie, geplande vervalupdates en bundelkaarten zonder handmatig werk.

In deze gids

Overzicht

Zodra een workflowtrigger afgaat en aan de voorwaarden is voldaan, voert Workflow Execution Engine een of meer geautomatiseerde bewerkingen uit die zijn gedefinieerd in workflow action type (25 acties verspreid over pasmutaties, tagging, berichtgeving, logica, CRM en analytics). Daarnaast voeren commerce- en PassFlow-automatiseringen (/automations en /api/v1/automations) 22 UniversalAutomationActionType-bewerkingen uit die worden aangestuurd door ExistingCardPolicy en ConflictResolutionPolicy.

Belangrijk: Geautomatiseerde pasmutaties (UPDATE_PASS, UPDATE_PASS_FIELDS, SWITCH_WALLET_EXPERIENCE, VOID_PASS, REACTIVATE_PASS) ondertekenen automatisch bijgewerkte .pkpass-archieven (met behulp van de Apple Pass Type Certificate bundleId van het sjabloon) en versturen stille APNs- en Google Wallet-updates naar alle geregistreerde apparaten voor die pashouder.

Uitvoeringsstroom van geautomatiseerde acties

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
SYSTEEMARCHITECTUURSTROOM: UITVOERING VAN WORKFLOWACTIES & WALLET-MORPHING
DEELNEMENDE SYSTEEMACTOREN
P1 Workflow Execution Engine
P2 Pas- & Ervaringsservices
P3 Wallet-apparaat van klant
STAP 1a VERZOEK / ACTIE SWITCH_WALLET_EXPERIENCE
›
Koppel pas aan nieuw sjabl./tier
STAP 2a VERZOEK / ACTIE Kaartvoorkant verandert live
STAP 1b VERZOEK / ACTIE GENERATE_ADDITIONAL_PASS
›
Geef extra pas uit (externalId) |-- 2b. Lever bundellink /
›
pushmelding
STAP 1c VERZOEK / ACTIE ADD_TAG / MOVE_TO_SEGMENT
›
Werk doelgroeplidmaatschap bij
STAP 1d VERZOEK / ACTIE WEBHOOK / HTTP_REQUEST
›
Stuur getekende payload naar CRM

Volledige catalogus van workflow action type (25 acties)

1. Mutaties van passen en wallet-ervaringen

workflow action typeGedrag van de bewerkingTypisch automatiseringsscenario
CREATE_PASSGeeft een pasrecord uit voor een doel-templateId op basis van triggerattributen of externalId.Maak een lidmaatschapskaart aan wanneer een inkomende WEBHOOK_RECEIVED-gebeurtenis binnenkomt vanuit Typeform of HubSpot.
UPDATE_PASSWerkt kerneigenschappen van de pas bij (expirationDate, barcodeValue, externalId, status).Verleng expirationDate met 365 dagen wanneer PAYMENT_RECEIVED plaatsvindt.
DELETE_PASSVerwijdert een pasrecord (soft-delete) uit de actieve voorraad van de werkruimte.Ruim niet-geactiveerde tijdelijke gastenpassen op na een bewaartermijn.
UPDATE_PASS_FIELDSWerkt een of meer aangepaste sleutel-waarde-attributen op de voor- of achterkant van de pas bij.Werk nextEventDate of promoBanner op passen bij wanneer een mijlpaal wordt bereikt.
VOID_PASSZet de passtatus om naar VOIDED en maakt de kaart grijs in Apple en Google Wallet.Verklaar een onbetaalde reserveringspas automatisch ongeldig als de betaling niet binnen 48 uur is bevestigd.
REACTIVATE_PASSHerstelt een eerder op VOIDED of INACTIVE gezette pas terug naar de status ACTIVE.Schakel een seizoensgebonden ski- of fitnesspas opnieuw in wanneer een lid zijn abonnement hervat.
SWITCH_WALLET_EXPERIENCETransformeert een geïnstalleerde pas ter plekke naar een nieuwe sjabloonlay-out of fase binnen de Wallet Experience.Verander een Evenementregistratieticket de ochtend na het concert in een Post-Event VIP-loyaliteitskaart.
GENERATE_ADDITIONAL_PASSGeeft een gekoppelde begeleidende pas uit (zoals een eenmalige beloningscoupon) die verbonden is met de hoofdpashouder.Geef een Voucher voor gratis verjaardagsgebak uit wanneer een klantenkaart 10 stempels bereikt.

2. Acties voor segmentatie, logica en analytics

workflow action typeToegestane enumwaardenDoel
DoelgroepsegmentatieADD_TAG, REMOVE_TAG, MOVE_TO_SEGMENTVoorzie passen van tags (bijv. "checked-in") of schrijf houders in voor dynamische uitzendsegmenten.
Controlestroom en gegevensIF_CONDITION, DELAY, UPDATE_FIELD, CALCULATE_VALUEVertak de uitvoering, wacht binnen Bull-wachtrijen (delay), muteer velden of bereken afgeleide waarden.
Analytics en CRM-synchronisatieUPDATE_CRM_CONTACT, CREATE_CRM_LEAD, TRACK_EVENT, UPDATE_ANALYTICSPush conversiegebeurtenissen naar CRM's en aangepaste telemetrietellers.

3. Multichannel-communicatie en externe callbacks

workflow action typeGedrag van de bewerkingTypisch automatiseringsscenario
SEND_PUSH_NOTIFICATIONStuurt een native pushmelding op het toegangsscherm naar alle apparaten die voor de pas zijn geregistreerd.Waarschuw pashouders 2 uur vóór expirationDate dat hun voucher bijna verloopt.
SEND_EMAILStuurt een transactionele e-mail met de slimme downloadlink (/s/:token).Stuur een e-mail met een reserve-downloadlink als PASS_CREATED niet binnen 24 uur wordt gevolgd door PASS_INSTALLED.
SEND_SMSVerstuurt een sms-bericht via de geconfigureerde gateway met de korte link naar de pas.Lever direct na een POS-check-in een directe mobiele voucherlink af.
WEBHOOK / HTTP_REQUEST / SLACK_MESSAGEStuurt een uitgaand ondertekend HTTP-verzoek (POST, PUT, PATCH) of een Slack-melding.Breng een extern ERP-systeem, magazijnfulfillmentsysteem of #ops Slack-kanaal op de hoogte.

Universele automatiseringsacties (/api/v1/automations)

Voor winkelkassa- en loyaliteitsregels die zijn geconfigureerd in Automatiseringen (/automations), biedt UniversalAutomationActionType 22 gespecialiseerde commerce-bewerkingen:

  • Kaartlevenscyclus: ASSIGN_OR_UPDATE_CARD, CREATE_NEW_CARD, UPGRADE_MEMBERSHIP_TIER, ISSUE_COUPON, ISSUE_GIFT_CARD, UPDATE_PASS_STATUS, EXTEND_EXPIRATION.
  • Saldi en attributen: ADD_POINTS, DEDUCT_POINTS, APPLY_STAMP, RESET_STAMPS, UNLOCK_REWARD, UPDATE_PREPAID_BALANCE, UPDATE_PASS_ATTRIBUTE, INCREMENT_PASS_ATTRIBUTE, DECREMENT_PASS_ATTRIBUTE.
  • Etalage en levering: APPLY_CART_OFFER, ACTIVATE_BENEFIT, SHOW_STOREFRONT_CTA, SEND_DELIVERY_NOTIFICATION, TRIGGER_WALLET_UPDATE, SCHEDULE_FOLLOW_UP.

End-to-end blauwdruk: Evenementticket transformeren naar loyaliteitskaart (POST /api/v1/workflows)

Een kenmerkende mogelijkheid van Passinstance is het transformeren van een reeds geïnstalleerde wallet-pas naar een nieuwe ervaring (SWITCH_WALLET_EXPERIENCE) met behulp van request payload:

JSON
{
  "name": "Morph Festival Ticket to Alumni Loyalty Pass",
  "trigger": {
    "type": "SCHEDULED",
    "schedule": {
      "cron": "0 10 18 11 *"
    },
    "filters": {
      "templateId": "tmpl_festival_2026_ticket"
    }
  },
  "conditions": {
    "field": "pass.tags",
    "operator": "CONTAINS",
    "value": "checked-in"
  },
  "actions": [
    {
      "type": "SWITCH_WALLET_EXPERIENCE",
      "name": "Switch to Alumni Card",
      "config": {
        "targetTemplateId": "tmpl_festival_alumni_club",
        "preserveSerialNumber": true,
        "changeMessage": "Bedankt voor uw komst! Uw ticket is nu een Alumni Club Pas (%@)."
      }
    },
    {
      "type": "ADD_TAG",
      "name": "Tag Alumni 2026",
      "config": {
        "tag": "alumni-2026"
      }
    }
  ]
}

Meer informatie over het configureren van triggers vindt u in Workflowconfiguratie en over het koppelen van meerdere kaarten in Projecten en pasbundeling.

Gerelateerde product- en ontwikkelaarsdocs

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.