Intégration Drupal
Ajoutez un chatbot IA à votre site Drupal
Entraînez un agent sur les contenus et documents de votre site Drupal, puis chargez-le sur chaque page via une bibliothèque de votre thème. Aucun module à installer, et vous pouvez tester l'agent avant la mise en ligne.
Dernière mise à jour:
Comment intoCHAT fonctionne sur Drupal
Drupal charge le JavaScript via des bibliothèques d'assets déclarées par votre thème. intoCHAT s'inscrit dans ce modèle : une bibliothèque qui pointe vers un script externe ajoute une bulle de chat dans le coin de chaque page affichée par le thème. L'agent répond à partir de ce que vous lui fournissez, comme vos pages publiées, vos PDF et vos questions-réponses, et le dit quand il ne sait pas. Les couleurs, la position et le message d'accueil se gèrent dans intoCHAT : la modification du thème ne se fait qu'une fois.
Installer intoCHAT sur Drupal
Créez et entraînez votre agent
Inscrivez-vous sur intoCHAT, créez un agent et saisissez l'adresse de votre site Drupal dans l'onglet Knowledge. intoCHAT trouve vos pages via le sitemap et les liens, et vous pouvez exclure des chemins comme /user avec des motifs.
Copiez l'identifiant de l'agent
Ouvrez l'onglet Share et copiez l'identifiant de l'agent dans le code sous Bubble Chat. La bibliothèque n'a besoin que de cet identifiant.
Déclarez la bibliothèque
Dans votre propre thème ou sous-thème, ajoutez une entrée chat_widget à THEME.libraries.yml qui charge le script comme fichier externe avec l'attribut data-chatbot-id, comme ci-dessous.
Attachez-la à chaque page
Ajoutez THEME/chat_widget à la liste libraries de THEME.info.yml. Drupal charge le JavaScript des bibliothèques dans le pied de page par défaut, et c'est là que le script doit s'exécuter.
Videz les caches et vérifiez
Videz tous les caches dans Configuration > Development > Performance, ou lancez drush cr. Rechargez votre site : la bulle de chat apparaît dans le coin inférieur, avec les couleurs et la position de l'onglet Appearance.
La définition de la bibliothèque
# THEME.libraries.yml
chat_widget:
js:
https://www.intochat.ai/api/embed.js:
type: external
attributes:
data-chatbot-id: 'YOUR_AGENT_ID'
# THEME.info.yml : à ajouter à la liste libraries existante
libraries:
- THEME/chat_widgetRemplacez THEME par le nom machine de votre thème. N'ajoutez pas header: true : le script ajoute la bulle de chat au body de la page dès qu'il s'exécute, il doit donc se charger dans le pied de page. Drupal écrit data-chatbot-id sur la balise script, là où le script lit l'identifiant de votre agent.
Ce que fait l'agent sur votre site Drupal
Apprend de vos pages Drupal
Collez l'adresse de votre site et intoCHAT trouve jusqu'à 500 pages via le sitemap et les liens. Excluez des chemins avec des motifs pour laisser de côté les pages d'administration, de connexion ou de recherche.
Lit les fichiers que vous publiez
Importez les PDF, fichiers Word et tableurs vers lesquels pointe votre site, ou ajoutez des textes et des questions-réponses. Les réponses des questions-réponses passent avant les autres sources.
Met en avant les sources clés
Ajoutez une étoile à une source, comme votre FAQ ou votre page de tarifs, pour qu'elle pèse davantage dans les réponses. Sans réentraînement.
Appelle vos endpoints
Les actions API personnalisées permettent à l'agent d'appeler un endpoint HTTP pendant le chat, par exemple une route REST ou JSON:API que vous exposez. Vous choisissez l'authentification et les champs de la réponse que voit le modèle.
Collecte des leads dans le chat
Un court formulaire dans la conversation demande un e-mail ou un numéro de téléphone, selon les règles que vous fixez. Chaque nouveau lead vous est envoyé par e-mail, ainsi qu'à cinq collègues au maximum.
Répond dans la langue du visiteur
L'agent répond dans la langue dans laquelle le visiteur écrit, ce qui convient bien aux sites Drupal multilingues.
Questions fréquentes
Existe-t-il un module intoCHAT pour Drupal ?
Non. intoCHAT se charge via une bibliothèque de votre thème, ce qui demande quelques lignes de YAML et aucun module contribué. Utilisez votre propre thème ou un sous-thème, pour que les mises à jour d'un thème contribué n'écrasent pas la modification.
Pourquoi la bibliothèque doit-elle se charger dans le pied de page ?
Le script ajoute la bulle de chat au body de la page dès qu'il s'exécute : le body doit donc déjà exister. Drupal charge le JavaScript des bibliothèques dans le pied de page par défaut, et seul header: true le déplacerait dans le head, alors n'utilisez pas ce réglage.
intoCHAT ralentit-il mon site Drupal ?
Le script est un fichier externe unique que Drupal place à la fin de la page, après votre contenu. La fenêtre de chat tourne dans son propre iframe servi par intoCHAT : son code reste séparé du JavaScript de Drupal.
Mon site envoie une Content Security Policy. Que dois-je autoriser ?
Autorisez www.intochat.ai pour script-src, connect-src et frame-src. Le script se charge depuis cet hôte, y récupère les réglages de votre agent et ouvre le chat dans un iframe servi par ce même hôte.
Pourquoi la bulle de chat n'apparaît-elle pas après l'ajout de la bibliothèque ?
Videz d'abord tous les caches, car Drupal met en cache les définitions de bibliothèques et les informations du thème. Vérifiez ensuite que la bibliothèque figure dans le fichier info du thème front-end actif et que l'identifiant de l'agent correspond à celui de l'onglet Share.
Dois-je modifier le thème quand je change l'agent ?
Non. La bibliothèque ne contient que l'identifiant de votre agent. Les couleurs, la position, le message d'accueil, les questions suggérées et les connaissances sont chargés depuis intoCHAT à chaque ouverture de page : vos modifications apparaissent sans nouveau déploiement.
Voyez-le répondre à partir de votre site
Collez l’adresse de votre site et discutez avec un agent créé à partir de vos pages. Cela prend environ une minute.
Créer votre agent gratuitementOffre gratuite, sans carte bancaire.