Plugin WordPress

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

Download

Scarica Plugin ChatReact v1.1.0

Installazione

Metodo 1: Upload tramite Admin WordPress

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

Metodo 2: Upload manuale via FTP

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

Configurazione

Dopo l'attivazione, vai su Impostazioni → ChatReact per le istruzioni d'uso.

Trovare l'ID del tuo Chatbot

1. Accedi a chatreact.ai
2. Vai alla Dashboard del tuo chatbot
3. Clicca sul pulsante Copia accanto all'ID del Chatbot (mostrato in alto)

Trovare l'ID del tuo Modulo

1. Accedi a chatreact.ai
2. Vai su Moduli
3. Seleziona il tuo modulo
4. Copia l'ID del Modulo

Opzioni di utilizzo

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

1. Shortcode

Aggiungi a qualsiasi pagina, articolo o area widget:

Widget Chat:

[chatreact id="TUO_ID_CHATBOT"]

Attributi opzionali: position, language, primary_color, auto_open

Modulo di Contatto:

[chatreact_form id="TUO_ID_MODULO"]

Attributi opzionali: language

Accordion FAQ:

[chatreact_faq id="TUO_ID_CHATBOT"]

Attributi opzionali: categories, container, language

2. Blocchi Gutenberg

Nell'editor a blocchi:

1. Clicca su + per aggiungere un blocco
2. Cerca "ChatReact"
3. Scegli Chat Widget, Form Widget o FAQ Widget
4. Inserisci il tuo ID nelle impostazioni del blocco

3. Elementor

Se usi Elementor:

1. Modifica la tua pagina con Elementor
2. Cerca "ChatReact" nei widget
3. Trascina il widget sulla tua pagina
4. Configura nel pannello di sinistra

Lingue supportate

Il plugin supporta 24 lingue dell'UE:

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

Risoluzione problemi

4. Assegnazione a Livello di Pagina

Assegna widget a pagine specifiche senza shortcode:

1. Modifica qualsiasi pagina o articolo
2. Trova il meta box "ChatReact Widget"
3. Seleziona un tipo di widget
4. Inserisci il tuo ID
5. Salva la pagina

Esempi di Shortcode

Widget Chat base

[chatreact id="abc123"]

Widget Chat con opzioni

[chatreact id="abc123" position="bottom-left" language="de" auto_open="true"]

FAQ con filtro categoria

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

Modulo di contatto con stile

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

Risoluzione problemi

Il widget non appare

1. Verifica che l'ID del tuo Chatbot sia corretto
2. Controlla se il chatbot è attivo nella tua dashboard ChatReact
3. Svuota qualsiasi plugin di cache (vedi sotto)
4. Controlla la console del browser per errori JavaScript

Compatibilità con Plugin di Cache

Il plugin è completamente compatibile con i plugin di cache e ottimizzazione più popolari, 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 riscontri ancora problemi (es. errori 404, widget che non si carica per i visitatori non autenticati):

1. Svuota la cache del tuo plugin di cache
2. Escludi chatreact dalla minificazione/combinazione JS nelle impostazioni del tuo plugin di cache
3. Il plugin usa attributi data-api-url come fallback per garantire la comunicazione corretta con l'API

Conflitti di Stile

Se il widget appare rotto:

• Il widget usa CSS isolato
• Controlla le regole CSS !important nel tuo tema
• Prova a disattivare temporaneamente altri plugin di chat

Widget Multipli

Puoi usare diversi chatbot su pagine diverse specificando ID univoci in ogni shortcode o blocco.

Integrazione CMS (Smart Sitemap)

A partire dalla versione 1.1.0, il plugin WordPress di ChatReact include una funzionalità Smart Sitemap che fornisce al crawler di ChatReact metadati strutturati sul contenuto direttamente dal tuo sito WordPress.

Come Funziona

1. Genera una Integration Key nella dashboard di ChatReact (Knowledge Base → Websites → CMS Integrations)
2. Incolla la chiave nelle impostazioni del plugin WordPress nella scheda Integration
3. Seleziona i tipi di contenuto che vuoi condividere (Pagine, Articoli, Custom Post Types)
4. Imposta le priorità (Alta/Media/Bassa) per tipo di contenuto
5. Quando esegui il crawl del tuo sito web, ChatReact utilizzerà automaticamente lo smart sitemap invece della scoperta regolare basata su link

Benefici

• Crawling più veloce – Lista diretta di URL invece della scoperta link per link
• Consapevolezza del tipo di contenuto – Il crawler sa se un URL è una Pagina, un Articolo o un Custom Post Type
• Indicizzazione basata su priorità – I contenuti importanti (come le Pagine) possono avere un peso maggiore rispetto agli articoli del blog
• Condivisione selettiva – Condividi solo i tipi di contenuto che desideri
• Esclusione per articolo – Escludi singoli articoli/pagine dalla sitemap tramite il meta box

Livelli di Priorità

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 chiave corretta.

Escludere Singoli Articoli

Nell'editor di WordPress, ogni articolo/pagina ha un meta box ChatReact Widget con l'opzione "Escludi dal Sitemap di ChatReact". Gli articoli selezionati non appariranno nello smart sitemap.

Requisiti

• WordPress 5.8 o superiore
• PHP 7.4 o superiore
• Un account ChatReact (registrati gratis)

Registro delle Modifiche

1.1.0

• NUOVO: Smart Sitemap (Integrazione CMS) — condivisione strutturata dei contenuti con il crawler di ChatReact
• NUOVO: Scheda Integration nelle impostazioni del plugin
• NUOVO: Selezione dei tipi di contenuto con livelli di priorità
• NUOVO: Esclusione per articolo dal sitemap tramite meta box
• NUOVO: Endpoint REST API protetto per smart sitemap
• FIX: Piena compatibilità con i plugin di cache (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
• FIX: Problemi di caricamento del widget per i visitatori non autenticati con plugin di cache
• CHANGED: Le impostazioni del widget sono ora gestite centralmente nella dashboard di ChatReact — rimosse le impostazioni di posizione, lingua, colore primario e apertura automatica dal plugin

1.0.24

• Supporto blocchi Gutenberg
• Integrazione Elementor
• Traduzioni in 24 lingue
• Assegnazione widget a livello di pagina

Prossimi passi

• Personalizzazione Widget →
• Gestione FAQ →
• Configurazione Moduli →