Plugin per WordPress

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

Download

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

Download ChatReact Plugin v1.2.0

Installazione

Metodo 1: WordPress Plugin Directory (Consigliato)

1. Vada su Plugin → Aggiungi nuovo nella sua area di amministrazione WordPress
2. Cerchi ChatReact
3. Clicchi Installa ora, poi Attiva

Metodo 2: Caricamento tramite amministrazione WordPress

1. Scarichi il file ZIP del plugin sopra
2. Vada su Plugin → Aggiungi nuovo → Carica plugin
3. Scegla il file ZIP e clicchi Installa ora
4. Clicchi Attiva plugin

Metodo 3: Caricamento manuale via FTP

1. Estragga il file ZIP
2. Carichi la cartella chatreact in /wp-content/plugins/
3. Vada su Plugin nell'area di amministrazione di WordPress
4. Trovi "ChatReact" e faccia clic su Attiva

Configurazione

Dopo l'attivazione, apra il menu ChatReact nella barra laterale della sua amministrazione WordPress per le impostazioni e le istruzioni d'uso.

Trovare il suo Chatbot ID

1. Acceda a chatreact.ai
2. Vada al Dashboard del suo chatbot
3. Clicchi il pulsante Copia accanto al Chatbot ID (mostrato in alto)

Trovare il suo Form ID

1. Acceda a chatreact.ai
2. Vada su Forms
3. Clicchi Copy embed code sul suo modulo (o apra il modulo e passi alla scheda Embed)
4. Il suo Form ID è il valore di data-form-id nel codice embed copiato

Opzioni di utilizzo

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

2. Blocchi Gutenberg

Nell'editor a blocchi:

1. Clicchi + per aggiungere un blocco
2. Cerchi "ChatReact"
3. Scega 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. Apre il menu ChatReact nella barra laterale dell'amministrazione
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 Save Changes

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

Per impostazione predefinita sono ricercabili solo le Pagine quando si assegna. Clicchi il pulsante Post Types per rendere ricercabili anche altri tipi di contenuto (es. Post o tipi di post personalizzati).

5. Assegnazione a livello di pagina

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

1. Modifichi 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 ChatReact completamente 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 e caching

FAQSEO-friendly

A partire dalla versione 1.1.2, i widget FAQ sono renderizzati lato server: le sue FAQ fanno parte dell'HTML della pagina e includono dati strutturati JSON-LD (schema FAQPage). Motori di ricerca e assistenti AI possono leggerle senza eseguire JavaScript.

llms.txt per crawler AI

Il plugin può fornire i contenuti delle FAQ su yoursite.com/llms.txt, un file di scoperta 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 velocizzare il caricamento delle pagine. 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 sue FAQ

La cache viene inoltre svuotata automaticamente ogni volta che le sue FAQ cambiano nel dashboard ChatReact.

Lingue supportate

Il plugin supporta 24 lingue UE:

• Bulgaro, Croato, Ceco, Danese, Olandese, Inglese
• Estone, Finlandese, Francese, Tedesco, Greco, Ungherese
• Irlandese, Italiano, Lettone, Lituano, Maltese, Polacco
• Portoghese, Rumeno, Slovacco, Sloveno, Spagnolo, Svedese

A partire 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 out of the box — usi l'attributo language nello shortcode solo se desidera forzare una lingua specifica.

Risoluzione dei problemi

Widget non visualizzato

1. Verifichi che il suo Chatbot ID sia corretto
2. Controlli che il chatbot sia attivo nel suo 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 è pienamente compatibile con i più diffusi plugin di caching e ottimizzazione tra cui WP Rocket, LiteSpeed Cache, Autoptimize e WP Super Cache. Il plugin previene automaticamente che questi strumenti minifichino o memorizzino nella cache gli script di ChatReact.

Se riscontra ancora problemi (es. errori 404, widget che non si carica per i visitatori non autenticati):

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

FAQ non aggiornate

Se il suo sito mostra FAQ obsolete, vada su ChatReact → FAQ Widget e clicchi Clear Cache. La cache viene inoltre svuotata automaticamente quando modifica le FAQ nel dashboard ChatReact.

Conflitti di stile

Se il widget appare rotto:

• Il widget utilizza CSS isolati
• Controlli la presenza di regole CSS !important nel suo tema
• Provi a disabilitare temporaneamente altri plugin di chat

Widget multipli

Può utilizzare chatbot diversi su pagine diverse specificando ID univoci in ogni shortcode o blocco.

Integrazione CMS (Smart Sitemap)

A partire dalla versione 1.1.0, il plugin ChatReact per WordPress include una funzionalità Smart Sitemap che fornisce al crawler ChatReact metadati strutturati dei contenuti direttamente dal suo sito WordPress.

Come funziona

1. Generi una Integration Key nel 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 ciascun tipo di contenuto
5. Quando crawla il suo sito, ChatReact utilizzerà automaticamente la smart sitemap invece della scoperta tramite link

Vantaggi

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

Livelli di priorità

Sicurezza

L'endpoint della 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.

Escludere singoli post

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

Requisiti

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

Changelog

1.2.0

• NEW: Traduzioni incorporate per tutte le 24 lingue ufficiali UE

1.1.3

• FIX: I widget FAQ con una singola categoria non mostrano più un pulsante filtro "All" non necessario né 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 rich result
• NEW: Endpoint llms.txt per la scoperta da parte dei crawler AI
• NEW: Svuotamento automatico della cache FAQ quando i contenuti cambiano nel dashboard ChatReact

1.1.1

• FIX: Miglioramenti alle traduzioni (Rumeno, Olandese)

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 la smart sitemap
• FIX: Piena compatibilità con plugin di caching (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
• FIX: Problemi di caricamento dei widget per i visitatori non autenticati con plugin di caching

1.0.24

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

Prossimi passi

• Widget Customization →
• FAQ Management →
• Form Configuration →