Überblick
Sobald ein Workflow-Auslöser feuert und alle Bedingungen erfüllt sind, führt Workflow Execution Engine eine oder mehrere in workflow action type definierte automatisierte Operationen aus (25 Aktionen für Pass-Änderungen, Tagging, Messaging, Logik, CRM und Analysen). Parallel dazu führen Commerce- und PassFlow-Automatisierungen (/automations und /api/v1/automations) 22 UniversalAutomationActionType-Operationen aus, gesteuert durch ExistingCardPolicy und ConflictResolutionPolicy.
Wichtig: Automatisierte Pass-Mutationen (
UPDATE_PASS,UPDATE_PASS_FIELDS,SWITCH_WALLET_EXPERIENCE,VOID_PASS,REACTIVATE_PASS) signieren automatisch aktualisierte.pkpass-Archive (mit dem Apple-Pass-Type-ZertifikatbundleIdder Vorlage) und versenden stille APNs- sowie Google-Wallet-Updates an alle für diesen Passinhaber registrierten Geräte.
Ausführungsablauf automatisierter Aktionen
Vollständiger workflow action type-Katalog (25 Aktionen)
1. Pass- & Wallet-Experience-Mutationen
| workflow action type | Operationsverhalten | Typisches Automatisierungsszenario |
|---|---|---|
CREATE_PASS | Stellt einen Pass-Datensatz für eine Ziel-templateId aus, verknüpft mit Trigger-Attributen oder externalId. | Mitgliedskarte ausstellen, sobald ein eingehendes WEBHOOK_RECEIVED-Ereignis von Typeform oder HubSpot eintrifft. |
UPDATE_PASS | Aktualisiert zentrale Pass-Eigenschaften (expirationDate, barcodeValue, externalId, status). | expirationDate um 365 Tage verlängern, sobald PAYMENT_RECEIVED eintritt. |
DELETE_PASS | Löscht einen Pass-Datensatz per Soft-Delete aus dem aktiven Arbeitsbereichsbestand. | Nicht aktivierte temporäre Gästepässe nach einer Aufbewahrungsfrist bereinigen. |
UPDATE_PASS_FIELDS | Aktualisiert ein oder mehrere benutzerdefinierte Schlüssel-Wert-Attribute auf der Vorder- oder Rückseite des Passes. | nextEventDate oder promoBanner über alle Pässe hinweg aktualisieren, wenn ein Meilenstein erreicht ist. |
VOID_PASS | Überführt den Pass-Status auf VOIDED und graut die Karte in Apple und Google Wallet aus. | Unbezahlten Reservierungspass automatisch entwerten, falls die Zahlung nicht innerhalb von 48 Stunden bestätigt wird. |
REACTIVATE_PASS | Stellt einen zuvor auf VOIDED oder INACTIVE gesetzten Pass wieder auf ACTIVE um. | Saison-Ski- oder Fitnessstudiopass wieder aktivieren, sobald ein Mitglied sein Abonnement fortsetzt. |
SWITCH_WALLET_EXPERIENCE | Verwandelt einen bereits installierten Pass direkt in ein neues Vorlagenlayout oder eine neue Wallet-Experience-Stufe. | Ein Event-Anmeldeticket am Morgen nach dem Konzert in eine Post-Event-VIP-Treuekarte umwandeln. |
GENERATE_ADDITIONAL_PASS | Stellt einen verknüpften Begleitpass (z. B. einen Einmal-Prämiencoupon) für denselben Inhaber aus. | Einen Gutschein für ein kostenloses Geburtstagsgebäck ausgeben, wenn eine Stempelkarte 10 Stempel erreicht. |
2. Segmentierungs-, Logik- & Analyse-Aktionen
| workflow action type | Erlaubte Enum-Werte | Zweck |
|---|---|---|
| Zielgruppensegmentierung | ADD_TAG, REMOVE_TAG, MOVE_TO_SEGMENT | Pässe mit Tags versehen (z. B. "checked-in") oder Inhaber in dynamische Broadcast-Segmente verschieben. |
| Kontrollfluss & Daten | IF_CONDITION, DELAY, UPDATE_FIELD, CALCULATE_VALUE | Ausführung verzweigen, innerhalb von Bull-Queues warten (delay), Felder ändern oder abgeleitete Werte berechnen. |
| Analysen & CRM-Sync | UPDATE_CRM_CONTACT, CREATE_CRM_LEAD, TRACK_EVENT, UPDATE_ANALYTICS | Konversionsereignisse an CRMs und benutzerdefinierte Telemetriezähler senden. |
3. Multi-Channel-Kommunikation & externe Callbacks
| workflow action type | Operationsverhalten | Typisches Automatisierungsszenario |
|---|---|---|
SEND_PUSH_NOTIFICATION | Sendet eine native Sperrbildschirm-Push-Benachrichtigung an alle für den Pass registrierten Geräte. | Passinhaber 2 Stunden vor expirationDate erinnern, dass ihr Gutschein bald abläuft. |
SEND_EMAIL | Versendet eine transaktionale E-Mail mit dem Smart-Download-Link (/s/:token). | Einen Backup-Download-Link per E-Mail senden, falls nach PASS_CREATED innerhalb von 24 Stunden kein PASS_INSTALLED folgt. |
SEND_SMS | Sendet eine SMS über das konfigurierte Gateway mit dem Pass-Kurzlink. | Unmittelbar nach einem POS-Check-in einen mobilen Gutschein-Link zustellen. |
WEBHOOK / HTTP_REQUEST / SLACK_MESSAGE | Sendet einen ausgehenden signierten HTTP-Request (POST, PUT, PATCH) oder eine Slack-Benachrichtigung. | Ein externes ERP, Lager-Fulfillment-System oder den #ops-Slack-Channel informieren. |
Universal-Automation-Aktionen (/api/v1/automations)
Für Shop-Checkout- und Treueregeln unter Automatisierungen (/automations) bietet UniversalAutomationActionType 22 spezialisierte Commerce-Operationen:
-
Karten-Lebenszyklus:
ASSIGN_OR_UPDATE_CARD,CREATE_NEW_CARD,UPGRADE_MEMBERSHIP_TIER,ISSUE_COUPON,ISSUE_GIFT_CARD,UPDATE_PASS_STATUS,EXTEND_EXPIRATION. -
Guthaben & Attribute:
ADD_POINTS,DEDUCT_POINTS,APPLY_STAMP,RESET_STAMPS,UNLOCK_REWARD,UPDATE_PREPAID_BALANCE,UPDATE_PASS_ATTRIBUTE,INCREMENT_PASS_ATTRIBUTE,DECREMENT_PASS_ATTRIBUTE. -
Storefront & Zustellung:
APPLY_CART_OFFER,ACTIVATE_BENEFIT,SHOW_STOREFRONT_CTA,SEND_DELIVERY_NOTIFICATION,TRIGGER_WALLET_UPDATE,SCHEDULE_FOLLOW_UP.
End-to-End-Blaupause: Event-Ticket morpht zur Treuekarte (POST /api/v1/workflows)
Eine Kernfunktion von Passinstance ist das Verwandeln eines bereits installierten Wallet-Passes in ein neues Erlebnis (SWITCH_WALLET_EXPERIENCE) mithilfe von request payload:
{
"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": "Thanks for attending! Your ticket is now an Alumni Club Pass (%@)."
}
},
{
"type": "ADD_TAG",
"name": "Tag Alumni 2026",
"config": {
"tag": "alumni-2026"
}
}
]
}
Mehr zur Auslöser-Konfiguration finden Sie unter Workflow-Konfiguration sowie zur Mehrfachkarten-Verknüpfung unter Projekte & Pass-Bündelung.
