AccueilDocumentation

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é)

  1. Allez dans Plugins → Add New dans l'administration WordPress
  2. Recherchez ChatReact
  3. Cliquez sur Install Now, puis Activer

Méthode 2 : Téléversement via l'administration WordPress

  1. Téléchargez le fichier ZIP du plugin ci‑dessus
  2. Allez dans Plugins → Add New → Upload Plugin
  3. Choisissez le fichier ZIP et cliquez sur Install Now
  4. Cliquez sur Activate Plugin

Méthode 3 : Téléversement manuel via FTP

  1. Extrayez le fichier ZIP
  2. Téléversez le dossier chatreact dans /wp-content/plugins/
  3. Allez dans Plugins dans l'administration WordPress
  4. 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

  1. Connectez‑vous à chatreact.ai
  2. Ouvrez votre chatbot et allez à l'onglet Intégration
  3. Cliquez sur Copier le code pour copier le snippet d'intégration, ou lisez l'ID depuis l'attribut data-chatbot-id dans le code copié

Trouver l'ID de votre formulaire

  1. Connectez‑vous à chatreact.ai
  2. Allez à Formulaires
  3. Cliquez sur Copier le code d'intégration sur votre formulaire (ou ouvrez le formulaire et basculez vers l'onglet Intégration)
  4. Votre Form ID est la valeur de data-form-id dans 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 :

  1. Cliquez sur + pour ajouter un bloc
  2. Recherchez "ChatReact"
  3. Choisissez ChatReact Chat, ChatReact Form, ou ChatReact FAQ
  4. Saisissez votre ID dans les paramètres du bloc

3. Elementor

Si vous utilisez Elementor :

  1. Éditez votre page avec Elementor
  2. Recherchez "ChatReact" parmi les widgets
  3. Glissez le widget sur votre page
  4. 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 :

  1. Ouvrez le menu ChatReact dans la barre latérale de l'administration
  2. Dans l'onglet Chat Widget, trouvez Widget Assignments
  3. Cliquez sur Add Assignment, choisissez une page ou une publication (ou sélectionnez Everywhere), et saisissez votre Chatbot ID
  4. 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 :

  1. Éditez n'importe quelle page ou publication
  2. Trouvez la boîte méta « ChatReact Widget »
  3. Cochez Enable custom widget for this page
  4. Saisissez votre Chatbot ID et choisissez éventuellement une position (Default, Bottom Right, Bottom Left)
  5. 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

  1. Vérifiez que votre Chatbot ID est correct
  2. Vérifiez si le chatbot est actif dans votre tableau de bord ChatReact
  3. Videz le cache de tout plugin de mise en cache de pages (voir ci‑dessous)
  4. 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) :

  1. Videz le cache de votre plugin de mise en cache
  2. Excluez chatreact de la minification/combinaison JS dans les paramètres de votre plugin de mise en cache
  3. Le plugin utilise les attributs data-api-url en 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 !important dans 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

  1. Générez une Integration Key dans le tableau de bord ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Collez la clé dans les paramètres du plugin WordPress sous l'onglet Integration
  3. Sélectionnez les types de contenu que vous souhaitez partager (Pages, Posts, Custom Post Types)
  4. Définissez des priorités (High/Medium/Low) par type de contenu
  5. 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é

PriorityDefault forDescription
HighPagesContenu métier principal (À propos, Services, Contact)
MediumPostsArticles 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, et auto_open (language est toujours pris en charge)

Étapes suivantes