Le variabili di metadati di messaggistica ottengono i rispettivi valori dai JSON Web Token (JWT) con firma usati per l’autenticazione della messaggistica. Durante una conversazione, un agente AI per la 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 degli agenti AI e di come usarle nelle risposte, consulta Uso delle variabili per personalizzare le risposte degli agenti AI.
Abilitazione delle variabili di metadati di messaggistica
Le variabili di metadati di messaggistica non sono abilitate per impostazione predefinita. Per abilitare le variabili di metadati di messaggistica, un amministratore deve creare una chiave di firma usata per generare JWT per l’autenticazione della messaggistica. L’autenticazione della messaggistica e le variabili di metadati della messaggistica sono disponibili solo per i canali Web Widget e SDK per dispositivi mobili.
Per ulteriori informazioni sulla configurazione 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 recuperato dal JWT usato per l’autenticazione della messaggistica. |
| Nome fornito | Nome del cliente. Questo nome viene recuperato dal JWT usato per l’autenticazione della messaggistica. |
| ID esterno autenticato | Stringa alfanumerica univoca che identifica il cliente. Questo ID viene recuperato dal JWT usato per l’autenticazione della messaggistica. |
| Stato Autenticato | Se è True, il cliente è autenticato. In caso contrario, è False. Questa variabile è sempre True o False, non è mai vuota.
Quando si usa la variabile stato Autenticato in un passaggio Branch per condizione, è supportato solo l’operatore Is. |
Uso delle variabili Nome fornito e Indirizzo email fornito
Quando usi le variabili Nome fornito e Indirizzo email fornito, tieni presente quanto segue:
- Gli agenti AI per la messaggistica ignorano automaticamente la raccolta delle variabili Nome e Indirizzo email per i clienti autenticati in un passaggio Chiedi dettagli. Per i clienti autenticati, queste variabili sono vuote e vengono ignorate nei passaggi successivi della conversazione. Al loro posto, usa le variabili Nome fornito e Indirizzo email fornito.
Raccolta delle variabili Nome e Indirizzo email ignorata 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 l’organizzazione non include un nome o un indirizzo email nei propri JWT, le rispettive variabili Nome fornito e Indirizzo email fornito sono vuote e vengono ignorate durante una conversazione.
In questi casi, ti consigliamo di aggiornare i tuoi JWT in modo da includere un nome e un indirizzo email.
- Le variabili Nome fornito e Indirizzo email fornito sono vuote per i clienti non autenticati. Evita di usare queste variabili nei passaggi del flusso di risposta per i clienti non autenticati.
Uso di variabili di metadati di messaggistica con clienti non autenticati
Se un cliente non è autenticato, il valore della variabile stato Autenticato è False. Le altre variabili di metadati di messaggistica sono vuote per i clienti non autenticati e vengono ignorate 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 best practice:
- 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 Indirizzo email fornito.
- Per creare un flusso di risposta disponibile sia per i clienti autenticati sia per quelli non autenticati, usa un passaggio Branch per condizione per controllare le variabili stato Autenticato del cliente. Includi le variabili di metadati di messaggistica solo nei branch in cui stato Autenticato è True.
- Se stai creando una risposta disponibile solo per i clienti autenticati e i JWT della tua organizzazione includono un nome e un indirizzo email, usa le variabili Nome fornito e Indirizzo email fornito per il nome e l’indirizzo email del cliente. In questi casi, non è necessario raccogliere nuovamente queste informazioni usando il passaggio Chiedi dettagli.