Vai al contenuto
Documentazione

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:

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

Aggiungerlo al tema

  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.

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.

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.

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. Cosa può fare l'agente in un negozio Shopify è spiegato nella pagina dell'integrazione Shopify.

Visualizza come Markdown