Les Data connectors permettent à Fin d'accéder aux données en temps réel de vos systèmes externes en pleine conversation, comme les détails de commande, le statut du compte et les informations d'abonnement, sans qu'un humain ait besoin de chercher. Cet article est votre table des matières pour le processus complet de configuration. Suivez les sections dans l'ordre si vous commencez de zéro, ou passez à un sujet spécifique si vous avez besoin d'une remise à niveau.
Avant de commencer
Lisez d'abord l'aperçu conceptuel. Il explique ce que sont les data connectors et les objets personnalisés, comment ils sont liés, et quand vous avez besoin de l'un ou de l'autre :
Data connectors and Custom Objects explained — couvre les concepts de base, la relation entre les connecteurs et les objets personnalisés, et la différence entre Fin connectors et Workflow connectors.
Étape 1 : Concevez les API et configurez votre connecteur
Commencez par concevoir vos API puis créez le Data connector et définissez comment il appelle votre API.
Designing and using your APIs with Data connectors — explique comment structurer vos points de terminaison API pour bien fonctionner avec Fin data connectors, avant de commencer la configuration du connecteur.
How to set up Data connectors — couvre en détail les quatre phases de configuration, y compris l'API (entrées de données et points de terminaison API), les données (mise en forme de la réponse API), Fin (comment Fin déclenche le connecteur) et la sécurité (contrôle d'accès et mise en production).
Use Data connector templates — démarrez rapidement à partir d'un modèle de data connector utilisant des applications tierces installées sur votre espace de travail.
Étape 2 : Authentification et sécurité
Avant la mise en production, configurez comment votre connecteur s'authentifie avec votre API externe et si les clients doivent être vérifiés avant que les données ne leur soient exposées.
Setting up Data connectors authentication — couvre les types de jetons d'authentification (texte, OAuth, JWT), la page des Credentials, et comment activer l'authentification client sur chaque connecteur.
Secure Data connectors with One-Time Passcode — impose la vérification OTP avant que Fin n'expose les données client.
Best practices when using Data connectors with Fin — couvre les contrôles de sécurité intégrés dans l'onglet Security, les risques courants et les recommandations avant la mise en production.
Important : Si vous n'imposez pas l'authentification client, des acteurs malveillants pourraient usurper vos users et accéder à leurs données. Au minimum, vérifiez les contrôles intégrés de l'onglet Security avant de mettre un connecteur en production.
Étape 3 : Schémas de réponse, objets et tableaux
La structure de la réponse de votre API détermine comment Fin lit et utilise les données retournées. Cette section explique comment gérer différentes structures de réponse.
JSON objects and arrays supported for Data connectors response mapping — couvre les objets plats, objets imbriqués, tableaux et réponses XML (converties automatiquement en JSON). Lisez ceci si votre API renvoie des données complexes ou imbriquées.
Étape 4 : Objets personnalisés et propriétés
Les objets personnalisés vous permettent de stocker des données structurées à plusieurs propriétés dans Intercom, comme les commandes, abonnements ou rendez-vous, qui ne sont pas capturés par les attributs standard de contact ou de conversation. Vous les remplissez généralement en mappant les données de réponse d'un connecteur à l'objet.
Setting up a Custom Object — couvre la création de types d'objets, la définition des propriétés, le remplissage de l'objet via un data connector, et la configuration des références aux objets People et Conversation.
Étape 5 : Mappages d'objets
Le mappage d'objets indique au connecteur où stocker les données de réponse API dans Intercom. Vous pouvez mapper vers des objets standard (attributs de contact et de conversation) ou des objets personnalisés.
Setting up references with Custom Objects — explique comment mapper directement les champs de réponse API aux attributs de contact ou d'entreprise Intercom, synchronisant automatiquement les données de votre système externe vers votre espace de travail Intercom.
How to set up Data connectors for Workflows and Inbox — contient des détails supplémentaires sur le mappage vers des objets personnalisés, y compris l'exigence external_id.
Étape 6 : Tests
Chaque connecteur dispose d'un outil de test intégré qui vous permet de valider l'appel API et la structure de la réponse avant la mise en production. Utilisez le bouton Test connection dans l'onglet Data du connecteur pour confirmer la requête et la réponse complètes. Pour un test de bout en bout de la façon dont Fin utilise le connecteur dans une conversation, utilisez les règles d'audience pour cibler le connecteur sur votre propre email utilisateur.
How to roll out Data connectors safely — explique comment surveiller et gérer vos data connectors, et voir l'activité des data connectors dans l'inbox.
Étape 7 : Utilisation des data connectors dans les procédures Fin
Fin peut appeler un Data connector directement pour répondre à une question client, mais les connecteurs sont aussi un élément clé pour des procédures plus complexes à plusieurs étapes — par exemple, rechercher une commande, proposer de la mettre à jour, puis confirmer le changement.
How to use Data connectors in Fin Procedures — vous apprend comment Fin peut lire et agir sur les données API externes et effectuer des actions automatisées pendant les conversations clients.
Dépannage et FAQ
Si votre connecteur ne fonctionne pas comme prévu, commencez par l'article de dépannage. Pour les questions de sécurité et de confidentialité, l'article FAQ couvre les préoccupations les plus courantes.
Understanding Data connector errors — vous apprend à lire et interpréter les journaux des data connectors, identifier la cause des erreurs de connecteur, et prendre les mesures appropriées pour les résoudre.
Troubleshooting Fin Procedures and Data connectors — couvre les pannes les plus courantes, y compris les connecteurs qui passent les tests mais échouent en procédure live, erreurs d'entrée et problèmes d'analyse de réponse.
Data connectors FAQs — couvre la confidentialité des données, la sécurité, les risques d'usurpation et autres questions fréquentes.
Référence rapide : tous les articles sur les Data connectors
Utilisez ce tableau pour accéder directement à n'importe quel article de la documentation des Data connectors.
Article | Ce qu'il couvre |
Concepts de base et quand utiliser chacun | |
Structuration de vos points de terminaison API pour bien fonctionner avec Fin | |
Guide principal de configuration des connecteurs, couvre en détail les quatre phases de configuration | |
Modèles de démarrage rapide utilisant des applications tierces | |
Jetons d'authentification, credentials, authentification client | |
Contrôles de sécurité, meilleures pratiques avant la mise en production | |
Schémas de réponse, objets imbriqués, tableaux, XML | |
Types d'objets personnalisés, propriétés, remplissage via connecteur | |
Mappage des réponses API aux attributs Intercom | |
Utilisation de Fin et indicateurs de santé | |
Cas d'utilisation et exemples de Data connectors | |
Permet à Fin de lire et d'agir sur les données API externes | |
Cas d'utilisation Workflow/Inbox, détails du mappage d'objets | |
Journaux et erreurs des data connectors | |
Pannes courantes et solutions | |
Confidentialité, sécurité et questions fréquentes |