# Installare il widget sul tuo sito > Metti la chat su tutte le pagine del sito: copi un codice dalla console, lo incolli nell'intestazione e controlli che il widget compaia. Pagina: https://supportfast.ai/it/guida/sito-web/installa-widget/ · Sezione: Sito web · Aggiornata il 30 ottobre 2026 Il widget è la chat sul tuo sito: un bottone tondo in un angolo in basso delle pagine che, al clic, apre la finestra della chat. Risponde il tuo agente chat, con le istruzioni e la conoscenza che gli hai dato. Le conversazioni arrivano nella console, in [Conversazioni](https://supportfast.ai/it/guida/conversazioni/casella.md), insieme a quelle degli altri canali. La scheda Condividi dell'agente offre tre codici: il widget, nel riquadro Bottone chat, il link e l'iframe. Link e iframe sono in [Pagina intera e iframe](https://supportfast.ai/it/guida/sito-web/pagina-intera-iframe.md). ![Scheda Condividi del Profilo Agente con i riquadri Link e Condivisione Diretta, iFrame e Bottone chat; evidenziato il pulsante Copia del Bottone chat.](https://supportfast.ai/_astro/06-condividi-widget.CufWqEL_.webp) _Il codice del Bottone chat va copiato e incollato nel tag head del sito._ > **Prima di iniziare** > > - Un agente chat nello stato Attivo e l'accesso al pannello o ai file del sito, oppure un'agenzia a cui mandare il codice. ## Copia il codice 1. **Apri la scheda Condividi** Nella console vai in Agente chat › Profilo Agente › Condividi. 2. **Copia il codice del widget** Nel riquadro Bottone chat premi Copia. Compare il messaggio «Copiato negli appunti!». Il codice che copi ha questa forma: **HTML · il codice del widget (codice agente d'esempio)** ``` ``` ## Incolla il codice nel sito Il codice va nell'intestazione del sito, cioè dentro il tag ``, subito prima di ``. Mettilo nel modello comune a tutte le pagine, di solito l'intestazione del tema: così il widget compare su tutto il sito. - **Così com'è.** Copialo sempre dalla console e incollalo senza modificarlo, anche in Google Tag Manager: se cambia, il widget non compare. - **Una volta per pagina.** Un secondo codice nella stessa pagina viene ignorato, anche se è di un altro agente. Agenti diversi vanno in pagine diverse. - **Anche in fondo alla pagina.** Se la tua piattaforma non ti lascia scrivere nell'intestazione, il codice funziona anche subito prima di ``. Scegli la guida della tua piattaforma: - [WordPress](https://supportfast.ai/it/guida/sito-web/wordpress.md): Con un plugin per il codice personalizzato. - [Shopify](https://supportfast.ai/it/guida/sito-web/shopify.md): Nel file theme.liquid del tema, prima di . - [HTML e altri siti](https://supportfast.ai/it/guida/sito-web/altri-siti.md): HTML, Google Tag Manager, Wix, Squarespace, Webflow, Joomla, PrestaShop. ## Il dominio di pubblicazione Il dominio di pubblicazione dice su quale sito può comparire il widget; non limita il link e l'iframe. È facoltativo: se lo lasci vuoto, il widget compare su qualunque sito che usa il tuo codice. Ti consigliamo di compilarlo quando il sito è online. Così il widget non compare su siti che non sono tuoi, anche se qualcuno copia il codice. 1. **Apri le impostazioni generali** Vai in Agente chat › Profilo Agente › Generali, riquadro Profilo Agente. 2. **Scrivi il dominio** Nel campo Dominio di Pubblicazione (Opzionale) scrivi solo il dominio, tutto in minuscolo, senza `https://` e senza `www.`: per esempio `esempio.it`. Con una lettera maiuscola, come in `Esempio.it`, il widget non compare su nessuna pagina. 3. **Salva** Premi Salva modifiche nella barra in fondo alla pagina. Compare il messaggio «Impostazioni salvate». Con il dominio `esempio.it` compilato, il widget si comporta così: | Indirizzo della pagina | Il widget compare? | | --- | --- | | `esempio.it` e `www.esempio.it` | Sì. | | `negozio.esempio.it` | No: un sottodominio conta come un sito diverso. | | Un altro dominio o un indirizzo di prova | No. | Hai il sito su più domini o sottodomini? Lascia vuoto il campo, oppure usa un agente per ciascun sito, ognuno con il suo dominio. > **Risultato** > > Sulle pagine del sito compare il widget, in basso a destra o a sinistra secondo la Posizione del bottone scelta in Interfaccia. Al clic si apre la chat con il tuo agente. ## Come verificare 1. **Apri il sito in una finestra anonima** La navigazione privata ti mostra il sito come lo vede un visitatore nuovo. Se il sito usa una cache, svuotala prima. 2. **Cerca il widget** Controlla la home e un paio di pagine interne. 3. **Fai una domanda** Apri la chat e scrivi un messaggio: l'agente deve rispondere. 4. **Controlla la console** Apri Agente chat › Conversazioni: la conversazione di prova compare fra quelle del canale Web. > **Consiglio** > > **Prova l'agente prima di metterlo online.** Con Test Chat, in alto nella pagina dell'agente, parli con lo stesso widget senza toccare il sito: vedi [Provare e pubblicare](https://supportfast.ai/it/guida/agente-testuale/prova-e-pubblica.md). ## Widget, link e iframe: le differenze | | Widget | Link e iframe | | --- | --- | --- | | Dove compare | Su ogni pagina del sito, sopra i contenuti | In una scheda tutta sua o in un riquadro della pagina | | Nuvola di benvenuto e X di chiusura | Sì | No | | Pagina del sito comunicata all'agente | Sì: indirizzo e titolo della pagina | No | In Conversazioni le chat dei tre modi stanno tutte nel canale Web. > **Attenzione** > > **Widget e iframe nella stessa pagina fanno due chat.** Il visitatore vedrebbe due conversazioni separate. Chiedi a chi cura il sito di nascondere il widget nella pagina con l'iframe, con la regola CSS spiegata in [API JavaScript del widget](https://supportfast.ai/it/guida/sviluppatori/widget-api.md#variabili-css). ## Problemi comuni Se il widget [non compare](https://supportfast.ai/it/guida/aiuto/problemi-widget.md#non-compare), compare [solo quando scorri la pagina](https://supportfast.ai/it/guida/aiuto/problemi-widget.md#ritardo) o copre altri elementi, le cause e le soluzioni sono in [Problemi con il widget sul sito](https://supportfast.ai/it/guida/aiuto/problemi-widget.md). ## Domande frequenti **Se cambio i colori o i testi dell'agente devo reinstallare il codice?** No: il codice resta lo stesso e le modifiche salvate in console si vedono alla visita successiva. ## Leggi anche - [Cosa vede il visitatore](https://supportfast.ai/it/guida/sito-web/cosa-vede-il-visitatore.md): Il bottone, la finestra della chat e cosa può fare chi la usa. - [Profilo Agente: Interfaccia](https://supportfast.ai/it/guida/agente-testuale/interfaccia.md): Colori, testi, posizione del bottone e nuvola di benvenuto. - [Passare i dati dell'utente](https://supportfast.ai/it/guida/sito-web/dati-utente.md): Fai riconoscere alla chat i clienti già registrati sul tuo sito.