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 l'app intoCHAT aggiunge la bolla di chat come incorporamento app: la attivi nell'editor del tema senza toccare il codice del tema. La bolla e la ricerca dei prodotti funzionano anche senza l'app, con i dati pubblici del negozio e senza chiave API; in quel caso incolli un solo tag script nel tema. Per permettere all'agente di cercare gli ordini, installa l'app Shopify.

Attivarla con l'app Shopify (senza codice)

Se installi l'app Shopify, non devi modificare il tema:

  1. Nel tab Share dell'agente, sotto Website, fai clic su Turn on in your theme nella scheda Your Shopify store (lo stesso pulsante è nella scheda Orders del tab Actions). Shopify apre l'editor del tema con Bolla chat intoCHAT attivata in Incorporamenti app.
  2. Fai clic su Salva. La bolla compare in ogni pagina del negozio.

Puoi trovarla anche in Negozio online → Temi → Personalizza → Incorporamenti app. L'incorporamento mostra l'agente su cui hai installato l'app; per un altro agente, incolla il suo ID nell'impostazione ID agente. Resta al suo posto quando aggiorni il tema e sparisce se disinstalli l'app.

Senza l'app, incolla invece lo snippet, come spiegato sotto.

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. Questo collegamento legge solo i dati pubblici dei prodotti. Non vede ordini, carrelli né dati dei clienti, e l'agente non può completare acquisti in chat; indirizza invece il cliente alla pagina giusta. Per cercare gli ordini serve l'app Shopify.

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.

Installare l'app Shopify

L'app Shopify di intoCHAT dà al tuo agente l'accesso in lettura agli ordini del negozio, così può rispondere a domande come "Dov'è il mio ordine?". È separata dalla bolla di chat e dalla ricerca dei prodotti descritte sopra, che continuano a funzionare senza l'app.

  1. Apri la scheda Actions (Azioni) del tuo agente e trova il riquadro Orders.
  2. Inserisci l'indirizzo Shopify del negozio: your-store oppure your-store.myshopify.com. Lo trovi nell'amministrazione di Shopify in Impostazioni → Domini. Il tuo dominio, come yourstore.com, qui non funziona.
  3. Clicca Install on Shopify. Shopify apre l'amministrazione del negozio ed elenca gli accessi che intoCHAT chiede.
  4. Approva l'installazione. Shopify ti riporta alla scheda Actions, che dice se ha funzionato.

Solo il proprietario dell'account e gli Admin possono installare l'app, perché conserva l'accesso al tuo negozio. In Shopify ti serve l'autorizzazione a installare app. Ogni agente si collega a un solo negozio; installare l'app su un altro negozio sostituisce il collegamento attuale dell'agente.

Nel riquadro Orders scegli cosa fa l'agente con gli ordini, per esempio se raccoglie richieste di reso.

Quali accessi chiede l'app

  • Lettura degli ordini (read_orders): per cercare lo stato, gli articoli, la spedizione e il tracciamento di un ordine quando un cliente lo chiede in chat.

Nient'altro. L'app non può creare, modificare, annullare o rimborsare ordini, e non chiede l'accesso a prodotti, elenco clienti, pagamenti o impostazioni del negozio. Con questo accesso Shopify permette alle app di leggere gli ordini degli ultimi 60 giorni, quindi l'agente non può cercare quelli più vecchi.

Pagare intoCHAT tramite Shopify

Quando l'app è installata nel tuo account, il piano viene addebitato tramite Shopify invece che sulla carta. In Settings → Billing scegli Starter o Pro, mensile o annuale: Shopify apre l'admin del negozio per approvare l'addebito, che poi compare nella tua fattura Shopify. La prova gratuita di 7 giorni di Starter funziona allo stesso modo. Per cambiare piano scegline un altro e approvalo in Shopify; per smettere di pagare scegli Free. I prezzi sono in dollari USA e Shopify li converte nella valuta di fatturazione del negozio. Un piano che paghi già con carta resta sulla carta.

Puoi anche partire da Shopify: aprendo intoCHAT dall'admin di Shopify accedi (o crei un account) e l'app viene installata sul tuo agente più recente, oppure su un nuovo agente per il negozio se non ne hai ancora uno.

Disinstallare l'app

Nell'amministrazione di Shopify, vai su Impostazioni → App, apri intoCHAT e scegli Disinstalla. Shopify lo comunica subito a intoCHAT, che elimina il collegamento al negozio e le richieste di reso salvate dalle chat con quel negozio. La bolla di chat e la ricerca dei prodotti non cambiano. Per ricollegare il negozio, installa l'app dal riquadro Orders.

intoCHAT rinnova da solo l'accesso dell'app finché l'agente lo usa. Se l'agente non cerca nessun ordine per 90 giorni, Shopify revoca l'accesso e il riquadro Orders ti chiede di installare di nuovo l'app.

Come intoCHAT tratta i dati del negozio

  • Conservati: l'indirizzo del negozio, gli accessi che hai approvato e i token di accesso dell'app, cifrati.
  • Non conservati: ordini e dati dei clienti. L'agente legge un ordine da Shopify mentre risponde in chat e non ne tiene una copia.
  • Richieste di reso: se permetti all'agente di raccoglierle, ogni richiesta viene salvata con l'indirizzo email e il numero d'ordine del cliente e inviata a te.
  • Trascrizioni delle chat: ciò che scrivono i clienti viene conservato con le altre conversazioni nella scheda Activity, dove puoi eliminare una conversazione.

Shopify inoltra le richieste sulla privacy alle app installate sul negozio, e intoCHAT le gestisce così:

  • Un cliente chiede i propri dati: intoCHAT invia a te, proprietario dell'account, un'email con ciò che conserva su di lui, così puoi rispondergli. Shopify ti chiede di rispondere entro 30 giorni.
  • Un cliente chiede la cancellazione: intoCHAT elimina le sue richieste di reso per il tuo negozio.
  • Vengono cancellati i dati del negozio (Shopify lo chiede 48 ore dopo la disinstallazione): intoCHAT elimina tutto ciò che resta del 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.
  • "Install on Shopify" dice che l'indirizzo non è valido. Usa l'indirizzo .myshopify.com che trovi in Impostazioni → Domini, non il tuo dominio.
  • "Shopify app wasn't installed". Il messaggio indica il motivo. Se l'installazione ha richiesto più di 10 minuti, o nel frattempo hai cambiato account intoCHAT, ricomincia dal riquadro Orders.

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