Passer au contenu principal

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.

  1. Téléchargez le ZIP du plugin WordPress ChattyBox ou clonez le dépôt 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, afin que les réponses administratives et les réponses qui ne sont pas des pages ne reçoivent pas le script.

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 que la réponse contient des citations renvoyant aux pages WordPress publiques.
  • 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.

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.

We use optional analytics and tag-management tools to understand site use. Choose whether to allow PostHog and Google Tag Manager. Turning analytics off reloads this page so the change takes effect cleanly. Essential site functionality and error monitoring are not controlled by this choice. Read our privacy policy.