WordPress fait tourner plus de 40 % du web, ce qui veut dire qu’il y a de bonnes chances que votre site en fasse partie. Ajouter un chatbot à WordPress est simple. Vous n’avez besoin ni d’un développeur, ni d’un plugin sur mesure, ni d’aucune expérience en code. Ce guide passe en revue trois méthodes, de l’approche par plugin la plus simple à l’installation au niveau du thème, et couvre les pièges les plus courants.
Avant de commencer
Deux éléments sont nécessaires avant d’ajouter le chatbot à votre site WordPress.
1. Un compte Agentkit avec un chatbot entraîné.
Si ce n’est pas encore fait, inscrivez-vous gratuitement et créez votre premier chatbot. Entraînez-le sur le contenu de votre site, vos pages FAQ, votre documentation, ou tout autre contenu sur lequel vos visiteurs posent des questions. Consultez le guide d’entraînement pour plus de détails.
2. Copiez le code d’intégration généré.
Ouvrez votre chatbot dans Agentkit, choisissez Canaux > Intégration au site web, puis Widget de chat, et cliquez sur Copier le code. Collez les deux balises de script complètes dans WordPress, sans modifier l’URL ni l’identifiant. Le code actuel comprend un petit script de chargement et celui du widget.
Activez le canal Widget de chat avant de tester le site public.
Comparatif des méthodes
| Méthode | Difficulté | Plugin requis | S’applique à | Survit aux mises à jour du thème | Idéal pour |
|---|---|---|---|---|---|
| Plugin (WPCode) | La plus simple | Oui (gratuit) | Toutes les pages | Oui | Les utilisateurs non techniques |
| Bloc HTML personnalisé | Facile | Non | Pages spécifiques | Oui | Un chatbot par page |
| Pied de page du thème (footer.php) | Modérée | Non | Toutes les pages | Non (thème enfant nécessaire) | Les développeurs |
Choisissez la méthode adaptée à votre niveau de confort. L’approche par plugin est recommandée pour la plupart des utilisateurs, car c’est la plus simple et la plus résistante aux mises à jour de thème.
Méthode 1 : approche par plugin (recommandée)
C’est la méthode la plus simple. Vous installez un plugin gratuit qui vous permet d’ajouter des extraits de code à votre site sans toucher aux fichiers du thème.
Avec WPCode (Insert Headers and Footers)
WPCode est un plugin WordPress gratuit comptant plus de 2 millions d’installations. Il vous permet d’ajouter du code à l’en-tête ou au pied de page de votre site sans modifier les fichiers du thème.
Étape 1 : installez le plugin
- Dans votre administration WordPress, allez dans Plugins puis Add New.
- Recherchez « WPCode ».
- Cliquez sur Install Now, puis sur Activate.
Étape 2 : ajoutez l’extrait du chatbot
- Dans la barre latérale d’administration WordPress, allez dans Code Snippets puis Header & Footer.
- Repérez la section Footer.
- Collez les deux balises de Canaux > Intégration au site web dans le champ Footer.
- Cliquez sur Save Changes.
C’est tout. Le widget du chatbot apparaît désormais sur chaque page de votre site WordPress.
Étape 3 : vérifiez que ça fonctionne
- Ouvrez votre site web dans un nouvel onglet de navigateur (pas l’administration WordPress).
- Vous devriez voir la bulle de discussion en bas à droite.
- Cliquez dessus et envoyez un message de test pour confirmer qu’il répond correctement.
WPCode s’appelait auparavant Insert Headers and Footers de WPBeginner. C’est le même plugin, pas une autre méthode. La documentation WPCode indique où coller le code dans Footer.
Contrôler les pages où le chatbot s’affiche
Pour quelques pages, utilisez le bloc HTML ci-dessous si votre compte peut publier des scripts. WPCode propose aussi des règles conditionnelles, mais certaines règles par page ou article nécessitent une licence payante. Vérifiez celles disponibles dans votre version.
Méthode 2 : bloc HTML personnalisé (pages spécifiques)
Si vous voulez le chatbot sur une ou deux pages seulement et ne voulez pas installer de plugin, vous pouvez utiliser l’éditeur de blocs de WordPress.
Étape 1 : modifiez la page où vous voulez le chatbot.
Étape 2 : ajoutez un bloc Custom HTML en bas du contenu de la page.
Étape 3 : collez les deux balises générées dans le bloc.
Étape 4 : mettez à jour ou publiez la page.
Après publication, vérifiez les deux balises dans le code source rendu. WordPress peut les retirer des comptes sans unfiltered_html, dont certains rôles Multisite. Si une balise manque, utilisez une extension de pied de page autorisée ou contactez l’administrateur. WordPress décrit cette limite. Sur WordPress.com, l’offre doit autoriser les plugins et le JavaScript personnalisé.
Limites de cette méthode :
- Si vous voulez le chatbot sur de nombreuses pages, cela devient fastidieux. Utilisez plutôt la méthode par plugin.
Méthode 3 : pied de page du thème (footer.php)
Cette méthode ajoute le chatbot au niveau du thème. C’est l’approche la plus directe, mais elle nécessite de modifier des fichiers du thème.
Important : si vous modifiez directement le fichier footer.php de votre thème, vos changements seront perdus à la prochaine mise à jour du thème. Utilisez un thème enfant pour rendre la modification permanente.
Avec un thème enfant
Étape 1 : si vous n’avez pas encore de thème enfant, créez-en un. La plupart des développeurs de thèmes fournissent des instructions. Vous pouvez aussi utiliser le plugin « Child Theme Configurator ».
Étape 2 : dans votre administration WordPress, allez dans Appearance puis Theme File Editor.
Étape 3 : sélectionnez votre thème enfant dans le menu déroulant.
Étape 4 : ouvrez footer.php. S’il n’existe pas dans votre thème enfant, créez-le en copiant le footer.php du thème parent.
Étape 5 : repérez </body> et collez le code généré complet juste avant.
Étape 6 : enregistrez le fichier.
Sans thème enfant (non recommandé)
Si vous modifiez directement le footer.php du thème parent, suivez les mêmes étapes, mais sachez qu’une mise à jour du thème écrasera vos changements. Si vous choisissez cette voie, conservez une copie de votre footer.php modifié afin de pouvoir le réappliquer après chaque mise à jour.
Tester votre installation
Une fois le chatbot ajouté avec l’une ou l’autre méthode, passez en revue cette liste de vérification.
Vérification de base
| Vérification | Comment vérifier | Résultat attendu |
|---|---|---|
| Le widget apparaît | Visitez votre site dans un nouvel onglet | Bulle de discussion visible en bas à droite |
| Le widget s’ouvre | Cliquez sur la bulle de discussion | La fenêtre de chat s’ouvre avec un message d’accueil |
| Le chatbot répond | Tapez une question et envoyez-la | Réponse IA basée sur vos données d’entraînement |
| Affichage mobile | Ouvrez le site sur un téléphone ou utilisez les outils de développement du navigateur | Le widget est accessible et utilisable |
| Vitesse de chargement | Vérifiez l’onglet Réseau des outils de développement du navigateur | Le script du widget se charge de manière asynchrone, sans blocage |
Liste de vérification pour vider le cache
La mise en cache est la principale raison pour laquelle les gens ajoutent le script du chatbot sans le voir apparaître sur leur site. Videz les caches dans cet ordre :
- Plugin de cache WordPress (WP Super Cache, W3 Total Cache, WP Rocket, LiteSpeed Cache) : allez dans les paramètres du plugin et purgez tous les caches.
- Cache au niveau de l’hébergeur (SiteGround, WP Engine, Cloudflare) : vérifiez le tableau de bord de votre hébergeur pour une option de purge du cache.
- Cache CDN (Cloudflare, StackPath, Fastly) : si vous utilisez un CDN, purgez également le cache à cet endroit.
- Cache du navigateur : ouvrez votre site dans une fenêtre de navigation privée pour contourner le cache local du navigateur.
Si le chatbot n’apparaît toujours pas après avoir vidé tous les caches, vérifiez la console de développement du navigateur (F12 sur ordinateur) pour repérer d’éventuelles erreurs JavaScript.
Dépannage des problèmes courants
Le chatbot n’apparaît pas
Cause : mise en cache. C’est le problème le plus fréquent. Suivez la liste de vérification pour vider le cache ci-dessus.
Cause : script bloqué. Dans la console ou l’onglet Réseau du navigateur, relevez le véritable hôte de l’URL src générée. Si la CSP le bloque, demandez à l’administrateur de l’autoriser.
Le chatbot apparaît mais ne répond pas
Cause : chatbot non entraîné. Allez dans votre tableau de bord Agentkit et vérifiez que votre chatbot dispose de données d’entraînement. Un chatbot non entraîné n’a rien sur quoi s’appuyer.
Cause : ID de chatbot incorrect. Vérifiez que le data-chatbot de votre code d’intégration correspond à l’ID affiché dans votre tableau de bord Agentkit.
Cause : restriction de domaine. Si vous avez configuré des restrictions de domaine dans les paramètres de votre chatbot, assurez-vous que votre domaine WordPress figure dans la liste des domaines autorisés.
Le chatbot entre en conflit avec un autre plugin de chat
Si vous utilisez un autre plugin de chat en direct ou de chatbot (Tidio, Intercom, Drift, Crisp), les deux widgets peuvent se chevaucher ou interférer l’un avec l’autre.
Solutions :
- Retirez l’autre plugin de chat si vous passez entièrement à Agentkit.
- Si vous avez besoin des deux, utilisez la méthode du bloc HTML personnalisé d’Agentkit pour ne l’afficher que sur les pages où l’autre plugin n’est pas actif.
- Ajustez la position du widget dans les paramètres de votre tableau de bord Agentkit si les deux doivent coexister.
Ralentissement du chargement de page après l’ajout du chatbot
Le widget Agentkit se charge de manière asynchrone (l’attribut async dans la balise de script), il ne devrait donc pas bloquer le rendu de votre page. Si vous constatez un ralentissement :
- Confirmez que l’attribut
asyncest présent dans votre balise de script. - Effectuez un test de vitesse (Google PageSpeed Insights, GTmetrix) et vérifiez si le script Agentkit est signalé.
- Vérifiez si une extension de performance retarde les scripts et autorisez si besoin la véritable URL du widget affichée dans Canaux.
Configurer le chatbot pour WordPress
Une fois le chatbot en ligne sur votre site WordPress, envisagez ces étapes de configuration dans votre tableau de bord Agentkit.
Restriction de domaine
Dans les Paramètres de votre chatbot, définissez le domaine autorisé sur le domaine de votre site WordPress (par exemple yourdomain.com). Cela empêche quiconque de copier votre code d’intégration et d’utiliser votre chatbot sur un autre site.
Entraînement sur le contenu WordPress
La meilleure source pour l’entraînement est le contenu réel de votre site web. Dans Agentkit, ajoutez l’URL de votre site WordPress comme source d’entraînement, et l’outil d’exploration indexera vos pages automatiquement.
Concentrez votre entraînement sur :
- Les pages FAQ ou base de connaissances
- Les pages produits ou services
- La page tarifs
- La page à propos
- La documentation d’assistance
- Les articles de blog qui répondent aux questions courantes
Évitez d’entraîner sur des pages au contenu pauvre, des pages de connexion ou des pages nécessitant une authentification.
Pour un guide d’entraînement complet, consultez Comment entraîner un chatbot sur le contenu de votre site web.
Collecte de prospects
Activez l’action de collecte de prospects pour recueillir les e-mails et noms des visiteurs directement dans le chat. Les prospects collectés apparaissent dans votre tableau de bord Agentkit et peuvent être envoyés vers votre CRM via Zapier ou des webhooks. Consultez la documentation sur la collecte de prospects pour la configuration.
Documentation d’intégration spécifique à WordPress
Pour les instructions de configuration les plus récentes et toute fonctionnalité spécifique à WordPress, consultez la documentation d’intégration WordPress.
Récapitulatif du comparatif des méthodes
| Considération | Plugin (WPCode) | Bloc HTML personnalisé | Pied de page du thème |
|---|---|---|---|
| Compétence technique | Aucune | Aucune | PHP de base |
| Survit aux mises à jour du thème | Oui | Oui | Uniquement avec un thème enfant |
| Couverture de tout le site | Oui | Non (page par page) | Oui |
| Dépendance à un plugin | Oui (plugin gratuit) | Non | Non |
Pour la plupart des utilisateurs WordPress, la méthode par plugin est le bon choix. Elle est rapide, sûre, et offre le plus de flexibilité sans mettre en danger les fichiers de votre thème.
Prochaines étapes
Une fois votre chatbot en ligne sur WordPress, passez quelques minutes dans le Playground d’Agentkit à tester les réponses. Si le chatbot ne répond pas bien sur certains sujets, ajoutez davantage de données d’entraînement pour ces domaines. Le Playground vous permet d’itérer rapidement sans avoir à tester sur votre site en ligne à chaque fois.
Explorez ensuite comment connecter votre chatbot à vos autres outils. Le guide d’intégration couvre les workflows Zapier, les webhooks et l’API REST pour des configurations plus avancées.
Créez votre chatbot gratuitement →
Aucune carte bancaire requise.



