Overzicht
Passinstance biedt twee aanvullende automatiseringsengines in het Dashboard (/workflows, /automations en /settings/workspace/integrations):
-
1
Workflow Engine (
Workflow Engine APIop/api/v1/workflows): Gebeurtenisgestuurde DAG-toestandsmachines op basis van workflow trigger type (29 triggertypen), workflow action type (25 actietypen),IF_CONDITIONenDELAY. -
2
Universele automatiseringen (
Automations APIop/api/v1/automations): Beleidsgestuurde e-commerce- en PassFlow-regels met ondersteuning voorExistingCardPolicy(REUSE_AND_UPDATE,ISSUE_ADDITIONAL,REPLACE,NO_OP, enz.) enConflictResolutionPolicy(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/workflowszijn sjabloonbewerkingsrechten (templates:manage) en minstens één gepubliceerd passjabloon vereist. Nieuw aangemaakte workflows starten alsDRAFTofINACTIVEtotdat ze worden geactiveerd viaPOST /api/v1/workflows/:workflowId/activate.
Pijplijn voor workflowuitvoering
Workflows beheren via REST (Workflow Engine API)
| Methode | Endpoint | Beschrijving |
|---|---|---|
| GET | /api/v1/workflows | Toont workflows van de werkruimte (filterbaar op status uit workflow status: DRAFT, ACTIVE, PAUSED, INACTIVE, ARCHIVED, ERROR). |
| POST | /api/v1/workflows | Maakt een nieuwe workflow aan met request payload (name, trigger, actions, conditions, tags). |
| GET | /api/v1/workflows/:workflowId | Haalt workflowdefinitie, uitvoeringsgeschiedenis (/:workflowId/executions) en logboeken (/:workflowId/logs) op. |
| PUT | /api/v1/workflows/:workflowId | Werkt triggers, voorwaarden, acties of status bij (request payload). |
| POST | /api/v1/workflows/:workflowId/activate | Activeert een workflow direct (deactivate pauzeert uitvoering; trigger start handmatig). |
| DELETE | /api/v1/workflows/:workflowId | Verwijdert 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:
| Triggercategorie | workflow trigger type-waarden | Wanneer deze wordt geactiveerd |
|---|---|---|
| Levenscyclus pas & sjabloon | PASS_CREATED, PASS_UPDATED, PASS_SCANNED, PASS_VOIDED, PASS_DELETED, PASS_DOWNLOADED, TEMPLATE_CREATED, TEMPLATE_UPDATED | Direct wanneer een pas of sjabloon wordt aangemaakt, gewijzigd, gescand, ongeldig verklaard, verwijderd of gedownload. |
| Wallet, mechanieken & opt-in | PASS_INSTALLED, PASS_REMOVED, USER_OPT_IN, USER_OPT_OUT, POINTS_UPDATED, TIER_CHANGED, BALANCE_CHANGED, EVENT_EXPIRED, PASS_INACTIVE, SCAN_PERFORMED | Wanneer Apple/Google Wallet-apparaatregistratie wijzigt, marketingtoestemming verandert of punten-/niveau-/saldodrempels worden overschreden. |
| Gebruiker, facturering & planning | USER_REGISTERED, USER_LOGIN, USER_PROFILE_UPDATED, SUBSCRIPTION_CHANGED, PAYMENT_RECEIVED, PAYMENT_FAILED, WEBHOOK_RECEIVED, API_CALL, SCHEDULED, MANUAL, CUSTOM_API_EVENT | Bij 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):
{
"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.
