botts.aiDocs

Installare su WordPress

Aggiungi il widget di chat botts.ai al tuo sito WordPress con il plugin gratuito WPCode, in sei passaggi e senza modificare i file del tema.

Questa guida aggiunge a un sito WordPress il widget di chat di un deployment botts.ai di tipo sito web. Usa il plugin gratuito WPCode, che inserisce lo script del widget in ogni pagina e lo mantiene anche quando cambi o aggiorni il tema.

Prima di iniziare

Ti servono:

  • Accesso da amministratore al tuo sito WordPress. Senza questo accesso non puoi installare plugin.
  • Un sito che consente i plugin. WordPress installato sul tuo hosting li consente sempre; su WordPress.com li consentono tutti i piani a pagamento, quello gratuito no.
  • Il codice di incorporamento del tuo deployment sito web. In botts.ai apri Agenti, scegli il tuo agente, passa alla scheda Implementa e apri il deployment Sito Web. La sezione Installazione in fondo all'editor mostra il codice con un pulsante per copiarlo. Non hai ancora un deployment sito web? Vedi Deployment.

Il codice di incorporamento è fatto così, con la chiave del tuo deployment al posto di YOUR_API_KEY:

<script async src="https://api.botts.ai/widget/chat-widget.js?key=YOUR_API_KEY"></script>

Nota

Il widget per il sito web richiede il piano Business o superiore. Il piano Personal include solo la chat interna.

Passaggio 1: Accedi a WordPress

Apri tuo-dominio.ch/wp-admin e accedi. Sostituisci tuo-dominio.ch con l'indirizzo del tuo sito.

Passaggio 2: Installa e attiva WPCode

Vai su Plugin → Aggiungi plugin (in inglese Add Plugin) e cerca WPCode. Scegli WPCode – Insert Headers and Footers + Custom Code Snippets, non il plugin Search & Replace accanto, dello stesso produttore. Clicca su Installa ora e poi su Attiva.

La pagina «Aggiungi plugin» di WordPress con «WPCode» nel campo di ricerca. Il primo risultato, WPCode – Insert Headers and Footers + Custom Code Snippets, è evidenziato.

Nello screenshot WPCode è già installato e ha un aggiornamento disponibile, per questo il pulsante dice Update now. Con una nuova installazione vedi Installa ora.

Su WordPress.com la schermata può essere diversa: nel menu a sinistra clicca su Plugin, cerca WPCode, apri il plugin e clicca su Installa e attiva.

Nel menu a sinistra vai su Snippet di codice → Header & Footer (in inglese Code Snippets → Header & Footer). La pagina si chiama Header e footer globali (in inglese Global Header and Footer) e ha tre campi: Header, Body e Footer.

La pagina Global Header and Footer di WPCode, aperta da Code Snippets → Header & Footer nel menu di WordPress.

Non vedi il menu Snippet di codice? Allora WPCode è nella modalità semplificata Headers & Footers: apri invece Impostazioni → Header & Footer.

Scorri fino al campo Footer e incolla il codice di incorporamento. Se nel campo c'è già del codice, metti il codice botts.ai su una nuova riga sotto e lascia il resto com'è. Incolla il codice esattamente come l'hai copiato: l'indirizzo e la chiave non devono cambiare.

Il campo Footer in WPCode con il codice di incorporamento botts.ai alla riga 1 e la chiave come segnaposto YOUR_API_KEY. La nota sotto indica che gli script vengono inseriti prima del tag di chiusura body.

WPCode inserisce il campo Footer subito prima del tag di chiusura </body>, ed è proprio lì che va lo script del widget.

Passaggio 5: Salva le modifiche

Torna in alto e clicca su Salva le modifiche (in inglese Save Changes) in alto a destra. Così il codice è attivo sul tuo sito. WPCode deve restare attivo: se disattivi il plugin, sparisce anche il widget.

Il pulsante Save Changes in alto a destra nella pagina Global Header and Footer di WPCode.

Passaggio 6: Controlla il widget sul sito

Apri il tuo sito pubblico in una finestra privata, ricarica la pagina e attendi un momento. Il pulsante della chat compare in basso a destra, o dove l'hai posizionato nell'editor del widget. Aprilo e invia una domanda di prova. Controlla anche una sottopagina e la visualizzazione sullo smartphone.

Suggerimento

Tutto a posto se il widget compare sul tuo sito pubblico, si apre e risponde alla tua domanda di prova.

Se il widget non compare

  1. Controlla che il codice completo sia nel campo Footer e che tu abbia salvato.
  2. Controlla in Plugin → Plugin installati che WPCode sia attivo.
  3. Svuota la cache. Un plugin di cache o la cache del tuo hosting possono continuare a servire la pagina senza widget. Anche i plugin di ottimizzazione che ritardano o uniscono il JavaScript possono bloccare il widget; escludi chat-widget.js da queste opzioni.
  4. Prova in una finestra privata senza ad blocker. Se il banner dei cookie o lo strumento di consenso blocca gli script, controllane la configurazione.
  5. Controlla che la chiave appartenga al deployment giusto e che il deployment sia attivo nella scheda Implementa.

Modificare o rimuovere il widget

Colori, testi, il launcher e tutte le altre impostazioni del widget si modificano nell'editor di botts.ai. Il tuo sito le applica senza che tu debba modificare nulla in WordPress. Devi sostituire il codice solo se cambia la chiave del deployment.

Per rimuovere il widget, cancella solo la riga dello script botts.ai dal campo Footer e salva di nuovo.

Nota

Gli screenshot mostrano WordPress in inglese. I nomi di menu e pulsanti possono cambiare a seconda della lingua e della versione di WordPress.

Altro aiuto

Altre piattaforme

Guide per altre piattaforme: Wix, Squarespace, Shopify, Webflow, Jimdo, TYPO3 e Google Tag Manager. Il codice di incorporamento funziona su qualsiasi sito che ti permetta di aggiungere codice prima del tag di chiusura </body>; vedi Codice di incorporamento. Se qualcun altro gestisce il tuo sito, invia il codice alla tua agenzia web.

Ultimo aggiornamento: 4 ottobre 2026