HomeDocumentazione

WordPress Plugin

Aggiungi chatbot AI di ChatReact, moduli di contatto e accordion FAQ al tuo sito WordPress con il nostro plugin ufficiale.

Download

Il plugin è disponibile nella WordPress Plugin Directory ufficiale, oppure come download diretto:

Download ChatReact Plugin v1.2.1

Installazione

Metodo 1: WordPress Plugin Directory (Consigliato)

  1. Vai su Plugin → Aggiungi nuovo nell'area admin di WordPress
  2. Cerca ChatReact
  3. Clicca su Installa ora, poi Attiva

Metodo 2: Caricamento tramite l'area admin di WordPress

  1. Scarichi il file ZIP del plugin sopra
  2. Vai su Plugin → Aggiungi nuovo → Carica plugin
  3. Scegli il file ZIP e clicca Installa ora
  4. Clicca Attiva plugin

Metodo 3: Caricamento manuale via FTP

  1. Estrai il file ZIP
  2. Carica la cartella chatreact in /wp-content/plugins/
  3. Vai su Plugin nell'area admin di WordPress
  4. Trova "ChatReact" e clicca Attiva

Configurazione

Dopo l'attivazione, apri il menu ChatReact nella barra laterale dell'area admin di WordPress per le impostazioni e le istruzioni d'uso.

Come trovare il tuo Chatbot ID

  1. Acceda a chatreact.ai
  2. Apri il tuo chatbot e vai nella scheda Incorpora
  3. Clicca Copia codice per copiare lo snippet di embed, oppure legga l'ID dall'attributo data-chatbot-id nel codice copiato

Come trovare il tuo Form ID

  1. Acceda a chatreact.ai
  2. Vai su Moduli
  3. Clicchi Copia il codice embed sul suo form (o apra il form e passi alla scheda Incorpora)
  4. Il suo Form ID è il valore di data-form-id nel codice di embed copiato

Opzioni d'uso

Il plugin offre diversi modi per aggiungere ChatReact al suo sito:

1. Shortcode

Aggiunga a qualsiasi pagina, articolo o area widget:

Chat Widget:

[chatreact id="YOUR_CHATBOT_ID"]

Attributi opzionali: language

Contact Form:

[chatreact_form id="YOUR_FORM_ID"]

Attributi opzionali: language

FAQ Accordion:

[chatreact_faq id="YOUR_CHATBOT_ID"]

Attributi opzionali: categories, container, language

Le impostazioni visive come posizione, colori e apertura automatica sono gestite centralmente nella sua dashboard ChatReact e si applicano automaticamente al sito WordPress. L'attributo language è opzionale in tutti gli shortcode — se lo omette, la lingua della pagina corrente viene rilevata automaticamente (funziona con siti multilingue).

2. Blocchi Gutenberg

Nell'editor a blocchi:

  1. Clicchi + per aggiungere un blocco
  2. Cerchi "ChatReact"
  3. Scegli ChatReact Chat, ChatReact Form, o ChatReact FAQ
  4. Inserisca il suo ID nelle impostazioni del blocco

3. Elementor

Se utilizza Elementor:

  1. Modifichi la pagina con Elementor
  2. Cerchi "ChatReact" nei widget
  3. Trascini il widget nella pagina
  4. Configuri nel pannello a sinistra

4. Assegnazioni Widget (Impostazioni del plugin)

Mostri un chatbot in pagine specifiche — o su tutto il sito — senza modificare alcun contenuto:

  1. Apra il menu ChatReact nella barra laterale dell'admin
  2. Nella scheda Chat Widget, trovi Widget Assignments
  3. Clicchi Add Assignment, scelga una pagina o un articolo (o selezioni Everywhere), e inserisca il suo Chatbot ID
  4. Clicchi Salvi le modifiche

Per le assegnazioni Everywhere può escludere URL specifici — uno per riga, con supporto wildcard (es. /blog/* o /checkout) — per nascondere il widget su pagine di destinazione o durante il checkout.

Di default sono ricercabili solo le Pagine quando si assegna. Clicchi il pulsante Post Types per rendere ricercabili altri tipi di contenuto (es. Post o tipi personalizzati).

5. Assegnazione a livello di pagina

Assegni un chatbot a una singola pagina direttamente dall'editor:

  1. Modifichi una qualsiasi pagina o articolo
  2. Trovi la meta box "ChatReact Widget"
  3. Selezioni Enable custom widget for this page
  4. Inserisca il suo Chatbot ID e opzionalmente scelga una posizione (Default, Bottom Right, Bottom Left)
  5. Salvi la pagina

La stessa meta box offre anche l'opzione Disable all widgets on this page se desidera nascondere completamente ChatReact su determinate pagine.

Esempi di Shortcode

Chat Widget di base

[chatreact id="abc123"]

Chat Widget con lingua fissa

[chatreact id="abc123" language="de"]

FAQ con filtro per categoria

[chatreact_faq id="abc123" categories="shipping,returns"]

Contact Form stilizzato

[chatreact_form id="form123" language="en"]

Widget FAQ: SEO & Caching

FAQ ottimizzate per la SEO

Dalla versione 1.1.2, i widget FAQ vengono renderizzati lato server: le FAQ fanno parte dell'HTML della pagina e includono dati strutturati JSON-LD (schema FAQPage). I motori di ricerca e gli assistenti AI possono leggerle senza eseguire JavaScript.

llms.txt per crawler AI

Il plugin può servire i contenuti delle FAQ su yoursite.com/llms.txt, un file di discoverability letto dai crawler AI. È abilitato di default. Per attivarlo/disattivarlo o impostare un Chatbot ID specifico per il file, vada su ChatReact → FAQ Widget → Cache & SEO Settings.

Caching delle FAQ

I dati delle FAQ sono memorizzati nella cache sul suo server per caricamenti delle pagine più veloci. In ChatReact → FAQ Widget → Cache & SEO Settings può:

  • Impostare la Cache Duration — 1, 3, 6 (consigliato), 12, o 24 ore, oppure disabilitare la cache
  • Cliccare Clear Cache per aggiornare immediatamente le FAQ

La cache viene anche svuotata automaticamente ogni volta che le FAQ vengono modificate nella dashboard ChatReact.

Lingue supportate

Il plugin supporta 24 lingue EU:

  • Bulgarian, Croatian, Czech, Danish, Dutch, English
  • Estonian, Finnish, French, German, Greek, Hungarian
  • Irish, Italian, Latvian, Lithuanian, Maltese, Polish
  • Portuguese, Romanian, Slovak, Slovenian, Spanish, Swedish

Dalla versione 1.2.0, le traduzioni per tutte le 24 lingue sono incluse nel plugin. La lingua del widget viene rilevata automaticamente dalla pagina corrente, quindi i siti multilingue funzionano immediatamente — usi l'attributo shortcode language solo se vuole forzare una lingua specifica.

Risoluzione dei problemi

Il widget non appare

  1. Verifichi che il suo Chatbot ID sia corretto
  2. Controlli che il chatbot sia attivo nella sua dashboard ChatReact
  3. Svuoti eventuali plugin di caching della pagina (vedi sotto)
  4. Controlli la console del browser per errori JavaScript

Compatibilità con plugin di caching

Il plugin è completamente compatibile con i plugin di caching e ottimizzazione più diffusi, inclusi WP Rocket, LiteSpeed Cache, Autoptimize, e WP Super Cache. Il plugin impedisce automaticamente a questi strumenti di minificare o memorizzare nella cache gli script di ChatReact.

Se continua a riscontrare problemi (es. errori 404, widget che non si carica per visitatori disconnessi):

  1. Svuoti la cache del plugin di caching
  2. Escluda chatreact dalla minificazione/combination JS nelle impostazioni del plugin di caching
  3. Il plugin usa gli attributi data-api-url come fallback per garantire una corretta comunicazione con l'API

Le FAQ non si aggiornano

Se il sito mostra FAQ non aggiornate, vada su ChatReact → FAQ Widget e clicchi Clear Cache. La cache viene anche svuotata automaticamente quando modifica le FAQ nella dashboard ChatReact.

Conflitti di stile

Se il widget appare danneggiato:

  • Il widget usa CSS isolato
  • Verifichi la presenza di regole CSS !important nel suo tema
  • Provi a disattivare temporaneamente altri plugin di chat

Widget multipli

Può utilizzare diversi chatbot su pagine differenti specificando ID unici in ciascuno shortcode o blocco.

Integrazione CMS (Smart Sitemap)

A partire dalla versione 1.1.0, il plugin ChatReact per WordPress include una funzione Smart Sitemap che fornisce al crawler ChatReact metadati di contenuto strutturati direttamente dal suo sito WordPress.

Come funziona

  1. Generi una Integration Key nella dashboard ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Incolli la key nelle impostazioni del plugin WordPress nella scheda Integration
  3. Selezioni i tipi di contenuto che desidera condividere (Pages, Posts, Custom Post Types)
  4. Imposti le priorità (High/Medium/Low) per ogni tipo di contenuto
  5. Quando esegue la scansione del sito, ChatReact userà automaticamente lo smart sitemap invece della scoperta basata sui link

Vantaggi

  • Scansione più veloce – Elenco diretto di URL invece della scoperta link per link
  • Consapevolezza del tipo di contenuto – Il crawler sa se un URL è Page, Post o Custom Post Type
  • Indicizzazione basata su priorità – Contenuti importanti (come le Pagine) possono avere peso maggiore rispetto ai post del blog
  • Condivisione selettiva – Condivida solo i tipi di contenuto desiderati
  • Esclusione per singolo post – Escluda singoli post/pagine dalla sitemap tramite la meta box

Livelli di priorità

PriorityDefault forDescription
HighPagesContenuti aziendali principali (About, Services, Contact)
MediumPostsArticoli del blog, aggiornamenti di news
Low–Contenuti supplementari

Sicurezza

L'endpoint dello smart sitemap (/wp-json/chatreact/v1/sitemap) è protetto dalla Integration Key. Non è visibile ai motori di ricerca o ad altri crawler — solo ChatReact può accedervi con la key corretta.

Se un plugin di sicurezza limita l'API REST di WordPress agli utenti autenticati, le versioni 1.2.1 e successive permettono comunque alle richieste ChatReact con una Integration Key valida di raggiungere /wp-json/chatreact/v1/ — tutte le altre rotte REST restano bloccate. Se un firewall blocca l'endpoint prima che WordPress sia caricato, consenta /wp-json/chatreact/v1/ lì. Ogni volta che lo smart sitemap non è raggiungibile, l'anteprima di scansione nella dashboard ChatReact mostra il motivo e ripiega sulla sitemap pubblica, che ignora la selezione dei tipi di contenuto.

Escludere singoli post

Nell'editor di WordPress, ogni post/pagina ha una meta box ChatReact Widget con un'opzione "Exclude from ChatReact Sitemap". I post selezionati non appariranno nello smart sitemap.

Requisiti

  • WordPress 5.8 o superiore
  • PHP 7.4 o superiore
  • Un account ChatReact (sign up free)

Changelog

1.2.1

  • FIX: Smart sitemap nuovamente raggiungibile su siti che limitano l'API REST agli utenti autenticati — le richieste con una Integration Key valida vengono consentite, quindi i tipi di contenuto selezionati vengono rispettati durante la scansione

1.2.0

  • NEW: Traduzioni incluse per tutte le 24 lingue ufficiali EU

1.1.3

  • FIX: I widget FAQ a categoria singola non mostrano più un inutile pulsante filtro "All" e i badge di categoria

1.1.2

  • NEW: Rendering lato server per i widget FAQ — le FAQ sono visibili ai motori di ricerca e agli LLM senza JavaScript
  • NEW: Dati strutturati JSON-LD (schema FAQPage) per migliorare la SEO e i risultati arricchiti
  • NEW: Endpoint llms.txt per la discoverability dei crawler AI
  • NEW: Pulizia automatica della cache FAQ quando i contenuti cambiano nella dashboard ChatReact

1.1.1

  • FIX: Miglioramenti alle traduzioni (Romanian, Dutch)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — condivisione di contenuti strutturati con il crawler ChatReact
  • NEW: Scheda Integration nelle impostazioni del plugin
  • NEW: Selezione dei tipi di contenuto con livelli di priorità
  • NEW: Esclusione per singolo post dalla sitemap tramite meta box
  • NEW: Endpoint REST API protetto per lo smart sitemap
  • FIX: Piena compatibilità con plugin di caching (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Problemi di caricamento del widget per visitatori disconnessi con plugin di caching

1.0.24

  • Widget Assignments — assegnare i chatbot alle pagine direttamente dalle impostazioni del plugin
  • Supporto a blocchi Gutenberg
  • Integrazione con Elementor
  • Traduzioni per 24 lingue
  • Assegnazione widget a livello di pagina
  • CHANGED: Le impostazioni del widget sono ora gestite centralmente nella dashboard ChatReact — rimossi gli attributi shortcode position, primary_color, e auto_open (language è ancora supportato)

Prossimi passi