AccueilDocumentation

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

  1. Allez dans les paramètres de votre chatbot
  2. Rendez-vous dans l'onglet Intégration
  3. 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

SettingDescriptionWhere to Configure
Colors & StylingPrimary, background and text colors, border radiusDashboard → FAQs → Settings
LargeurChoose between 100% (full width) or a custom pixel width (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderDisplay order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop)Dashboard → FAQs → Settings → Behavior
Filtre par catégorieShow only specific categories in the widgetEmbed code data-categories attribute
Custom ContainerRender the widget inside your own element instead of the default chatreact-faq divEmbed code data-container attribute
LangueOverride the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language)Embed code data-lang attribute
Accordion BehaviorAllow multiple FAQs open at once, or auto-expand the first FAQDashboard → 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 » :

  1. Installez n'importe quel plugin « Header/Footer Scripts »
  2. Ajoutez le code d'intégration dans la section footer
  3. Enregistrez et publiez

Shopify

Recommandé : ChatReact Shopify App

Installez l'application ChatReact depuis le Shopify App Store pour l'intégration la plus simple :

  1. Installez l'application ChatReact dans votre admin Shopify
  2. Saisissez votre Chatbot ID dans les paramètres de l'application
  3. Le widget de chat apparaît automatiquement sur votre vitrine
  4. 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

  1. Allez dans Online Store → Themes → Edit Code
  2. Ouvrez theme.liquid
  3. Ajoutez le code avant </body>
  4. Enregistrez

Webflow

  1. Allez dans Project Settings → Custom Code
  2. Ajoutez dans Footer Code
  3. 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 :

  1. Utilisez la fonctionnalité Aperçu dans votre tableau de bord
  2. Testez différents scénarios
  3. 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

  1. Vérifiez la console du navigateur pour les erreurs
  2. Vérifiez que l'ID du chatbot est correct
  3. Assurez-vous que le chatbot est actif (non désactivé)
  4. Vérifiez si des bloqueurs de publicité interfèrent
  5. 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 !important dans 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