Widget del sito web

• Cosa possono fare i clienti nel widget: chat, Voice, screenshot e file, nella loro lingua.
• 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.

L'agente di supporto con IA risponde a ogni conversazione del widget in base alla tua base di conoscenza. Per i clienti autenticati usa anche i dati di account che il tuo backend autorizza.

• Chattare nella propria lingua: l'agente risponde in qualunque lingua scriva il cliente.
• Talk (Voice): i clienti possono parlare con l'agente. Il parlato viene rilevato automaticamente e Voice risponde a voce in 40+ lingue; dove la risposta vocale non è supportata, la conversazione prosegue per iscritto. I minuti Voice sono inclusi nei piani a pagamento.
• Inviare screenshot e file: immagini, screenshot e foto, oltre a file PDF, DOC, DOCX e TXT fino a 8 MB. Le immagini vengono lette con la visione artificiale; i documenti PDF e Word vengono analizzati, tabelle comprese.
• Incollare link: l'agente legge la pagina collegata come contesto per quella conversazione. I link dei clienti sono contesto, non conoscenza approvata da te.
• Parlare con una persona: quando l'agente non può verificare una risposta, passa la conversazione al tuo team invece di tirare a indovinare, e chiunque nel team può prenderla in carico dall'inbox.

Vai in Channels -> Widget. Se il widget non è ancora abilitato, abilitalo prima.

• Anteprima live di Home, Chat e Talk, su desktop e mobile.
• Impostazioni di design e comportamento.
• Codice di installazione.

Adatta il widget al tuo prodotto senza scrivere CSS. Ogni modifica appare nell'anteprima live mentre lavori.

• Superfici: Home, Chat e Talk (Voice). Scegli quale si apre per prima.
• Tema: chiaro o scuro.
• Colori: header, fumetti dell'assistente e del cliente, sfondo della chat, campo di input, pulsante di invio, launcher, pulsanti e pulsante di chiusura.
• Tipografia: 45 Google Fonts (sans-serif, serif e monospace), impostabili separatamente per header, messaggi dell'assistente, messaggi del cliente, campo di input e launcher, ognuno con la propria dimensione.
• Messaggi: 6 forme di fumetto, applicabili facoltativamente a entrambi i lati, e una scelta di icone di invio.
• Header: nome dell'assistente, riga di stato e un avatar o logo opzionale.
• Launcher: 15 icone, testo opzionale (solo icona su mobile, se preferisci) e 13 animazioni del launcher.
• Schermata Home: titolo, una breve riga sopra il titolo, un pulsante principale, fino a 3 link, una sfera animata e stili di sfondo come mesh, halo, rays, glow, stars, dots, grain e halftone, con controlli per tinta, intensità e movimento.
• Talk: voce, messaggio di benvenuto parlato e texture della sfera.
• Testi e comportamento: messaggio di benvenuto, placeholder del campo di input, caricamento file attivo o disattivo, modalità compatta, domini consentiti e pagine consentite o escluse.

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

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

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.

• Ogni conversazione del widget compare in Conversations, nella stessa inbox di WhatsApp, Instagram e Telegram.
• L'agente di supporto con IA risponde in base alla tua base di conoscenza e, per i clienti autenticati, ai dati di account autorizzati, nella lingua del cliente.
• Chiunque nel team può prendere in carico la conversazione e rispondere direttamente. Mentre un membro del team gestisce la conversazione, l'IA resta in silenzio; fai clic su Resume AI per restituirla all'IA.
• Nel widget, il cliente vede "{name} joined the conversation" quando risponde un membro del team e "Assistant resumed" quando l'IA torna a rispondere.

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