Intégration : référence technique pour les développeurs

Cette référence s’adresse aux développeurs qui intègrent reactive.chat à un site, une application ou un backend. Elle décrit les interfaces et les flux tels qu’ils sont implémentés dans le code, avec leurs noms, types, valeurs par défaut et cas d’erreur.

La configuration de l’apparence, des textes, de l’écran d’accueil, des règles, des visites guidées, des tests A/B et de la personnalité de l’IA est décrite dans Personnalisation. L’utilisation du compte et de l’espace agents est décrite dans le Manuel.

Vue d’ensemble

Your visitors' browser                      reactive.chat                         your server
----------------------                      -------------                         -----------
loader.js  --(trigger)-->   core.<hash>.js  cdn.reactive.chat
   window.ReactiveChat (API, events)
   WebSocket rc.v1  <------------------->   ws.reactive.chat/rc_wss/
   HTTP fallback (SSE/Poll) <----------->   ws.reactive.chat/rc_wss/h/
                                            chat server  --- POST (signed) ---->  customer data endpoint
                                                         --- POST (signed) ---->  webhook receiver
                                            reactive.chat/v1  <--- Bearer -----  REST API / MCP
identify(userHash)  <-------------------------------------- HMAC-SHA256 ------  identity secret

Côté client, vous intégrez une balise script et pouvez contrôler le widget via window.ReactiveChat. Côté serveur, vous signez l’identité des utilisateurs connectés, répondez si nécessaire aux demandes de données clients, recevez des webhooks et utilisez l’API REST.

Chapitres

Bases

• Architecture et fonctionnement – les composants, leurs interactions, les versions et la distribution
• Démarrage rapide – intégration, saisie du domaine, CSP, vérification

Dans le navigateur

• Référence de la balise script – tous les attributs data-rc-* et les sources de configuration
• API JavaScript – toutes les commandes de ReactiveChat(…)
• Événements – on/off et événements DOM
• Identifier les visiteurs et transmettre du contexte – identify, userHash, exp, track
• Applications monopages et changements de page
• Sécurité et Content Security Policy

Connexion et distribution

• Domaine personnalisé et proxy de première partie – nginx, Apache, Caddy
• Transport : WebSocket, repli HTTP, reconnexion – protocole, codes d’erreur et de fermeture

Sur votre serveur

• Point de terminaison des données clients – récupération et import des commandes
• Webhooks – événements, signature, nouvelles tentatives, hooks REST
• API serveur (REST v1) et MCP
• Intégrations et canaux – WhatsApp, Messenger, Instagram, Telegram, SMS, e-mail

Autres possibilités d’intégration

• Applications mobiles – le chat dans une WebView
• Smart Answer – réponse IA dans la recherche de votre site

Exploitation

• Intégration de la confidentialité – consentement, stockage, texte de confidentialité
• Limites et quotas
• Dépannage et liste de vérification

Autres pages sur le sujet

• Intégrer le widget – la version courte
• Détails techniques – mesures de taille, d’accessibilité et de contraste
• Ouvrir le chat depuis votre propre lien ou bouton
• La carte promotionnelle dans le chat
• Données clients dans le chat
• Domaine personnalisé (première partie)
• Repli HTTP
• Intégrer automatiquement le texte de confidentialité

Terminologie

• Clé de site – la clé publique d’un projet (24 caractères), incluse dans le code d’intégration. Ce n’est pas un secret.
• Projet – un site ou une application avec ses propres réglages ; plusieurs projets forment un espace de travail.
• Espace agents – l’interface dans laquelle votre équipe répond.
• Utilisateur confirmé – un visiteur dont votre serveur a signé l’identité via userHash.
• Chargeur / noyau – la petite partie de chargement loader.js et la partie principale core.<hash>.js chargée ensuite.

Toutes les parties de la documentation en un coup d’œil : Documentation.