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

Workflowconfiguratie

Stel automatiseringsregels en sjabloonwissels rechtstreeks in binnen uw Wallet Experiences.

In deze gids

Overzicht

Passinstance biedt twee aanvullende automatiseringsengines in het Dashboard (/workflows, /automations en /settings/workspace/integrations):

  1. 1
    Workflow Engine (Workflow Engine API op /api/v1/workflows): Gebeurtenisgestuurde DAG-toestandsmachines op basis van workflow trigger type (29 triggertypen), workflow action type (25 actietypen), IF_CONDITION en DELAY.
  2. 2
    Universele automatiseringen (Automations API op /api/v1/automations): Beleidsgestuurde e-commerce- en PassFlow-regels met ondersteuning voor ExistingCardPolicy (REUSE_AND_UPDATE, ISSUE_ADDITIONAL, REPLACE, NO_OP, enz.) en ConflictResolutionPolicy (ALLOW_ALL, RUN_ALL, HIGHEST_PRIORITY, BEST_OFFER, FIRST_MATCH, EXCLUSIVE, EXCLUSIVE_BY_SCOPE).

Vereisten: Voor het aanmaken of wijzigen van workflows via POST /api/v1/workflows zijn sjabloonbewerkingsrechten (templates:manage) en minstens één gepubliceerd passjabloon vereist. Nieuw aangemaakte workflows starten als DRAFT of INACTIVE totdat ze worden geactiveerd via POST /api/v1/workflows/:workflowId/activate.

Pijplijn voor workflowuitvoering

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
GEBEURTENISGESTUURDE WORKFLOW-ENGINE & PROCESSOR
DEELNEMENDE SYSTEEMACTOREN
P1 Domain Event Bus / Cron
P2 Workflow Engine API & Matcher
P3 Workflow Execution Engine (Bull Queue)
STAP 1 VERZOEK / ACTIE Zend Triggerevent uit
STAP 2 VERZOEK / ACTIE Zoek actieve workflows
›
TIER_CHANGED, PASS_SCANNED)
›
(status: ACTIVE, filters)
STAP 3 VERZOEK / ACTIE Plan uitvoertaak in
STAP 4 VERZOEK / ACTIE Evalueer voorwaarden
›
& IF_CONDITION-acties
STAP 5 VERZOEK / ACTIE Voer geordende actions[] uit
›
(DELAY, SEND_PUSH_NOTIFICATION,
›
SWITCH_WALLET_EXPERIENCE)

Workflows beheren via REST (Workflow Engine API)

MethodeEndpointBeschrijving
GET/api/v1/workflowsToont workflows van de werkruimte (filterbaar op status uit workflow status: DRAFT, ACTIVE, PAUSED, INACTIVE, ARCHIVED, ERROR).
POST/api/v1/workflowsMaakt een nieuwe workflow aan met request payload (name, trigger, actions, conditions, tags).
GET/api/v1/workflows/:workflowIdHaalt workflowdefinitie, uitvoeringsgeschiedenis (/:workflowId/executions) en logboeken (/:workflowId/logs) op.
PUT/api/v1/workflows/:workflowIdWerkt triggers, voorwaarden, acties of status bij (request payload).
POST/api/v1/workflows/:workflowId/activateActiveert een workflow direct (deactivate pauzeert uitvoering; trigger start handmatig).
DELETE/api/v1/workflows/:workflowIdVerwijdert een workflow en annuleert uitgestelde taken.

Ondersteunde triggers (workflow trigger type)

De Passinstance database-enum workflow trigger type definieert alle 29 canonieke triggertypen voor workflows:

Triggercategorieworkflow trigger type-waardenWanneer deze wordt geactiveerd
Levenscyclus pas & sjabloonPASS_CREATED, PASS_UPDATED, PASS_SCANNED, PASS_VOIDED, PASS_DELETED, PASS_DOWNLOADED, TEMPLATE_CREATED, TEMPLATE_UPDATEDDirect wanneer een pas of sjabloon wordt aangemaakt, gewijzigd, gescand, ongeldig verklaard, verwijderd of gedownload.
Wallet, mechanieken & opt-inPASS_INSTALLED, PASS_REMOVED, USER_OPT_IN, USER_OPT_OUT, POINTS_UPDATED, TIER_CHANGED, BALANCE_CHANGED, EVENT_EXPIRED, PASS_INACTIVE, SCAN_PERFORMEDWanneer Apple/Google Wallet-apparaatregistratie wijzigt, marketingtoestemming verandert of punten-/niveau-/saldodrempels worden overschreden.
Gebruiker, facturering & planningUSER_REGISTERED, USER_LOGIN, USER_PROFILE_UPDATED, SUBSCRIPTION_CHANGED, PAYMENT_RECEIVED, PAYMENT_FAILED, WEBHOOK_RECEIVED, API_CALL, SCHEDULED, MANUAL, CUSTOM_API_EVENTBij gebruikers-/betaalgebeurtenissen, inkomende webhookaanvragen (POST /api/v1/workflows/webhook/:customerId/:workflowId), cron-planningen (genormaliseerd naar werkruimetijdzone) of handmatige/API-aanroepen.

Voorbeeld: Een vervolgworkflow voor niveau-upgrade aanmaken (POST /api/v1/workflows)

request payload accepteert een hoofdobject trigger en een geordende array actions (IWorkflowActionConfig[]), naast optionele conditions, dataMapping, maxRetries (standaard 3) en timeout (standaard 300 seconden):

JSON
{
  "name": "Gold Tier Upgrade Celebration & Companion Voucher",
  "description": "Sends congratulatory push and waits 1 hour before issuing bonus drink voucher",
  "trigger": {
    "type": "TIER_CHANGED",
    "filters": {
      "templateId": "tmpl_loyalty_01"
    }
  },
  "conditions": {
    "field": "pass.tier",
    "operator": "EQUALS",
    "value": "GOLD"
  },
  "actions": [
    {
      "type": "SEND_PUSH_NOTIFICATION",
      "name": "Gold Upgrade Alert",
      "config": {
        "message": "Welcome to Gold Tier! Enjoy 2x points on every visit."
      }
    },
    {
      "type": "DELAY",
      "name": "Wait 60 Minutes",
      "config": {
        "durationMinutes": 60
      }
    },
    {
      "type": "GENERATE_ADDITIONAL_PASS",
      "name": "Issue Companion Voucher",
      "config": {
        "targetTemplateId": "tmpl_gold_welcome_drink",
        "linkToParentPass": true
      }
    }
  ],
  "tags": ["loyalty", "gold-tier"]
}

Verken alle actietypen in Geautomatiseerde pasbewerkingen en visuele orkestratie op /workflow-engine.

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.