Skip to main content
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

Installazione in una riga

Un singolo tag script asincrono per widget. Le modifiche di aspetto e comportamento si pubblicano dalle Impostazioni senza toccare di nuovo lo snippet.

Posta in arrivo unificata

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 tua AI, non la loro

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.

Allowlist delle origini

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, 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: 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 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