Raccolta dati con le variabili
La tab Variabili di un nodo consente di raccogliere dati dall'utente durante la conversazione, con controlli di validazione, e di riutilizzarli nel resto del workflow.
Prerequisiti
- Un nodo aperto nel dialogo di configurazione (vedi Configurare un nodo).
Cosa sono le variabili di conversazione
Una variabile di conversazione è un valore raccolto dall'utente in un nodo e reso disponibile ai nodi successivi dello stesso workflow (ad esempio per personalizzare un messaggio o per instradare la conversazione con una condizione). Le variabili possono essere pulite in un nodo successivo tramite l'opzione "Pulisci variabili" descritta in Configurare un nodo.
Tipi di variabile
Per ciascuna variabile si configurano nome, etichetta mostrata all'utente e uno dei seguenti tipi:
- Costante — valore fisso, non richiesto all'utente;
- Testo generico — testo libero;
- Selezione singola — l'utente sceglie un valore tra opzioni predefinite;
- Selezione multipla — l'utente sceglie più valori tra opzioni predefinite;
- Nome proprio;
- Data;
- Ora.
Per i tipi a selezione è possibile definire un valore di default e l'elenco delle opzioni disponibili.
Raccolta multi-passo
Le variabili di un nodo possono essere raccolte in un'unica richiesta oppure in modalità multi-passo: in questo caso le variabili sono raggruppate e mostrate una alla volta, ciascuna con la propria etichetta, guidando l'utente passo dopo passo nella compilazione.
Validazione dell'input
Ogni variabile può richiedere una validazione specifica del valore inserito:
| Tipo di validazione | Descrizione |
|---|---|
| Testo libero | Nessun formato specifico richiesto |
| Formato indirizzo email | |
| Telefono | Formato numero di telefono |
| Data | Formato data |
| Ora | Formato ora |
| Data e ora | Formato combinato data e ora |
| Numero | Valore numerico |
| Numero intero | Valore numerico intero |
| Valuta | Importo in valuta |
| URL | Formato indirizzo web |
| Codice Fiscale | Formato codice fiscale italiano |
| Partita IVA | Formato partita IVA italiana |
| CAP | Formato codice di avviamento postale |
| IBAN | Formato coordinate bancarie IBAN |
| Carta di credito | Formato numero di carta di pagamento |
| Pattern regex personalizzato | Espressione regolare definita dall'amministratore |
Per ogni variabile è inoltre possibile impostare: campo obbligatorio, valori minimo/massimo, un messaggio di errore personalizzato mostrato in caso di valore non valido, un testo segnaposto (placeholder) e, per i campi modificabili, un timeout di modifica con separatore configurabile per i valori multipli.
Restrizioni sulle date
Per le variabili di tipo Data è possibile limitare i valori accettati a date passate, date future o a un intervallo definito, oltre a specificare il formato di output desiderato per il valore raccolto.
Riutilizzare le variabili nel flusso
Una volta raccolta, una variabile è disponibile nei nodi successivi dello stesso workflow: può essere richiamata nel testo dei messaggi, utilizzata come criterio nelle condizioni della tab Opzioni (vedi Opzioni di risposta e condizioni) o passata a un'azione (vedi Azioni e integrazioni dal workflow).
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| L'utente non riesce a proseguire dopo aver inserito un valore | Il valore non supera la validazione configurata | Verificare il tipo di validazione e il messaggio di errore mostrato |
| Una variabile risulta vuota in un nodo successivo | Un nodo intermedio ha pulito le variabili di processo | Escludere la variabile dalla pulizia nel nodo intermedio |
| I valori multipli non vengono separati correttamente | Separatore non configurato o non coerente con l'input atteso | Impostare il separatore corretto nelle opzioni avanzate della variabile |