Intégrations, migration et clés d’API

Sous Intégrations (/app/integrations), connectez reactive.chat aux outils que votre équipe utilise déjà. Les intégrations s’appliquent à tout l’espace de travail. Les propriétaires et les administrateurs peuvent les configurer, mais pas un administrateur dont l’accès est limité à certains projets.

Cette page explique ce que les intégrations vous apportent et comment les utiliser. Les détails techniques, par exemple la signature des webhooks, figurent dans la partie Intégration technique.

Le point sur l’état actuel

Des connexions à plus de 30 services sont disponibles. La plupart ont été testées avec des services simulés, mais n’ont pas encore été exécutées avec le service réel. La page des intégrations les signale par « Non vérifiée avec le service réel » ; certaines portent la mention « En cours ». Les webhooks et Slack ne portent pas cette mention. Configurez une intégration non vérifiée, testez-la avec des données réelles et signalez tout problème avec Donner un avis.

Configurer une intégration

1. Ouvrez Intégrations. En haut figurent le nombre d’intégrations connectées, en erreur ou en pause, ainsi que les éventuels échecs de livraison.
2. Recherchez dans le catalogue (Rechercher des intégrations, filtre « Toutes » ou « Non connectées ») et cliquez sur Configurer.
3. Saisissez les identifiants demandés par le service, généralement une clé d’API ou un jeton provenant de votre compte sur ce service.
4. Connecter et activer vérifie immédiatement la connexion et active l’intégration. Enregistrer sans activer permet de le faire plus tard.

Vous pouvez ensuite Modifier, Mettre en pause, Réactiver ou Supprimer une intégration. La suppression efface les identifiants enregistrés et ne peut pas être annulée. Les identifiants sont stockés sous forme chiffrée.

Seul Google Drive dispose d’un bouton pour se connecter au service. Pour tous les autres, saisissez vous-même les identifiants : pour Slack, par exemple, ceux de votre propre application Slack.

Quand un service ne répond pas

Chaque intégration passe par une file d’attente. Si un service ne répond pas, la livraison est retentée plusieurs fois, à intervalles croissants. Après des échecs répétés, elle est suspendue pendant un moment (« Suspension temporaire : le service n’a pas répondu à plusieurs reprises … »). Un événement non livré après environ une heure est abandonné. La section Livraisons échouées affiche les échecs les plus récents, sans leur contenu.

Un message de chat n’attend jamais une intégration. Si un service se bloque, le chat continue de fonctionner normalement.

Ce qui est disponible

Notifications à votre équipe

• Slack – chaque nouvelle conversation apparaît comme un fil dans un canal. Vous répondez dans le fil et le visiteur voit votre réponse dans le chat. /rc affiche l’état. Vous associez les utilisateurs Slack aux agents.
• Microsoft Teams, Discord – notifications via une adresse de webhook.
• Telegram – notifications dans un chat via un jeton de bot et un identifiant de chat.
• E-mail – notifications dans une boîte e-mail d’équipe.

Automatisation

• Webhooks – reactive.chat envoie des événements signés à l’adresse https:// de votre choix : nouvelle conversation, chaque message, demande de transfert à une personne, évaluation, nouvelle erreur. Zapier, Make et n8n se connectent aussi de cette façon. Vous pouvez afficher, copier et régénérer le Secret de signature ; un nouveau secret s’applique immédiatement et l’ancien cesse d’être valide.
• Zapier – via les REST hooks de l’interface. Il n’existe pas encore d’application prête à l’emploi pour Make et n8n ; utilisez les webhooks pour ces services.

Contexte dans l’espace agents

Ces intégrations affichent dans la colonne de contexte de l’espace agents des cartes concernant le visiteur, par exemple ses commandes ou sa fiche CRM. Certaines proposent des actions :

• CRM – HubSpot, Pipedrive
• Boutique – Shopify, Shopware 6, WooCommerce
• Paiements – Stripe (avec une clé de lecture restreinte)
• Site web – WordPress
• Analyse – Matomo, Plausible, Google Analytics 4
• Erreurs – Sentry

La carte signale les informations qui reposent sur une déclaration non signée du visiteur. Vous effectuez les actions avec Exécuter, puis une confirmation.

Tickets, rendez-vous, téléphone

• Zendesk, Freshdesk, Jira, Linear, GitHub – créer des tickets ou des tâches à partir d’une conversation ou d’un cas d’erreur.
• Cal.com – afficher et réserver les rendez-vous disponibles, y compris par l’assistant IA.
• Twilio – SMS depuis l’espace agents et voie d’envoi pour le canal SMS.

Sources de connaissances

• Notion, Confluence – intégrer des contenus à la base de connaissances.
• Google Drive – sous la base de connaissances, « Fichiers et Google Drive » (voir Base de connaissances et centre d’aide).
• KB-Crawler – réglages de l’exploration de votre site.

Canaux

• WhatsApp Business, Facebook Messenger, Instagram Direct – voir Canaux.

Migrer depuis un autre fournisseur

Sous Migration (/app/migration), reprenez les données d’un autre outil de chat :

• Intercom et Crisp – via leur interface ou un fichier d’export ; pour Crisp, aussi les articles d’aide au format Markdown,
• Tidio – via un fichier d’export,
• Zendesk – via l’export JSON complet et l’export du centre d’aide.

Procédure :

1. Démarrer une nouvelle migration et choisir la destination (Dans quel projet ?).
2. Se connecter et voir ce qu’il y a – vous voyez les données disponibles et un échantillon.
3. Que faut-il reprendre ? – contacts, conversations, articles.
4. Démarrer la migration. Vous pouvez Arrêter ou Abandonner la tâche.

À savoir :

• Les conversations importées arrivent fermées dans l’espace agents.
• Les contacts importés sont considérés comme non vérifiés.
• Les données sensibles des textes sont masquées.
• Les pièces jointes sont reprises sous forme de lien, pas de fichier.
• Un second passage ne crée aucun doublon.
• Vos identifiants de l’ancien fournisseur sont supprimés après le passage.
• Les interfaces des fournisseurs ont été testées sans comptes réels chez eux ; les imports de fichiers ont été testés de bout en bout avec des fichiers d’exemple.

Avec Remplacer le code, le compte convertit un code Intercom ou Crisp existant en code reactive.chat. Les commandes JavaScript boot, open, identify et track conservent les mêmes noms que dans Intercom.

Clés d’API

Sous Clés d’API (/app/api-keys, propriétaires et administrateurs), créez des clés pour l’interface REST. Une clé est affichée une seule fois ; ensuite, reactive.chat n’en conserve qu’une empreinte. Copiez-la donc immédiatement dans un endroit sûr.

À la création, choisissez les opérations autorisées :

• lecture seule
• lecture et écriture
• import de données clients uniquement – pour l’import décrit dans Données clients dans le chat
• lecture + données visiteurs ou lecture, écriture + données visiteurs – seules ces portées donnent accès au nom, à l’e-mail et au téléphone des visiteurs

La liste affiche le nom, le préfixe, la date et l’auteur de création de la clé, ainsi que sa dernière utilisation. Révoquer prend effet immédiatement et ne peut pas être annulé.

Une clé permet aussi de connecter reactive.chat à des outils IA compatibles avec le Model Context Protocol (MCP). La page donne des exemples. Le fonctionnement de l’interface est décrit dans la partie Intégration technique.