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

Workflow-Konfiguration

Richten Sie Automatisierungsregeln und Vorlagenwechsel innerhalb von Wallet Experiences direkt im Workspace ein.

In dieser Anleitung

Überblick

Passinstance stellt im Dashboard (/workflows, /automations und /settings/workspace/integrations) zwei sich ergänzende Automatisierungs-Engines bereit:

  1. 1
    Workflow Engine (Workflow Engine API unter /api/v1/workflows): Ereignisgesteuerte DAG-Zustandsautomaten auf Basis von workflow trigger type (29 Auslösertypen), workflow action type (25 Aktionstypen), IF_CONDITION und DELAY.
  2. 2
    Universal Automations (Automations API unter /api/v1/automations): Regelbasierte E-Commerce- und PassFlow-Automatisierungen mit Unterstützung für ExistingCardPolicy (REUSE_AND_UPDATE, ISSUE_ADDITIONAL, REPLACE, NO_OP usw.) und ConflictResolutionPolicy (ALLOW_ALL, RUN_ALL, HIGHEST_PRIORITY, BEST_OFFER, FIRST_MATCH, EXCLUSIVE, EXCLUSIVE_BY_SCOPE).

Voraussetzungen: Das Erstellen oder Bearbeiten von Workflows über POST /api/v1/workflows erfordert Berechtigungen zum Bearbeiten von Vorlagen (templates:manage) sowie mindestens eine veröffentlichte Pass-Vorlage. Neu erstellte Workflows starten im Status DRAFT oder INACTIVE, bis sie über POST /api/v1/workflows/:workflowId/activate aktiviert werden.

Pipeline zur Workflow-Ausführung

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
EREIGNISGESTEUERTE WORKFLOW-ENGINE & PROZESSOR
BETEILIGTE SYSTEMKOMPONENTEN
P1 Domain Event Bus / Cron
P2 Workflow Engine API & Matcher
P3 Workflow Execution Engine (Bull Queue)
SCHRITT 1 ANFRAGE / AKTION Trigger-Event auslösen
SCHRITT 2 ANFRAGE / AKTION Aktive Workflows abgleichen
›
TIER_CHANGED, PASS_SCANNED)
›
(status: ACTIVE, filters)
SCHRITT 3 ANFRAGE / AKTION Ausführungs-Job einreihen
SCHRITT 4 ANFRAGE / AKTION Bedingungen & IF_CONDITION
›
Aktionen auswerten
SCHRITT 5 ANFRAGE / AKTION Geordnete actions[] ausführen
›
(DELAY, SEND_PUSH_NOTIFICATION,
›
SWITCH_WALLET_EXPERIENCE)

Workflows über REST verwalten (Workflow Engine API)

MethodeEndpunktBeschreibung
GET/api/v1/workflowsListet Arbeitsbereich-Workflows auf (filterbar nach status in workflow status: DRAFT, ACTIVE, PAUSED, INACTIVE, ARCHIVED, ERROR).
POST/api/v1/workflowsErstellt einen neuen Workflow mit request payload (name, trigger, actions, conditions, tags).
GET/api/v1/workflows/:workflowIdRuft Workflow-Definition, Ausführungsverlauf (/:workflowId/executions) und Protokolle (/:workflowId/logs) ab.
PUT/api/v1/workflows/:workflowIdAktualisiert Workflow-Auslöser, Bedingungen, Aktionen oder status (request payload).
POST/api/v1/workflows/:workflowId/activateAktiviert einen Workflow sofort (deactivate pausiert die Ausführung; trigger startet ihn manuell).
DELETE/api/v1/workflows/:workflowIdLöscht einen Workflow und bricht ausstehende verzögerte Jobs ab.

Unterstützte Auslöser (workflow trigger type)

Das Passinstance database-Enum workflow trigger type definiert alle 29 kanonischen Workflow-Auslösertypen:

Auslöser-Kategorieworkflow trigger type-WerteWann er ausgelöst wird
Pass- & Vorlagen-LebenszyklusPASS_CREATED, PASS_UPDATED, PASS_SCANNED, PASS_VOIDED, PASS_DELETED, PASS_DOWNLOADED, TEMPLATE_CREATED, TEMPLATE_UPDATEDSofort, wenn ein Pass oder eine Vorlage erstellt, geändert, gescannt, entwertet, gelöscht oder heruntergeladen wird.
Wallet, Mechaniken & Opt-inPASS_INSTALLED, PASS_REMOVED, USER_OPT_IN, USER_OPT_OUT, POINTS_UPDATED, TIER_CHANGED, BALANCE_CHANGED, EVENT_EXPIRED, PASS_INACTIVE, SCAN_PERFORMEDWenn sich die Apple-/Google-Wallet-Geräteregistrierung ändert, Marketing-Einwilligungen wechseln oder Punkte-/Stufen-/Guthabenschwellen überschritten werden.
Benutzer, Abrechnung & ZeitplanUSER_REGISTERED, USER_LOGIN, USER_PROFILE_UPDATED, SUBSCRIPTION_CHANGED, PAYMENT_RECEIVED, PAYMENT_FAILED, WEBHOOK_RECEIVED, API_CALL, SCHEDULED, MANUAL, CUSTOM_API_EVENTBei Benutzer-/Zahlungsereignissen, eingehenden Webhooks (POST /api/v1/workflows/webhook/:customerId/:workflowId), Cron-Zeitplänen (normalisiert auf die Arbeitsbereich-Zeitzone) oder manuellen bzw. API-Aufrufen.

Beispiel: Folge-Workflow nach Stufenaufstieg erstellen (POST /api/v1/workflows)

request payload akzeptiert ein Top-Level-trigger-Objekt und ein geordnetes actions-Array (IWorkflowActionConfig[]) sowie optionale Felder für conditions, dataMapping, maxRetries (Standard 3) und timeout (Standard 300 Sekunden):

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"]
}

Entdecken Sie alle Aktionstypen unter Automatisierte Pass-Operationen sowie die visuelle Orchestrierung unter /workflow-engine.

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.