Documentazione

WordPress

Aggiungi il tuo agente ai siti WordPress.

Aggiungi il tuo agente AI ai siti WordPress usando il codice di embed. Funziona con qualsiasi tema WordPress.

Per prima cosa, ottieni il codice di embed da Chatbot > Publish nella dashboard.

Aggiungi il widget a tutte le pagine tramite il tuo tema:

  1. Vai su Appearance → Theme Editor (o Theme File Editor)
  2. Trova footer.php nei file del tema
  3. Incolla il codice di embed appena prima di </body>

Formato di esempio (recupera il tuo codice reale da Chatbot > Publish):

<script
  src="YOUR_WIDGET_URL"
  data-chatbot="YOUR_CHATBOT_ID"
  async
></script>
  1. Clicca su Update File

Il widget appare ora su tutte le pagine.

Metodo 2: blocco HTML personalizzato

Aggiungilo a pagine specifiche usando l'editor a blocchi:

  1. Modifica la pagina in cui vuoi il widget
  2. Aggiungi un blocco Custom HTML
  3. Incolla il codice di embed da Chatbot > Publish

Formato di esempio:

<script
  src="YOUR_WIDGET_URL"
  data-chatbot="YOUR_CHATBOT_ID"
  async
></script>
  1. Salva la pagina

Metodo 3: plugin (script Header/Footer)

Usa un plugin per aggiungere script a tutto il sito:

  1. Installa un plugin come "Insert Headers and Footers" o "WPCode"
  2. Vai alle impostazioni del plugin
  3. Trova la sezione "Footer Scripts"
  4. Incolla il codice di embed da Chatbot > Publish
  5. Salva le modifiche

Questo metodo non richiede di modificare i file del tema.

Metodo 4: tema figlio

Per i temi che si aggiornano frequentemente, usa un tema figlio:

  1. Crea un tema figlio per il tuo tema attuale
  2. Aggiungi un file functions.php con quanto segue (sostituisci YOUR_WIDGET_URL e YOUR_CHATBOT_ID con i valori da Chatbot > Publish):
<?php
function add_chatbot_widget() {
    ?>
    <script
      src="YOUR_WIDGET_URL"
      data-chatbot="YOUR_CHATBOT_ID"
      async
    ></script>
    <?php
}
add_action('wp_footer', 'add_chatbot_widget');

Questo resiste agli aggiornamenti del tema.

Siti WooCommerce

Il widget funziona automaticamente sui siti WooCommerce. Valuta di:

  • Aggiungerlo alle pagine prodotto per le domande sui prodotti
  • Aggiungerlo al checkout per il supporto sugli ordini
  • Usarlo solo su pagine specifiche tramite blocchi HTML personalizzati

Page Builder

Elementor

  1. Modifica con Elementor
  2. Aggiungi un widget HTML
  3. Incolla il codice di embed
  4. Imposta la visualizzazione su tutto il sito (opzionale)

Divi

  1. Aggiungi un modulo Code
  2. Incolla il codice di embed
  3. Salva le modifiche

Beaver Builder

  1. Aggiungi un modulo HTML
  2. Incolla il codice di embed
  3. Pubblica le modifiche

Multisito

Per WordPress Multisite:

  • Aggiungi il codice a ogni sito singolarmente, oppure
  • Usa un plugin attivato a livello di rete per aggiungerlo a tutti i siti

Plugin di caching

Se usi plugin di caching (WP Super Cache, W3 Total Cache, ecc.):

  1. Aggiungi il codice del widget
  2. Svuota tutte le cache
  3. Testa il widget

Il widget dovrebbe funzionare con tutti i principali plugin di caching.

Troubleshooting

Il widget non appare

  • Svuota la cache di WordPress
  • Controlla la console del browser per eventuali errori
  • Verifica che l'ID dell'agente sia corretto

Il Theme Editor non è disponibile

  • Alcuni hosting disabilitano la modifica dei temi
  • Usa invece un metodo con plugin
  • Oppure modifica i file via FTP

Posizione del widget errata

  • Modificala nelle impostazioni Design del tuo agente
  • Controlla eventuali conflitti CSS del tema

Testing

Dopo l'installazione:

  1. Apri il tuo sito WordPress in una finestra in incognito
  2. Cerca la bolla della chat
  3. Invia un messaggio di prova
  4. Verifica la risposta

Next Steps