Utilisez cet article pour configurer, paramétrer et gérer les connecteurs de données — la fonctionnalité qui permet à Fin de récupérer des données en temps réel depuis vos systèmes externes et de fournir aux clients des réponses personnalisées sans attendre un collègue. Vous apprendrez à créer un connecteur à partir d'un modèle ou de zéro, configurer son point de terminaison API, façonner la réponse, contrôler qui peut le déclencher, gérer la sécurité, le déployer en toute sécurité et surveiller ses performances.

Chaque connecteur de données consiste en un appel API (interface de programmation d'application) que vous configurez. Fin détermine automatiquement quand l'utiliser pour fournir des réponses spécifiques au client. Vous pouvez connecter n'importe quel système avec une API, y compris :

Accédez à Paramètres > Intégrations > Connecteurs de données et cliquez sur Nouveau.

Si vous avez l'une des applications prises en charge installée, vous verrez un modèle pour cette application listé sous Créer un connecteur de données. Des modèles sont actuellement disponibles pour Shopify, Stripe et Statuspage — voir À partir d'un modèle tiers ci-dessous pour plus de détails.

Des modèles de connecteurs de données sont disponibles lorsque les applications suivantes sont installées dans votre espace de travail :

Si l'application n'est pas encore installée, rendez-vous sur l'App Store pour l'installer. Une fois l'application installée, les modèles de connecteurs de données pour chaque application apparaîtront comme un connecteur de données prêt à être mis en ligne.

Lorsque vous cliquez sur un modèle, vous verrez des informations sur ce que fait le connecteur de données et vous pouvez le tester dans l'aperçu Messenger. Si vous êtes satisfait du comportement du connecteur de données, sélectionnez simplement Mettre en ligne pour AI Agent.

L'aperçu Messenger ici utilise des données d'exemple. Lors de la mise en ligne du connecteur de données, Fin utilisera vos données clients réelles.

Si vous souhaitez configurer le connecteur de données, vous pouvez cliquer sur Personnaliser, ce qui vous mènera au générateur de connecteurs de données pour une configuration avancée.

Si vous n'avez pas l'une de nos applications prises en charge installée, les applications apparaîtront ici pour que vous puissiez les installer dans votre espace de travail. Après l'installation, les modèles de connecteurs de données pertinents apparaîtront dans la section ci-dessus.

Pour voir les connecteurs de données recommandés par AI, allez dans Paramètres > Intégrations > Connecteurs de données et cliquez sur Nouveau connecteur de données.

Vous verrez vos connecteurs de données recommandés par AI uniques sous "Créer un connecteur de données à partir d'un modèle". Ceux-ci sont générés en fonction de votre historique de conversation pour vous aider à identifier les connecteurs de données potentiels, voir quel pourcentage du volume de conversation ils pourraient résoudre, et les prévisualiser dans Messenger, avant toute configuration.

Pour que les recommandations AI apparaissent, Fin doit être en ligne sur votre espace de travail et vous devez avoir un volume de conversation suffisant.

Lorsque vous cliquez sur un connecteur de données recommandé par AI, vous trouverez des informations sur ce que fait le connecteur de données et vous pouvez le prévisualiser dans Messenger (en utilisant des données d'exemple). Les connecteurs de données recommandés par AI ne sont que des suggestions basées sur votre volume de conversation, mais ils nécessitent une API à connecter manuellement pour fonctionner.

Pour mettre le connecteur de données en ligne, cliquez sur Configurer pour paramétrer les détails de l'API.

Il ne vous reste plus qu'à connecter le connecteur de données à votre API en ajoutant l'URL HTTPS.

Pour personnaliser davantage ce connecteur de données, consultez la section À partir d'un connecteur de données personnalisé.

Pour configurer votre propre connecteur de données personnalisé pour Fin, accédez à Paramètres > Intégrations > Connecteurs de données et cliquez sur + Nouveau > + Créer à partir de zéro.

L'onglet API définit comment Intercom communique avec votre système externe.

Donnez à votre connecteur un nom court et descriptif — par exemple, "Obtenir le solde de compte impayé." Cela aide Fin à comprendre quand l'utiliser. Ajoutez une description interne pour référence de votre équipe.

Les entrées de données vous permettent de spécifier quelles informations Fin doit collecter avant que le connecteur ne s'exécute — par exemple, le numéro de compte d'un client s'il n'est pas déjà stocké dans Intercom.

Cliquez sur + Entrée de données et choisissez un format :

Donnez un nom et une description à chaque entrée afin que Fin sache comment la collecter. Vous pouvez également définir une valeur de secours pour les cas où l'API renvoie une réponse nulle ou manquante.

Pour chaque entrée, choisissez la provenance des données :

Ajoutez l'URL HTTPS (web sécurisé) de votre API endpoint et sélectionnez la méthode de requête HTTP : GET (récupérer des données), POST (envoyer des données), PUT (remplacer des données), DELETE (supprimer des données) ou PATCH (mettre à jour partiellement des données).

Utilisez l'Attribute Inserter pour passer des valeurs dynamiques — comme l'ID utilisateur d'un client — directement dans le chemin URL ou le corps de la requête.

Sélectionnez un jeton d'authentification et ajoutez toutes les paires clé-valeur personnalisées que votre API requiert (par exemple, Content-Type: application/json).

Une fois l'URL de l'endpoint et les détails d'authentification complétés, cliquez sur Test connection pour valider votre configuration. Un test réussi affiche une confirmation verte et la réponse brute de l'API. Un test échoué affiche le code d'erreur HTTP et une description — corrigez les erreurs avant de passer à la Phase 2 : Data.

L'onglet Data contrôle comment la réponse API est filtrée et transformée avant que Fin ne l'utilise pour répondre aux clients. Vous pouvez restreindre les champs visibles par Fin et remodeler les données à l'aide d'un éditeur visuel ou de code Python.

Par défaut, Fin a accès à la réponse complète de l'API. Pour limiter ce que Fin peut lire, passez à Restreindre l'accès manuellement et sélectionnez uniquement les champs que vous souhaitez exposer.

Choisissez comment vous souhaitez transformer la réponse :

Le mappage d'objet vous permet d'associer directement les champs de réponse API aux attributs contact ou entreprise d'Intercom, synchronisant automatiquement les données de votre système externe vers votre espace de travail Intercom.

Cliquez sur Test code pour valider votre logique de transformation Python, et sur Test connection pour confirmer l'appel complet de l'API et la forme de la réponse. Corrigez les erreurs avant de passer à la Phase 3 : Fin.

L'onglet Fin contrôle si Fin déclenche le connecteur Data automatiquement ou seulement lorsqu'il est explicitement appelé depuis un workflow, une procédure ou un macro. Choisissez le mode de déclenchement qui correspond à la sensibilité ou à l'activité en écriture du connecteur.

Fin déclenche le connecteur automatiquement en fonction de la question du client — aucun workflow requis. Idéal pour les connecteurs en lecture seule comme « Vérifier le statut de la commande » et les requêtes répétitives à fort volume.

Vous pouvez contrôler à qui ce connecteur Data est disponible avec des audiences Fin réutilisables, ou en créant une audience personnalisée spécifiquement pour ce connecteur. Par exemple, vous pouvez le rendre disponible aux clients de votre audience « Enterprise plan », ou le restreindre à une audience personnalisée comme les users connectés avec un email vérifié qui posent des questions sur leur solde de compte.

Le connecteur ne s'exécutera pas automatiquement. Vous devrez l'ajouter manuellement à un Workflow, une procédure ou un Macro. Idéal pour les connecteurs sensibles ou actifs en écriture — comme « Supprimer un compte » — où vous souhaitez une supervision humaine ou via workflow avant toute exécution.

Utilisez l'aperçu Fin pour voir exactement comment Fin répondra en utilisant ce connecteur avant de le mettre en production.

L'onglet Sécurité est la dernière étape avant la mise en production. Il contrôle si les clients doivent être authentifiés avant que le connecteur Data puisse accéder ou afficher leurs données.

Activez cette option pour appliquer les règles d'authentification de votre espace de travail avant que le connecteur puisse accéder ou afficher des informations sensibles. Les règles d'authentification sont configurées dans Paramètres > Espace de travail > Sécurité > Authentification client.

Exécutez un diagnostic pour évaluer la santé et la sécurité de votre configuration API. Tous les risques sont identifiés avec des recommandations exploitables — résolvez-les avant de mettre le connecteur en production.

Une fois tous les contrôles de sécurité réussis, cliquez sur Enregistrer puis sur Mettre en service. Le statut du Data connector passe à En service dans Paramètres > Intégrations > Data connectors. Fin commencera à l’utiliser immédiatement pour les conversations correspondant à l’audience configurée.

Nous recommandons d’utiliser les règles d’audience pour déployer les Data connectors par phases auprès de votre base client. Cela vous permet de valider la performance du Data connector et d’apporter des ajustements si nécessaire.

Pour trouver les Data connectors existants, allez dans Paramètres > Intégrations > Data connectors. La liste des Data connectors affiche les détails suivants pour chaque connecteur :

Cliquez sur une ligne de connecteur pour ouvrir son tableau de bord de santé, où vous pouvez consulter l’utilisation, les métriques de performance et les journaux d’exécution, ou ouvrir l’éditeur de configuration pour effectuer des modifications.

Pour voir l’activité d’un Data connector pour une conversation spécifique, ouvrez la conversation dans l’Inbox et sélectionnez Afficher les événements de la conversation. Le panneau des événements montre si Fin avait accès au Data connector et s’il a été déclenché avec succès.

Les vues Inbox peuvent être créées avec l’attribut « Fin AI Agent : Action utilisée en réponse ». Cet attribut est défini si Fin appelle un Data connector et utilise une partie ou la totalité de la réponse dans une réponse.

Les Data connectors utilisent un système de version brouillon/en service pour que vous puissiez faire des modifications en toute sécurité sans interrompre le connecteur en cours d’exécution.

Deux APIs publiques (interfaces de programmation d’applications) vous donnent un accès programmatique aux configurations et résultats d’exécution des Data connectors. Les deux utilisent OAuth (Open Authorization) pour l’authentification. La documentation complète est disponible dans le Intercom Developer Hub.

La Configuration API est un ensemble de points de terminaison CRUD (créer, lire, mettre à jour, supprimer) pour gérer programmétiquement les Data connectors. Utilisez-la pour créer de nouveaux connecteurs, synchroniser les connecteurs avec vos systèmes internes et automatiser la gestion des connecteurs à grande échelle. Le tableau ci-dessous liste les points de terminaison disponibles et leur but.

L'authentification utilise OAuth (Open Authorization). L'accès en lecture et écriture nécessite la portée read_write_data_connectors. L'accès en lecture seule nécessite la portée read_workflow_connector_execution_result.

L'API Results vous donne un accès programmatique aux données d'exécution pour chaque Data connector. Utilisez-la pour créer des tableaux de bord personnalisés, alimenter des systèmes d'alerte ou effectuer une analyse plus approfondie que le tableau de bord de santé intégré.

Les options de filtrage incluent le statut de succès, des types d'erreurs spécifiques et des plages horaires spécifiées en timestamps Unix (secondes écoulées depuis le 1er janvier 1970 UTC). La pagination utilise un modèle basé sur un curseur, retournant jusqu'à 30 résultats par page. L'authentification utilise OAuth avec la portée read_workflow_connector_execution_result.

Les limitations suivantes s'appliquent aux Data connectors. Lorsqu'une solution de contournement est disponible, elle est indiquée ci-dessous.

Toutes les données de réponse des Data connectors déclenchés par Fin sont enregistrées et stockées pendant 14 jours maximum. Pour accéder aux journaux, allez dans Paramètres > Intégrations > Data connectors, cliquez sur le connecteur que vous souhaitez examiner, puis sélectionnez Journaux.

Pour des signaux en temps réel sur les taux de succès et d'échec des Data connectors, utilisez le webhook d'exécution du Data connector. Cela vous permet de recevoir des événements d'exécution d'Intercom et de les utiliser pour créer des tableaux de bord en temps réel, des alertes et une surveillance SLA dans vos services externes.