Widget Embedding
Ajoutez votre chatbot IA à n'importe quel site en quelques secondes grâce à notre simple code d'intégration.
Démarrage rapide
Ajoutez ce code avant la balise de fermeture </body> :
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
C'est tout ! Votre chatbot est maintenant en ligne sur votre site.
Trouver l'ID de votre chatbot
- Allez dans les paramètres de votre chatbot
- Rendez-vous dans l'onglet Intégration
- Copiez le code d'intégration (inclut votre ID)
L'ID du chatbot dans le code d'intégration n'est pas le même que le nom dans l'URL de votre tableau de bord. Copiez toujours l'ID depuis l'onglet Intégration.
Personnalisation du widget
L'apparence et le comportement du widget se configurent dans votre tableau de bord — pas dans le code d'intégration. Allez dans Dashboard → Chatbots → [votre chatbot] → Widget pour ajuster :
- Position — en bas à droite, en bas à gauche, ou inline
- Couleurs — couleurs principales, de fond et de texte, plus le rayon de bordure
- Taille — largeur et hauteur du widget
Pour ouvrir la conversation automatiquement après un délai configurable, activez Ouverture automatique dans l'onglet Comportement de la même page de paramètres. Sur les plans white-label, le branding ChatReact est masqué par défaut — le même onglet Comportement propose un interrupteur Show "Powered by ChatReact" si vous souhaitez l'afficher dans le pied de widget.
Les changements s'appliquent automatiquement à votre site — pas besoin de mettre à jour le code d'intégration. Consultez le guide Widget Customization pour toutes les options disponibles.
La langue du widget est détectée automatiquement à partir du navigateur de chaque visiteur, en fonction des langues que vous activez dans l'onglet Langues de votre chatbot.
Choisissez la position Inline pour intégrer le chat directement dans la page à l'endroit où la balise script est placée. Le widget est toujours ouvert, sans bulle ni bouton de fermeture — idéal pour les pages dédiées au chat ou les sections d'assistance.
Widget FAQ
Affichez les FAQ sous forme d'accordéon sur n'importe quelle page :
<div id="chatreact-faq"></div>
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
Le widget FAQ affiche les FAQ publiées de votre chatbot. Les couleurs et le style (couleurs principales, de fond et de texte, rayon de bordure) se configurent dans Tableau de bord → FAQ → Paramètres.
Options du widget FAQ
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primary, background and text colors, border radius | Dashboard → FAQs → Settings |
| Largeur | Choose between 100% (full width) or a custom pixel width (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Display order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop) | Dashboard → FAQs → Settings → Behavior |
| Filtre par catégorie | Show only specific categories in the widget | Embed code data-categories attribute |
| Custom Container | Render the widget inside your own element instead of the default chatreact-faq div | Embed code data-container attribute |
| Langue | Override the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language) | Embed code data-lang attribute |
| Accordion Behavior | Allow multiple FAQs open at once, or auto-expand the first FAQ | Dashboard → FAQs → Settings → Behavior |
Exemple de filtre par catégorie
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Lorsque le widget est filtré sur une seule catégorie, l'ordre propre à cette catégorie (défini dans Dashboard → FAQs → Categories) remplace le réglage global de tri.
Optimisation mobile
Le widget de chat est entièrement optimisé pour les appareils mobiles :
- Mise en page pleine largeur sur petits écrans
- Animation de glissement lors de l'ouverture
- Gestion du clavier iOS (le widget s'ajuste au clavier à l'écran)
- Prise en charge des zones sûres pour l'encoche et l'indicateur d'accueil des iPhone
- Cibles tactiles plus grandes pour une meilleure utilisabilité
- La taille de la police du champ empêche le zoom automatique sur iOS
Guides spécifiques aux plateformes
WordPress
Recommandé : Utilisez le ChatReact WordPress Plugin officiel pour l'intégration la plus simple avec les blocs Gutenberg, les widgets Elementor et les shortcodes.
Alternative : Intégration manuelle via un plugin « Header/Footer Scripts » :
- Installez n'importe quel plugin « Header/Footer Scripts »
- Ajoutez le code d'intégration dans la section footer
- Enregistrez et publiez
Shopify
Recommandé : ChatReact Shopify App
Installez l'application ChatReact depuis le Shopify App Store pour l'intégration la plus simple :
- Installez l'application ChatReact dans votre admin Shopify
- Saisissez votre Chatbot ID dans les paramètres de l'application
- Le widget de chat apparaît automatiquement sur votre vitrine
- Gérez l'affectation du widget par page, ou activez-le partout
L'application prend également en charge les widgets Form et FAQ en tant que App Blocks dans l'éditeur de thème.
Alternative : Intégration manuelle
- Allez dans Online Store → Themes → Edit Code
- Ouvrez
theme.liquid - Ajoutez le code avant
</body> - Enregistrez
Webflow
- Allez dans Project Settings → Custom Code
- Ajoutez dans Footer Code
- Publiez le site
Next.js / React
Utilisez le composant Script :
import Script from 'next/script';
export default function Layout({ children }) {
return (
<>
{children}
<Script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
strategy="lazyOnload"
/>
</>
);
}
Vue.js
Ajoutez dans votre fichier principal App.vue ou dans le layout :
<script setup>
import { onMounted } from 'vue';
onMounted(() => {
const script = document.createElement('script');
script.src = 'https://www.chatreact.ai/embed/widget.js';
script.dataset.chatbotId = 'YOUR_CHATBOT_ID';
script.async = true;
document.body.appendChild(script);
});
</script>
API JavaScript
Interagissez avec le widget de façon programmatique :
// Open the chat
ChatReact.open();
// Close the chat
ChatReact.close();
// Toggle open/closed
ChatReact.toggle();
// Start a fresh conversation
ChatReact.newChat();
// Remove the widget from the page entirely
// (useful in single-page apps, e.g. on route changes)
ChatReact.destroy();
Tests
Mode aperçu
Avant d'intégrer en production :
- Utilisez la fonctionnalité Aperçu dans votre tableau de bord
- Testez différents scénarios
- Vérifiez que les réponses sont précises
Vous testez sur un site de développement local ? Utilisez le code d'intégration standard sans modification — il fonctionne aussi sur les pages localhost.
Dépannage
Le widget n'apparaît pas
- Vérifiez la console du navigateur pour les erreurs
- Vérifiez que l'ID du chatbot est correct
- Assurez-vous que le chatbot est actif (non désactivé)
- Vérifiez si des bloqueurs de publicité interfèrent
- Vérifiez l'utilisation de votre plan — le widget se met en pause lorsque le quota mensuel de votre plan est atteint
Plugins de cache & d'optimisation
Certains plugins de cache ou d'optimisation de scripts réécrivent les URLs des scripts, ce qui peut empêcher le chargement du widget. Si cela se produit, ajoutez une URL d'API explicite à la balise script :
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-api-url="https://www.chatreact.ai"
async
></script>
Le même attribut fonctionne sur les scripts des widgets FAQ et form.
Conflits de style
Si le CSS de votre site entre en conflit :
- Le widget scope ses styles à son propre conteneur et utilise des règles de haute priorité pour résister aux conflits
- Vérifiez les valeurs de z-index des éléments qui recouvrent le widget
- Évitez les règles générales
!importantdans le CSS de votre site qui ciblent des éléments génériques
Performance
Le widget est conçu pour un impact minimal :
- Se charge de façon asynchrone — ne bloque jamais le rendu de votre page
- Léger : environ 30 KB en transfert compressé
Étapes suivantes
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — intégrez des formulaires autonomes avec le widget form