WordPress Plugin
Ajoutez les chatbots ChatReact AI, les formulaires de contact et les accordéons FAQ à votre site WordPress grâce à notre plugin officiel.
Téléchargement
Le plugin est disponible dans le WordPress Plugin Directory, ou en téléchargement direct :
Télécharger le plugin ChatReact v1.2.1
Installation
Méthode 1 : Répertoire de plugins WordPress (recommandé)
- Allez dans Plugins → Add New dans l'administration WordPress
- Recherchez ChatReact
- Cliquez sur Install Now, puis Activer
Méthode 2 : Téléversement via l'administration WordPress
- Téléchargez le fichier ZIP du plugin ci‑dessus
- Allez dans Plugins → Add New → Upload Plugin
- Choisissez le fichier ZIP et cliquez sur Install Now
- Cliquez sur Activate Plugin
Méthode 3 : Téléversement manuel via FTP
- Extrayez le fichier ZIP
- Téléversez le dossier
chatreactdans/wp-content/plugins/ - Allez dans Plugins dans l'administration WordPress
- Trouvez "ChatReact" et cliquez sur Activer
Configuration
Après l'activation, ouvrez le menu ChatReact dans la barre latérale de l'administration WordPress pour les paramètres et les instructions d'utilisation.
Trouver l'ID de votre chatbot
- Connectez‑vous à chatreact.ai
- Ouvrez votre chatbot et allez à l'onglet Intégration
- Cliquez sur Copier le code pour copier le snippet d'intégration, ou lisez l'ID depuis l'attribut
data-chatbot-iddans le code copié
Trouver l'ID de votre formulaire
- Connectez‑vous à chatreact.ai
- Allez à Formulaires
- Cliquez sur Copier le code d'intégration sur votre formulaire (ou ouvrez le formulaire et basculez vers l'onglet Intégration)
- Votre Form ID est la valeur de
data-form-iddans le code d'intégration copié
Options d'utilisation
Le plugin offre plusieurs façons d'ajouter ChatReact à votre site :
1. Shortcodes
Ajoutez dans n'importe quelle page, publication ou zone de widget :
Chat Widget :
[chatreact id="YOUR_CHATBOT_ID"]
Attributs optionnels : language
Contact Form :
[chatreact_form id="YOUR_FORM_ID"]
Attributs optionnels : language
FAQ Accordion :
[chatreact_faq id="YOUR_CHATBOT_ID"]
Attributs optionnels : categories, container, language
Les paramètres visuels tels que la position, les couleurs et l'ouverture automatique sont gérés centralement dans votre tableau de bord ChatReact et s'appliquent automatiquement à votre site WordPress. L'attribut language est optionnel sur tous les shortcodes — si vous l'omettez, la langue de la page courante est détectée automatiquement (fonctionne avec les sites multilingues).
2. Blocs Gutenberg
Dans l'éditeur de blocs :
- Cliquez sur + pour ajouter un bloc
- Recherchez "ChatReact"
- Choisissez ChatReact Chat, ChatReact Form, ou ChatReact FAQ
- Saisissez votre ID dans les paramètres du bloc
3. Elementor
Si vous utilisez Elementor :
- Éditez votre page avec Elementor
- Recherchez "ChatReact" parmi les widgets
- Glissez le widget sur votre page
- Configurez dans le panneau de gauche
4. Assignations de widget (Paramètres du plugin)
Affichez un chatbot sur des pages spécifiques — ou sur tout le site — sans modifier le contenu :
- Ouvrez le menu ChatReact dans la barre latérale de l'administration
- Dans l'onglet Chat Widget, trouvez Widget Assignments
- Cliquez sur Add Assignment, choisissez une page ou une publication (ou sélectionnez Everywhere), et saisissez votre Chatbot ID
- Cliquez sur Enregistrer les modifications
Pour les assignations Everywhere, vous pouvez exclure des URL spécifiques — une par ligne, avec prise en charge des jokers (p. ex. /blog/* ou /checkout) — pour masquer le widget sur des pages d'atterrissage ou pendant le paiement.
Par défaut, seules les Pages sont recherchables lors de l'assignation. Cliquez sur le bouton Post Types pour rendre d'autres types de contenu (par ex. Posts ou types de publication personnalisés) recherchables également.
5. Assignation au niveau de la page
Assignez un chatbot à une seule page directement depuis l'éditeur :
- Éditez n'importe quelle page ou publication
- Trouvez la boîte méta « ChatReact Widget »
- Cochez Enable custom widget for this page
- Saisissez votre Chatbot ID et choisissez éventuellement une position (Default, Bottom Right, Bottom Left)
- Enregistrez la page
La même boîte méta offre aussi l'option Disable all widgets on this page si vous souhaitez masquer entièrement ChatReact sur certaines pages.
Exemples de shortcodes
Chat Widget basique
[chatreact id="abc123"]
Chat Widget avec langue fixe
[chatreact id="abc123" language="de"]
FAQ avec filtre de catégorie
[chatreact_faq id="abc123" categories="shipping,returns"]
Formulaire de contact stylé
[chatreact_form id="form123" language="en"]
Widget FAQ : SEO & mise en cache
FAQs optimisées pour le SEO
Depuis la version 1.1.2, les widgets FAQ sont rendus côté serveur : vos FAQs font partie du HTML de la page et incluent des données structurées JSON-LD (schéma FAQPage). Les moteurs de recherche et les assistants IA peuvent les lire sans exécuter de JavaScript.
llms.txt pour les crawlers IA
Le plugin peut servir votre contenu FAQ à l'URL yoursite.com/llms.txt, un fichier de découverte lu par les crawlers IA. Il est activé par défaut. Pour l'activer/désactiver ou définir un Chatbot ID spécifique pour ce fichier, allez dans ChatReact → FAQ Widget → Cache & SEO Settings.
Mise en cache des FAQs
Les données FAQ sont mises en cache sur votre serveur pour des chargements de page rapides. Sous ChatReact → FAQ Widget → Cache & SEO Settings, vous pouvez :
- Définir la Cache Duration — 1, 3, 6 (recommandé), 12, ou 24 heures, ou désactiver la mise en cache
- Cliquer sur Clear Cache pour rafraîchir vos FAQs immédiatement
Le cache est également purgé automatiquement chaque fois que vos FAQs changent dans le tableau de bord ChatReact.
Langues prises en charge
Le plugin prend en charge 24 langues de l'UE :
- Bulgare, Croate, Tchèque, Danois, Néerlandais, Anglais
- Estonien, Finnois, Français, Allemand, Grec, Hongrois
- Irlandais, Italien, Letton, Lituanien, Maltais, Polonais
- Portugais, Roumain, Slovaque, Slovène, Espagnol, Suédois
Depuis la version 1.2.0, les traductions pour les 24 langues sont incluses avec le plugin. La langue du widget est détectée automatiquement à partir de la page courante, donc les sites multilingues fonctionnent immédiatement — utilisez l'attribut de shortcode language uniquement si vous souhaitez forcer une langue spécifique.
Dépannage
Widget n'apparaît pas
- Vérifiez que votre Chatbot ID est correct
- Vérifiez si le chatbot est actif dans votre tableau de bord ChatReact
- Videz le cache de tout plugin de mise en cache de pages (voir ci‑dessous)
- Vérifiez la console du navigateur pour les erreurs JavaScript
Compatibilité avec les plugins de mise en cache
Le plugin est entièrement compatible avec les plugins de mise en cache et d'optimisation populaires, notamment WP Rocket, LiteSpeed Cache, Autoptimize, et WP Super Cache. Le plugin empêche automatiquement ces outils de minifier ou de mettre en cache les scripts ChatReact.
Si vous rencontrez toujours des problèmes (p. ex., erreurs 404, widget ne se chargeant pas pour les visiteurs déconnectés) :
- Videz le cache de votre plugin de mise en cache
- Excluez
chatreactde la minification/combinaison JS dans les paramètres de votre plugin de mise en cache - Le plugin utilise les attributs
data-api-urlen tant que solution de secours pour garantir une communication API correcte
FAQs qui ne se mettent pas à jour
Si votre site affiche des FAQs obsolètes, allez dans ChatReact → FAQ Widget et cliquez sur Clear Cache. Le cache se vide également automatiquement lorsque vous modifiez vos FAQs dans le tableau de bord ChatReact.
Conflits de style
Si le widget apparaît cassé :
- Le widget utilise du CSS isolé
- Recherchez des règles CSS
!importantdans votre thème - Essayez de désactiver temporairement d'autres plugins de chat
Widgets multiples
Vous pouvez utiliser des chatbots différents sur des pages différentes en spécifiant des IDs uniques dans chaque shortcode ou bloc.
Intégration CMS (Smart Sitemap)
À partir de la version 1.1.0, le plugin ChatReact pour WordPress inclut une fonctionnalité Smart Sitemap qui fournit au crawler ChatReact des métadonnées de contenu structurées directement depuis votre site WordPress.
Comment ça marche
- Générez une Integration Key dans le tableau de bord ChatReact (Knowledge Base → Websites → CMS Integrations)
- Collez la clé dans les paramètres du plugin WordPress sous l'onglet Integration
- Sélectionnez les types de contenu que vous souhaitez partager (Pages, Posts, Custom Post Types)
- Définissez des priorités (High/Medium/Low) par type de contenu
- Lors du crawl de votre site, ChatReact utilisera automatiquement le smart sitemap au lieu de la découverte basée sur les liens
Avantages
- Crawl plus rapide – liste d'URL directe au lieu d'une découverte lien par lien
- Connaissance du type de contenu – le crawler sait si une URL est une Page, un Post ou un Custom Post Type
- Indexation basée sur la priorité – le contenu important (comme les Pages) peut être pondéré plus fortement que les articles de blog
- Partage sélectif – ne partagez que les types de contenu souhaités
- Exclusion par article – excluez des posts/pages individuels du sitemap via la boîte méta
Niveaux de priorité
| Priority | Default for | Description |
|---|---|---|
| High | Pages | Contenu métier principal (À propos, Services, Contact) |
| Medium | Posts | Articles de blog, actualités |
| Low | – | Contenu complémentaire |
Sécurité
Le point de terminaison du smart sitemap (/wp-json/chatreact/v1/sitemap) est protégé par la Integration Key. Il n'est pas visible par les moteurs de recherche ou d'autres crawlers — seul ChatReact peut y accéder avec la clé correcte.
Si un plugin de sécurité restreint l'API REST WordPress aux utilisateurs connectés, la version 1.2.1 et ultérieure laisse quand même passer les requêtes ChatReact avec une Integration Key valide vers /wp-json/chatreact/v1/ — toutes les autres routes REST restent bloquées. Si un pare‑feu bloque le point de terminaison avant le chargement de WordPress, autorisez /wp-json/chatreact/v1/ à ce niveau. Chaque fois que le smart sitemap est inaccessible, l'aperçu de scan dans le tableau de bord ChatReact affiche la raison et bascule sur le sitemap public, qui ignore votre sélection de types de contenu.
Exclure des articles individuels
Dans l'éditeur WordPress, chaque post/page possède une boîte méta ChatReact Widget avec une option « Exclude from ChatReact Sitemap ». Les articles cochés n'apparaîtront pas dans le smart sitemap.
Exigences
- WordPress 5.8 ou supérieur
- PHP 7.4 ou supérieur
- Un compte ChatReact (sign up free)
Changelog
1.2.1
- FIX : Smart sitemap de nouveau accessible sur les sites qui restreignent l'API REST aux utilisateurs connectés — les requêtes avec une Integration Key valide sont autorisées, de sorte que les types de contenu sélectionnés sont respectés lors du scan
1.2.0
- NEW : Traductions incluses pour les 24 langues officielles de l'UE
1.1.3
- FIX : Les widgets FAQ à catégorie unique n'affichent plus un bouton de filtre "All" inutile ni des badges de catégorie
1.1.2
- NEW : Rendu côté serveur pour les widgets FAQ — les FAQs sont visibles par les moteurs de recherche et les LLM sans JavaScript
- NEW : Données structurées JSON-LD (schéma FAQPage) pour un meilleur SEO et les résultats enrichis
- NEW : Point de terminaison llms.txt pour la découverte par les crawlers IA
- NEW : Purge automatique du cache FAQ lorsque le contenu change dans le tableau de bord ChatReact
1.1.1
- FIX : Améliorations de traduction (roumain, néerlandais)
1.1.0
- NEW : Smart Sitemap (CMS Integration) — partage structuré de contenu avec le crawler ChatReact
- NEW : Onglet Integration dans les paramètres du plugin
- NEW : Sélection des types de contenu avec niveaux de priorité
- NEW : Exclusion par article du sitemap via la boîte méta
- NEW : Point de terminaison REST API protégé pour le smart sitemap
- FIX : Compatibilité complète avec les plugins de mise en cache (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
- FIX : Problèmes de chargement du widget pour les visiteurs déconnectés avec des plugins de mise en cache
1.0.24
- Assignations de widget — assigner des chatbots aux pages directement depuis les paramètres du plugin
- Support des blocs Gutenberg
- Intégration Elementor
- Traductions pour 24 langues
- Assignation de widget au niveau de la page
- CHANGED : Les paramètres du widget sont désormais gérés centralement dans le tableau de bord ChatReact — suppression des attributs de shortcode
position,primary_color, etauto_open(languageest toujours pris en charge)