Come aggiungere un chatbot a WordPress con blocco, widget o shortcode

Apri l'amministrazione di WordPress → WebChatAgent → General. Incolla l'UUID completo in Chatbot ID, attiva il widget solo se desideri un pulsante mobile su tutto il sito e seleziona Save Settings. Il titolo di sola lettura e l'anteprima dovrebbero aggiornarsi mostrando l'assistente previsto.

Il pannello informativo blu è importante: aspetto, posizione, messaggi, conoscenza e comportamento delle risposte sono gestiti nella dashboard di WebChatAgent. WordPress non deve diventare una seconda fonte di configurazione in conflitto.

Il salvataggio riuscito conferma l'archiviazione locale. Il caricamento del titolo dell'assistente e dell'anteprima conferma inoltre che l'ID, la richiesta di configurazione pubblica e la voce in Allowed websites corrispondono.

Usa il widget mobile per un'assistenza su tutto il sito che deve rimanere disponibile mentre i visitatori navigano tra le pagine. Usa una chat inline quando la conversazione deve svolgersi all'interno di una pagina specifica di supporto, prezzi, onboarding o knowledge base.

Apri Inline Embed per visualizzare i due metodi di modifica. Chi usa Gutenberg dovrebbe preferire WebChatAgent Inline Chat poiché gli editor possono individuarlo visivamente e impostare un ID opzionale specifico per la pagina. Chi usa Classic Editor, Elementor, Divi o widget di testo può incollare `[webchatagent_inline]` in un elemento che supporta gli shortcode.

Entrambi i metodi inline riutilizzano per impostazione predefinita il Chatbot ID di General. Ciò mantiene centralizzate le future modifiche all'assistente e riduce la manutenzione.

Apri una normale pagina front-end e verifica che il pulsante della chat rimanga all'interno dell'area sicura in basso a destra senza coprire avvisi sui cookie, azioni di checkout o navigazione mobile. Aprilo una volta e controlla il titolo dell'assistente, il messaggio di benvenuto, i colori e il focus da tastiera.

Il widget mobile si carica ovunque il tema attivo esegua la chiamata a `wp_footer()`. Se appare nell'anteprima di amministrazione ma non sul sito, ispeziona il footer del tema e i plugin di ottimizzazione prima di modificare il Chatbot ID.

Esegui il test sulla home page, su una pagina interna memorizzata nella cache e in una sessione di navigazione in incognito. Una sessione amministratore attiva può nascondere problemi legati a consensi, cache e persistenza dei dati.

Crea o modifica la pagina di destinazione, apri il selettore dei blocchi (Block Inserter) e cerca “chat”. Seleziona WebChatAgent Inline Chat nella sezione Embeds. Aggiungi un titolo chiaro e una frase prima del blocco per indicare ai visitatori cosa possono chiedere.

L'editor mostra un segnaposto invece di caricare il widget remoto attivo. Questo è intenzionale: evita di avviare sessioni visitatore o consumare traffico chat mentre un editor riorganizza i contenuti.

Pubblica prima in ambiente di staging. Apri l'URL pubblico e verifica l'altezza completa della chat su desktop e mobile; non valutare il layout finale basandoti solo sul segnaposto dell'editor.

Lascia vuoto il campo Chatbot ID nella barra laterale del blocco per ereditare le impostazioni di General. Inserisci un UUID completo solo quando questa pagina richiede intenzionalmente un assistente specialistico, ad esempio per l'assistenza durante l'onboarding all'interno del relativo portale, mantenendo il bot mobile per il supporto generale.

Registra l'URL della pagina, il nome dell'assistente e il responsabile dell'override nella documentazione dei contenuti. Quando un assistente viene eliminato o sostituito, gli override non documentati sono facili da dimenticare.

Se la chat inline e quella mobile rispondono in modo diverso, confronta i loro nomi pubblici e ID prima di intervenire sulle impostazioni della knowledge base o del modello.

Aggiungi un modulo Shortcode o compatibile con HTML e incolla `[webchatagent_inline]`. Questa è la scelta più sicura per Classic Editor, Elementor, Divi, widget riutilizzabili e template che eseguono gli shortcode di WordPress.

Per un assistente dedicato e specialistico usa `[webchatagent_inline chatbot-id="UUID"]`. L'alias `chatbot_id="UUID"` è disponibile per i page builder che rimuovono i trattini dai nomi degli attributi.

Non incollare lo snippet di installazione JavaScript grezzo nella stessa pagina quando il plugin è attivo. Il plugin carica già la risorsa inline solo dove il blocco o lo shortcode vengono renderizzati.

Se una pagina inline deve contenere solo una chat, disattiva l'interruttore globale mobile per l'intero sito o rimuovi il blocco inline da quella pagina. Poiché il plugin non dispone di un'esclusione del widget mobile per singola pagina, pianifica le strategie combinate prima del rilascio.

Carica l'archiviazione opzionale della chat o il tracciamento solo dopo aver ottenuto lo stato di consenso richiesto dalla tua policy. Il widget WebChatAgent rispetta lo stato del consenso, ma è il tuo gestore dei consensi su WordPress a decidere quando gli script opzionali possono essere eseguiti. Documenta la base giuridica, la conservazione e le informazioni sul responsabile del trattamento per la tua installazione.

Escludi `web-chat-agent.js` e `chat-widget-inline.js` da ritardi di esecuzione, combinazione di script e minificazione aggressiva. Svuota la cache di WordPress, dei page builder, dei reverse proxy e della CDN dopo ogni modifica a posizionamento o ID.

Apri la pagina pubblicata in una nuova sessione visitatore. Verifica la presenza di un solo widget inline, lo stato corretto del pulsante mobile, i controlli in inglese, la leggibilità su mobile e l'assenza di scorrimento orizzontale. Quindi poni una domanda la cui risposta esatta è presente in una fonte indicizzata.

Domanda verificata: “What is the exact onboarding code for the WordPress embed lab?” Risultato previsto ed effettivo: `WP-EMBED-47`. Il widget inline reale ha risposto: “The exact onboarding code for the WordPress embed lab is WP-EMBED-47.”

Ripeti la stessa domanda dopo ogni modifica a plugin, tema, cache, consensi, assistente o knowledge base. Esegui anche un test con una domanda non supportata e richiedi una risposta trasparente di assenza di informazioni, evitando supposizioni plausibili.