Comment ajouter le chatbot IA Asyntai à Bludit

Guide étape par étape pour Bludit CMS

Plateforme :

Étape 1 : Obtenir votre code d'intégration

Tout d'abord, rendez-vous sur votre Tableau de bord Asyntai et faites défiler jusqu'à la section « Code d'intégration ». Copiez votre code d'intégration unique qui ressemblera à ceci :

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Note : Le code ci-dessus n'est qu'un exemple. Vous devez copier votre propre code d'intégration depuis votre Tableau de bord car il contient votre identifiant de widget personnel.

Étape 2 : Ajouter le code via le plugin HTML Code (recommandé)

La façon la plus simple d'ajouter le chatbot à votre site Bludit est d'utiliser le plugin intégré HTML Code :

Connectez-vous à votre panneau d'administration Bludit
Accédez à Plugins dans la barre latérale gauche
Trouvez le plugin « HTML Code » (il est généralement préinstallé)
S'il n'est pas actif, cliquez sur "Activer" pour l'activer
Cliquez sur "Configure" sur le plugin HTML Code
Dans la configuration, vous verrez des champs pour le code d'en-tête et de pied de page
Collez votre code d'intégration Asyntai dans la section "Footer"
Cliquez sur "Save"

Astuce : L'ajout de code dans le pied de page garantit qu'il se charge à la fin de vos pages, ce qui ne ralentira pas le chargement initial de votre site. Cette méthode ajoute automatiquement le chatbot à toutes les pages de votre site.

Méthode alternative 1 : Intégration via les fichiers du thème

Pour plus de contrôle, vous pouvez ajouter le code directement aux fichiers de votre thème :

Connectez-vous à votre installation Bludit via FTP ou le Gestionnaire de fichiers
Accédez à /bl-themes/your-theme-name/
Ouvrez le fichier index.php pour le modifier
Trouvez la balise fermante </body>
Collez votre code d'intégration Asyntai juste avant la balise </body>
Enregistrez le fichier
Videz le cache de votre site si applicable

Note : Lorsque vous modifiez directement les fichiers du thème, assurez-vous de sauvegarder le fichier original au préalable. Les mises à jour du thème peuvent écraser vos modifications, alors documentez vos changements.

Méthode alternative 2 : Contenu personnalisé dans les pages

Vous pouvez également ajouter le code du chatbot directement à des pages spécifiques en utilisant l'éditeur de contenu de Bludit :

Connectez-vous à votre panneau d'administration Bludit
Accédez à Contenu et sélectionnez la page que vous souhaitez modifier
Passez en mode HTML dans l'éditeur (si vous utilisez un éditeur visuel)
Ajoutez votre code d'intégration Asyntai n'importe où dans le contenu de la page
Cliquez sur "Save"
Répétez pour les autres pages où vous souhaitez le chatbot

Important : Lorsque vous ajoutez du code directement au contenu d'une page, vous devrez l'ajouter à chaque page individuellement. Pour une installation sur l'ensemble du site, utilisez plutôt le plugin HTML Code ou la méthode par fichier de thème.

Utilisation des hooks de plugin (avancé)

Pour les développeurs créant des plugins personnalisés, Bludit fournit des hooks de plugin :

siteBodyBegin - S'exécute en haut de la balise <body>
siteBodyEnd - S'exécute en bas, idéal pour le code JavaScript comme le widget Asyntai

Vous pouvez créer un plugin personnalisé qui utilise le hook siteBodyEnd pour injecter le code du chatbot sur toutes les pages.

Étape 3 : Vérifier l'installation

Après avoir enregistré vos modifications, visitez votre site Bludit dans un nouvel onglet de navigateur ou en navigation privée. Vous devriez voir le bouton du widget de chat dans le coin inférieur droit. Cliquez dessus pour vérifier qu'il s'ouvre et fonctionne correctement.

Vous ne voyez pas le widget ? Assurez-vous d'avoir enregistré la configuration du plugin ou les modifications du fichier de thème. Videz le cache de votre navigateur et le cache de Bludit (si activé). Vérifiez la console du navigateur (F12) pour toute erreur JavaScript.