Le variabili dei workflow contengono dei valori che potranno essere utilizzati nel contesto di una sessione.
In genere le variabili possono essere utilizzate nei nodi di verifica oppure nel contenuto di un messaggio.
Definisci la variabile
Apri la scheda del workflow e fai clic su Modifica nella card di Impostazioni.
Alla sezione Variabili puoi consultare le variabili disponibili ed inserirne di nuove.
I tipi di valore disponibili sono:
- numero intero: esempio, i punti del programma fedeltà all'inizio del flusso
- stringa: per i valori di testo;
- data e orario: esempio, la data di emissione di un buono o la scadenza di un abbonamento;
- Sì/No: esempio, il contatto è iscritto a un servizio;
- elenco di valori;
- numero decimale: esempio, importo dell'ultima donazione effettuata.
Il nome descrive l'etichetta della variabile, mentre l'ID corrisponde all'identificativo utilizzato nel codice e nelle espressioni - pertanto non potrà ammettere spazi o caratteri speciali.
Assegna un valore
All'interno del designer del workflow, utilizza il nodo Aggiorna variabile per assegnare un valore.
Spesso il valore è assegnato all'inizio sessione, in modo da conservare il valore iniziale di un campo, oppure per calcolare un valore che sarà utilizzato successivamente per tutta la sessione del workflow.
In questo esempio, viene dichiarata una variabile di fine promozione pari a 30gg dopo la data di compleanno del contatto. Questa data potrà essere utilizzata sia in un nodo di verifica condizione, sia nel contenuto di un messaggio.
Inserisci l'espressione per calcolare il valore della variabile:
- per utilizzare il valore di un campo del contatto: contact.values.NAME;
- per utilizzare il valore di una variabile del workflow: workflow.values.NOMEVAR;
- per assegnare un valore a un numero utilizza il punto come separatore decimale (non la virgola);
- per assegnare un valore a un tipo Vero/Falso sono accettati solo: true/false, yes/no;
- per i tipi a scelta singola o multipla, se indichi un valore non esistente, la variabile non sarà valorizzata;
- per assegnare un valore testuale a una variabile, devi racchiuderlo tra apici: 'color'.
Esempio di espressione: per aggiungere 1 al valore di una variabile numerica, usa workflow.values.NOMEVAR + 1.
Verifica quali funzioni puoi utilizzare per manipolare numeri, date o stringhe di testo. Nell'esempio fn.today() esprime la data odierna.
Utilizza la variabile
Sfrutta il contenuto della variabile nei messaggi del workflow inserendo nel testo il segnaposto con la sintassi [workflow:IDvariabile] oppure usa l'icona per inserire un segnaposto e seleziona nella prima tendina il tipo "Variabili del workflow".
Puoi usare la variabile anche in altri nodi del workflow, es. nei nodi di verifica condizione, scrivendo un’espressione con la sintassi workflow.values.IDvariabile.
Questo ti permette di prendere decisioni dinamiche all’interno del workflow, non solo di personalizzare i contenuti. Per esempio, puoi salvare in una variabile il totale carrello e poi:
- Inviare comunicazioni diverse in base al valore
- Attivare un reminder solo sopra una certa soglia
- Gestire percorsi diversi per interessi o comportamenti specifici
In questo modo il workflow diventa più flessibile e reagisce in tempo reale ai dati che raccogli lungo il percorso.
Test del contenuto della variabile
Per effettuare una prova avvia una sessione di test del workflow.
Apri il dettaglio della sessione in corso e accedi alla sezione delle Variabili.
Troverai le variabili valorizzate con il valore corrente.