# Installare il widget di chat su Shopify

> Aggiungi la bolla di chat di intoCHAT al tuo negozio Shopify incollando un tag script in theme.liquid, poi collega il negozio per la ricerca dei prodotti.

Su Shopify aggiungi la bolla di chat incollando un solo tag script nel tema. Non c'è nessuna app da installare, e la ricerca dei prodotti funziona con i dati pubblici del negozio, senza chiave API.

## Copiare lo snippet

Apri la scheda **Share** del tuo agente. Nel riquadro **Shopify**, clicca **Copy Code**. È lo stesso script del riquadro **Bubble Chat** e contiene già l'ID del tuo agente:

```html
<script src="https://www.intochat.ai/api/embed.js" data-chatbot-id="YOUR_AGENT_ID"></script>
```

## Aggiungerlo al tema

> Prima duplica il tema, così hai una copia di riserva a cui tornare.

1. Nell'amministrazione di Shopify, vai su **Negozio online → Temi**.
2. Accanto al tema attuale, clicca **⋯** e scegli **Modifica codice**.
3. Nella cartella **Layout**, apri `theme.liquid`.
4. Incolla lo snippet subito sopra `</body>` e clicca **Salva**.
5. Apri il negozio. La bolla di chat compare nell'angolo in basso di ogni pagina che usa questo layout, con i colori e la posizione della scheda [Appearance](/it/docs/appearance).

La posizione consigliata è subito sopra `</body>`, ma lo snippet funziona anche nella sezione `<head>` di `theme.liquid`. Se finisce due volte nel tema, compare una sola bolla.

> L'aggiornamento del tema a una nuova versione o il passaggio a un altro tema può eliminare il codice aggiunto. Dopo, controlla che la bolla ci sia ancora e, se serve, incolla di nuovo lo snippet.

## Far cercare i prodotti all'agente

1. Apri la scheda **Actions** (Azioni) e scegli **Connect your website**.
2. Incolla l'indirizzo del negozio. intoCHAT riconosce Shopify e aggiunge due azioni: **Search products**, con fino a cinque risultati per ricerca, e **Get product details**, con varianti, prezzi e disponibilità.
3. Prova nel **Playground**: chiedi di un prodotto, di un prezzo o se un articolo è disponibile. Le risposte mostrano schede prodotto con immagine, prezzo e link alla pagina del prodotto.

I prodotti vengono cercati in tempo reale mentre il visitatore chatta, quindi nuovi prodotti e prezzi aggiornati compaiono senza riaddestrare. Il collegamento legge solo i dati pubblici dei prodotti. Non vede ordini, carrelli né dati dei clienti, quindi l'agente non può verificare ordini, gestire resi o completare acquisti in chat. Indirizza invece il cliente alla pagina giusta.

Se il negozio è protetto da password, l'agente non vede i prodotti. Rimuovi la password in **Negozio online → Preferenze** e collega di nuovo il negozio. Dettagli in [Collegare il negozio](/it/docs/connect-your-store).

## Addestrare l'agente sui contenuti del negozio

Nella scheda **Knowledge** (Conoscenza) inserisci l'indirizzo del negozio e scegli le pagine su spedizioni, resi e FAQ. Carica guide alle taglie o condizioni come file e aggiungi coppie di domande e risposte per le risposte che devono essere formulate in modo preciso.

## Risoluzione dei problemi

- **Nessuna bolla nel negozio.** Controlla di aver modificato il tema pubblicato e non una copia, e che lo snippet si trovi sopra `</body>` in `theme.liquid`.
- **"Chatbot not found." nella console del browser.** L'ID dell'agente nello snippet è errato. Copialo di nuovo dalla scheda **Share**.
- **"Connect your website" non riesce.** Controlla che l'indirizzo sia quello pubblico del negozio e che il negozio non sia protetto da password.

Altri casi sono descritti in [Risoluzione dei problemi](/it/docs/troubleshooting). Cosa può fare l'agente in un negozio Shopify è spiegato nella [pagina dell'integrazione Shopify](/it/integrazioni/shopify).