Accès et disponibilité

Mon plan inclut-il les connecteurs de données pour Fin ?

Les connecteurs de données peuvent être utilisés par Fin sur tous les plans tarifaires et vous serez facturé par résultat.

Fin peut-il utiliser les connecteurs de données sur des espaces de travail hébergés régionalement ?

Les connecteurs de données sont disponibles sur tous les espaces de travail hébergés US, EU et AU hébergés régionalement.

Que s’est-il passé avec les Actions personnalisées ?

Les Actions ou « Custom Actions » ont simplement été renommées en « Data connectors ». Il n’y a aucun changement de fonctionnalité ou de paramétrage.

Fonctionnalité : Capacité à déclencher des appels API dans des systèmes externes. Ceux-ci peuvent être déclenchés directement par Fin pour générer des réponses personnalisées utilisant des données en temps réel (par exemple « Obtenir le statut de la commande »). Ou ils peuvent être ajoutés aux Workflows ou aux Fin Procedures et déclenchés après que certaines conditions soient remplies (par exemple, n’utiliser « annuler la commande » que si la commande n’a pas encore été expédiée).
Navigation : Paramètres > Intégrations > Data connectors

Confidentialité et sécurité des données

Comment les données sensibles sont-elles traitées dans les conversations avec Fin ?

Intercom propose une fonction de masquage PAN qui analyse le contenu des conversations à la recherche de numéros ressemblant à des numéros de carte de crédit et passant un contrôle de Luhn. Si un numéro correspondant est trouvé, il sera masqué jusqu’aux 4 derniers chiffres, et les clients verront une version masquée dans le web Messenger ainsi que dans les SDK iOS et Android. Le numéro apparaîtra également masqué dans la conversation dans l’Inbox.

Pour un contrôle supplémentaire, vous pouvez installer l’application Strac pour détecter et masquer les données sensibles dans les messages et pièces jointes Intercom. Cela vous permet de configurer une liste d’éléments de données sensibles (SSN, DoB, permis de conduire, passeport, carte de crédit, carte de débit, clés API, etc.) à masquer.

Comment empêcher les acteurs malveillants de usurper l’identité ?

Pour éviter l’usurpation d’identité, il est fortement recommandé de sécuriser votre Messenger en appliquant la sécurité Messenger avec JWTs. Cela garantit que les données ne sont exposées qu’aux Users vérifiés. Si vous n’activez pas l’authentification, des acteurs malveillants pourraient potentiellement effectuer des actions non autorisées ou déclencher des Data connectors sur votre espace de travail.

Pour les Leads, ou pour les conversations provenant de canaux autres que le Messenger, l’authentification Messenger ne s’applique pas. Dans ces cas, vous devez utiliser des codes à usage unique (OTP) ou une autre méthode de vérification sécurisée avant d’exposer des données utilisateur.

Le test d’un Data connector affectera-t-il mes données ?

Oui, si vous utilisez les méthodes POST, PUT ou DELETE lors du test d’un Data connector, cela effectuera ces actions sur vos données. Par exemple, tester un appel DELETE sur un utilisateur le supprimera réellement.

Comment m’assurer que Fin ne partage pas de données personnelles avec quelqu’un qui n’est pas l’utilisateur ?

Fin ne pourra lire que les données auxquelles vous avez donné accès dans l’onglet Aperçu. Fin utilisera ces données pour générer des réponses basées sur la question d’un utilisateur. Si vous avez des données internes sensibles que vous ne souhaitez pas que Fin accède, sélectionnez Accès restreint aux données et ne donnez accès qu’aux champs que vous souhaitez que Fin utilise pour générer des réponses. De plus, vous pouvez transformer les données de réponse avec des noms et valeurs adaptés au client. Par exemple, au lieu du statut de la demande « En attente de vérification à quatre yeux », vous pouvez transformer la valeur en un langage que vous utiliseriez avec votre client, comme « En cours de révision ».

Consultez le tableau pour les paramètres recommandés afin de mieux atténuer ce risque :

Cas d’usage	Risque	Meilleure pratique pour atténuer
Fin récupère des données personnalisées pour un client à partir d’un ID utilisateur stocké dans un CDA Intercom.	Un acteur malveillant pourrait manipuler la valeur CDA pour que Fin récupère des données d’un autre compte.	Nous recommandons d’empêcher les users de mettre à jour ces attributs via le Messenger. Cela aide à garantir que les acteurs malveillants ne peuvent pas accéder à des données qui ne leur appartiennent pas. Pour configurer cela, allez dans Paramètres > Données > Personnes, sélectionnez l’attribut concerné et activez « Empêcher les mises à jour via le Messenger ».
Fin récupère des données personnalisées pour un client à partir d’une valeur de données collectée par Fin.	Un acteur malveillant pourrait fournir une valeur à Fin pour un compte auquel il ne devrait pas avoir accès.	Nous recommandons d’effectuer des vérifications côté serveur API pour garantir que l’utilisateur a le contrôle d’accès aux données demandées.
Fin récupère des données personnalisées pour un client à partir d’une valeur de données collectée par Fin.	Fin hallucine une valeur pour un autre client, récupérant les mauvaises données.	Le risque de cette hallucination, bien que non nul, est faible. Cependant, nous recommandons d’effectuer des vérifications côté serveur API pour garantir que l’utilisateur a le contrôle d’accès aux données demandées.

Stockage, autorisation et exécution

Comment les tokens sont-ils stockés dans les Data connectors ?

Les tokens sont stockés dans la configuration des en-têtes. Pour ces valeurs, nous chiffrons les données au repos. En savoir plus sur la sécurité chez Intercom.

Quelles options d’authentification les Data connectors supportent-ils ?

Les Data connectors supportent à la fois les tokens fixes et dynamiques pour l’authentification. Vous pouvez configurer et gérer vos tokens d’authentification que vous souhaitez utiliser dans la requête, qui peuvent ensuite être ajoutés à l’en-tête.

Comment les requêtes sont-elles exécutées dans les Data connectors ?

Toutes les configurations de requête (Corps, URL et En-têtes) sont chiffrées au repos.
Notre backend envoie toutes les requêtes. Cela signifie que nous ne faisons aucun appel API depuis le navigateur. Par exemple, lorsqu’un user déclenche une action, cette action est déclenchée par le système Intercom et non par l’interface utilisateur.

Important : Les données tierces ne sont pas validées par Intercom, et votre Data connector peut écraser les données que vous avez stockées dans Intercom. Vous devez vous assurer de faire confiance aux données retournées par un Data connector.

Puis-je faire un branchement basé sur les codes d’erreur API (par exemple, 4xx ou 5xx) ?

Gestion des erreurs dans les workflows : Pour le moment, vous ne pouvez pas faire de branchement direct sur des codes d’erreur API spécifiques retournés par un data connector (comme les réponses 4xx ou 5xx). Les workflows ne peuvent faire de branchement que selon que le déclencheur du data connector réussit ou échoue. Cela dit, selon la conception de votre API, il peut y avoir une solution de contournement. Si l’API retourne des détails de réponse dans la charge utile JSON (par exemple, un champ status), vous pouvez stocker cette valeur comme un Conversation Data Attribute (CDA). Vous pouvez ensuite utiliser cette valeur stockée pour piloter la logique de branchement dans les étapes ultérieures de votre workflow.

Gestion des erreurs dans les Fin Procedures :Les Fin Procedures ne gèrent pas automatiquement les échecs des data connectors. Si un connecteur expire ou retourne une erreur, Fin ne réessaiera pas la requête ni ne récupérera gracieusement de manière autonome. Sans instructions explicites de secours, Fin peut s’arrêter de manière inattendue ou générer des réponses non fondées sur votre configuration.

Pour éviter cela, assurez-vous que votre Procedure inclut des instructions claires pour les scénarios d’échec, par exemple : « Si la recherche échoue, excusez-vous et escaladez à un agent humain. » Si vous avez besoin d’un comportement de secours plus avancé, envisagez d’encapsuler l’appel du data connector dans une sous-procédure pour mieux contrôler la gestion des erreurs. Pour une gestion avancée des échecs, le status_code retourné par un appel de data connector est désormais exposé comme un attribut de sortie. Vous pouvez le référencer dans une étape Condition pour faire un branchement sur des codes de réponse HTTP spécifiques — par exemple, gérer un 404 (non trouvé) différemment d’un 500 (erreur serveur). Voir Comment écrire des conditions de code pour les Fin Procedures pour des exemples.

Que se passe-t-il si un connecteur échoue et qu’aucun secours n’est configuré ?

Si un connecteur de données échoue, expire ou renvoie une erreur, Fin ne revient pas automatiquement à dire qu'il n'a pas l'information. Sauf si une règle de guidance indique explicitement à Fin de refuser ou de transférer en cas d'échec de recherche, l'étape de génération de réponse tentera toujours de produire une réponse utile — et le modèle peut générer des détails spécifiques au compte (noms, soldes, charges, dates, statut du plan) qui semblent aussi confiants que des données réelles mais sont entièrement fabriqués.

Cela signifie qu'une recherche échouée ne doit jamais être considérée comme une preuve qu'un compte, une charge ou un droit n'existe pas. Fin peut simplement combler le vide avec des détails inventés.

Comment se protéger contre cela :

Ajoutez une étape Condition après chaque appel de connecteur et branchez vers un message d'échec explicite lorsque le status_code indique une erreur, avec un lien vers la section « Gestion avancée des échecs avec status_code » dans l'article de dépannage.
Ajoutez une règle de guidance indiquant à Fin de ne pas fabriquer ou estimer des données spécifiques au compte lorsqu'un connecteur échoue, et de dire clairement au client qu'il ne peut pas récupérer l'information pour le moment.
Si seules des données partielles sont retournées, demandez à Fin de fournir uniquement la partie vérifiée et d'indiquer quels détails n'ont pas pu être récupérés.

Puis-je définir l'attribut Brand via l'API lors de la création d'une conversation ?

Non, l'attribut Brand ne peut pas être défini via l'API lors de la création d'une conversation. L'association de la marque est déterminée automatiquement en fonction de l'interface Messenger utilisée par le client, ou par vos paramètres de workflow — pas par la requête API. Si vous avez besoin qu'une conversation soit associée à une marque spécifique, assurez-vous que le client commence la conversation via le Messenger de marque approprié, ou configurez votre workflow pour attribuer la marque adéquate selon les conditions de la conversation.

Note : Tenter de passer une valeur de marque dans le corps de la requête API n'aura aucun effet. La valeur sera ignorée et l'association de la marque sera toujours résolue à partir de la configuration Messenger ou workflow.

Les connecteurs de données peuvent-ils fonctionner avec des API qui renvoient du XML ?

Oui, les connecteurs de données convertissent désormais automatiquement les réponses XML des API en JSON. Cela vous permet de vous connecter facilement à un plus large éventail d'API et d'utiliser les données dans Fin, Workflows et Inbox sans avoir besoin de convertir manuellement le format des données.

Quelles adresses IP Intercom utilise-t-il pour envoyer les requêtes des connecteurs de données ?

Vous devrez peut-être autoriser sur liste blanche les adresses IP Intercom suivantes (à partir desquelles nous envoyons les requêtes Data connector, Canvas Kit et webhook) afin d'accepter les requêtes Intercom de votre côté. Les adresses sont les suivantes :

USA :

34.231.68.152

34.197.76.213

35.171.78.91

35.169.138.21

52.70.27.159

52.44.63.161

Europe :

54.217.125.63

54.246.173.113

54.216.9.3

Australie :

52.63.36.185

3.104.68.152

52.64.2.165

Fin est-il uniquement une IA informative, ou peut-il effectuer des actions comme des mises à jour de compte ?

Fin est plus qu'informatif. Bien qu'il puisse répondre aux questions basées sur votre contenu de support, il peut aussi être configuré pour effectuer des actions. Avec Fin Procedures, vous pouvez apprendre à Fin à gérer des processus multi-étapes comme les mises à jour de compte. Avec Data connectors, Fin peut récupérer ou mettre à jour en toute sécurité des données dans des systèmes externes (comme changer le statut d'une commande ou mettre à jour les détails d'un user).

Comportement de Fin

Comment Fin fonctionne avec Procedures, Guidance, Data connectors et Workflows

Fonctionnalité	Ce qu'elle fait	Quand l'utiliser	Notes
Procedures	Apprenez à Fin à gérer des processus spécifiques et multi-étapes comme les remboursements ou les mises à jour de compte en utilisant un langage naturel et des étapes basées sur des règles.	Lorsque vous souhaitez que Fin gère des processus complexes et multi-étapes déclenchés par le langage naturel.	Idéal pour les demandes à forte implication et logiques. Contrôle total avec un flux conversationnel.
Guidance	Formez Fin à fournir des réponses précises et à escalader les problèmes selon votre style de communication et vos politiques.	Lorsque vous souhaitez que Fin adopte votre ton, applique des règles d'escalade et assure un support conforme à vos politiques.	Ne réalise pas d'actions, mais régit la façon dont Fin parle, clarifie et escalade.
Data connectors	Permettez à Fin d'accéder aux données dans des systèmes externes (par exemple, appels API), déclenchés par Fin Procedures ou Workflows	Lorsque vous avez besoin que Fin récupère ou mette à jour des données externes dans le cadre d'un Fin Procedures, Workflow ou Inbox workflow.	Utilisé directement par Fin pour générer des réponses personnalisées. Utilisé aussi dans* Procedures ou Workflows.*
Workflows	Automatisez les workflows opérationnels comme le triage de ticket, la qualification de lead et le support proactif avec des chemins codés en dur.	Lors de l'automatisation des opérations de support standard qui ne nécessitent pas de flexibilité mais suivent des chemins structurés et connus.	Peut devenir difficile à étendre et à maintenir à mesure que les cas particuliers augmentent.

Fin Procedures vs. Workflows

Utilisez un Workflow lorsque vous avez besoin de chemins d'automatisation rigides et prédéterminés (comme le routage, le marquage ou l'envoi de messages programmés) qui se déclenchent à partir d'événements spécifiques ou de sélections de boutons. Utilisez une Fin Procedure lorsque vous souhaitez que Fin gère des processus conversationnels à plusieurs étapes (comme poser des questions pour prendre un rendez-vous, collecter des informations ou dépanner) où Fin s'adapte dynamiquement aux demandes en langage naturel et aux réponses des clients.

Fin Procedures vs. Data connectors

Les Data connectors récupèrent le statut d'une commande pour générer une réponse personnalisée, tandis qu'une Fin Procedure traite une annulation de commande, vérifie l'éligibilité au remboursement et effectue le remboursement si applicable.

Fin Procedures vs. Fin Guidance

Fin Guidance garantit que Fin est particulièrement poli lorsqu'il répond à une demande de remboursement, tandis qu'une Fin Procedure automatise le processus de remboursement selon les règles d'éligibilité.

Pourquoi mon message de fermeture automatique n'a-t-il pas été envoyé lorsque Fin a fermé une conversation en attente ?

Lorsque vous activez Auto-close pending Fin conversations dans une étape de workflow Let Fin Handle, vous pouvez choisir un message que Fin enverra avant de fermer la conversation. Cependant, dans certains cas, Fin peut fermer la conversation sans envoyer ce message.

Fin sautera l'envoi du message de fermeture automatique si le client devient inactif pendant qu'un travail est en cours, ou pendant que Fin attend la réponse du client à un élément interactif (comme des boutons de réponse). Dans ces cas, Fin fermera toujours la conversation comme prévu, mais silencieusement.

Fin est conçu ainsi pour éviter de perturber le workflow. Si Fin envoyait un message de fermeture automatique pendant un travail actif ou une étape interactive :

Le message de fermeture automatique apparaîtrait dans la conversation et supprimerait tous les boutons de réponse.
Mais Fin attendrait toujours que le client choisisse l'une de ces options de réponse.
Cela bloquerait le workflow.

Pour éviter cela, Fin effectue la fermeture en arrière-plan et n'envoie pas le message de fermeture automatique pendant qu'un workflow est en cours ou en attente d'une sélection de bouton de réponse.

Note : Même si le message est ignoré, Fin fera toujours :

Détecter que le client est devenu inactif.
Fermer automatiquement la conversation.
Enregistrer la fermeture dans les événements de la conversation.

Problèmes courants d'automatisation Fin

Pourquoi Fin ferme-t-il les conversations prématurément ?

Fin peut fermer automatiquement les conversations en raison des paramètres d'auto-fermeture ou des configurations de workflow. Causes courantes :

Si le workflow atteint une étape finale après avoir confirmé que le client n'a plus de questions, la conversation se fermera.
Les paramètres d'auto-fermeture peuvent être configurés pour fermer la conversation quelques minutes après le dernier message de Fin. Pour éviter les fermetures prématurées, cliquez sur l'étape Let Fin handle dans votre workflow et ajustez le minuteur d'auto-fermeture à une durée plus longue.

Pourquoi Fin ne répond-il pas aux questions des clients ?

Fin peut ne pas répondre aux questions des clients pour les raisons suivantes :

Atteinte de la limite d'utilisation définie par votre espace de travail. Vérifiez la page Fin Usage et augmentez la limite si nécessaire.
Configurations de workflow qui privilégient le routage vers des agents humains plutôt que Fin. Vérifiez et ajustez vos déclencheurs de workflow pour garantir une utilisation appropriée de Fin.

Pourquoi Fin escalade-t-il inutilement les questions vers des agents humains ?

Fin peut escalader inutilement les questions vers des agents humains s'il a atteint la limite de résolution définie par votre espace de travail. Allez dans Settings > Billing > Usage et vérifiez le graphique de résolution. Augmentez la limite si nécessaire.

Pourquoi Fin ferme-t-il une conversation après avoir demandé plus d'informations ?

Si un client ne demande pas d'escalade après que Fin n'a pas fourni de réponse satisfaisante, la conversation peut se fermer. Les clients peuvent toujours poser plus de questions à Fin même après la fermeture d'une conversation — Fin la rouvrira s'ils répondent.

Pourquoi Fin répond-il sans qu'une question soit posée ?

Fin prend en compte toutes les entrées précédentes dans la conversation — y compris les sélections de boutons de réponse rapide — lorsqu'il forme sa réponse. Si vous souhaitez que Fin réponde uniquement aux questions explicites, mettez à jour ses instructions de Guidance pour spécifier ce comportement.

Pourquoi Fin ne répond-il pas aux clients qui répondent aux messages sortants ?

L'option pour que Fin réponde aux réponses aux messages sortants ne fonctionne qu'avec une configuration de déploiement Simple. Si vous utilisez un déploiement Avancé avec Workflows, Fin ne répondra pas automatiquement à ces réponses. Passez à une configuration de déploiement Simple ou gérez les réponses via un Workflow Avancé avec une étape Let Fin handle.

Pourquoi Fin ferme-t-il une conversation au lieu de l'escalader ?

Fin peut interpréter certains messages — comme « merci d'avoir escaladé ce problème » — comme un signal de résolution et fermer la conversation au lieu de l'escalader. Mettez à jour votre Fin Guidance pour instruire explicitement Fin sur la gestion du langage d'escalade et assurez-vous qu'il ne considère pas les messages de remerciement comme résolus.

Pourquoi Fin informe-t-il le client qu'il a contacté en dehors des heures de travail ?

Fin envoie un message hors horaires lorsque la conversation est initiée en dehors de vos heures de bureau configurées. Vérifiez et ajustez les heures de bureau dans les paramètres de votre compte pour correspondre à votre planning opérationnel. Notez que les Workflows utilisent uniquement les heures de bureau par défaut — pas les heures personnalisées définies pour des équipes individuelles.

Pourquoi Fin ne répond-il pas aux e-mails comme prévu ?

Fin peut ne pas répondre aux e-mails comme prévu pour les raisons suivantes :

Envoi d'e-mails de test depuis une adresse e-mail qui n'est pas configurée comme adresse d'un coéquipier dans Intercom. Assurez-vous d'utiliser une adresse de test correctement configurée.
Règles d'affectation de workflow assignant la conversation à un coéquipier après la réponse initiale de Fin. Vérifiez votre workflow pour vous assurer que les étapes d'affectation ne contredisent pas l'automatisation des e-mails de Fin.

Pourquoi Fin répond-il aux e-mails qu'il devrait ignorer ?

Les profils Fin hérités peuvent entrer en conflit avec les méthodes de déploiement plus récentes, ce qui fait que Fin répond à des e-mails qu'il devrait ignorer. Mettez en pause tous les profils Fin actifs et déployez Fin uniquement via Workflows ou un déploiement Simple pour éviter cela.

Comment désactiver Fin AI Agent ?

Pour désactiver Fin AI Agent, allez sur la page Fin AI Agent Deploy pour le canal où vous souhaitez désactiver Fin et désactivez-le. Suivez ces étapes pour vous assurer que Fin est complètement désactivé :

Allez dans Fin AI Agent > Deploy et désactivez Fin pour le canal concerné. Les points verts à côté des configurations 'Chat' et 'Email' devraient devenir jaunes lorsqu'ils sont désactivés.
Supprimez Fin de tous les Workflows actifs.
Désactivez toutes les Procedures ou Workflows en cours où Fin est activé — Fin peut toujours interagir avec les clients via les Workflows actifs, les connecteurs de données et les Procedures même si les canaux principaux sont en pause.

FAQ sur les connecteurs de données