embent

Guides d'installation / HTML & sites personnalisés

Installer Embent sur tout site HTML

Une balise script, aucune étape de build, aucun framework. Si vous pouvez modifier votre HTML, c'est fait en moins d'une minute.

Avant de commencer

  • Accès en modification aux fichiers ou modèles HTML servis par votre site.

Étapes

1

Copiez votre extrait d'intégration

Dans votre tableau de bord Embent, ouvrez la vue d'ensemble de votre bot et copiez l'extrait d'intégration. Voici à quoi il ressemble :

<script src="https://api.embent.com/widget.js" data-bot="YOUR_BOT_ID" async></script>
2

Collez-la avant la balise </body> fermante

Ouvrez le fichier ou modèle qui rend chaque page — sur la plupart des sites statiques, c'est une mise en page partagée ou un include de pied de page — et collez l'extrait juste avant la balise </body> fermante.

3

Publiez vos modifications

Uploadez ou déployez le fichier modifié de la façon dont vous publiez habituellement votre site.

Vérifiez que ça fonctionne

Rechargez votre site : la bulle de chat apparaît dans le coin. Posez-lui une question sur vos propres pages, il doit répondre avec une citation.

Si ça ne fonctionne pas

Vous avez essayé et le widget ne s'affiche pas ? Ceci résout presque tous les cas.

J'ai ajouté le code d'intégration mais le widget n'apparaît pas — pas de bulle de chat, pas de lanceur, rien ne s'affiche sur mon siteQuatre vérifications résolvent presque tous les cas de « widget invisible ». D'abord, ouvrez votre site en ligne et affichez le code source de la page (clic droit → Afficher le code source de la page) et cherchez « embent » — si le script n'y est pas, le code n'a pas été enregistré sur une page publiée. Ensuite, vérifiez que l'ID data-bot de votre extrait correspond à celui affiché dans votre tableau de bord sous Paramètres. Ensuite, videz le cache de pages de votre site et tout cache CDN — une page en cache continue de servir l'ancienne version sans le widget. Enfin, vérifiez que le bot n'est pas en pause dans le tableau de bord : un bot en pause n'affiche délibérément rien aux visiteurs.
La bulle de chat apparaît mais les réponses n'arrivent jamais, ou le widget est absent et mon site définit une Content-Security-PolicyAjoutez https://api.embent.com à la fois à script-src (charge le script du widget) et à connect-src (le flux de réponse du chat se connecte à la même origine). Une entrée script-src manquante masque entièrement le widget ; une entrée connect-src manquante affiche la bulle mais aucune réponse ne s'affiche jamais.
J'utilise Cloudflare avec Rocket Loader et le widget est instable ou absentRocket Loader retarde les scripts via son propre chargeur. Le widget est conçu pour y survivre, mais s'il ne s'affiche pas, ajoutez data-cfasync="false" à la balise script Embent — l'option de désactivation officielle de Rocket Loader — et le script se charge normalement.

Questions fréquentes

Est-ce que ça fonctionne avec React, Vue, Next.js ou d'autres frameworks ?Oui. Collez l'extrait une fois dans le modèle HTML racine — index.html ou votre mise en page racine. Le widget se rend dans un Shadow DOM et reste à l'écart de votre framework ; aucun composant wrapper nécessaire.
Est-ce que ça va ralentir mon site ?Non. Le script se charge de façon asynchrone et le widget fait moins de 50 Ko gzippé sans framework propre, donc il ne bloque jamais le rendu de votre page.
Dois-je l'ajouter à chaque page ?Seulement aux modèles partagés entre les pages. Une page qui ne passe pas par la mise en page partagée a besoin que l'extrait soit ajouté séparément.
Connectez Embent à votre site dès maintenant.Un agent IA qui préfère dire « je ne sais pas » plutôt que d'inventer une réponse. Plan Free, sans carte bancaire — la plupart des sites répondent en moins de deux minutes.

La bulle de chat dans le coin, c'est Embent lui-même, en action sur cette page — posez-lui n'importe quelle question sur nous.