# Installare il widget di chat su WordPress

> Aggiungi il tuo agente intoCHAT a WordPress con il plugin ufficiale: installalo, incolla l'ID dell'agente in Impostazioni e usa lo shortcode per pagine scelte.

Il plugin ufficiale di intoCHAT aggiunge la bolla di chat al tuo sito WordPress senza modificare i file del tema. È gratuito, open source con licenza GPL e si trova nella directory dei plugin di WordPress.org come [intochat.ai](https://wordpress.org/plugins/intochat-ai-embed/).

## Prima di iniziare

- Un agente intoCHAT salvato. Apri la sua scheda **Share** e, nel riquadro **WordPress Plugin**, clicca **Copy ID**.
- Un account WordPress che può installare plugin.

## Installare il plugin

1. Nell'amministrazione di WordPress, vai su **Plugin → Aggiungi nuovo** (**Aggiungi nuovo plugin** nelle versioni recenti).
2. Cerca **intochat.ai**, poi installa e attiva il plugin.
3. Vai su **Impostazioni → intochat.ai**, incolla l'ID dell'agente e salva.
4. Apri il tuo sito. La bolla di chat compare su ogni pagina, con i colori e la posizione della scheda [Appearance](/it/docs/appearance).

Il plugin collega soltanto il sito all'agente. Addestramento, istruzioni, aspetto e impostazioni dei lead restano nella dashboard di intoCHAT, e le modifiche fatte lì arrivano sul sito senza toccare di nuovo il plugin.

## Mostrare la chat solo su alcune pagine

Di base la bolla compare su ogni pagina. Nelle impostazioni del plugin puoi scegliere invece di mostrarla solo dove inserisci lo shortcode `[intochat]`, per esempio in un blocco Shortcode nella pagina contatti o di assistenza.

## Senza plugin

Se preferisci non installare un plugin, incolla il tag script della scheda **Share** nel footer del tema, subito prima di `</body>`. Usa un tema child, così un aggiornamento del tema non lo cancella. Vedi [Installare con un tag script](/it/docs/script-tag).

## Addestrare l'agente sui contenuti WordPress

Nella scheda **Knowledge** (Conoscenza) inserisci l'indirizzo del sito. Il crawl trova pagine e articoli tramite la sitemap e i link, e tu scegli quali includere. Non esiste una sincronizzazione automatica: quando aggiorni una pagina, clicca su **Refresh from website** (aggiorna dal sito) nella sua fonte per rileggerla. Vedi [Crawl del sito](/it/docs/website-crawl).

## Negozi WooCommerce

Su WooCommerce il plugin funziona allo stesso modo. Perché l'agente cerchi anche i tuoi prodotti:

1. Apri la scheda **Actions** (Azioni) e scegli **Connect your website**.
2. Incolla l'indirizzo del negozio, cartella compresa se WordPress è installato in una sottocartella come `/shop`.
3. intoCHAT verifica la WooCommerce Store API e aggiunge le azioni **Search products** e **Get product details**.

La ricerca prodotti legge i dati pubblici dei prodotti da `/wp-json/`. Se usi un plugin di sicurezza come Wordfence, assicurati che non blocchi questo percorso. Vedi [Collegare il negozio](/it/docs/connect-your-store) e la [guida WooCommerce](/it/integrazioni/woocommerce).

## Risoluzione dei problemi

- **Nessuna bolla.** Controlla che l'ID in **Impostazioni → intochat.ai** corrisponda a quello della scheda **Share**.
- **Ancora nessuna bolla dopo il salvataggio.** Svuota la cache del plugin di caching o dell'hosting. Se un plugin di ottimizzazione unisce o ritarda il JavaScript, escludi `embed.js`.
- **Test da utente collegato.** Per vedere il sito come un visitatore, aprilo in una finestra privata. Se sei collegato, sullo smartphone la chat si apre a schermo intero sotto la barra di amministrazione di WordPress.

Altri casi sono descritti in [Risoluzione dei problemi](/it/docs/troubleshooting). Per una panoramica di cosa fa l'agente su WordPress, vedi la [pagina dell'integrazione WordPress](/it/integrazioni/wordpress).