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.

Puis-je utiliser ChattyBox sur WordPress sans sa marque ?​

Oui. Le plugin officiel charge le widget hébergé ChattyBox sur votre site WordPress. Le forfait Free conserve le pied de page « Powered by ChattyBox ». Starter, Pro et Business permettent de le retirer dans Personnaliser → Apparence → Marque ChattyBox, en désactivant Afficher la marque ChattyBox. Consultez la personnalisation du widget pour ce réglage et les tarifs pour les forfaits.

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 Tester le chatbot. Dans Installer → Clés et domaines, examinez les paramètres d’origine de votre clé publique de widget ou créez-en une. Une clé préparée pour un site peut déjà être limitée à l’origine de ce site. Dans Installer → Installation sur le site web, sélectionnez une clé adaptée et copiez-la depuis l’extrait d’installation.

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.

Le paquet 0.2.0 déclare WordPress 5.8+ et PHP 7.4+, et les métadonnées indiquent des tests jusqu’à WordPress 6.8. Testez vos versions réelles de WordPress et PHP ainsi que votre thème ; ces métadonnées ne garantissent pas la compatibilité avec chaque version plus récente.

  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’extrait d’installation.
  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
  • Activé : non tant que vous n’avez pas activé le chatbot avec une clé publique non vide
  • Surcharge de langue : vide ; le widget hébergé suit la politique de langue du projet (mode Auto par défaut)

Dans le code source actuel du widget hébergé, le mode Auto essaie d’abord la langue prise en charge de l’attribut <html lang> de la page, puis les langues prises en charge du navigateur, la langue par défaut configurée et l’anglais. Le mode Fixed utilise la langue par défaut du projet. La surcharge de langue facultative du plugin devient l’attribut data-locale et n’est prise en compte que si le projet autorise les surcharges par script. Utilisez un code de langue pris en charge en minuscules ; les textes personnalisés d’en-tête et de bienvenue ne sont pas traduits automatiquement. Si vous comptez sur ce comportement, vérifiez la version du chargeur déployé séparément.

Le point de terminaison API est intégré à cette version du plugin et n’est pas déduit de la clé. Modifier Widget script URL ne le modifie pas. Si l’extrait d’installation du site cible un autre déploiement API, utilisez plutôt l’intégration manuelle du script. Les URL distantes du chargeur doivent utiliser HTTPS (HTTP est autorisé uniquement pour les hôtes locaux de développement).

Le plugin enregistre le widget lors de la mise en file des scripts pour les requêtes frontend WordPress et ignore explicitement les flux, les requêtes REST et les requêtes AJAX. Ces contrôles ne vérifient pas tous les types de réponse et ne garantissent pas que chaque page frontend est publique. Ils ne vérifient pas le caractère privé de chaque page frontend : excluez explicitement les pages de paiement, de compte, protégées par mot de passe ou réservées aux membres lorsque c’est nécessaire. Vérifiez également que votre thème exécute les scripts WordPress en pied de page. Le plugin n’explore ni ne synchronise les articles ; l’indexation et les actualisations sont gérées dans ChattyBox.

Les clés créées sans restriction fonctionnent depuis toutes les origines de navigateur ; une clé préparée pour un site peut déjà être limitée à l’origine de ce site. Lorsque les restrictions facultatives de Installer → Clés et domaines sont activées, indiquez le schéma, l’hôte et le port de chaque origine prévue. Pour les clés soumises à des restrictions, une origine effective de requête manquante ou non autorisée entraîne une réponse HTTP 401 Invalid API key ; en l’absence de l’en-tête Origin, le serveur peut déduire l’origine d’un Referer valide. Les restrictions d’origine sont une protection supplémentaire, pas un mécanisme d’authentification des visiteurs. Testez la page de production, pas seulement le tableau de bord.

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.

Ce filtre décide si le script est chargé pour la requête WordPress en cours ; il ne retire pas un widget déjà initialisé lors d’une navigation côté client dans une SPA.

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 publiques 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 de paiement, de compte ou privée si vous avez configuré une exclusion.
  • Après toute modification des réglages ou exclusions, purgez les caches WordPress/CDN pertinents et testez un chargement de page neuf.
  • Une exclusion côté serveur ne retire pas un widget déjà initialisé lors d’une navigation côté client dans une SPA. Sur les routes sensibles ou après le retrait du consentement, démontez activement le widget au moyen d’une intégration prise en charge par la version du chargeur effectivement déployée. Supprimer une balise de script ou masquer le widget en CSS ne constitue pas un démontage complet. Cette opération ne peut pas annuler une requête déjà traitée par le serveur.
  • Le chargeur automatique du plugin ne vérifie pas le consentement du visiteur avant de mettre le widget en file de chargement. Si le consentement est requis, utilisez une intégration qui empêche le chargement jusqu’à son obtention et vérifiez le comportement en cas de retrait du consentement avec le chargeur déployé.

Consultez la checklist de lancement avant d’annoncer le chatbot. Utilisez Conversations → Historique, disponible dans toutes les offres, pour consulter les conversations. Avec les forfaits Pro ou Business, utilisez Conversations → Analyses et Conversations → Questions sans réponse pour améliorer le contenu WordPress après l’arrivée de vraies questions.