Comment ajouter un chatbot à WordPress avec un bloc, un widget ou un shortcode

Ouvrez Admin WordPress → WebChatAgent → General. Collez l'UUID complet dans Chatbot ID, activez le widget uniquement si vous souhaitez un bouton flottant sur tout le site et sélectionnez Save Settings. Le titre en lecture seule et l'aperçu doivent se mettre à jour pour afficher l'assistant souhaité.

Le panneau d'information bleu est important : l'apparence, la position, les messages, les connaissances et le comportement des réponses sont gérés dans le tableau de bord WebChatAgent. WordPress ne doit pas devenir une seconde source de configuration contradictoire.

Un enregistrement réussi prouve le stockage local. Un titre d'assistant et un aperçu chargés prouvent en outre que l'identifiant, la requête de configuration publique et l'entrée Allowed websites concordent.

Utilisez le widget flottant pour une assistance sur l'ensemble du site qui doit rester disponible lorsque les visiteurs passent d'une page à l'autre. Utilisez un chat intégré sur la page lorsque la conversation a sa place au sein d'une page spécifique de support, de tarifs, d'onboarding ou de base de connaissances.

Ouvrez Inline Embed pour voir les deux méthodes d'édition. Les utilisateurs de Gutenberg doivent privilégier WebChatAgent Inline Chat car les éditeurs peuvent le découvrir visuellement et définir un identifiant optionnel spécifique à la page. Les utilisateurs de l'Éditeur classique, d'Elementor, de Divi et des widgets texte peuvent coller `[webchatagent_inline]` dans un élément prenant en charge les shortcodes.

Les deux méthodes intégrées réutilisent le Chatbot ID général par défaut. Cela permet de centraliser les modifications futures de l'assistant et de réduire la maintenance.

Ouvrez une page front-end standard et confirmez que le bouton de chat reste dans la zone sécurisée en bas à droite sans recouvrir les bandeaux de cookies, les actions de paiement ou la navigation mobile. Ouvrez-le une fois et vérifiez le titre de l'assistant, le message de bienvenue, les couleurs et le focus clavier.

Le widget flottant se charge partout où le thème actif appelle `wp_footer()`. S'il apparaît dans l'aperçu d'administration mais pas sur le site, inspectez le pied de page du thème et les extensions d'optimisation avant de modifier le Chatbot ID.

Testez la page d'accueil, une page interne mise en cache et une session de navigation privée. Une session administrateur active peut masquer des problèmes de consentement, de cache et de persistance.

Créez ou modifiez la page cible, ouvrez l'outil d'insertion de blocs (Block Inserter) et recherchez “chat”. Sélectionnez WebChatAgent Inline Chat sous Intégrations (Embeds). Ajoutez un titre clair et une phrase indiquant aux visiteurs ce qu'ils peuvent demander avant le bloc.

L'éditeur affiche un espace réservé au lieu de charger le widget distant en direct. C'est intentionnel : cela évite de démarrer des sessions de visiteurs ou de consommer du trafic de chat pendant qu'un éditeur réorganise le contenu.

Publiez d'abord sur un environnement de préproduction. Ouvrez l'URL publique et vérifiez la hauteur complète du chat sur ordinateur et mobile ; ne jugez pas la disposition finale uniquement à partir de l'espace réservé de l'éditeur.

Laissez Chatbot ID vide dans la barre latérale du bloc pour hériter des réglages généraux (General). Entrez un UUID complet uniquement lorsque cette page a délibérément besoin d'un assistant spécialisé—par exemple, une aide à la prise en main dans le portail d'onboarding pendant que le bot flottant reste dédié au support général.

Notez l'URL de la page, le nom de l'assistant et le responsable de la substitution dans votre documentation de contenu. Lorsqu'un assistant est supprimé ou remplacé, les substitutions cachées sont sinon faciles à oublier.

Si les chats intégrés et flottants répondent différemment, comparez leurs noms d'assistants publics et leurs identifiants avant de déboguer les connaissances ou les paramètres du modèle.

Ajoutez un module Shortcode ou compatible HTML et collez `[webchatagent_inline]`. C'est le choix le plus sûr pour l'Éditeur classique, Elementor, Divi, les widgets réutilisables et les modèles qui exécutent les shortcodes WordPress.

Pour un assistant spécialisé délibéré, utilisez `[webchatagent_inline chatbot-id="UUID"]`. L'alias `chatbot_id="UUID"` existe pour les constructeurs de pages qui suppriment les tirets des noms d'attributs.

Ne collez pas l'extrait d'installation JavaScript brut dans la même page lorsque l'extension est active. L'extension charge déjà la ressource intégrée uniquement là où le bloc ou le shortcode est affiché.

Si une page intégrée ne doit contenir qu'un seul chat, désactivez l'interrupteur flottant global pour l'ensemble du site ou supprimez le bloc intégré de cette page. Comme l'extension ne propose pas d'exclusion du bouton flottant par page, les stratégies mixtes doivent être planifiées avant le déploiement.

Ne chargez le stockage optionnel de chat ou de suivi qu'après avoir obtenu l'état de consentement requis par votre politique. Le widget WebChatAgent prend en compte l'état du consentement, mais votre gestionnaire de consentement WordPress décide toujours du moment où les scripts optionnels peuvent s'exécuter. Documentez la base légale, la durée de conservation et les informations sur le sous-traitant pour votre déploiement.

Excluez `web-chat-agent.js` et `chat-widget-inline.js` du chargement différé, de la combinaison de scripts et de la minification agressive. Videz les caches de WordPress, des constructeurs de pages, des reverse proxies et du CDN après avoir modifié l'emplacement ou l'identifiant.

Ouvrez la page publiée dans une nouvelle session visiteur. Confirmez la présence d'un seul widget intégré, l'état flottant prévu, les éléments de contrôle en anglais, une largeur lisible sur mobile et l'absence de débordement horizontal. Posez ensuite une question dont la réponse exacte existe dans une source indexée.

Entrée vérifiée : “What is the exact onboarding code for the WordPress embed lab?” Résultat attendu et observé : `WP-EMBED-47`. Le véritable widget intégré a répondu : “The exact onboarding code for the WordPress embed lab is WP-EMBED-47.”

Répétez la même question après toute modification d'extension, de thème, de cache, de consentement, d'assistant ou de connaissances. Testez également une question sans support documentaire et exigez une réponse honnête d'absence d'information plutôt qu'une supposition plausible.