Passa al contenuto principale

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.

Posso usare ChattyBox su WordPress senza il marchio?​

Sì. Il plugin ufficiale carica il widget ospitato di ChattyBox sul tuo sito WordPress. Free mantiene il piè di pagina «Powered by ChattyBox». Starter, Pro e Business consentono di rimuoverlo disattivando Mostra il branding di ChattyBox in Personalizza → Marchio ChattyBox. Consulta la personalizzazione del widget per l'impostazione e i prezzi per i piani.

Prima dell'installazione​

Completa prima il flusso Per iniziare: collega il tuo URL WordPress pubblico, esamina le pagine indicizzate e verifica risposte rappresentative in Prova il chatbot. In Installa → Chiavi e domini, consulta o crea una chiave pubblica del widget e verifica le impostazioni delle origini. In Installa → Installazione sul sito web, seleziona una chiave adatta e copiala dallo snippet di installazione.

Installare il plugin​

Il plugin non ha dipendenze da Composer, npm o passaggi di build. Attualmente è distribuito dal repository GitHub pubblico di ChattyBox, non dalla WordPress.org Plugin Directory, quindi usa il flusso Upload Plugin di WordPress invece della ricerca nella directory. Gli aggiornamenti automatici gestiti dalla directory non sono ancora disponibili.

Il pacchetto fissato 0.2.0 dichiara WordPress 5.8+ e PHP 7.4+, con test indicati fino a WordPress 6.8. Verifica le versioni effettive di WordPress e PHP e il tema: questi metadati non garantiscono la compatibilità con ogni versione successiva.

  1. Scarica lo ZIP fissato del plugin WordPress ChattyBox 0.2.0, oppure consulta il repository del codice sorgente 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 dallo snippet di installazione.
  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
  • Attivo: no, finché non lo abiliti con chiave pubblica non vuota
  • Override lingua: vuoto; segue la policy del progetto (modalità Rilevamento automatico per impostazione predefinita)

Nel codice sorgente attuale del widget ospitato, la modalità Rilevamento automatico prova prima la lingua supportata in <html lang> della pagina, poi le lingue supportate del browser, la lingua predefinita configurata e infine l'inglese. In modalità Fissa si usa la lingua predefinita del progetto. L'override di lingua facoltativo del plugin diventa data-locale e prevale solo se il progetto consente gli override di script. Usa un codice locale supportato in minuscolo; il testo personalizzato dell'intestazione e di benvenuto non viene tradotto automaticamente. Se fai affidamento su questo comportamento, verifica la versione del loader distribuito separatamente.

L'endpoint API è integrato in questa versione del plugin e non viene ricavato dalla chiave. Modificare Widget script URL non modifica l'endpoint. Se lo snippet di installazione sul sito web punta a un deployment API diverso, usa l'integrazione manuale. Gli URL remoti del loader devono usare HTTPS; HTTP è consentito solo per host locali di sviluppo (localhost, 127.0.0.1 e ::1).

Il plugin registra il widget nelle richieste di enqueue del frontend di WordPress ed esclude esplicitamente i feed, le richieste REST e le richieste AJAX. Questi controlli non verificano ogni tipo di risposta né stabiliscono se ogni pagina frontend sia pubblica.

Queste guardie sulle richieste non verificano la privacy o l'appartenenza a un'area riservata di ogni pagina frontend. Checkout, account, pagine protette da password e pagine per gli iscritti richiedono esclusioni esplicite, se necessario. Verifica anche che il tema esegua gli script del footer di WordPress. Il plugin non esegue il crawling né sincronizza gli articoli: l'indicizzazione dei contenuti e i relativi aggiornamenti avvengono in ChattyBox.

Le chiavi create senza restrizioni funzionano da origini browser diverse; una chiave preparata per un sito può essere già limitata all'origine di quel sito. Le restrizioni facoltative in Installa → Chiavi e domini richiedono ogni schema, hostname e porta previsti. Per le chiavi con restrizioni, un'origine effettiva della richiesta mancante o non consentita restituisce 401 Invalid API key; se l'header Origin è assente, il server può ricavare l'origine da un Referer valido. Le restrizioni di origine sono un livello di protezione aggiuntivo, non un metodo di autenticazione dei visitatori. Prova la pagina di produzione, non solo il dashboard.

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:

Il filtro viene applicato alle richieste idonee lato server, dopo i controlli del plugin; non rimuove un widget già inizializzato durante la navigazione lato client.

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 una risposta supportata citi pagine WordPress pubbliche indicizzate e che una domanda non supportata mostri la risposta alternativa, che potrebbe non avere fonti.
  • Controlla nella console del browser se mancano data-api-key o data-api-url, oppure se sono presenti errori relativi alla chiave.
  • Prova una route checkout, account o privata se hai configurato un'esclusione.
  • Svuota le cache di pagina WordPress/CDN pertinenti dopo aver modificato le impostazioni o le esclusioni e prova una nuova richiesta della pagina. Le esclusioni lato server non rimuovono un widget già inizializzato durante la navigazione lato client. Per le route sensibili o in caso di revoca del consenso, verifica la versione del loader distribuita e rimuovi attivamente il widget tramite un'integrazione supportata; rimuovere solo lo script o nascondere il widget con CSS non equivale a una rimozione completa. Questa operazione non può annullare le richieste già elaborate dal server.
  • Il loader automatico del plugin non verifica il consenso dei visitatori prima di mettere in coda il widget. Se il consenso è richiesto, usa un'integrazione che impedisca il caricamento fino alla sua concessione e verifica il comportamento in caso di revoca con il loader distribuito.

Continua con la checklist di lancio prima di annunciare il chatbot. In Conversazioni → Cronologia puoi consultare le conversazioni con tutti i piani. Con i piani Pro e Business, usa le analisi in Conversazioni → Analisi e le domande in Conversazioni → Domande senza risposta per migliorare i contenuti WordPress quando arrivano domande reali.