Come aggiungere un chatbot a WordPress (senza scrivere codice)

WordPress alimenta oltre il 40% del web, quindi è molto probabile che anche il tuo sito lo usi. Aggiungere un chatbot a WordPress è semplice. Non ti serve uno sviluppatore, un plugin personalizzato o esperienza di programmazione. Questa guida illustra tre metodi, dall'approccio più semplice con un plugin fino all'installazione a livello di tema, e copre le insidie in cui inciampano più spesso gli utenti.

Prima di iniziare

Ti servono due cose prima di aggiungere il chatbot al tuo sito WordPress.

1. Un account Agentkit con un chatbot addestrato.

Se non l'hai ancora fatto, registrati gratis e crea il tuo primo chatbot. Addestralo sui contenuti del tuo sito web, sulle pagine FAQ, sulla documentazione o su qualsiasi altro materiale su cui i tuoi visitatori fanno domande. Vedi la guida all'addestramento per i dettagli.

2. Il tuo tag script di embed.

Una volta addestrato il chatbot, vai alla pagina Impostazioni poi Pubblica del tuo chatbot nella dashboard di Agentkit. Vedrai un tag script simile a questo:

<script
  src="https://cdn.agentkit.ai/widget.js"
  data-chatbot="your-chatbot-id"
  async>
</script>

Copia questo snippet. Lo incollerai in WordPress usando uno dei tre metodi qui sotto.

Confronto tra i metodi

Scegli il metodo adatto al tuo livello di dimestichezza. L'approccio con plugin è consigliato per la maggior parte degli utenti perché è il più semplice e il più resistente agli aggiornamenti del tema.

Metodo 1: approccio con plugin (consigliato)

Questo è il metodo più semplice. Installi un plugin gratuito che ti permette di aggiungere snippet di codice al tuo sito senza modificare i file del tema.

Usare WPCode (Insert Headers and Footers)

WPCode è un plugin WordPress gratuito con oltre 2 milioni di installazioni. Ti permette di aggiungere codice all'header o al footer del tuo sito senza toccare i file del tema.

Passaggio 1: installa il plugin

1. Nel tuo pannello di amministrazione WordPress, vai su Plugin poi Aggiungi nuovo.
2. Cerca "WPCode" (il nome completo è WPCode - Insert Headers, Footers, and Code Snippets).
3. Clicca su Installa ora, poi su Attiva.

Passaggio 2: aggiungi lo snippet del chatbot

1. Nella barra laterale dell'amministrazione WordPress, vai su Code Snippets poi Header & Footer.
2. Trova la sezione Footer.
3. Incolla il tuo tag script di incorporamento di Agentkit nella casella Footer.
4. Clicca su Salva modifiche.

Tutto qui. Il widget del chatbot apparirà ora su ogni pagina del tuo sito WordPress.

Passaggio 3: verifica che funzioni

1. Apri il tuo sito web in una nuova scheda del browser (non il pannello di amministrazione WordPress).
2. Dovresti vedere la bolla della chat nell'angolo in basso a destra.
3. Cliccaci sopra e invia un messaggio di prova per confermare che risponda correttamente.

Usare Insert Headers and Footers (alternativa)

Se preferisci un plugin diverso, "Insert Headers and Footers" di WPBeginner funziona allo stesso modo:

1. Installa e attiva il plugin.
2. Vai su Impostazioni poi Insert Headers and Footers.
3. Incolla lo script di embed nella casella Scripts in Footer.
4. Salva.

Controllare in quali pagine mostrare il chatbot

Sia WPCode che i plugin simili supportano una logica condizionale. Se vuoi il chatbot solo su determinate pagine:

1. In WPCode, invece di usare la sezione Header & Footer, crea un nuovo Code Snippet.
2. Imposta il tipo di codice su "HTML Snippet".
3. Incolla il tuo script di embed.
4. In Insertion, scegli "Site Wide Footer".
5. In Smart Conditional Logic, aggiungi condizioni come:
   • Page is "Contact" or "Support" or "Pricing"
   • Post type is "Product"
   • URL contains "/help"
6. Salva e attiva lo snippet.

Questo ti dà un controllo preciso senza dover creare più chatbot.

Metodo 2: blocco HTML personalizzato (pagine specifiche)

Se vuoi il chatbot solo su una o due pagine e non vuoi installare un plugin, puoi usare l'editor a blocchi di WordPress.

Passaggio 1: modifica la pagina in cui vuoi il chatbot.

Passaggio 2: aggiungi un blocco HTML personalizzato in fondo al contenuto della pagina.

Passaggio 3: incolla il tuo script di embed di Agentkit nel blocco:

<script
  src="https://cdn.agentkit.ai/widget.js"
  data-chatbot="your-chatbot-id"
  async>
</script>

Passaggio 4: aggiorna o pubblica la pagina.

Il chatbot apparirà solo su quella pagina specifica. Ripeti per altre pagine se necessario.

Limiti di questo metodo:

• Lo script si carica come parte del contenuto della pagina, quindi potrebbe caricarsi leggermente più tardi rispetto a un posizionamento nel footer.
• Se vuoi il chatbot su molte pagine, questo diventa tedioso. Usa invece il metodo con plugin.
• Alcuni page builder (Elementor, Divi) possono rimuovere i tag script dai blocchi HTML. Se succede, usa il metodo con plugin.

Metodo 3: footer del tema (footer.php)

Questo metodo aggiunge il chatbot a livello di tema. È l'approccio più diretto, ma richiede di modificare i file del tema.

Importante: se modifichi direttamente il file footer.php del tuo tema, le modifiche andranno perse quando il tema si aggiorna. Usa un tema figlio per rendere la modifica permanente.

Con un tema figlio

Passaggio 1: se non hai già un tema figlio, creane uno. La maggior parte degli sviluppatori di temi fornisce istruzioni. In alternativa, usa il plugin "Child Theme Configurator".

Passaggio 2: nel tuo pannello di amministrazione WordPress, vai su Aspetto poi Editor di file del tema.

Passaggio 3: seleziona il tuo tema figlio dal menu a tendina.

Passaggio 4: apri footer.php. Se non esiste nel tuo tema figlio, crealo copiando il footer.php del tema principale.

Passaggio 5: trova il tag di chiusura </body>. Incolla lo script di embed immediatamente prima:

<!-- Agentkit Chatbot -->
<script
  src="https://cdn.agentkit.ai/widget.js"
  data-chatbot="your-chatbot-id"
  async>
</script>
</body>
</html>

Passaggio 6: salva il file.

Senza un tema figlio (sconsigliato)

Se modifichi direttamente il footer.php del tema principale, segui gli stessi passaggi ma sappi che un aggiornamento del tema sovrascriverà le tue modifiche. Se scegli questa strada, conserva una copia del tuo footer.php modificato così puoi riapplicarla dopo gli aggiornamenti.

Testare la tua installazione

Dopo aver aggiunto il chatbot con uno qualsiasi dei metodi, esegui questa checklist.

Verifica di base

Checklist per lo svuotamento della cache

La cache è la ragione numero uno per cui le persone aggiungono lo script del chatbot e non lo vedono sul loro sito. Svuota le cache in quest'ordine:

1. Plugin di cache WordPress (WP Super Cache, W3 Total Cache, WP Rocket, LiteSpeed Cache): vai alle impostazioni del plugin e svuota tutte le cache.
2. Cache a livello di hosting (SiteGround, WP Engine, Cloudflare): controlla il pannello del tuo hosting per un'opzione di svuotamento della cache.
3. Cache del CDN (Cloudflare, StackPath, Fastly): se usi un CDN, svuota anche la cache lì.
4. Cache del browser: apri il tuo sito in una finestra in incognito/privata per bypassare la cache locale del browser.

Se il chatbot continua a non apparire dopo aver svuotato tutte le cache, controlla la console per sviluppatori del browser (F12 su desktop) per eventuali errori JavaScript.

Risoluzione dei problemi più comuni

Il chatbot non appare

Causa: cache. Questo è il problema più comune. Segui la checklist per lo svuotamento della cache sopra.

Causa: posizionamento del tag script. Assicurati che lo script sia dentro il tag <body>, non nell'<head>. Alcuni plugin per header/footer inseriscono il codice nell'<head> per impostazione predefinita.

Causa: Content Security Policy. Alcuni plugin di sicurezza aggiungono header Content Security Policy che bloccano gli script esterni. Controlla se il tuo plugin di sicurezza (Wordfence, Sucuri, iThemes Security) ha impostazioni CSP e aggiungi cdn.agentkit.ai alle fonti di script consentite.

Causa: conflitto con il page builder. Alcuni page builder rimuovono i tag script dalle aree di contenuto. Usa il metodo con plugin (Metodo 1) invece del blocco HTML personalizzato.

Il chatbot appare ma non risponde

Causa: chatbot non addestrato. Vai alla tua dashboard di Agentkit e conferma che il tuo chatbot abbia dati di addestramento. Un chatbot non addestrato non ha nulla da cui attingere.

Causa: ID chatbot errato. Verifica che il data-chatbot nel tuo codice di embed corrisponda all'ID mostrato nella tua dashboard di Agentkit.

Causa: restrizione di dominio. Se hai configurato restrizioni di dominio nelle impostazioni del chatbot, assicurati che il tuo dominio WordPress sia nell'elenco consentito.

Il chatbot va in conflitto con un altro plugin di chat

Se hai in esecuzione un altro plugin di live chat o chatbot (Tidio, Intercom, Drift, Crisp), i due widget potrebbero sovrapporsi o interferire tra loro.

Soluzioni:

• Rimuovi l'altro plugin di chat se stai passando completamente ad Agentkit.
• Se ti servono entrambi, usa il metodo del blocco HTML personalizzato di Agentkit per posizionarlo solo sulle pagine dove l'altro plugin non è attivo.
• Regola la posizione del widget nelle impostazioni della dashboard di Agentkit se entrambi devono coesistere.

Caricamento lento della pagina dopo l'aggiunta del chatbot

Il widget di Agentkit si carica in modo asincrono (l'attributo async nel tag script), quindi non dovrebbe bloccare il rendering della pagina. Se noti rallentamenti:

1. Conferma che l'attributo async sia presente nel tuo tag script.
2. Esegui un test di velocità (Google PageSpeed Insights, GTmetrix) e controlla se lo script di Agentkit viene segnalato. Gli script asincroni raramente influiscono sui punteggi di performance.
3. Se usi un plugin di performance che ritarda il JavaScript, aggiungi cdn.agentkit.ai alla whitelist per evitare che interferisca con il caricamento del widget.

Configurare il chatbot per WordPress

Una volta che il chatbot è attivo sul tuo sito WordPress, valuta questi passaggi di configurazione nella tua dashboard di Agentkit.

Restrizione di dominio

Nelle Impostazioni del tuo chatbot, imposta il dominio consentito sul dominio del tuo sito WordPress (ad es., yourdomain.com). Questo impedisce a chiunque di copiare il tuo codice di embed e usare il tuo chatbot su un sito diverso.

Addestramento sui contenuti WordPress

La fonte migliore per l'addestramento è il contenuto reale del tuo sito web. In Agentkit, aggiungi l'URL del tuo sito WordPress come fonte di addestramento, e il crawler indicizzerà automaticamente le tue pagine. Se il tuo sito usa rendering JavaScript, il crawler basato su Firecrawl lo gestisce.

Concentra il tuo addestramento su:

• Pagine FAQ o base di conoscenza
• Pagine di prodotto o servizio
• Pagina dei prezzi
• Pagina Chi siamo
• Documentazione di supporto
• Articoli del blog che rispondono a domande comuni

Evita di addestrare su pagine con contenuti scarsi, pagine di login o pagine protette da autenticazione.

Per indicazioni complete sull'addestramento, vedi Come addestrare un chatbot sui contenuti del tuo sito web.

Raccolta lead

Attiva l'azione Raccogli contatti per raccogliere email e nomi dei visitatori direttamente in chat. I lead catturati compaiono nella tua dashboard di Agentkit e possono essere inviati al tuo CRM tramite Zapier o webhook. Vedi la documentazione sulla raccolta lead per la configurazione.

Documentazione specifica per l'integrazione con WordPress

Per le istruzioni di configurazione più aggiornate e per eventuali funzionalità specifiche di WordPress, vedi la documentazione sull'integrazione con WordPress.

Riepilogo del confronto tra metodi

Per la maggior parte degli utenti WordPress, il metodo con plugin è la scelta giusta. È rapido, sicuro e ti dà la massima flessibilità senza rischiare i file del tuo tema.

Prossimi passi

Una volta che il chatbot è attivo su WordPress, passa qualche minuto nel Playground di Agentkit a testare le risposte. Se il chatbot non risponde bene su argomenti specifici, aggiungi altri dati di addestramento per quelle aree. Il Playground ti permette di iterare rapidamente senza dover testare ogni volta sul tuo sito in produzione.

Poi esplora il collegamento del tuo chatbot ad altri strumenti. La guida all'integrazione copre i flussi di lavoro Zapier, i webhook e l'API REST per configurazioni più avanzate.

Crea il tuo chatbot gratis →

Nessuna carta di credito richiesta.