Aperçu
Passinstance met à disposition deux moteurs d'automatisation complémentaires dans le tableau de bord (/workflows, /automations et /settings/workspace/integrations) :
-
1
Moteur de workflows (
Workflow Engine APIsous/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_CONDITIONetDELAY. -
2
Automatisations universelles (
Automations APIsous/api/v1/automations) : Règles pilotées par politiques pour le e-commerce et PassFlow gérantExistingCardPolicy(REUSE_AND_UPDATE,ISSUE_ADDITIONAL,REPLACE,NO_OP, etc.) etConflictResolutionPolicy(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/workflowsné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 statutDRAFTouINACTIVEjusqu'à son activation explicite viaPOST /api/v1/workflows/:workflowId/activate.
Pipeline d'exécution des workflows
Gérer les workflows via REST (Workflow Engine API)
| Méthode | Point d'entrée | Description |
|---|---|---|
| GET | /api/v1/workflows | Liste les workflows de l'espace (filtrables par status dans workflow status : DRAFT, ACTIVE, PAUSED, INACTIVE, ARCHIVED, ERROR). |
| POST | /api/v1/workflows | Crée un workflow via request payload (name, trigger, actions, conditions, tags). |
| GET | /api/v1/workflows/:workflowId | Récupère la définition d'un workflow, son historique d'exécution (/:workflowId/executions) et ses journaux (/:workflowId/logs). |
| PUT | /api/v1/workflows/:workflowId | Met à jour les déclencheurs, conditions, actions ou le status (request payload). |
| POST | /api/v1/workflows/:workflowId/activate | Active immédiatement un workflow (deactivate suspend son exécution ; trigger le lance manuellement). |
| DELETE | /api/v1/workflows/:workflowId | Supprime 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éclencheur | Valeurs workflow trigger type | Moment du déclenchement |
|---|---|---|
| Cycle de vie Passe & Modèle | PASS_CREATED, PASS_UPDATED, PASS_SCANNED, PASS_VOIDED, PASS_DELETED, PASS_DOWNLOADED, TEMPLATE_CREATED, TEMPLATE_UPDATED | Immédiatement lorsqu'un passe ou un modèle est créé, modifié, scanné, invalidé, supprimé ou téléchargé. |
| Wallet, Mécaniques & Consentement | PASS_INSTALLED, PASS_REMOVED, USER_OPT_IN, USER_OPT_OUT, POINTS_UPDATED, TIER_CHANGED, BALANCE_CHANGED, EVENT_EXPIRED, PASS_INACTIVE, SCAN_PERFORMED | Lors d'un changement d'enregistrement Apple/Google Wallet, d'opt-in marketing ou du franchissement d'un seuil points/palier/solde. |
| Utilisateur, Facturation & Planification | USER_REGISTERED, USER_LOGIN, USER_PROFILE_UPDATED, SUBSCRIPTION_CHANGED, PAYMENT_RECEIVED, PAYMENT_FAILED, WEBHOOK_RECEIVED, API_CALL, SCHEDULED, MANUAL, CUSTOM_API_EVENT | Sur é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) :
{
"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.
