Chatbot AI per Shopify: come installarlo nel tema

Su Shopify l’assistente AI di Wosnic si installa incollando una riga di codice nel tema del negozio. Qui trovi cosa risponde ai clienti, dove prendere il codice, dove incollarlo in theme.liquid, come provarlo e come aggiungere WhatsApp allo stesso assistente. Non serve nessuna app a pagamento.

A cosa serve un chatbot in un negozio Shopify

Le domande di chi compra online sono poche e sempre uguali: quanto costa la spedizione, in quanti giorni arriva, come si fa un reso, che taglia prendere, se un prodotto torna disponibile. Arrivano prima dell’acquisto, spesso la sera, e se nessuno risponde il carrello resta lì. Il chatbot risponde subito con le informazioni che carichi tu nel pannello: le pagine di spedizioni e resi, la guida alle taglie, le schede dei prodotti, le FAQ.

Quando la domanda riguarda un ordine specifico («dov’è il mio pacco?»), l’assistente di base non legge gli ordini: raccoglie numero d’ordine ed email e passa la richiesta a te. Per un negozio abbiamo fatto un collegamento su misura che legge ordini e catalogo da Shopify: se ti serve, è un lavoro a parte, da vedere in call.

L’assistente raccoglie anche i contatti: nome, email e richiesta finiscono nel pannello e ti arrivano per email. Risponde nella lingua del cliente, anche se i documenti sono in italiano, e si presenta sempre come assistente AI.

Prima di iniziare: il codice del widget

Il codice lo prendi dalla tua area clienti su app.wosnic.com: Servizi del progetto → la scheda dell’Assistente → Funzionalità disponibili → Script. Nel riquadro «Script Chat» c’è il pulsante Copia. È una riga sola:

<script src="https://widget.wosnic.com/?serviceId=IL-TUO-ID"></script>

Al posto di IL-TUO-ID c’è l’identificativo del tuo assistente, già compilato nel pannello. Colori, posizione, messaggio di apertura e documenti si cambiano dal pannello: il codice nel tema non va più toccato.

Dove incollare il codice su Shopify

Shopify non ha un campo per gli script di tutto il sito: la riga va nel file di layout del tema, theme.liquid, che Shopify carica in ogni pagina della vetrina. Prima di modificarlo, fai una copia del tema: ci vuole un minuto e ti salva se sbagli.

1. Fai una copia del tema

1. Nel pannello di Shopify vai su Negozio online → Temi.
2. Sul tema attivo clicca il menu con i tre puntini (…) e scegli Duplica. La copia resta fra i temi non pubblicati: se qualcosa va storto, la pubblichi e torni come prima.

2. Apri il file theme.liquid

1. Sempre sul tema attivo, dal menu con i tre puntini scegli Modifica codice.
2. Nella colonna di sinistra apri la cartella Layout e clicca theme.liquid.

3. Incolla la riga e salva

1. Cerca la riga con </body>, in fondo al file, e incolla il codice del widget nella riga subito prima. Va bene anche nell’intestazione, prima di </head>: il widget parte in entrambi i posti.
2. Clicca Salva in alto a destra. La modifica è subito in linea: Shopify non ha una cache da svuotare.

Quando aggiorni il tema, Shopify può crearne una copia nuova senza le tue modifiche al codice: prima di pubblicarla, controlla che la riga sia in theme.liquid e, se manca, rimettila. Lo stesso vale se cambi tema.

Come si prova

1. Apri il negozio in una finestra in incognito: in basso a destra compare il pulsante della chat.
2. Fai una domanda a cui sai rispondere, per esempio sui tempi di spedizione, poi una sulla taglia di un prodotto.
3. Chiedi dello stato di un ordine: l’assistente deve chiedere numero d’ordine ed email e dirti che la richiesta passa al negozio.
4. Nel pannello, sotto Conversazioni, ritrovi la chat; sotto Richieste di contatto, la richiesta.

Il widget compare nelle pagine della vetrina: home, collezioni, prodotti, carrello e pagine di contenuto. Nel checkout di Shopify non compare, perché il checkout non usa theme.liquid.

Come si aggiunge WhatsApp

Lo stesso assistente, con le stesse informazioni su spedizioni, resi e prodotti, può rispondere anche sul numero WhatsApp del negozio. Cambia il canale, non le istruzioni. Si attiva così:

1. Chiedi al tecnico di aggiungere il canale WhatsApp al tuo progetto: compare una nuova scheda fra i servizi.
2. Nella scheda WhatsApp apri Numero e profilo e clicca Collega con Facebook: si apre il collegamento guidato di Meta, con l’account dell’azienda.
3. Scegli il numero: uno che hai già, purché non sia in uso sull’app WhatsApp, oppure uno nuovo. Account e numero restano intestati a te: Wosnic è Tech Provider Meta e si collega con le API ufficiali.

Sul negozio puoi poi mettere un pulsante «Scrivici su WhatsApp» che apre il numero collegato: le risposte le dà lo stesso assistente, e le conversazioni stanno nello stesso pannello. I costi dei messaggi li fattura Meta sul tuo account: te li spieghiamo in call.

Se qualcosa non funziona

• Il pulsante non compare. Controlla di aver salvato theme.liquid del tema pubblicato, non della copia, e che la riga sia intera, con <script all’inizio e </script> alla fine.
• Compare due volte. La riga è stata incollata sia nell’intestazione sia prima di </body>: lasciane una.
• Un’app di velocità rimanda gli script. Alcune app che «ottimizzano» il caricamento eseguono gli script a pagina già finita, e il widget non parte. Escludi lo script di widget.wosnic.com, oppure chiedi al tecnico la variante del codice per il caricamento ritardato.
• Nella console del browser c’è «[Wosnic] Servizio sospeso». Il servizio è fermo: controlla i crediti nel pannello.