Plugin de chatbot WordPress

Utilisez le plugin WordPress officiel de ChattyBox si vous souhaitez une installation sans code qui charge le widget hébergé sans modifier les fichiers du thème. Ce guide couvre la configuration opérationnelle. La page du chatbot IA WordPress explique la stratégie de contenu et d’exploration, tandis que la page de présentation du plugin WordPress présente brièvement le produit.

Avant l’installation

Suivez d’abord le parcours Prise en main : connectez votre URL WordPress publique, examinez les pages indexées et vérifiez des réponses représentatives dans Test Chat. Créez ensuite une clé publique compatible avec le navigateur dans Public Keys et copiez-la depuis l’onglet Embed du projet.

Installer le plugin

Le plugin ne dépend ni de Composer, ni de npm, ni d’une étape de build. Il est actuellement distribué depuis le dépôt GitHub public de ChattyBox, et non via le répertoire des extensions de WordPress.org ; utilisez donc le parcours Upload Plugin de WordPress plutôt que la recherche dans le répertoire. Les mises à jour automatiques gérées par le répertoire ne sont pas encore disponibles.

1. Téléchargez le ZIP 0.2.0 épinglé du plugin WordPress ChattyBox, ou consultez le dépôt source public.
2. Dans WordPress, ouvrez Plugins > Add New > Upload Plugin, téléversez le ZIP et activez ChattyBox AI Chatbot. Pour une installation manuelle sur le serveur, copiez d’abord le répertoire du plugin dans wp-content/plugins/.
3. Ouvrez Settings > ChattyBox.
4. Collez la clé API publique du widget depuis l’onglet Embed du projet.
5. Activez le chatbot et enregistrez les paramètres.

Le plugin stocke la clé publique du widget et les paramètres d’affichage dans les options WordPress. Ne collez jamais d’identifiant de gestion ChattyBox dans le plugin.

Configurer le chargement

Les paramètres par défaut de production sont les suivants :

• Script du widget : https://chattybox.ai/widget.js
• Point de terminaison API : configuré automatiquement par le plugin
• Langue : détectée à partir de la langue de la page et du navigateur du visiteur

Le plugin charge le widget lors des requêtes du frontend public. Il ignore intentionnellement wp-admin, les flux, les requêtes REST et les requêtes AJAX. Ces gardes ne vérifient pas la confidentialité de chaque page frontend : excluez explicitement paiement, compte, pages protégées ou membres. Le plugin ne crawl ni ne synchronise les articles ; l’indexation reste côté ChattyBox.

Exclure d’autres routes

Utilisez le filtre chattybox_load_widget depuis un plugin propre au site ou un thème enfant lorsqu’une route publique ne doit pas afficher le widget :

add_filter(
    'chattybox_load_widget',
    static function ( $should_load ) {
        return $should_load && ! is_page( array( 'checkout', 'account' ) );
    }
);

Laissez d’abord le comportement par défaut du plugin activé, puis ajoutez uniquement les exclusions de routes nécessaires à votre site. Après avoir modifié le filtre, testez à la fois une route exclue et une page publique normale.

Repli manuel du script

Utilisez le plugin comme méthode par défaut. Si votre équipe WordPress gère déjà les scripts via un thème, un thème enfant, un plugin de scripts ou Google Tag Manager, vous pouvez charger le widget hébergé manuellement à la place :

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="YOUR_WIDGET_API_URL"
  async
></script>

N’activez pas le plugin et n’ajoutez pas le même extrait de widget en même temps. Choisissez un seul chargeur afin que les visiteurs ne reçoivent pas de lanceurs en double.

Vérifier l’installation

Après avoir configuré le plugin :

• Ouvrez une page WordPress publique dans une fenêtre de navigation privée.
• Vérifiez que le lanceur apparaît une seule fois.
• Posez une vraie question de visiteur.
• Vérifiez qu’une réponse prise en charge cite les pages WordPress indexées et qu’une question non prise en charge renvoie le repli, éventuellement sans source.
• Consultez la console du navigateur pour détecter l’absence de data-api-key, data-api-url ou des erreurs de clé.
• Testez une route checkout, account ou privée si vous avez configuré une exclusion, puis videz les caches WordPress/CDN. Retirer un script ou masquer le widget en CSS ne constitue pas une destruction complète ni une révocation de consentement.

Consultez la checklist de lancement avant d’annoncer le chatbot. Utilisez Analytics et Content Gaps pour améliorer le contenu WordPress après l’arrivée de vraies questions.