Skip to content
Guide du centre d'aide · Workflows & automatisation
3 min de lectureVérifié 2026-11-16

Configuration des workflows

Paramétrez déclencheurs d'automatisation et bascules de modèles directement au sein des Wallet Experiences.

Dans ce guide

Aperçu

Passinstance met à disposition deux moteurs d'automatisation complémentaires dans le tableau de bord (/workflows, /automations et /settings/workspace/integrations) :

  1. 1
    Moteur de workflows (Workflow Engine API sous /api/v1/workflows) : Machines à états événementielles de type DAG reposant sur workflow trigger type (29 types de déclencheurs), workflow action type (25 types d'actions), IF_CONDITION et DELAY.
  2. 2
    Automatisations universelles (Automations API sous /api/v1/automations) : Règles pilotées par politiques pour le e-commerce et PassFlow gérant ExistingCardPolicy (REUSE_AND_UPDATE, ISSUE_ADDITIONAL, REPLACE, NO_OP, etc.) et ConflictResolutionPolicy (ALLOW_ALL, RUN_ALL, HIGHEST_PRIORITY, BEST_OFFER, FIRST_MATCH, EXCLUSIVE, EXCLUSIVE_BY_SCOPE).

Prérequis : La création ou modification de workflows via POST /api/v1/workflows nécessite la permission d'édition des modèles (templates:manage) ainsi qu'au moins un modèle de passe publié. Tout nouveau workflow démarre au statut DRAFT ou INACTIVE jusqu'à son activation explicite via POST /api/v1/workflows/:workflowId/activate.

Pipeline d'exécution des workflows

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
MOTEUR DE WORKFLOWS ÉVÉNEMENTIEL & PROCESSEUR
ACTEURS SYSTÈME PARTICIPANTS
P1 Bus d'événements / Cron
P2 Workflow Engine API & Matcher
P3 Workflow Execution Engine (File Bull)
ÉTAPE 1 REQUÊTE / ACTION Émettre événement déclencheur
ÉTAPE 2 REQUÊTE / ACTION Sélectionner workflows actifs
›
TIER_CHANGED, PASS_SCANNED)
›
(status: ACTIVE, filters)
ÉTAPE 3 REQUÊTE / ACTION Mettre en file l'exécution
ÉTAPE 4 REQUÊTE / ACTION Évaluer conditions
›
& nœuds IF_CONDITION
ÉTAPE 5 REQUÊTE / ACTION Exécuter actions[]
›
(DELAY, SEND_PUSH_NOTIFICATION,
›
SWITCH_WALLET_EXPERIENCE)

Gérer les workflows via REST (Workflow Engine API)

MéthodePoint d'entréeDescription
GET/api/v1/workflowsListe les workflows de l'espace (filtrables par status dans workflow status : DRAFT, ACTIVE, PAUSED, INACTIVE, ARCHIVED, ERROR).
POST/api/v1/workflowsCrée un workflow via request payload (name, trigger, actions, conditions, tags).
GET/api/v1/workflows/:workflowIdRécupère la définition d'un workflow, son historique d'exécution (/:workflowId/executions) et ses journaux (/:workflowId/logs).
PUT/api/v1/workflows/:workflowIdMet à jour les déclencheurs, conditions, actions ou le status (request payload).
POST/api/v1/workflows/:workflowId/activateActive immédiatement un workflow (deactivate suspend son exécution ; trigger le lance manuellement).
DELETE/api/v1/workflows/:workflowIdSupprime un workflow et annule les tâches différées en attente.

Déclencheurs pris en charge (workflow trigger type)

L'énumération Passinstance database workflow trigger type définit l'ensemble des 29 types de déclencheurs canoniques :

Catégorie de déclencheurValeurs workflow trigger typeMoment du déclenchement
Cycle de vie Passe & ModèlePASS_CREATED, PASS_UPDATED, PASS_SCANNED, PASS_VOIDED, PASS_DELETED, PASS_DOWNLOADED, TEMPLATE_CREATED, TEMPLATE_UPDATEDImmédiatement lorsqu'un passe ou un modèle est créé, modifié, scanné, invalidé, supprimé ou téléchargé.
Wallet, Mécaniques & ConsentementPASS_INSTALLED, PASS_REMOVED, USER_OPT_IN, USER_OPT_OUT, POINTS_UPDATED, TIER_CHANGED, BALANCE_CHANGED, EVENT_EXPIRED, PASS_INACTIVE, SCAN_PERFORMEDLors d'un changement d'enregistrement Apple/Google Wallet, d'opt-in marketing ou du franchissement d'un seuil points/palier/solde.
Utilisateur, Facturation & PlanificationUSER_REGISTERED, USER_LOGIN, USER_PROFILE_UPDATED, SUBSCRIPTION_CHANGED, PAYMENT_RECEIVED, PAYMENT_FAILED, WEBHOOK_RECEIVED, API_CALL, SCHEDULED, MANUAL, CUSTOM_API_EVENTSur événement utilisateur ou paiement, réception webhook entrant (POST /api/v1/workflows/webhook/:customerId/:workflowId), cron planifié (normalisé sur le fuseau de l'espace) ou appel manuel/API.

Exemple : créer un workflow de suivi de montée de palier (POST /api/v1/workflows)

request payload attend un objet racine trigger et un tableau ordonné actions (IWorkflowActionConfig[]), accompagnés en option de conditions, dataMapping, maxRetries (défaut 3) et timeout (défaut 300 secondes) :

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

Explorez tous les types d'actions dans Opérations automatisées sur passes et l'orchestration visuelle sur /workflow-engine.

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.