Widget del sito web
Il widget OneTwoAgent permette ai clienti di scriverti direttamente dal tuo sito su desktop e mobile, con tutte le chat nella inbox Conversations.
Widget chat web con IARaccolta lead dal chat del sitoConfigurazione web chat senza codiceMessaggistica clienti sul sito web
Cosa copre questo articolo
- Come personalizzare design e comportamento del widget.
- Come installare il widget sul tuo sito web.
- Come applicare impostazioni di sicurezza come domini consentiti e pagine escluse.
1. Apri le impostazioni del Widget
Vai in Channels -> Widget. Se il widget non è ancora abilitato, abilitalo prima.
- Anteprima del widget.
- Impostazioni di personalizzazione.
- Codice di installazione.
2. Personalizza il design del widget
Puoi adattare il widget a quasi qualsiasi stile di sito web.
- Colori del widget: colore del pulsante, sfondo, colori del testo e colore di accento.
- Tipografia: famiglia di font o preset di stile, e dimensione del font quando disponibile.
- Icona ed elementi brand: icona del launcher, nome del business nell’header e sottotitolo o breve saluto opzionale.
- Posizione e layout: in basso a destra o a sinistra, distanza dai bordi dello schermo e comportamento su mobile.
- Comportamento: apertura automatica vs solo al clic, visibilità del saluto, tutte le pagine o pagine selezionate.
Note
- Mantieni il widget minimale: colori semplici, titolo chiaro e un breve saluto.
3. Installa il widget sul tuo sito web
Installazione standard (consigliata).
- 1Copia lo script del widget da Channels -> Widget -> Install code
- 2Aggiungilo al tuo sito in modo che si carichi su ogni pagina.
- 3Punto migliore: dentro <head>, prima di </head>.
- 4Se <head> non è disponibile, inseriscilo prima di </body> (funziona comunque, ma potrebbe caricarsi un po’ più lentamente).
Note
- Dopo l’installazione e la pubblicazione, il widget dovrebbe comparire sul tuo sito live.
4. Installa sulle piattaforme più comuni
- Shopify: Online Store>Themes>Edit code -> layout/theme.liquid -> incolla prima di </head> -> Save
- Wix Opzione A: Settings -> Custom Code -> Add New Tool -> incolla il codice -> Load on all pages -> posizionalo in Head -> Save e pubblica.
- Wix Opzione B: aggiungi lo script tramite l’area globale script/plugin del sito e assicurati che carichi su tutte le pagine.
- Webflow: Project Settings>Custom Code>incolla in Head Code -> Save e pubblica.
- WordPress: usa un plugin per script nel header (sezione Header) oppure incollalo in header.php prima di </head>.
- Siti custom-coded: inserisci lo script nel template HTML globale dentro <head> o prima di </body>.
Oppure invia questo al tuo sviluppatore
6. Impostazioni di sicurezza e controllo
Impostazioni consigliate per un comportamento più sicuro e più pulito.
- Domini consentiti: evita che il codice del widget venga riutilizzato su siti non correlati.
- Esempi di domini: yourdomain.com, www.yourdomain.com, shop.yourdomain.com.
- Pagine escluse: nascondi il widget dove non è rilevante.
- Esclusioni comuni: checkout, conferma ordine, account/login, privacy e pagine tecniche.
- Esempi di percorso: /checkout, /account, /thank-you.
Note
- Inizia in modo semplice: abilita il widget ovunque e poi escludi solo le pagine che davvero non vuoi.
7. Come funzionano le chat del widget in OneTwoAgent
- Quando un cliente invia un messaggio nel widget, compare una nuova conversazione in Conversations.
- Puoi sempre rispondere manualmente.
- Se Auto Sales è abilitato, l’assistente può rispondere automaticamente usando la tua configurazione e il tuo catalogo.
Risoluzione dei problemi
- Il widget non compare: conferma che lo script sia sul sito live (non solo in anteprima), pubblica le modifiche e verifica i domini consentiti se attivati.
- Il widget compare solo su alcune pagine: controlla le regole delle pagine escluse e conferma che lo script sia installato globalmente.
- I messaggi non arrivano: verifica di usare il business account OneTwoAgent corretto e che il widget sia abilitato in Channels -> Widget.
Guide correlate
Continua con i prossimi passaggi di configurazione per canali, prenotazioni, agenda o automazione.
Domande frequenti
Posso installare il widget senza una custom integration completa?
Sì. La configurazione normale prevede un solo script del widget sul sito, più le impostazioni di design e comportamento nel dashboard.
Il widget funziona anche su mobile oltre che su desktop?
Sì. Il widget è pensato sia per i visitatori desktop sia per quelli mobile, con le conversazioni nella stessa inbox.