Nello strumento di creazione bot, una variabile è un contenitore di dati correlati a una conversazione, come il nome di un cliente o l'ID di un ordine in negozio. Durante una conversazione, un bot di messaggistica può usare le variabili per inviare messaggi personalizzati, visualizzare informazioni dinamiche o cambiare il flusso della conversazione.
Un bot può includere fino a 50 variabili univoche in tutte le risposte. Ogni variabile univoca può essere usata in una risposta tutte le volte che è necessario.
Informazioni su nomi e valori di variabile
Nello strumento di creazione bot, ogni variabile ha un nome e un valore. Quando si configura un passaggio in una risposta, il nome funge da segnaposto per il valore. Quando il bot esegue la risposta, sostituisce il nome della variabile con il valore della variabile. Ad esempio, puoi usare una variabile denominata Email come segnaposto per l’indirizzo email del cliente.
Gestione di variabili vuote
Una variabile è vuota se non ha valore. I bot di messaggistica ignorano le variabili vuote durante una conversazione.
Ad esempio, un passaggio Invia messaggio include un messaggio bot del tipo "Lo stato di spedizione del pacco è shipping_status". Se la variabile shipping_status è vuota durante una conversazione, il bot invia il messaggio “Lo stato della spedizione è ”.
Messaggio del bot | Vista del cliente |
---|---|
Gestione di variabili mancanti
Nel passaggio Effettua chiamata API, se una delle variabili salvate non è presente nella risposta, viene attivato il branch Non riuscito del passaggio. Consulta Come aggiungere il passaggio Effettua chiamata API in Creazione workflow.
Informazioni sui tipi di variabili
Variabili cliente
Le variabili cliente memorizzano le informazioni fornite da un cliente durante il passaggio Richiedi dettagli. Ad esempio, questo passaggio potrebbe chiedere a un cliente di fornire il proprio nome e indirizzo email.
Quando si inserisce una variabile in un passaggio usando l’icona Aggiungi una variabile (), le variabili cliente appaiono in Risposte del cliente.
Variabili di servizio esterne
Le variabili di servizio esterne memorizzano i dati ricevuti da un sistema esterno durante un passaggio Effettua chiamata API. Ad esempio, il passaggio può inviare una richiesta API REST a uno spedizioniere per recuperare lo stato corrente di un pacco.
Gli amministratori creano variabili di servizio esterne durante la configurazione del passaggio Effettua chiamata API. Come parte della configurazione, l’amministratore può impostare un nome personalizzato per ogni variabile.
Quando si inserisce una variabile in un passaggio usando l’icona Aggiungi una variabile (), le variabili di servizio esterne appaiono in Risposte dal servizio esterno.
Variabili di metadati di messaggistica
Le variabili di metadati di messaggistica contengono informazioni sull’identità di un cliente e sullo stato di autenticazione. Le variabili di metadati di messaggistica ottengono i rispettivi valori dai JSON Web Token (JWT) con firma usati per l’autenticazione della messaggistica.
Le variabili di metadati di messaggistica non sono abilitate per impostazione predefinita e sono disponibili solo per il Web Widget e i canali SDK per dispositivi mobili. Per ulteriori informazioni sull’abilitazione e l’uso delle variabili di metadati di messaggistica, consulta Uso dei metadati di autenticazione in una risposta di bot.
Se l’opzione è abilitata, le variabili dei metadati di messaggistica appaiono in Metadati di messaggistica quando si inserisce una variabile in un passaggio usando l’icona Aggiungi una variabile (),
Variabili di Sunshine Conversations
Le variabili Sunshine Conversations possono essere usate per connettersi alle integrazioni Sunshine Conversations.
Le variabili disponibili includono:
Uso di variabili in una risposta
Puoi usare fino a 50 variabili in un singolo flusso.
Personalizzazione dei messaggi bot
Invio di dati a sistemi esterni
Quando si effettua una chiamata API REST a un sistema esterno usando il passaggio Effettua chiamata API, gli amministratori possono aggiungere variabili di inserimento al percorso e alla stringa di query del campo URL endpoint del passaggio. Per maggiori informazioni, consulta Uso del passaggio Effettua chiamata API in Creazione bot.
Diramazione del flusso di una risposta
Il passaggio Branch per condizione consente a un amministratore di branch il flusso di una risposta in base al valore di una o più variabili. Per maggiori informazioni, consulta Informazioni sulle condizioni di branching.