Chatbot WordPress e WooCommerce: installazione passo passo
Come aggiungere un chatbot AI a un sito WordPress o a un negozio WooCommerce senza plugin pesanti, con una riga di codice. Guida passo passo.
10 min di lettura
Di Nicolas Ricardi, Founder di Kiedi.me
Per aggiungere un chatbot WordPress non serve un plugin dedicato: basta incollare una riga di codice nell'header o nel footer del sito, con uno dei tanti plugin gratuiti che lo permettono. In questa guida vedi come farlo passo per passo, sia su un sito vetrina sia su un negozio WooCommerce.
WordPress è la piattaforma più usata al mondo per i siti web, e la directory dei plugin è piena di chatbot. Il rischio è installarne uno che appesantisce il sito, chiede di configurare menu e percorsi a mano, o risponde con frasi generiche. Qui usiamo un chatbot AI che legge le pagine del tuo sito e risponde con quelle. Se vuoi prima capire cosa fa e come sceglierlo, parti dalla guida al chatbot AI per sito web.
Plugin o snippet: due modi per aggiungere un chatbot a WordPress
Cercando "chatbot plugin wordpress" trovi decine di risultati. Un plugin chatbot si installa dalla bacheca, ha le sue impostazioni dentro WordPress e spesso gira in parte sul tuo server. Uno snippet esterno invece è una riga di codice che carica il chatbot da un servizio esterno: il widget e le risposte arrivano da lì, il tuo sito deve solo mostrarlo.
Ecco le differenze che contano per chi gestisce il sito:
- Velocità: un plugin può aggiungere codice PHP, tabelle nel database e script su ogni pagina. Uno snippet esterno carica solo il file del widget, e il lavoro pesante (leggere i contenuti, generare le risposte) avviene sui server del servizio.
- Aggiornamenti: ogni plugin è una cosa in più da aggiornare, e a volte un aggiornamento va in conflitto con il tema o con altri plugin. Lo snippet resta sempre uguale: il servizio si aggiorna dal suo lato.
- Sicurezza: meno plugin hai, meno codice di terze parti gira dentro il tuo WordPress. Uno snippet esterno non ha accesso al pannello di amministrazione né al database.
- Comodità: il plugin ha il vantaggio di avere tutto nella bacheca. Con uno snippet le impostazioni stanno nella dashboard del servizio, e il codice lo incolli una volta sola.
Kiedi funziona con lo snippet: niente plugin da installare, niente da aggiornare. Colore, testi e posizione del pulsante si cambiano dalla dashboard di Kiedi e si aggiornano sul sito senza toccare di nuovo il codice.
Cosa ti serve prima di iniziare
Prima di partire, controlla di avere queste cose:
- L'accesso da amministratore a WordPress. Serve per installare un plugin o modificare il tema. Se il sito lo gestisce un'agenzia o un freelance, puoi anche solo mandargli la riga di codice.
- Un account Kiedi. Crei il chatbot, colleghi il sito e prendi lo snippet dalla pagina di installazione.
- Pagine pubbliche e aggiornate. Il chatbot risponde con quello che trova sul sito: orari, spedizioni, resi, servizi, prezzi. Se una pagina è vecchia, anche la risposta lo sarà.
- Eventuali documenti. Listini, condizioni di vendita, schede tecniche: puoi caricarli in PDF, Word, TXT o Markdown (i PDF scansionati dal piano Pro), e il chatbot li usa come le pagine.
WordPress genera le pagine sul server, quindi di solito il chatbot le legge senza problemi. Fanno eccezione i contenuti che compaiono solo dopo il caricamento tramite JavaScript: quelli a volte non vengono letti.
Installazione passo passo
Ecco la procedura completa, dall'account alla verifica. Se hai l'accesso da amministratore, è un lavoro breve.
Crea il chatbot e collega il sito
Registrati su Kiedi e crea il tuo chatbot: dagli un nome, inserisci l'indirizzo del sito e scrivi il messaggio di benvenuto. Il chatbot legge le pagine pubbliche del sito; i documenti puoi aggiungerli dopo. Prima di installarlo, provalo dalla dashboard con qualche domanda vera dei tuoi clienti.
Copia lo snippet
Nella pagina di installazione del tuo chatbot trovi il codice da copiare. 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 così com'è, senza modificarlo. Se vuoi forzare il pulsante a sinistra o a destra solo su questo sito, puoi aggiungere data-position="left" o data-position="right".
Incollalo con un plugin per header e footer
Kiedi non ha un plugin per WordPress, e non serve. Installa uno dei tanti plugin gratuiti che permettono di aggiungere codice all'header o al footer del sito, per esempio Head & Footer Code o Insert Headers And Footers. Sono plugin piccoli che fanno solo questo. Incolla lo snippet nel campo dell'header o del footer e salva. Fatto: la chat compare su tutte le pagine e resta anche se cambi o aggiorni il tema.
Se usi Elementor o Divi, puoi farlo anche senza plugin: trovi le istruzioni nella sezione dedicata più sotto.
Verifica che il widget compaia
Apri il sito in una finestra in incognito, da non loggato: molti plugin di cache mostrano agli amministratori una versione diversa della pagina. Controlla che il pulsante della chat compaia in basso, fai una domanda e guarda la risposta.
Ripeti il controllo dal telefono. Su mobile la chat si apre a tutto schermo: verifica che il pulsante non copra altri elementi, come la barra del carrello o il pulsante di WhatsApp. Se si sovrappongono, sposta il pulsante dall'altro lato dalle impostazioni di aspetto.
Chatbot per WooCommerce
Un chatbot WooCommerce si installa esattamente come sopra: WooCommerce è un plugin di WordPress, quindi lo snippet nel footer compare anche su negozio, schede prodotto e carrello.
Cambia il tipo di domande. Chi compra online chiede soprattutto:
- quanto costa la spedizione e da che importo è gratuita;
- in quanti giorni arriva l'ordine;
- come funzionano resi, cambi e rimborsi;
- quali metodi di pagamento accetti;
- che differenza c'è tra due prodotti, o se un accessorio è compatibile.
Il chatbot risponde leggendo le tue pagine: condizioni di spedizione, pagina resi, schede prodotto, FAQ. Ecco un esempio sul sito della Torrefazione Bianchi, un negozio di fantasia che vende caffè e capsule.
- Cliente: Le capsule del vostro caffè sono compatibili con la mia macchina Nespresso Original?
- Chatbot: Sì, le capsule della linea Classica sono compatibili con le macchine Nespresso Original. Non lo sono con le Vertuo. Fonte: Capsule compatibili Classica.
- Cliente: Se ne ordino tre confezioni la spedizione è gratis?
- Chatbot: La spedizione è gratuita per ordini da 39 € in su. Tre confezioni da 14,90 € fanno 44,70 €, quindi sì. Fonte: Spedizioni e consegne.
C'è un limite da conoscere. Kiedi non è collegato a WooCommerce: non vede gli ordini e non legge il magazzino in tempo reale. Sa quello che è scritto sulle pagine prodotto all'ultimo aggiornamento delle fonti. Se un prodotto va esaurito o cambi un prezzo, premi "Aggiorna" nella sezione Fonti, altrimenti il chatbot continua a rispondere con la versione precedente. Per le domande sul singolo ordine, il chatbot spiega come funzionano le spedizioni e indica come contattarti.
Occhio anche al numero di pagine. Il piano Starter legge fino a 200 pagine: se hai centinaia di prodotti, ti serve il Pro, che arriva a 1.000. Per esempi di risposte su spedizioni, resi e taglie, leggi la guida al chatbot per e-commerce.
Con Elementor e i page builder
Se il sito è fatto con Elementor, hai due possibilità.
Con Elementor Pro c'è la funzione Custom Code, nel menu Elementor della bacheca. Crea un nuovo codice personalizzato, incolla lo snippet e come posizione scegli <body> – End, cioè la fine della pagina. Poi pubblicalo su tutto il sito.
Con la versione gratuita di Elementor la funzione Custom Code non c'è. Usa un plugin per header e footer come spiegato nel passo 3: funziona con qualsiasi tema e page builder.
Con Divi vai in Divi, Theme Options, scheda Integration, e incolla lo snippet nel campo per il codice del body. Salva e svuota la cache.
Evita invece di incollare lo snippet in un blocco HTML o in un widget dentro una singola pagina. La chat comparirebbe solo in quella pagina, e se il blocco viene cancellato sparisce anche il chatbot. Lo snippet va messo in un posto che vale per tutto il sito.
Problemi comuni e soluzioni
Il widget non compare. Prima svuota la cache e ricontrolla in incognito. Se ancora non c'è, apri la pagina sul computer, premi F12 e guarda 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.
La chat compare solo dopo che scorri la pagina. È l'effetto dei plugin di ottimizzazione che ritardano gli script. Nelle impostazioni del plugin cerca l'opzione che ritarda l'esecuzione di JavaScript (spesso si chiama "Delay JavaScript") e aggiungi widget.js tra i file esclusi.
Il cookie banner blocca il widget. Alcuni banner, come quelli di iubenda, Cookiebot o Complianz, possono bloccare in automatico gli script di terze parti finché il visitatore non dà il consenso. Se la chat compare solo dopo aver accettato i cookie, controlla nelle impostazioni del banner come viene classificato lo script. Il widget di Kiedi non usa cookie di profilazione né di marketing: salva nel browser solo un identificativo tecnico, che tiene insieme la conversazione e scade dopo 30 giorni senza usare la chat. Per questo di solito può essere classificato come necessario, senza aspettare il consenso. Trovi i dettagli nella nostra cookie policy.
Lo snippet è incollato due volte. Succede se lo metti in due posti, per esempio in un plugin e nelle opzioni del tema. Il widget compare comunque una sola volta, ma è meglio tenerne una copia sola, così sai dove andare se devi toglierlo.
Le risposte sono vecchie. Il sito è aggiornato ma il chatbot no: la rilettura automatica arriva solo una volta al mese con lo Starter e una a settimana con Pro e Agenzia. Per non aspettare, vai nella sezione Fonti e premi "Aggiorna".
Domande frequenti
Esiste un chatbot gratis per WordPress?
Sì, esistono plugin chatbot gratuiti, ma di solito sono chatbot a menu, da configurare a mano, oppure versioni gratuite con pochi messaggi al mese. Un chatbot AI che legge il tuo sito ha un costo, perché ogni risposta viene generata da un modello di intelligenza artificiale. Kiedi parte da 29 € al mese più IVA con il piano Starter, con una prova di 7 giorni a 1 €. Per un confronto completo, leggi quanto costa un chatbot.
Rallenta il sito?
Pochissimo. Lo script di Kiedi pesa circa 16 KB, meno di 5 KB compresso, e si carica con l'attributo defer, cioè dopo il contenuto della pagina, senza bloccarla. La finestra della chat vera e propria si carica solo quando il visitatore la apre. Rispetto a un plugin, sul tuo server non gira nulla in più.
Funziona con WordPress multilingua?
Sì. Se usi WPML, Polylang o un plugin simile, lo snippet nel footer vale per tutte le lingue del sito. Il chatbot risponde nella lingua in cui scrive il visitatore, anche se i contenuti sono solo in italiano. Se hai pagine tradotte, assicurati che siano pubbliche, così il chatbot può leggerle.