OneTwoAgent

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).

  1. 1Copia lo script del widget da Channels -> Widget -> Install code
  2. 2Aggiungilo al tuo sito in modo che si carichi su ogni pagina.
  3. 3Punto migliore: dentro <head>, prima di </head>.
  4. 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.

Hai bisogno di aiuto?

support@onetwoagent.com