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

Opérations automatisées sur passes

Automatisez les bons post-installation, mises à jour planifiées et créations de bundles sans interrogation manuelle.

Dans ce guide

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 .pkpass mises à jour (à l'aide du bundleId du 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

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
EXÉCUTION DES ACTIONS DE WORKFLOW & TRANSFORMATION WALLET
ACTEURS SYSTÈME PARTICIPANTS
P1 Workflow Execution Engine
P2 Services Passe & Expérience
P3 Appareil Wallet du porteur
ÉTAPE 1a REQUÊTE / ACTION SWITCH_WALLET_EXPERIENCE
›
Réassocie le passe au modèle/palier
ÉTAPE 2a REQUÊTE / ACTION Carte transformée en direct
ÉTAPE 1b REQUÊTE / ACTION GENERATE_ADDITIONAL_PASS
›
Émet un passe compagnon (externalId)|-- 2b. Lien bundle / Push
ÉTAPE 1c REQUÊTE / ACTION ADD_TAG / MOVE_TO_SEGMENT
›
Met à jour les segments d'audience
ÉTAPE 1d REQUÊTE / ACTION WEBHOOK / HTTP_REQUEST
›
Envoie une charge signée au CRM

Catalogue complet workflow action type (25 actions)

1. Mutations de passes et d'expériences Wallet

workflow action typeComportement de l'opérationScé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_PASSMet à 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_PASSSupprime 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_FIELDSMet à 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_PASSFait 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_PASSRestaure 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_EXPERIENCETransforme 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 typeValeurs d'enum autoriséesObjectif
Segmentation d'audienceADD_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éesIF_CONDITION, DELAY, UPDATE_FIELD, CALCULATE_VALUEAiguiller l'exécution, patienter dans les files Bull (delay), modifier des champs ou calculer des valeurs dérivées.
Analytique et synchronisation CRMUPDATE_CRM_CONTACT, CREATE_CRM_LEAD, TRACK_EVENT, UPDATE_ANALYTICSPousser 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 typeComportement de l'opérationScénario d'automatisation courant
SEND_PUSH_NOTIFICATIONEnvoie 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_EMAILEnvoie 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_SMSEnvoie 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_MESSAGEEnvoie 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 :

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

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.

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.