Il widget è la bolla di chat che i tuoi visitatori vedono nell’angolo del tuo sito e che permette loro di parlare con l’assistente IA della tua agenzia (e, se necessario, con una persona del tuo team). Non è una pagina a parte né un’app da installare: è un piccolo frammento di codice che incolli una volta nel tuo sito, e da quel momento il widget compare in tutte le pagine dove è presente quel codice.
A riposo appare come una bolla fluttuante nell’angolo inferiore dello schermo. Cliccandoci si apre una finestra di chat con il saluto configurato dalla tua agenzia e alcuni suggerimenti di conversazione.
Cosa succede dietro le quinte (per il profilo più tecnico)
Sezione intitolata “Cosa succede dietro le quinte (per il profilo più tecnico)”Lo snippet che incolli nel tuo sito carica in modo asincrono un piccolo script (embed.js) ospitato sul
dominio del tuo fornitore. Quello script non disegna nulla da solo: crea un <iframe> isolato e gli passa
la configurazione (identificatore del widget, lingua, dominio di origine e, opzionalmente, l’URL del
backend) come parametri nell’URL stesso dell’iframe. All’interno di quell’iframe gira l’applicazione della
chat, che parla con il backend della piattaforma in modo indipendente dal resto del tuo sito.
Questo ha due conseguenze pratiche: il widget non può rompere il CSS né il JavaScript del tuo sito (vive nel proprio documento isolato), e il tuo sito non può accedere ai dati della conversazione (vivono dentro l’iframe).
L’identità del visitatore è un token di sessione proprio del widget — non usa cookie del tuo sito né di terzi. Quel token si salva nel browser del visitatore (localStorage) e la conversazione si mantiene fino a 7 giorni; passato quel tempo, o se il dato si corrompe, il widget inizia semplicemente una nuova conversazione senza mostrare alcun errore.
Nota — Stati che può mostrare il widget
Online (servizio normale) · fuori orario (con il messaggio che configuri) · trasferito a un umano del tuo team · offline con nuovo tentativo automatico e pulsante «Riprova» · errore di configurazione se manca qualche dato dello snippet. Gli ultimi due sono spiegati in dettaglio nel capitolo 5; il trasferimento a un umano, subito sotto.
Trasferimento a un umano del tuo team
Sezione intitolata “Trasferimento a un umano del tuo team”Se il visitatore preme il suggerimento «Parla con un umano» o scrive esplicitamente che vuole parlare con una persona (in spagnolo o in inglese — il sistema riconosce la richiesta comunque la scriva), l’assistente smette di rispondere da quel messaggio in poi: la conversazione passa ad attendere un operatore nella inbox della tua agenzia (modalità IN CODA, vedi il manuale utente). La chat non mostra alcun avviso speciale mentre attende — semplicemente non arriva una nuova risposta dall’assistente — finché qualcuno del tuo team non prende il controllo dalla inbox; da quel momento, l’intestazione della chat mostra «Ti sta assistendo [nome] del team» e le risposte successive sono sue, non dell’assistente.
Lo stesso accade se hai configurato una regola di escalation dell’agente con l’azione «Trasferisci a un umano» (per parole chiave o per turni non risolti, vedi il manuale dell’amministratore): l’effetto sul widget è identico — l’assistente tace e la conversazione cade nella coda della inbox.