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.

Apri Canali > Incorporamento nel sito web, scegli Widget di chat e copia il codice completo con entrambi i tag script. Mantieni invariati URL e ID generati. Per tutto il sito senza modificare il tema, usa il campo Footer di WPCode nel metodo 3.

Attiva il canale Widget di chat prima di provare il sito pubblico.

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>
  4. 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 Canali > Incorporamento nel sito web
  4. Salva la pagina

Il blocco HTML personalizzato funziona solo se il tuo account può pubblicare script. Dopo aver salvato, verifica che entrambi i tag compaiano nel sorgente renderizzato. WordPress può rimuoverli senza unfiltered_html, soprattutto in Multisite. WordPress spiega il permesso.

Metodo 3: plugin (script Header/Footer)

Usa un plugin per aggiungere script a tutto il sito:

  1. Installa WPCode, precedentemente chiamato Insert Headers and Footers da WPBeginner.
  2. Vai alle impostazioni del plugin
  3. Trova la sezione Footer
  4. Incolla il codice di embed da Canali > Incorporamento nel sito web
  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. Uno sviluppatore può inserire entrambi i tag generati tramite wp_footer. Verifica dopo gli aggiornamenti del tema.

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

Alcuni editor rimuovono gli script dai contenuti. Controlla il sorgente renderizzato; se manca un tag, usa il campo Footer di WPCode.

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

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

Controlla entrambi i tag nel sorgente renderizzato e l’URL configurato nella scheda Rete. Se manca un tag, verifica i permessi e la cache.

Next Steps