Skip to content
Hilfecenter-Anleitung · Workflows & Automatisierung
3 Min. LesezeitGeprüft 2026-11-16

Automatisierte Pass-Abläufe

Automatisieren Sie Folgegutscheine nach Installation, geplante Status-/Ablaufupdates und Bundle-Erzeugung ohne manuelles Polling.

In dieser Anleitung

Ü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-Zertifikat bundleId der Vorlage) und versenden stille APNs- sowie Google-Wallet-Updates an alle für diesen Passinhaber registrierten Geräte.

Ausführungsablauf automatisierter Aktionen

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
WORKFLOW-AKTIONS-AUSFÜHRUNG & WALLET-MORPHING
BETEILIGTE SYSTEMKOMPONENTEN
P1 Workflow Execution Engine
P2 Pass- & Experience-Services
P3 Wallet-Gerät des Kunden
SCHRITT 1a ANFRAGE / AKTION SWITCH_WALLET_EXPERIENCE
›
Pass an neue Vorlage/Stufe binden
SCHRITT 2a ANFRAGE / AKTION Karten-Design morpht live
›
patchen
SCHRITT 1b ANFRAGE / AKTION GENERATE_ADDITIONAL_PASS
›
Begleitpass ausstellen|-- 2b. Bündel-Link /
›
(externalId)
›
Push-Nachricht senden
SCHRITT 1c ANFRAGE / AKTION ADD_TAG / MOVE_TO_SEGMENT
›
Zielgruppenzugehörigkeit pflegen
SCHRITT 1d ANFRAGE / AKTION WEBHOOK / HTTP_REQUEST
›
Signiertes Payload an CRM senden

Vollständiger workflow action type-Katalog (25 Aktionen)

1. Pass- & Wallet-Experience-Mutationen

workflow action typeOperationsverhaltenTypisches Automatisierungsszenario
CREATE_PASSStellt 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_PASSAktualisiert zentrale Pass-Eigenschaften (expirationDate, barcodeValue, externalId, status).expirationDate um 365 Tage verlängern, sobald PAYMENT_RECEIVED eintritt.
DELETE_PASSLöscht einen Pass-Datensatz per Soft-Delete aus dem aktiven Arbeitsbereichsbestand.Nicht aktivierte temporäre Gästepässe nach einer Aufbewahrungsfrist bereinigen.
UPDATE_PASS_FIELDSAktualisiert 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_PASSStellt 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_EXPERIENCEVerwandelt 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_PASSStellt 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 typeErlaubte Enum-WerteZweck
ZielgruppensegmentierungADD_TAG, REMOVE_TAG, MOVE_TO_SEGMENTPässe mit Tags versehen (z. B. "checked-in") oder Inhaber in dynamische Broadcast-Segmente verschieben.
Kontrollfluss & DatenIF_CONDITION, DELAY, UPDATE_FIELD, CALCULATE_VALUEAusführung verzweigen, innerhalb von Bull-Queues warten (delay), Felder ändern oder abgeleitete Werte berechnen.
Analysen & CRM-SyncUPDATE_CRM_CONTACT, CREATE_CRM_LEAD, TRACK_EVENT, UPDATE_ANALYTICSKonversionsereignisse an CRMs und benutzerdefinierte Telemetriezähler senden.

3. Multi-Channel-Kommunikation & externe Callbacks

workflow action typeOperationsverhaltenTypisches Automatisierungsszenario
SEND_PUSH_NOTIFICATIONSendet 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_EMAILVersendet 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_SMSSendet 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_MESSAGESendet 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:

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": "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.

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.