# Installare il widget su HTML e altri siti

> Installa il widget della chat su un sito in HTML, con Google Tag Manager o con un costruttore di siti.

Pagina: https://supportfast.ai/it/guida/sito-web/altri-siti/ · Sezione: Sito web · Aggiornata il 30 ottobre 2026

Su qualunque piattaforma vale una regola: il codice del widget va in tutte le pagine, così com'è. Di preferenza nell'intestazione (`<head>`); se la piattaforma non lo permette, subito prima di `</body>`.

> **Prima di iniziare**
>
> - Il codice del widget, copiato da Agente chat › Profilo Agente › Condividi, riquadro Bottone chat.
> - L'accesso ai file del sito, al pannello del costruttore di siti o al contenitore di Google Tag Manager.

## Sito in HTML

Apri il file HTML di ogni pagina, o il modello comune se il sito ne ha uno. Incolla il codice prima di `</head>` e pubblica i file sul server.

## Google Tag Manager

Con [Google Tag Manager](https://tagmanager.google.com/) crei un tag che aggiunge il widget a tutte le pagine, senza toccare il codice del sito.

1. **Crea un tag HTML personalizzato**
   Nel contenitore del sito crea un tag nuovo di tipo HTML personalizzato. Incolla il codice del widget copiato dalla console, così com'è.

2. **Scegli l'attivatore**
   Come attivatore scegli la visualizzazione di tutte le pagine (All Pages).

3. **Prova e pubblica**
   Prova il tag con l'anteprima di Tag Manager, poi pubblica il contenitore. Finché non lo pubblichi, il tag non arriva sul sito.

## Wix, Squarespace, Webflow e altri costruttori di siti

I costruttori di siti hanno quasi sempre una funzione per aggiungere codice personalizzato. Il nome cambia da piattaforma a piattaforma: codice personalizzato, iniezione di codice, custom code.

1. **Trova la funzione per il codice personalizzato**
   Cercala nelle impostazioni del sito, non in quelle della singola pagina.

2. **Scegli intestazione e tutte le pagine**
   Se la piattaforma lo chiede, scegli di inserire il codice nell'intestazione (head) e su tutte le pagine. Se l'intestazione non c'è fra le scelte, va bene anche la fine della pagina (body).

3. **Incolla e pubblica**
   Incolla il codice del widget, salva e pubblica il sito.

> **Nota**
>
> **Dipende dal piano della piattaforma.** Alcuni costruttori di siti permettono il codice personalizzato solo con i piani a pagamento, o solo con un dominio collegato. Se il tuo piano non lo permette, puoi usare il [link alla chat](https://supportfast.ai/it/guida/sito-web/pagina-intera-iframe.md#link).

## Joomla

Su Joomla hai due strade:

- un'estensione per il codice personalizzato, che inserisca il codice nell'intestazione di tutte le pagine;
- il file principale del template (`index.php`), dove incolli il codice prima di `</head>`. Lavora su un template figlio o su una copia: un aggiornamento del template cancellerebbe la modifica.

## PrestaShop

Su PrestaShop hai due strade:

- un modulo per il codice personalizzato, che inserisca il codice nell'intestazione di tutte le pagine;
- il file dell'intestazione del tema, dove incolli il codice in fondo. Nel tema Classic di PrestaShop 1.7 e 8 è `templates/_partials/head.tpl`. Lavora su un tema figlio o su una copia: un aggiornamento del tema cancellerebbe la modifica.

Dopo la modifica svuota la cache di PrestaShop, di solito in Parametri avanzati › Prestazioni. Per far riconoscere alla chat i clienti collegati c'è l'esempio in [Passare i dati dell'utente](https://supportfast.ai/it/guida/sito-web/dati-utente.md#prestashop).

## Siti fatti su misura e regole di sicurezza

Se il sito è fatto su misura, l'installazione la fa chi lo sviluppa: passagli la pagina [API JavaScript del widget](https://supportfast.ai/it/guida/sviluppatori/widget-api.md).

Alcuni siti hanno una Content Security Policy (CSP): una regola di sicurezza che dice da quali indirizzi la pagina può caricare script, immagini e collegamenti. Se il sito ne ha una, va aggiornata con gli indirizzi del widget, altrimenti il bottone non compare. I domini e le direttive da aggiungere sono in [API JavaScript del widget › Content Security Policy](https://supportfast.ai/it/guida/sviluppatori/widget-api.md#csp).

> **Risultato**
>
> Il codice del widget è in tutte le pagine pubblicate e la chat si apre al clic.

## Come verificare

Apri il sito pubblicato in una finestra anonima, non l'editor o l'anteprima della piattaforma, e segui la prova di [Installare il widget](https://supportfast.ai/it/guida/sito-web/installa-widget.md#verifica). Se il widget manca, le cause sono in [Problemi con il widget sul sito](https://supportfast.ai/it/guida/aiuto/problemi-widget.md).

## Leggi anche

- [Installare il widget](https://supportfast.ai/it/guida/sito-web/installa-widget.md): Il codice, il dominio di pubblicazione e la verifica.

- [API JavaScript del widget](https://supportfast.ai/it/guida/sviluppatori/widget-api.md): Aprire la chat da codice, forzare la lingua, Content Security Policy.

- [Pagina intera e iframe](https://supportfast.ai/it/guida/sito-web/pagina-intera-iframe.md): Il link alla chat e la chat dentro una pagina del sito.