Widget chat sur votre site web

Intégrer l'assistant ReachFlow sur votre site avec un script et des origines autorisées.

5 min de lecture · Mis à jour le 25 juin 2026

Objectif

Vous créerez un widget chat, autoriserez le domaine de votre site et collerez le script d'intégration.

Ouvrir Widgets chat site web

Prérequis

Plan Pro (ou supérieur), ou add-on Agent commercial IA sur Gratuit.
Au moins un document de référence au statut Prêt — voir Documents de référence.
Des crédits assistant disponibles (icône ✨ dans le header).

Ouvrez Assistant IA & Documents, puis Widgets chat site web (ou Widgets chat site web directement).
Cliquez sur Nouveau.
Donnez un nom (usage interne, ex. « Support boutique »).
Ajoutez les origines autorisées de votre site (voir ci-dessous).
Optionnel : message d'accueil, persona, langue, documents ciblés, transfert humain (webhook et/ou email).
Enregistrez, puis copiez la clé publique et le code d'intégration.

Origines autorisées (`allowedOrigins`)

Pour des raisons de sécurité, le widget ne répond que depuis les domaines que vous avez déclarés.

Format exact : URL complète sans chemin — ex. https://www.maboutique.bj, https://app.maboutique.bj.
Format wildcard : motif https://*.votredomaine.tld pour autoriser tous les sous-domaines d'un domaine (ex. https://*.maboutique.bj couvre www, app, staging, etc.).
Chaque domaine racine distinct doit être ajouté séparément si vous n'utilisez pas de wildcard.
Si le domaine du visiteur ne correspond à aucune entrée, le widget affiche une erreur de chargement.

Astuce

Le wildcard https://*.example.com ne couvre pas le domaine nu https://example.com — ajoutez les deux si nécessaire. Testez d'abord sur un domaine de préproduction avant d'activer le widget en production.

Transfert humain (handoff)

Lorsque l'assistant ne peut pas répondre seul (demande complexe, hors périmètre), il peut déclencher un handoff : le visiteur voit un message indiquant qu'un humain reprendra la conversation.

Dans le formulaire widget, section Transfert humain (optionnel) :

Champ	Rôle
Webhook handoff	URL HTTPS appelée en POST par ReachFlow avec un résumé JSON de la session (message visiteur, contexte, horodatage). Utile pour créer un ticket CRM ou alerter Slack/Teams via votre middleware.
Email de notification	Adresse alertée par email lors d'un handoff.

Vous pouvez configurer l'un, l'autre ou les deux. Sans configuration, le visiteur voit quand même le message de handoff dans le widget, mais votre équipe n'est pas alertée automatiquement.

Information

Le webhook reçoit un corps JSON structuré (pas de données sensibles au-delà du contenu déjà échangé dans le chat). Vérifiez que l'endpoint accepte les requêtes depuis l'API ReachFlow et répond en moins de quelques secondes.

Intégration sur votre site

Collez le snippet fourni dans le dashboard avant la balise </body> sur chaque page où le chat doit apparaître :

<script
  src="https://app.reachflow.me/widget/embed.js"
  data-public-key="cw_live_xxxxxxxx"
  data-api-url="https://api.reachflow.me"
  async
></script>

Remplacez les URLs et la clé par celles affichées dans ReachFlow. Le script charge une bulle de chat : le visiteur ouvre le panneau, envoie un message et reçoit une réponse fondée sur vos documents indexés.

Information

La clé publique (cw_live_…) est visible dans le code source de votre page — c'est normal. Ne partagez jamais votre clé API secrète (paramètres API).

Crédits `WEB_CHAT`

Chaque message envoyé par un visiteur via le widget consomme 1 crédit assistant (opération WEB_CHAT), au même tarif qu'une réponse analysée dans l'inbox.

Action	Crédits
Message visiteur → réponse assistant	1
Import de document de référence	0

Si vos crédits sont épuisés, le visiteur voit un message d'indisponibilité. Rechargez ou attendez le renouvellement mensuel — voir Crédits assistant.

Dépannage rapide

Symptôme	Cause probable
« Impossible de charger le widget »	Domaine absent des origines autorisées
Pas de réponse / erreur crédits	Solde assistant insuffisant
Réponses hors sujet	Documents incomplets ou non Prêts
Handoff sans alerte équipe	Webhook ou email non configurés dans le widget

Voir aussi

Cet article vous a-t-il aidé ?