Guide
Intégrer un chatbot IA sur WordPress : trois méthodes
Extension autonome, extension d'un service ou script : intégrer un chatbot IA au WordPress d'un client sans casser le thème ni le cache.
Mis à jour le
Il existe trois façons d'ajouter un assistant IA à un site WordPress : une extension qui fait tout dans WordPress avec votre propre clé d'IA, l'extension ou le script d'un service hébergé à l'extérieur, ou un script collé à la main. Pour le site d'un client, le choix se fait moins sur la technique que sur trois questions : qui paie l'usage de l'IA, où vivent les conversations, et qui s'occupe du suivi.
Les trois méthodes côte à côte
| Méthode | Comment ça marche | Ce qu'il faut savoir |
|---|---|---|
| Extension autonome | L'extension appelle un fournisseur de modèles d'IA avec une clé saisie dans WordPress | L'usage est facturé par le fournisseur, sur le compte qui détient la clé. Les réglages vivent dans l'administration du site |
| Extension ou script d'un service hébergé | Le chatbot est configuré chez un éditeur ; WordPress n'affiche que la fenêtre | Les réglages, la base de connaissances et les conversations sont chez l'éditeur. L'abonnement se gère hors du site |
| Script collé à la main | Vous ajoutez la balise fournie par l'outil, sans extension dédiée | Fonctionne avec presque tous les outils ; il faut gérer soi-même l'emplacement et le chargement |
Exemple d'extension autonome
AI Engine, publiée sur le répertoire officiel des extensions, ajoute des chatbots qui répondent à partir du contenu du site. Sa fiche (version 3.9.4, consultée le 15/11/2026) indique :
- des connecteurs pour plusieurs fournisseurs (OpenAI, Anthropic, Google, Mistral et d'autres), et la possibilité de brancher un serveur compatible hébergé soi-même ;
- l'obligation de fournir ses propres clés d'accès aux fournisseurs ;
- un affichage en fenêtre, intégré à la page ou en plein écran ;
- une base de connaissances construite à partir des articles et des fichiers PDF, la partie « embeddings » (représentation du texte pour la recherche) étant réservée à la version payante ;
- des prérequis : WordPress 6.0 ou plus, PHP 8.1 ou plus.
Pour un client, la question pratique est celle de la clé : si elle est à votre nom, vous payez l'usage et le refacturez ; si elle est au nom du client, il reçoit la facture du fournisseur et doit garder son compte actif.
Coller un script proprement
La plupart des services hébergés fournissent une balise <script> à placer sur toutes les pages. Deux emplacements tiennent dans la durée.
Option 1 : une extension d'insertion de code
WPCode, par exemple, permet d'ajouter des scripts dans l'en-tête ou le pied de page « sans modifier les fichiers du thème ». Elle propose aussi une logique conditionnelle : charger un code seulement sur certaines pages, ou selon que le visiteur est connecté. C'est utile pour réserver l'assistant aux pages où il sert (contact, tarifs, fiches produits) plutôt que de le charger partout. Sa fiche indique un prérequis de WordPress 5.0 ou plus.
C'est l'option la plus simple quand le fournisseur donne un extrait complet avec des attributs de configuration (identifiant du bot, couleur, langue) : vous le collez tel quel.
Option 2 : le thème enfant et wp_enqueue_script
Si vous gérez le code du thème, passez par un thème enfant. La documentation WordPress le dit sans détour : une fonction ajoutée au functions.php du thème parent « disparaîtra » à la prochaine mise à jour du thème.
Depuis WordPress 6.3, la fonction wp_enqueue_script accepte un tableau d'options avec deux clés utiles :
in_footer: imprimer le script en pied de page ;strategy:defer(exécuté après la lecture de la page, dans l'ordre) ouasync(exécuté dès qu'il est téléchargé, sans ordre garanti).
add_action( 'wp_enqueue_scripts', function () {
wp_enqueue_script(
'assistant-chat',
'https://fournisseur.exemple/widget.js',
array(),
null,
array( 'in_footer' => true, 'strategy' => 'defer' )
);
} );
L'adresse ci-dessus est un exemple : remplacez-la par celle de votre outil. WordPress tient compte des dépendances et peut appliquer une stratégie moins différée que celle demandée, jamais plus stricte. Cette méthode convient aux scripts qui n'ont besoin que d'une adresse ; si l'outil exige des attributs sur la balise, l'extension d'insertion est plus simple.
Les pièges propres à WordPress
- Constructeurs de pages. Si le client utilise un constructeur visuel, vérifiez que la fenêtre ne passe pas sous un en-tête collant ou une fenêtre surgissante du thème.
- Extensions de cache et d'optimisation. Celles qui regroupent ou réduisent les fichiers JavaScript peuvent modifier le script du chat. Si le widget ne s'affiche plus après activation du cache, excluez son adresse de l'optimisation, puis videz le cache.
- Visiteur déconnecté. Testez toujours en navigation privée : l'administrateur connecté ne voit pas toujours la même page que le visiteur, surtout avec une logique conditionnelle ou un cache.
- Mises à jour. Après une mise à jour de WordPress, du thème ou de l'extension, rouvrez une page publique et lancez une conversation. C'est une ligne à prévoir dans le contrat de maintenance.
- Consentement. Si le widget dépose un cookie dès le chargement, il doit attendre l'accord du visiteur : voir chatbot et consentement aux cookies.
Liste de contrôle avant la mise en ligne
- Le script est placé dans une extension d'insertion ou dans un thème enfant, jamais dans le thème parent.
- Il est chargé en différé (
defer) ou après l'affichage, et seulement sur les pages prévues. - Le domaine du site (et celui de la préproduction) est autorisé dans l'outil du chatbot.
- Le widget fonctionne avec le cache activé, en navigation privée, sur mobile.
- Le message d'accueil dit qu'il s'agit d'une IA (voir les mentions à ajouter au site).
- La fenêtre s'ouvre et se ferme au clavier (voir les tests d'accessibilité).
- Le compte de l'outil ou la clé d'IA est enregistré au nom prévu par le contrat, avec un accès de secours.
Pour les autres plateformes que WordPress, la méthode générale est décrite dans la page sur l'intégration d'un widget de chat.
Questions fréquentes
Où coller le script d'un chatbot dans WordPress ?
Dans une extension d'insertion de code (en-tête ou pied de page), ou dans le fichier functions.php d'un thème enfant avec wp_enqueue_script. Jamais dans les fichiers du thème parent : la prochaine mise à jour du thème effacerait la modification.
Peut-on charger le script du chatbot en différé sur WordPress ?
Oui. Depuis WordPress 6.3, wp_enqueue_script accepte une clé « strategy » avec la valeur defer ou async. WordPress peut appliquer une stratégie moins différée si les dépendances l'exigent, jamais plus stricte.
Une extension de chatbot avec sa propre clé d'IA, c'est quoi ?
Une extension qui appelle directement un fournisseur de modèles d'IA avec une clé que vous saisissez. C'est le cas d'AI Engine : vous fournissez vos propres clés, et le coût d'usage est facturé par le fournisseur choisi.
Sources
Pages consultées pour écrire cet article :
- https://wordpress.org/plugins/ai-engine/
- https://wordpress.org/plugins/insert-headers-and-footers/
- https://developer.wordpress.org/reference/functions/wp_enqueue_script/
- https://developer.wordpress.org/themes/advanced-topics/child-themes/
- https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script