Panoramica
Una volta che un trigger di workflow si attiva e le condizioni sono soddisfatte, Workflow Execution Engine esegue una o più operazioni automatizzate definite in workflow action type (25 azioni tra modifiche pass, tagging, messaggistica, logica, CRM e analytics). Parallelamente, le automazioni commerce e PassFlow (/automations e /api/v1/automations) eseguono 22 operazioni UniversalAutomationActionType governate da ExistingCardPolicy e ConflictResolutionPolicy.
Importante: Le modifiche automatizzate sui pass (
UPDATE_PASS,UPDATE_PASS_FIELDS,SWITCH_WALLET_EXPERIENCE,VOID_PASS,REACTIVATE_PASS) firmano automaticamente gli archivi.pkpassaggiornati (utilizzando il certificato Apple Pass TypebundleIddel modello) e inviano aggiornamenti silenziosi APNs e Google Wallet a tutti i dispositivi registrati per quel titolare.
Flusso di esecuzione delle azioni automatizzate
Catalogo completo workflow action type (25 azioni)
1. Mutazioni di pass e Wallet Experience
| workflow action type | Comportamento dell'operazione | Scenario tipico di automazione |
|---|---|---|
CREATE_PASS | Emette un record pass per un templateId di destinazione mappato dagli attributi del trigger o externalId. | Creare una tessera socio quando arriva un evento WEBHOOK_RECEIVED in ingresso da Typeform o HubSpot. |
UPDATE_PASS | Aggiorna le proprietà principali del pass (expirationDate, barcodeValue, externalId, status). | Estendere expirationDate di 365 giorni quando si verifica PAYMENT_RECEIVED. |
DELETE_PASS | Elimina logicamente un record pass dall'inventario attivo del workspace. | Ripulire pass ospiti temporanei non attivati dopo una finestra di conservazione. |
UPDATE_PASS_FIELDS | Aggiorna uno o più attributi chiave-valore personalizzati sul fronte o sul retro del pass. | Aggiornare nextEventDate o promoBanner sui pass al raggiungimento di un traguardo. |
VOID_PASS | Porta lo stato del pass su VOIDED e oscura la tessera in Apple e Google Wallet. | Annullare automaticamente un pass di prenotazione non pagato se il pagamento non viene confermato entro 48 ore. |
REACTIVATE_PASS | Ripristina allo stato ACTIVE un pass precedentemente in stato VOIDED o INACTIVE. | Riattivare uno skipass o un abbonamento palestra stagionale quando il socio riprende l'abbonamento. |
SWITCH_WALLET_EXPERIENCE | Trasforma un pass già installato sul posto in un nuovo layout di modello o fase Wallet Experience. | Trasformare un Biglietto di registrazione evento in una Tessera fedeltà VIP post-evento il mattino successivo al concerto. |
GENERATE_ADDITIONAL_PASS | Emette un pass associato complementare (come un coupon premio monouso) collegato al titolare del pass principale. | Emettere un Voucher dolce compleanno gratuito quando una carta fedeltà raggiunge 10 timbri. |
2. Azioni di segmentazione, logica e analytics
| workflow action type | Valori Enum consentiti | Scopo |
|---|---|---|
| Segmentazione audience | ADD_TAG, REMOVE_TAG, MOVE_TO_SEGMENT | Applica tag ai pass (es. "checked-in") o iscrive i titolari a segmenti dinamici di invio. |
| Flusso di controllo e dati | IF_CONDITION, DELAY, UPDATE_FIELD, CALCULATE_VALUE | Dirama l'esecuzione, attende nelle code Bull (delay), modifica campi o calcola valori derivati. |
| Analytics e sync CRM | UPDATE_CRM_CONTACT, CREATE_CRM_LEAD, TRACK_EVENT, UPDATE_ANALYTICS | Invia eventi di conversione ai CRM e contatori telemetrici personalizzati. |
3. Comunicazioni multicanale e callback esterni
| workflow action type | Comportamento dell'operazione | Scenario tipico di automazione |
|---|---|---|
SEND_PUSH_NOTIFICATION | Invia una notifica push nativa in schermata di blocco a tutti i dispositivi registrati per il pass. | Avvisa i titolari 2 ore prima di expirationDate che il voucher sta per scadere. |
SEND_EMAIL | Invia un'e-mail transazionale contenente lo smart link di download (/s/:token). | Invia per e-mail un link di download di backup se PASS_CREATED non è seguito da PASS_INSTALLED entro 24 ore. |
SEND_SMS | Invia un messaggio SMS tramite il gateway configurato con il link breve del pass. | Consegna istantaneamente il link di un voucher mobile subito dopo un check-in al POS. |
WEBHOOK / HTTP_REQUEST / SLACK_MESSAGE | Invia una richiesta HTTP firmata in uscita (POST, PUT, PATCH) o un avviso Slack. | Notifica un ERP esterno, un sistema di logistica o il canale Slack #ops. |
Azioni di Automazioni Universali (/api/v1/automations)
Per le regole di checkout negozio e fedeltà configurate in Automazioni (/automations), UniversalAutomationActionType mette a disposizione 22 operazioni commerce specializzate:
-
Ciclo di vita della tessera:
ASSIGN_OR_UPDATE_CARD,CREATE_NEW_CARD,UPGRADE_MEMBERSHIP_TIER,ISSUE_COUPON,ISSUE_GIFT_CARD,UPDATE_PASS_STATUS,EXTEND_EXPIRATION. -
Saldi e attributi:
ADD_POINTS,DEDUCT_POINTS,APPLY_STAMP,RESET_STAMPS,UNLOCK_REWARD,UPDATE_PREPAID_BALANCE,UPDATE_PASS_ATTRIBUTE,INCREMENT_PASS_ATTRIBUTE,DECREMENT_PASS_ATTRIBUTE. -
Storefront e consegna:
APPLY_CART_OFFER,ACTIVATE_BENEFIT,SHOW_STOREFRONT_CTA,SEND_DELIVERY_NOTIFICATION,TRIGGER_WALLET_UPDATE,SCHEDULE_FOLLOW_UP.
Blueprint end-to-end: trasformazione del biglietto evento in tessera fedeltà (POST /api/v1/workflows)
Una funzionalità distintiva di Passinstance consiste nel trasformare un pass Wallet già installato in una nuova esperienza (SWITCH_WALLET_EXPERIENCE) utilizzando 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"
}
}
]
}
Scopra di più sulla configurazione dei trigger in Configurazione dei workflow e sul collegamento multi-tessera in Progetti e bundling dei pass.
