Le variabili di Creazione workflow consentono di personalizzare le risposte di un bot di messaggistica in base ai dati correlati a una conversazione. Le variabili di metadati di messaggistica sono un tipo di variabile di Creazione workflow che contiene informazioni sull’identità del cliente attuale e sullo stato di autenticazione.
Le variabili di metadati di messaggistica ottengono i loro valori dai JSON Web Token (JWT) con firma usati per l’autenticazione della messaggistica. Durante una conversazione, un bot di messaggistica può usare questi dati per personalizzare le risposte, visualizzare informazioni specifiche per il cliente o diramare il flusso della conversazione.
Per una panoramica più ampia delle variabili di Creazione workflow e di come usarle in un flusso di risposte, consulta Uso di variabili per personalizzare le risposte dei bot.
Abilitazione delle variabili di metadati di messaggistica
Per impostazione predefinita, le variabili di metadati di messaggistica non sono abilitate. Per abilitare le variabili di metadati di messaggistica, un amministratore deve creare una chiave di firma usata per generare i JWT per l'autenticazione della messaggistica. L’autenticazione della messaggistica e le variabili dei metadati della messaggistica sono disponibili solo per i canali Web Widget e SDK per dispositivi mobili.
Per ulteriori informazioni sull’impostazione dell’autenticazione della messaggistica, consulta Autenticazione degli utenti finali nella messaggistica per il Web Widget e l’SDK per dispositivi mobili.
Variabili di metadati di messaggistica supportate
Nome variabile metadati di messaggistica | Descrizione |
---|---|
Indirizzo email fornito | Indirizzo email del cliente. Questo indirizzo email viene estratto dal JWT usato per l’autenticazione della messaggistica. |
Nome fornito | Nome del cliente. Questo nome viene estratto dal JWT usato per l’autenticazione della messaggistica. |
ID esterno autenticato | Stringa alfanumerica univoca che identifica il cliente. Questo ID viene estratto dal JWT usato per l’autenticazione della messaggistica. |
Stato autenticato | Se è true, il cliente viene autenticato. Altrimenti, false. Questa variabile è sempre vera o falsa, mai vuota. Quando si usa la variabile di stato Authenticated in un passaggio di condizione Branch by , è supportato solo l’operatore Is . |
Uso delle variabili Nome fornito e Email fornita
Quando usi le variabili Nome fornito e Email fornita , tieni a mente le seguenti considerazioni:
- I bot di messaggistica saltano automaticamente la raccolta delle variabili Nome ed Email per i clienti autenticati in un passaggio Chiedi dettagli . Per i clienti autenticati, queste variabili sono vuote e vengono saltate nei passaggi successivi della conversazione. Usa invece le variabili Nome fornito e Email fornita .
Ha saltato la raccolta di variabili Nome ed Email nel passaggio Chiedi dettagli Variabili Nome fornito e Indirizzo email fornito - I JWT usati per l’autenticazione della messaggistica non richiedono il nome o l’indirizzo email del cliente. Se la tua organizzazione non include un nome o un indirizzo email nei suoi JWT, le rispettive variabili Nome fornito e Email fornita sono vuote e vengono saltate durante una conversazione.
In questi casi, ti consigliamo di aggiornare i tuoi JWT per includere un nome e un indirizzo email.
- Le variabili Nome fornito e Email fornita sono vuote per i clienti non autenticati. Evita di usare queste variabili nei passaggi di risposta per i clienti non autenticati.
Uso delle variabili di metadati di messaggistica con clienti non autenticati
Se un cliente non è autenticato, il valore della variabile di stato Authenticated è false. Le altre variabili di metadati di messaggistica sono vuote per i clienti non autenticati e vengono saltate durante una conversazione.
Prassi ottimali per l’uso delle variabili di metadati di messaggistica
Quando crei una risposta che usa variabili di metadati di messaggistica, tieni presente le seguenti prassi ottimali:
- Se non includi il nome o l'indirizzo email del cliente nei JWT usati per l'autenticazione della messaggistica, non usare le variabili Nome fornito e Email fornita .
- Per creare un flusso di risposte disponibile sia ai clienti autenticati che a quelli non autenticati, usa un passaggio di condizione Branch by per controllare le variabili di stato autenticazione del cliente. Includi variabili di metadati di messaggistica solo nei branch in cui Authenticated Status è true.
- se stai creando una risposta che è disponibile solo per i clienti autenticati e i JWT della tua organizzazione includono un nome e un indirizzo email, usa le variabili Nome e indirizzo email forniti come nome e indirizzo email del cliente. In questi casi, non è necessario raccogliere di nuovo queste informazioni usando il passaggio Chiedi dettagli .
Avvertenza sulla traduzione: questo articolo è stato tradotto usando un software di traduzione automatizzata per fornire una comprensione di base del contenuto. È stato fatto tutto il possibile per fornire una traduzione accurata, tuttavia Zendesk non garantisce l'accuratezza della traduzione.
Per qualsiasi dubbio sull'accuratezza delle informazioni contenute nell'articolo tradotto, fai riferimento alla versione inglese dell'articolo come versione ufficiale.