Comment ajouter le chatbot IA Asyntai à Drupal

Guide étape par étape pour les sites Drupal

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 : Utiliser le module Header and Footer Scripts (recommandé)

La façon la plus simple d'ajouter le chatbot est d'utiliser le module « Header and Footer Scripts » :

Connectez-vous à votre panneau d'administration Drupal
Accédez à Extend et cliquez sur « Installer un nouveau module »
Recherchez « Header and Footer Scripts » ou téléchargez-le depuis Drupal.org
Installez et activez le module
Accédez à Configuration → Développement → Scripts d'en-tête et de pied de page
Cliquez sur l'onglet "Footer"
Collez votre code d'intégration Asyntai dans le champ Footer Scripts
Cliquez sur "Save configuration"

Astuce : L'ajout du code dans la section pied de page garantit qu'il se charge après le contenu de la page, ce qui est recommandé pour les widgets de chat.

Alternative : Modifier le template du thème

Vous pouvez ajouter le code directement au fichier de template de votre thème :

Accédez au dossier de votre thème : themes/your_theme/
Ouvrez le fichier html.html.twig (ou créez-le s'il n'existe pas)
Trouvez la balise fermante </body>
Collez votre code d'intégration Asyntai juste avant la balise </body>
Enregistrez le fichier
Videz le cache de Drupal : Configuration → Performance → Clear all caches

Important : Les modifications apportées aux fichiers du thème peuvent être écrasées lors de la mise à jour de votre thème. Envisagez d'utiliser un thème enfant ou le module Header and Footer Scripts pour une solution plus pérenne.

Alternative : Utilisation des bibliothèques (pour les développeurs)

Pour les développeurs qui préfèrent utiliser le système de bibliothèque d'assets de Drupal :

Créez ou modifiez le fichier *.libraries.yml de votre thème
Ajoutez une nouvelle entrée de bibliothèque :
asyntai-chatbot: js: https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
Attachez la bibliothèque dans le fichier *.info.yml de votre thème :
libraries: - your_theme/asyntai-chatbot
Videz le cache de Drupal

Étape 3 : Vérifier l'installation

Après avoir enregistré vos modifications et vidé le cache, visitez votre site web 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.