Plugin chatbot WordPress

Usa il plugin WordPress ufficiale di ChattyBox quando vuoi un'installazione senza codice che carichi il widget ospitato senza modificare i file del tema. Questa guida illustra la configurazione operativa. La pagina del chatbot AI WordPress spiega la strategia dei contenuti e del crawling, mentre la pagina di presentazione del plugin WordPress offre una panoramica del prodotto.

Prima dell'installazione

Completa prima il flusso Per iniziare: collega il tuo URL WordPress pubblico, esamina le pagine indicizzate e verifica risposte rappresentative in Test Chat. Poi crea una chiave pubblica sicura per il browser in Public Keys e copiala dalla scheda Embed del progetto.

Installare il plugin

Il plugin non ha dipendenze da Composer, npm o passaggi di build.

1. Scarica lo ZIP del plugin WordPress ChattyBox oppure clona il repository pubblico.
2. In WordPress, apri Plugins > Add New > Upload Plugin, carica lo ZIP e attiva ChattyBox AI Chatbot. Per un'installazione manuale sul server, copia prima la directory del plugin in wp-content/plugins/.
3. Apri Settings > ChattyBox.
4. Incolla la chiave API pubblica del widget dalla scheda Embed del progetto.
5. Abilita il chatbot e salva le impostazioni.

Il plugin memorizza la chiave pubblica del widget e le impostazioni di visualizzazione nelle opzioni di WordPress. Non incollare mai nel plugin una credenziale di gestione di ChattyBox.

Configurare il caricamento

Le impostazioni predefinite di produzione sono:

• Script del widget: https://chattybox.ai/widget.js
• Endpoint API: configurato automaticamente dal plugin
• Lingua: rilevata dalla lingua della pagina e dal browser del visitatore

Il plugin carica il widget nelle richieste del frontend pubblico. Salta intenzionalmente wp-admin, i feed, le richieste REST e le richieste AJAX, così le risposte amministrative e quelle che non riguardano pagine non ricevono lo script.

Escludere altre route

Usa il filtro chattybox_load_widget da un plugin specifico del sito o da un tema child quando una route pubblica non deve mostrare il widget:

add_filter(
    'chattybox_load_widget',
    static function ( $should_load ) {
        return $should_load && ! is_page( array( 'checkout', 'account' ) );
    }
);

Mantieni inizialmente attivo il comportamento predefinito del plugin, poi aggiungi solo le esclusioni di route necessarie al tuo sito. Dopo aver modificato il filtro, prova sia una route esclusa sia una normale pagina pubblica.

Fallback dello script manuale

Usa il plugin come percorso predefinito. Se il tuo team WordPress gestisce già gli script tramite un tema, un tema child, un plugin per gli script o Google Tag Manager, puoi caricare manualmente il widget ospitato:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="YOUR_WIDGET_API_URL"
  async
></script>

Non abilitare il plugin e aggiungere contemporaneamente lo stesso snippet del widget. Scegli un solo loader, così i visitatori non ricevono launcher duplicati.

Verificare l'installazione

Dopo aver configurato il plugin:

• Apri una pagina WordPress pubblica in una finestra in incognito.
• Conferma che il launcher compaia una sola volta.
• Fai una domanda reale da visitatore.
• Verifica che la risposta includa citazioni delle fonti che rimandano a pagine WordPress pubbliche.
• Controlla nella console del browser l'assenza di data-api-key, data-api-url o di errori della chiave.
• Prova una route checkout, account o privata se hai configurato un'esclusione.

Continua con la checklist di lancio prima di annunciare il chatbot. Usa Analytics e Content Gaps per migliorare i contenuti WordPress dopo l'arrivo di domande reali.