<!--
  Translated by the docs agent from content-src/es/guides/widget-web/01-que-es-el-widget-y-como-funciona.md
  (source_hash 92baf6cea8b9). If that Spanish source_hash changes, re-check this translation.
-->

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)

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

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.