Retour au tableau de bord

Documentation

Apprenez à utiliser Asyntai

Comment ajouter le chatbot IA Asyntai à Drupal

Guide étape par étape pour les sites Drupal

Obtenir le code d'intégration

É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 » :

  1. Log in to your Drupal admin panel
  2. Accédez à Extend et cliquez sur « Installer un nouveau module »
  3. Recherchez « Header and Footer Scripts » ou téléchargez-le depuis Drupal.org
  4. Installez et activez le module
  5. Accédez à Configuration → Développement → Scripts d'en-tête et de pied de page
  6. Cliquez sur l'onglet "Footer"
  7. Paste your Asyntai embed code in the footer scripts text area
  8. 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

You can add the code directly to your theme's template file:

  1. Accédez au dossier de votre thème : themes/your_theme/
  2. Ouvrez le fichier html.html.twig (ou créez-le s'il n'existe pas)
  3. Trouvez la balise fermante </body>
  4. Collez votre code d'intégration Asyntai juste avant la balise </body>
  5. Enregistrez le fichier
  6. 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)

For developers who prefer using Drupal's asset library system:

  1. Create or edit your theme's *.libraries.yml file
  2. 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 } }
  3. Attach the library in your theme's *.info.yml file:
    libraries:
    - your_theme/asyntai-chatbot
  4. 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.

Vous ne voyez pas le widget ? Assurez-vous de vider le cache de Drupal en allant dans Configuration → Performance → Clear all caches. Essayez également de vider le cache de votre navigateur ou de consulter le site dans une fenêtre de navigation privée.