Skip to content
Guida del Centro assistenza · Workflow e automazione
4 min di letturaVerificato 2026-11-16

Operazioni automatizzate sui pass

Automatizza buoni post-installazione, aggiornamenti scadenze e pacchetti bundle senza polling manuale.

In questa guida

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 .pkpass aggiornati (utilizzando il certificato Apple Pass Type bundleId del modello) e inviano aggiornamenti silenziosi APNs e Google Wallet a tutti i dispositivi registrati per quel titolare.

Flusso di esecuzione delle azioni automatizzate

FLUSSO ARCHITETTURALE
ARCHITETTURA INTERATTIVA
ESECUZIONE AZIONI WORKFLOW E TRASFORMAZIONE WALLET
ATTORI DI SISTEMA COINVOLTI
P1 Workflow Execution Engine
P2 Servizi Pass ed Experience
P3 Dispositivo Wallet cliente
FASE 1a RICHIESTA / AZIONE SWITCH_WALLET_EXPERIENCE
›
Riassocia pass a nuovo Modello/Livello
FASE 2a RICHIESTA / AZIONE Aspetto carta aggiornato live
FASE 1b RICHIESTA / AZIONE GENERATE_ADDITIONAL_PASS
›
Emette pass collegato (externalId)|-- 2b. Consegna link bundle /
›
notifica push
FASE 1c RICHIESTA / AZIONE ADD_TAG / MOVE_TO_SEGMENT
›
Aggiorna appartenenza audience
FASE 1d RICHIESTA / AZIONE WEBHOOK / HTTP_REQUEST
›
Invia payload firmato al CRM

Catalogo completo workflow action type (25 azioni)

1. Mutazioni di pass e Wallet Experience

workflow action typeComportamento dell'operazioneScenario tipico di automazione
CREATE_PASSEmette 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_PASSAggiorna le proprietà principali del pass (expirationDate, barcodeValue, externalId, status).Estendere expirationDate di 365 giorni quando si verifica PAYMENT_RECEIVED.
DELETE_PASSElimina logicamente un record pass dall'inventario attivo del workspace.Ripulire pass ospiti temporanei non attivati dopo una finestra di conservazione.
UPDATE_PASS_FIELDSAggiorna 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_PASSPorta 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_PASSRipristina 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_EXPERIENCETrasforma 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_PASSEmette 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 typeValori Enum consentitiScopo
Segmentazione audienceADD_TAG, REMOVE_TAG, MOVE_TO_SEGMENTApplica tag ai pass (es. "checked-in") o iscrive i titolari a segmenti dinamici di invio.
Flusso di controllo e datiIF_CONDITION, DELAY, UPDATE_FIELD, CALCULATE_VALUEDirama l'esecuzione, attende nelle code Bull (delay), modifica campi o calcola valori derivati.
Analytics e sync CRMUPDATE_CRM_CONTACT, CREATE_CRM_LEAD, TRACK_EVENT, UPDATE_ANALYTICSInvia eventi di conversione ai CRM e contatori telemetrici personalizzati.

3. Comunicazioni multicanale e callback esterni

workflow action typeComportamento dell'operazioneScenario tipico di automazione
SEND_PUSH_NOTIFICATIONInvia 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_EMAILInvia 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_SMSInvia 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_MESSAGEInvia 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:

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

Scopra di più sulla configurazione dei trigger in Configurazione dei workflow e sul collegamento multi-tessera in Progetti e bundling dei pass.

Documentazione prodotto e API correlata

Pronto a lanciare il tuo primo programma di carte Wallet?

Crea il tuo workspace, configura il modello e testa una carta reale in Apple Wallet e Google Wallet prima di scalare.