> ## Documentation Index > Fetch the complete documentation index at: https://docs.switchbord.ai/llms.txt > Use this file to discover all available pages before exploring further. # Widget per sito web > Widget di live chat first-party per il tuo sito web — le conversazioni dei visitatori arrivano nella posta in arrivo di Switchbord, con risposte AI GBCA opzionali in modalità bozza o invio automatico. Il widget per sito web inserisce una bolla di chat nativa di Switchbord su qualsiasi sito web sotto il tuo controllo. I messaggi dei visitatori arrivano nella stessa posta in arrivo degli operatori delle conversazioni WhatsApp, gli operatori rispondono dallo stesso compositore e — a differenza dei fornitori di chat ospitate che ti vincolano al loro chatbot — il widget può convogliare le conversazioni direttamente nel tuo agente GBCA connesso. Se attualmente usi tawk.to o un widget ospitato simile solo per la live chat, questo è il percorso di sostituzione drop-in: un solo tag script, la tua AI, i tuoi dati. ## Cosa ottieni Un singolo tag script asincrono per widget. Le modifiche di aspetto e comportamento si pubblicano dalle Impostazioni senza toccare di nuovo lo snippet. Le conversazioni del widget appaiono in `/inbox` accanto a WhatsApp, in tempo reale, con funzionalità consapevoli del canale (nessun modello o regola di finestra di servizio si applica alle chat del widget). La modalità AI per singolo widget collega l'agente GBCA: bozze di risposta per la revisione dell'operatore, o invio completamente automatico finché un umano non prende il controllo. Ogni widget serve solo i domini che elenchi. Le richieste provenienti da qualsiasi altra origine falliscono in modo sicuro. ## Creare un widget Vai su **Impostazioni → Integrazioni → Canali → Widget per sito web**: 1. Fai clic su **Crea widget** e assegnagli un nome visualizzato. 2. Scegli uno **slug** — diventa parte dell'URL pubblico dello script e del link diretto alla chat, quindi scegli qualcosa che non ti dispiaccia esporre (lettere minuscole, numeri, trattini). 3. Aggiungi le tue **origini consentite** — le origini esatte (schema + host, ad es. `https://www.example.com`) di ogni sito che incorporerà il widget. I sottodomini sono origini separate. 4. Scegli un colore d'accento del tema e la posizione del launcher, imposta il titolo del widget e il messaggio di benvenuto. 5. Copia lo **snippet di installazione** dalla sezione Install e consegnalo a chi mantiene il sito web — oppure usa la [guida all'installazione](/it/guides/website-widget-install), che include istruzioni specifiche per framework e un prompt già pronto per gli agenti di coding AI. La scheda **Diagnostica di installazione** sulla stessa pagina esegue controlli passivi — endpoint pubblico abilitato, origini configurate, slug valido — così puoi confermare la configurazione prima ancora che lo snippet venga distribuito. Ogni widget ottiene anche un **link diretto alla chat** ospitato (`/chat/{slug}` sul tuo dominio API). Utile per firme email, codici QR o per testare il widget senza toccare un sito web. ## Modalità agente AI (GBCA) Ogni widget ha la propria modalità AI, indipendente dalle impostazioni di risposta automatica di WhatsApp: | Modalità | Comportamento | | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Off** (predefinita) | Gli operatori gestiscono ogni messaggio. Nessun coinvolgimento dell'AI. | | **Bozza** | Ogni messaggio del visitatore genera una bozza GBCA nel compositore della posta in arrivo per la revisione dell'operatore — lo stesso flusso in stato ambra delle bozze proattive di WhatsApp. | | **Invio automatico** | L'agente GBCA risponde automaticamente ai visitatori. Nell'istante in cui un operatore umano invia una risposta nella conversazione, gli invii autonomi si fermano e l'agente torna a produrre bozze. | L'autorizzazione all'invio automatico viene ri-verificata rispetto alle impostazioni del widget al momento dell'invio, quindi riportare la modalità su Bozza o Off ha effetto immediato — anche per le risposte già in coda. L'interruttore principale GB-Agent a livello di area di lavoro deve essere abilitato affinché una qualsiasi delle due modalità AI faccia qualcosa. Le conversazioni del widget non toccano mai la pipeline di invio WhatsApp/Meta. Le risposte AI vengono consegnate al visitatore attraverso il widget stesso. ## Identità del visitatore Di default i visitatori sono anonimi — il widget crea automaticamente una sessione e un contatto sintetico. Sono disponibili due potenziamenti: * **Attributi non verificati**: il JavaScript della tua pagina può chiamare `SwitchbordWidget.setVisitor({...})` per allegare un nome o un'email che il visitatore ha digitato da qualche parte. Vengono memorizzati come non verificati e non possono mai sovrascrivere dati verificati. * **Identità firmata (Secure Mode)**: se il tuo sito ha utenti autenticati, il tuo backend può generare un token HS256 a breve scadenza così che Switchbord sappia *in modo verificabile* chi è il visitatore. I visitatori verificati riprendono la conversazione precedente tra sessioni e dispositivi. Consulta la [guida all'installazione](/it/guides/website-widget-install#identità-firmata-secure-mode) per esempi lato server. Puoi anche attivare **Richiedi identità** su un widget, che blocca l'invio dei messaggi e lo storico finché il visitatore della sessione non è stato verificato — il widget si avvia comunque in modo anonimo per poter eseguire l'handshake di login. Quando un'identità verificata corrisponde a un contatto esistente (per email o telefono), Switchbord crea un **suggerimento di unione** non distruttivo invece di unire automaticamente. ## Cosa vedono gli operatori * Le conversazioni del widget portano il badge del canale sito web; le funzionalità esclusive di WhatsApp (modelli, conto alla rovescia della finestra di servizio, caricamento di media) sono nascoste. * Le risposte appaiono al visitatore con l'etichetta dell'autore operatore; le risposte AI mostrano l'etichetta dell'agente. * I visitatori vedono un badge di non letto sul launcher quando arrivano risposte mentre la chat è chiusa. ## Limiti e comportamento * Gli endpoint pubblici del widget sono soggetti a rate limit per area di lavoro (120 richieste/minuto), in aggiunta alla protezione a livello di piattaforma. * Le esecuzioni AI attivate dai messaggi del widget hanno un debounce — messaggi rapidi e consecutivi del visitatore si fondono in un'unica esecuzione dell'agente per il messaggio più recente. * Lo storico della trascrizione è limitato alla sessione: i visitatori anonimi che cancellano la memoria del browser iniziano una nuova conversazione. L'identità firmata è il filo persistente tra dispositivi. ## Prossimi passi * [Installa il widget sul tuo sito web](/it/guides/website-widget-install) — snippet, framework, riferimento SDK, identità firmata e un prompt di installazione per agenti AI. * [Connettore GB-Agent](/it/platform/gb-agent-connector) — come l'agente GBCA stesso è collegato alla tua area di lavoro.