Les Data connectors sont des intégrations sans code et profondément intégrées qui peuvent connecter vos données externes en temps réel avec Intercom. Ces données en direct peuvent être utilisées pour alimenter Fin, Workflows et Inbox, permettant à vos clients de répondre automatiquement à leurs demandes.

Une excellente façon de commencer est de penser aux questions courantes auxquelles vos collègues passent beaucoup de temps à répondre, en utilisant des informations actuellement non disponibles dans Intercom.

Il peut s’agir de questions où vos clients veulent simplement obtenir des informations que vous stockez dans un système externe, comme « Quel est le statut de ma commande ? », ou d’utiliser un Data connector comme « Reprogrammer une livraison » ou « Traiter un remboursement » dans votre système externe.

Lorsque vous savez quelles questions vous souhaitez résoudre, il est étonnamment simple et rapide de configurer un Data connector avec peu ou pas de compétences techniques.

Tout d’abord, allez dans Paramètres > Intégrations > Data connectors.

C’est ici que vous configurerez toutes les différentes connexions que vous avez aux données externes (par exemple Shopify, Salesforce, etc.) selon votre cas d’utilisation. Cliquez sur + Nouveau.

Donnez à votre Data connector un nom unique qui explique exactement quel Data connector il prendra (par exemple « Obtenir l’ID de commande »). Utilisez le champ description pour indiquer à vos collègues quand utiliser ce Data connector et quelles informations ils peuvent s’attendre à récupérer (par exemple « Obtenir la commande pour un ID donné. L’ID de commande doit être stocké dans Conversation CDA »).

Pour permettre à Fin d’utiliser ce connecteur directement, allez dans l’onglet Fin et réglez Comment Fin doit-il utiliser ce connecteur ? sur Activé (déclencheur direct). Si vous souhaitez qu’il soit utilisé uniquement dans un Workflow, une Tâche, une Procédure ou un Macro, réglez-le sur Désactivé (déclencheur manuel).

Ensuite, remplissez les détails de la requête. C’est ici que vous devrez entrer l’URL HTTPS vers le système tiers auquel vous vous connectez (par exemple Shopify, Salesforce, etc.).

Vous pouvez spécifier quel Data connector vous souhaitez que cette requête utilise en sélectionnant la méthode :

Dans cet exemple, nous demanderons à la requête de GET l’ID de commande depuis l’API et entrerons l’URL.

Vous pouvez choisir d’ajouter des paramètres supplémentaires à cette requête en cliquant sur Ajouter une paire clé-valeur puis sélectionnez Paired clé-valeur sous En-têtes HTTP :

Les Data connectors prennent en charge les jetons fixes et dynamiques pour l’authentification. Sous les En-têtes HTTP, vous pouvez sélectionner le jeton d’authentification que vous souhaitez utiliser dans la requête, qui sera alors ajouté à l’en-tête.

Si vous effectuez une requête POST ou PUT, vous aurez la possibilité de fournir un corps de requête pour inclure toutes les données que vous souhaitez envoyer dans la requête :

Ensuite, vous devrez tester la réponse de ce Data connector pour vous assurer qu’il récupère les bonnes données du système tiers auquel vous vous connectez.

Cliquez sur Tester la requête pour vérifier que le Data connector a été configuré correctement. Vous devriez obtenir une coche verte et voir les détails de cette requête si la connexion est validée avec l’API.

Ce sont toutes les informations que vous pouvez maintenant utiliser pour alimenter vos Workflows et fournir des réponses rapides aux clients, comme le statut de la commande.

Par défaut, Fin peut accéder à toutes les données de la réponse pour générer des réponses. Sélectionnez Restreindre manuellement l’accès si vous souhaitez limiter les données que Fin peut lire. Puis cochez les champs de données auxquels vous souhaitez donner accès à Fin.

Vous pouvez également modifier les éléments de données individuels en cliquant sur l’icône modifier pour donner à vos données de réponse un nom destiné aux clients ainsi que spécifier toute transformation des données.

Par exemple, si la réponse de l’API renvoie un solde de 0, au lieu que Fin indique que le solde impayé est de 0, il peut répondre qu’il n’y a actuellement aucun solde impayé restant.

Avec les blocs de code pour Data connectors, nous vous permettons de transformer et manipuler directement les réponses API en Python — directement dans la configuration de votre connecteur.

Cette étape est optionnelle. Elle indique au Data connector où stocker ces informations dans Intercom afin qu’elles puissent être fournies aux clients dans vos Workflows comme réponses à leurs questions.

Les scénarios courants où vous n’aurez peut-être pas besoin de stocker les données sont les types de requêtes Data connector PUT, POST, DELETE. Pour toutes les requêtes GET, si vous souhaitez utiliser les données dans les bots, vous devrez stocker ces données dans Intercom.

Lors de la création de connecteurs de données pour Fin, il n'est pas nécessaire de mapper les données de réponse aux attributs ou objets Intercom. Fin interprète directement la réponse JSON et peut ensuite l'utiliser pour résoudre les questions. La réponse est générée à partir de la section « Test response ». Chaque ligne correspond à un point de données dans la réponse JSON.

En savoir plus sur la gestion du stockage, de l'autorisation et de l'exécution des connecteurs de données.

Les données de réponse JSON peuvent être stockées dans :

Sélectionnez l'objet Intercom puis mappez-le avec l'objet API externe.

Sélectionnez maintenant les attributs de données dans Intercom où vous souhaitez stocker cette information. Par exemple, nous avons sélectionné « Order » comme objet Intercom, puis « root » comme objet API dans le système externe et l'avons mappé avec l'attribut API « currency » :

Lors du mapping avec des Objets personnalisés, vous devez mapper l'ID au champ external_id sinon cela créera des doublons à chaque requête GET. En savoir plus sur la configuration des bonnes références avec les Objets personnalisés

L'étape suivante consiste à sélectionner quelles références des Personnes ou Conversations sont liées à votre objet personnalisé que vous souhaitez mettre à jour.

Une fois que vous avez testé avec succès votre connecteur de données, vous êtes prêt à le mettre en production.

Pour gérer ou modifier en toute sécurité vos connecteurs de données à grande échelle, vous pouvez auditer de manière proactive où chaque connecteur de données ou action MCP est utilisé dans Intercom.

La colonne Used by peut être masquée par défaut. Pour l'afficher :

Cette colonne fournit une liste en direct et cliquable des références. Cliquer sur un élément vous mènera directement à cette source.

Elle suit l'utilisation des connecteurs de données dans :

Une fois votre connecteur de données en production, vous pouvez surveiller ses performances directement depuis Paramètres > Intégrations > Connecteurs de données.

Une colonne Health affiche le statut opérationnel de chaque connecteur basé sur ses taux récents de réussite d'exécution et sa latence.

Survolez n'importe quel badge de statut de santé pour voir une répartition détaillée de ses performances récentes :

Utilisez le filtre temporel en haut du tableau de bord pour ajuster la fenêtre de rapport. Options disponibles : 1h, 6h, 24h, 7d ou 14d.

Cliquez sur n'importe quel connecteur pour ouvrir son tableau de bord de santé dédié, puis sélectionnez l'onglet Journaux pour voir un enregistrement horodaté de chaque exécution. Chaque entrée montre le canal sur lequel elle a été exécutée et si elle a réussi ou échoué — cliquez sur une entrée pour développer les détails complets de l'exécution.

Vous pouvez filtrer les journaux par :

Si vous souhaitez déprécier d'anciens Data connectors qui ne sont plus nécessaires, vous pouvez les passer en état de brouillon.

Allez dans Paramètres > Intégrations > Data connectors et cliquez sur le Data connector que vous souhaitez passer en brouillon, puis sélectionnez Mettre en brouillon.

Bien qu'Intercom vous empêche de mettre en brouillon un connecteur avec des dépendances actives, vous pouvez désormais gérer ces dépendances de manière proactive en utilisant la colonne 'Used by'. Cette colonne fournit une liste indexée en temps réel de chaque Workflow, Procedure, Task, Macro, et Custom Answer qui référence l'action. Vous pouvez cliquer directement sur un élément de cette liste pour accéder à cette automatisation spécifique et résoudre la dépendance.