Aperçu
Lorsqu'un déclencheur de workflow s'active et que ses conditions sont remplies, Workflow Execution Engine exécute une ou plusieurs opérations automatisées définies dans workflow action type (25 actions couvrant les mutations de passes, le marquage par tags, la messagerie, la logique conditionnelle, le CRM et l'analytique). En parallèle, les automatisations e-commerce et PassFlow (/automations et /api/v1/automations) exécutent 22 opérations UniversalAutomationActionType régies par ExistingCardPolicy et ConflictResolutionPolicy.
Important : Les mutations automatisées de passes (
UPDATE_PASS,UPDATE_PASS_FIELDS,SWITCH_WALLET_EXPERIENCE,VOID_PASS,REACTIVATE_PASS) signent automatiquement les archives.pkpassmises à jour (à l'aide dubundleIddu certificat Apple Pass Type du modèle) et envoient des mises à jour silencieuses APNs et Google Wallet à tous les appareils enregistrés pour le porteur.
Flux d'exécution des actions automatisées
Catalogue complet workflow action type (25 actions)
1. Mutations de passes et d'expériences Wallet
| workflow action type | Comportement de l'opération | Scénario d'automatisation courant |
|---|---|---|
CREATE_PASS | Émet un enregistrement de passe pour un templateId cible mappé depuis les attributs du déclencheur ou externalId. | Créer une carte de membre lorsqu'un événement entrant WEBHOOK_RECEIVED arrive depuis Typeform ou HubSpot. |
UPDATE_PASS | Met à jour les propriétés principales du passe (expirationDate, barcodeValue, externalId, status). | Prolonger expirationDate de 365 jours lorsqu'un événement PAYMENT_RECEIVED survient. |
DELETE_PASS | Supprime de manière logique un enregistrement de passe de l'inventaire actif de l'espace de travail. | Nettoyer les passes invités temporaires non activés après une fenêtre de rétention. |
UPDATE_PASS_FIELDS | Met à jour un ou plusieurs attributs clé-valeur personnalisés au recto ou au verso du passe. | Actualiser nextEventDate ou promoBanner sur les passes lorsqu'un palier est atteint. |
VOID_PASS | Fait passer le statut du passe à VOIDED et grise la carte dans Apple Wallet et Google Wallet. | Annuler automatiquement un passe de réservation impayé si le paiement n'est pas confirmé sous 48 heures. |
REACTIVATE_PASS | Restaure un passe précédemment VOIDED ou INACTIVE vers le statut ACTIVE. | Réactiver un forfait de ski saisonnier ou une carte de salle de sport lorsqu'un membre reprend son abonnement. |
SWITCH_WALLET_EXPERIENCE | Transforme sur place un passe déjà installé vers une nouvelle mise en page de modèle ou une nouvelle étape Wallet Experience. | Transformer un Billet d'inscription à un événement en Carte de fidélité VIP post-événement le lendemain du concert. |
GENERATE_ADDITIONAL_PASS | Émet un passe compagnon lié (tel qu'un coupon de récompense à usage unique) rattaché au porteur principal. | Émettre un Bon pâtisserie d'anniversaire offerte lorsqu'une carte de fidélité atteint 10 tampons. |
2. Segmentation, logique et analytique
| workflow action type | Valeurs d'enum autorisées | Objectif |
|---|---|---|
| Segmentation d'audience | ADD_TAG, REMOVE_TAG, MOVE_TO_SEGMENT | Étiqueter des passes (ex. "checked-in") ou inscrire les porteurs dans des segments de diffusion dynamiques. |
| Contrôle de flux et données | IF_CONDITION, DELAY, UPDATE_FIELD, CALCULATE_VALUE | Aiguiller l'exécution, patienter dans les files Bull (delay), modifier des champs ou calculer des valeurs dérivées. |
| Analytique et synchronisation CRM | UPDATE_CRM_CONTACT, CREATE_CRM_LEAD, TRACK_EVENT, UPDATE_ANALYTICS | Pousser les événements de conversion vers les CRM et les compteurs de télémétrie personnalisés. |
3. Communications multicanales et rappels externes
| workflow action type | Comportement de l'opération | Scénario d'automatisation courant |
|---|---|---|
SEND_PUSH_NOTIFICATION | Envoie une notification push native sur écran verrouillé à tous les appareils enregistrés pour le passe. | Alerter les porteurs 2 heures avant expirationDate que leur bon arrive bientôt à expiration. |
SEND_EMAIL | Envoie un e-mail transactionnel contenant le lien de téléchargement intelligent (/s/:token). | Envoyer un lien de secours par e-mail si PASS_CREATED n'est pas suivi de PASS_INSTALLED dans les 24 heures. |
SEND_SMS | Envoie un SMS via la passerelle configurée avec le lien court du passe. | Envoyer un lien de bon mobile instantané juste après un passage en caisse ou un contrôle d'entrée. |
WEBHOOK / HTTP_REQUEST / SLACK_MESSAGE | Envoie une requête HTTP sortante signée (POST, PUT, PATCH) ou une alerte Slack. | Notifier un ERP externe, un système de préparation logistique ou un canal Slack #ops. |
Actions d'automatisation universelles (/api/v1/automations)
Pour les règles de passage en caisse et de fidélité configurées dans Automatisations (/automations), UniversalAutomationActionType met à disposition 22 opérations e-commerce spécialisées :
-
Cycle de vie de la carte :
ASSIGN_OR_UPDATE_CARD,CREATE_NEW_CARD,UPGRADE_MEMBERSHIP_TIER,ISSUE_COUPON,ISSUE_GIFT_CARD,UPDATE_PASS_STATUS,EXTEND_EXPIRATION. -
Soldes et attributs :
ADD_POINTS,DEDUCT_POINTS,APPLY_STAMP,RESET_STAMPS,UNLOCK_REWARD,UPDATE_PREPAID_BALANCE,UPDATE_PASS_ATTRIBUTE,INCREMENT_PASS_ATTRIBUTE,DECREMENT_PASS_ATTRIBUTE. -
Boutique et livraison :
APPLY_CART_OFFER,ACTIVATE_BENEFIT,SHOW_STOREFRONT_CTA,SEND_DELIVERY_NOTIFICATION,TRIGGER_WALLET_UPDATE,SCHEDULE_FOLLOW_UP.
Exemple de bout en bout : transformation d'un billet d'événement en carte de fidélité (POST /api/v1/workflows)
Une capacité phare de Passinstance consiste à transformer sur place un passe Wallet déjà installé vers une nouvelle expérience (SWITCH_WALLET_EXPERIENCE) via 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"
}
}
]
}
Pour aller plus loin sur la configuration des déclencheurs, consultez Configuration des workflows et sur l'association multi-cartes dans Gestion des projets & bundles.
