Chatbot per PrestaShop e Joomla: come aggiungerlo al sito

Per aggiungere un chatbot al tuo negozio PrestaShop non serve per forza un modulo. Basta una riga di codice nel tema, subito prima della chiusura della pagina: da lì la chat compare su home, categorie, schede prodotto e carrello, e risponde ai clienti con le informazioni che hai già pubblicato.

PrestaShop è in calo da qualche anno (Store Leads), ma tanti negozi italiani lo usano ancora, soprattutto chi vende da anni e ha un catalogo ampio. Kiedi lo supporta senza problemi: è solo una riga di codice. Qui vedi quando conviene un modulo e quando uno snippet, come installarlo passo per passo e cosa aspettarti dalle risposte. Se vuoi prima capire come funziona un assistente di questo tipo, parti dalla guida al chatbot AI per sito web. Se il tuo sito è su Joomla, trovi le istruzioni in fondo all'articolo.

Modulo o snippet: cosa scegliere

Cercando "modulo chatbot prestashop" trovi soprattutto moduli a pagamento su PrestaShop Addons. Un modulo si installa dal back office, ha le sue impostazioni dentro PrestaShop e può leggere i dati del negozio, come ordini o clienti, se lo prevede. In cambio è una cosa in più da aggiornare, e a ogni aggiornamento importante di PrestaShop devi controllare che sia compatibile.

Uno snippet esterno invece non gira dentro PrestaShop. È solo un pezzo di codice che dice al browser del cliente di caricare la chat da un servizio esterno. Il lavoro pesante, cioè leggere le pagine e scrivere le risposte, avviene sui server del servizio.

Kiedi funziona con lo snippet. Ha senso se:

• Vuoi che risponda con le tue pagine e i tuoi documenti. Cataloghi, schede tecniche e condizioni di vendita li carichi in PDF, Word, TXT o Markdown (i PDF scansionati dal piano Pro).
• Vuoi vedere la fonte. Sotto ogni risposta compare la pagina usata, così il cliente può controllare e tu capisci da dove arriva un'informazione.
• Non vuoi aprire l'accesso ai dati del negozio. Lo snippet non entra nel back office e non tocca il database.
• Non vuoi pensare alla compatibilità. Lo snippet resta uguale tra una versione e l'altra di PrestaShop: il servizio si aggiorna dal suo lato.

Il limite è chiaro: Kiedi non è un modulo PrestaShop. Non lo trovi su Addons e non si installa con un clic: il codice lo incolli tu, una volta sola. Colore, testi e posizione del pulsante poi si cambiano dalla dashboard di Kiedi.

Installazione passo passo

Ti serve l'accesso al back office e ai file del tema, via FTP o dal pannello dell'hosting. Se il negozio lo segue un'agenzia o uno sviluppatore, mandagli la riga di codice e questa guida: per chi conosce PrestaShop è un lavoro breve.

1. Crea il chatbot e collega il negozio

   Registrati su Kiedi, crea il chatbot e inserisci l'indirizzo del negozio. Il chatbot legge le pagine pubbliche; i documenti puoi aggiungerli dopo, dalla sezione Fonti.

   Se il negozio è in manutenzione, il chatbot non riesce a leggere le pagine: collegalo quando è aperto al pubblico, oppure parti dai documenti. Prima di installarlo, fai qualche domanda di prova dalla dashboard.

2. Copia lo snippet

   Nella pagina di installazione del chatbot trovi il codice. Ha questa forma, con il tuo codice al posto di IL-TUO-ID:

   <script src="https://www.kiedi.me/widget.js" data-bot-id="IL-TUO-ID" defer></script>
   

   Copialo intero, senza cambiare nulla. Se a destra c'è già un altro pulsante, per esempio quello di WhatsApp, puoi aggiungere data-position="left" per spostare la chat a sinistra.

3. Aggiungilo al tema

   Hai due strade.

   Nel tema (consigliato se hai accesso ai file). Apri la cartella del tema attivo, themes/[nome-tema]/templates/layouts/, e poi il file layout-both-columns.tpl. In fondo trovi il tag </body>: incolla lo snippet sulla riga subito prima. Nel tema Classic di PrestaShop gli altri layout (pagina intera, colonna sinistra, solo contenuto) partono da questo file, quindi la chat compare su tutto il negozio. Se usi un tema acquistato, controlla che faccia lo stesso.

   Meglio ancora, fai la modifica in un tema child, cioè un tema "figlio" che eredita tutto dal tema principale e contiene solo i file che cambi. Copi layout-both-columns.tpl nella stessa cartella del child e lo modifichi lì. Così un aggiornamento del tema non cancella lo snippet. La procedura è nella guida ufficiale ai temi child.

   Con un modulo per il codice personalizzato. Se non vuoi toccare i file, su Addons e sui forum di PrestaShop trovi moduli, alcuni gratuiti, che aggiungono codice HTML o JavaScript dal back office. Scegline uno compatibile con la tua versione e inserisci lo snippet in fondo alla pagina, su tutte le pagine.

4. Svuota la cache e verifica

   PrestaShop tiene in memoria una versione già pronta dei template, quindi finché non svuoti la cache i clienti non vedono la chat. Nel back office vai in Parametri Avanzati › Prestazioni e premi Pulisci la cache, in alto nella pagina. Se usi anche la cache dell'hosting o Cloudflare, svuota pure quella. Trovi tutte le opzioni nella documentazione di PrestaShop sulle prestazioni.

   Poi apri il negozio in una finestra in incognito, dal computer e dal telefono. Controlla che il pulsante compaia in basso e non copra il pulsante del carrello o la barra dei cookie, e fai una domanda vera, per esempio sui costi di spedizione.

Sulla velocità puoi stare tranquillo. Lo script pesa circa 16 KB, meno di 5 KB compresso, e si carica con defer, cioè dopo il contenuto della pagina. La finestra della chat si carica solo quando il cliente la apre.

Se la chat non compare

Hai svuotato la cache? È la causa più comune. Svuotala di nuovo e ricontrolla in incognito.

Guarda la console del browser. Dal computer premi F12 e apri la scheda Console. Il messaggio "[kiedi] Attributo data-bot-id mancante." vuol dire che lo snippet è stato copiato male: ricopialo intero. Il messaggio "[kiedi] Chat non disponibile per questo sito." vuol dire che il codice è giusto ma il chatbot non è attivo, per esempio perché l'abbonamento non è attivo.

Ottimizzazione JavaScript. In Prestazioni c'è l'opzione Smart cache per JavaScript, che unisce e comprime gli script del tema. Di solito non tocca uno script esterno come il nostro, ma se il problema compare dopo averla attivata, prova a disattivarla, svuota la cache e ricontrolla. Lo stesso vale per i moduli di ottimizzazione della velocità che ritardano gli script.

Cookie banner. Alcuni moduli per i cookie bloccano gli script esterni finché il cliente non accetta. Se la chat compare solo dopo il consenso, controlla come il banner classifica lo script. Il widget di Kiedi non usa cookie di profilazione: salva nel browser solo un identificativo tecnico, che scade dopo 30 giorni senza usare la chat. I dettagli sono nella cookie policy.

Cosa risponde ai clienti

Il chatbot legge le pagine pubbliche del negozio: schede prodotto, categorie, pagine CMS come spedizioni, resi, condizioni di vendita, chi siamo e contatti. Quando un cliente scrive, cerca il passaggio giusto e risponde con parole semplici, indicando la pagina da cui arriva l'informazione.

Un esempio sul negozio Ricambi Bici Bianchi, un negozio di fantasia:

• Cliente: La catena da 11 velocità va bene per il mio gruppo Shimano 105?
• Chatbot: Sì, nella scheda prodotto è indicata come compatibile con i gruppi Shimano a 11 velocità, compreso il 105. Fonte: Catena 11 velocità.
• Cliente: Spedite anche in Sardegna?
• Chatbot: Sì, come indicato nella pagina Spedizioni. Per isole e zone disagiate la consegna richiede in media due giorni in più.

Il chatbot risponde con le tue regole. Se un'informazione non c'è, lo dice e invita il cliente a contattarti via email, telefono, WhatsApp o dalla pagina contatti. Quelle domande le ritrovi poi nella sezione Conversazioni, con il filtro "Senza risposta": ti dicono quali pagine completare. Per altri esempi su taglie, pagamenti e resi leggi la guida al chatbot per e-commerce, e per scrivere pagine che rispondono davvero prendi spunto dagli esempi di FAQ.

Ci sono cose che non può sapere, perché non è collegato al back office:

• Stato dell'ordine. Può spiegare tempi di consegna e dove il cliente trova il tracciamento, non dove si trova il suo pacco.
• Magazzino in tempo reale. Sa quello che era scritto sulla scheda prodotto all'ultimo aggiornamento delle fonti.
• Dati dei clienti. Non sa chi sta scrivendo né cosa ha comprato.

Kiedi rilegge il negozio da solo, una volta al mese con lo Starter e una a settimana con Pro e Agenzia. Quando cambi prezzi, condizioni o prodotti non aspettare: vai nella sezione Fonti di Kiedi e premi "Aggiorna".

Infine, il catalogo. Ogni prodotto e ogni categoria sono pagine, e sui negozi PrestaShop crescono in fretta. Il piano Starter legge fino a 200 pagine, il Pro fino a 1.000, l'Agenzia fino a 5.000. Con qualche centinaio di prodotti ti serve con ogni probabilità il Pro. Se il catalogo è molto più grande, puoi far leggere al chatbot le pagine più importanti e caricare il resto come PDF, per esempio un catalogo o un listino.

E se il sito è su Joomla?

Su Joomla vale lo stesso principio: una riga di codice, incollata una volta sola. Joomla lo installi sul tuo hosting, quindi non ci sono piani da controllare. Le istruzioni valgono per Joomla 4 e 5.

Con un modulo personalizzato (il più semplice). Nel pannello di amministrazione vai in Contenuto › Moduli sito e crea un nuovo modulo di tipo Personalizzato. Incolla lo snippet con l'editor disattivato (pulsante "Editor sì/no"), perché l'editor visuale può cancellare lo script. Nascondi il titolo, scegli una posizione presente su tutte le pagine (nel template Cassiopeia vanno bene "footer" o "debug") e in Assegnazione menu scegli Su tutte le pagine. Salva.

Se dopo il salvataggio lo script è sparito, la causa sono i filtri di testo di Joomla: di base tolgono il tag script a tutti tranne ai Super Utenti. Salva il modulo da un account Super Utente, oppure chiedi a chi amministra il sito di controllare Sistema › Configurazione globale › Filtri di testo.

Con il template. In Sistema › Template sito apri il tuo template, trova index.php e incolla lo snippet subito prima di </body>. Fallo su un template figlio, così gli aggiornamenti di Joomla non cancellano la modifica.

Domande frequenti