Utilisez cet article pour lire et interpréter les journaux du connecteur de données, identifier la cause des erreurs du connecteur et prendre les mesures appropriées pour les résoudre. Cet article s'adresse aux coéquipiers qui ont configuré au moins un connecteur de données et doivent diagnostiquer pourquoi il échoue.
Comment accéder aux journaux du connecteur de données
Les journaux du connecteur de données montrent l'historique de chaque requête effectuée par le connecteur. Pour ouvrir les journaux d'un connecteur, allez dans Paramètres > Intégrations > Data Connectors, sélectionnez un connecteur, puis ouvrez l'onglet Journaux.
Comment trouver les journaux d'une conversation spécifique
Pour voir quels data connectors ont fonctionné pendant une conversation spécifique (et si certains ont échoué), ouvrez la conversation dans l'Inbox et activez la vue de l'historique des événements depuis la timeline de la conversation. Les exécutions de connecteurs de données échouées apparaissent en rouge.
Comment lire les journaux
La zone des journaux comporte trois composants principaux. Sélectionnez une requête dans la liste pour ouvrir son panneau de détails :
Filtrer : Vous pouvez filtrer les journaux par différentes valeurs et plages horaires.
Liste des requêtes : Chaque entrée affiche la date et l'heure, ce qui a déclenché le connecteur, et si la requête a réussi ou échoué.
Détails de la requête : Montre une répartition de chaque étape traversée par la requête et à quelle étape elle a échoué.
Filtrer
Utilisez le sélecteur de plage de dates pour filtrer les journaux par une période spécifique.
Vous pouvez aussi filtrer par l'une des valeurs suivantes :
ID d'exécution : Un identifiant unique pour chaque requête de connecteur. Notre équipe support peut le demander lors du diagnostic des problèmes.
ID de conversation
Statut (Succès/Échec)
Type d'échec :
Erreur de configuration de la requête : Le connecteur est mal configuré — par exemple, l'URL ou un champ requis est manquant ou incorrect — donc Fin n'a même pas pu tenter l'appel.
Erreur Faraday : Une erreur de connectivité au niveau réseau — Fin n'a pas pu atteindre le service externe du tout. Cela est généralement causé par un délai d'attente, une défaillance DNS ou un serveur inaccessible. Vérifiez si le service externe est en ligne et que l'URL du connecteur est correcte.
Erreur API tierce (interface de programmation d'application) : Fin a atteint le service externe avec succès, mais le service a renvoyé une erreur en réponse — par exemple, la requête a été rejetée ou le service était temporairement indisponible. Contactez le fournisseur du service externe et partagez la réponse d'erreur pour enquête.
Erreur de mappage de la réponse : Le service externe a répondu avec succès, mais Fin n'a pas pu lire ou extraire les données de la réponse comme prévu.
Erreur de rafraîchissement du jeton : Le jeton OAuth (Open Authorization) utilisé pour s'authentifier auprès du service externe a expiré, et la tentative de renouvellement automatique a échoué. Utilisez le bouton Réauthentifier dans les paramètres du connecteur pour restaurer l'accès.
Erreur de validation de la requête : Les données que Fin s'apprêtait à envoyer ont été vérifiées et jugées invalides ou incomplètes avant même que la requête ne soit effectuée.
Erreur de transformation du bloc de code : Un extrait de code personnalisé que le connecteur utilise pour reformater les données avant l'envoi ou après la réception a planté ou produit un résultat inattendu.
Exécuté dans :
Fin : Le connecteur a été déclenché par Fin AI pendant qu'il gérait une conversation client.
Procédure : Le connecteur a été déclenché par une Procédure — une tâche structurée ou un workflow que Fin suit étape par étape.
Inbox : Le connecteur a été déclenché manuellement par un coéquipier directement depuis une conversation dans l'inbox.
Règle d'automatisation Inbox : Le connecteur a été déclenché automatiquement par une règle configurée pour exécuter des actions lorsque certaines conditions sont remplies dans l'inbox.
Bot personnalisé : Le connecteur a été déclenché par un flux de bot construit dans le créateur de Workflows pour automatiser les conversations.
Bot de résolution : Le connecteur a été déclenché par l'ancien Bot de résolution alors qu'il essayait de répondre automatiquement à la question d'un client.
Macros (Réponse enregistrée) : Le connecteur a été déclenché lorsqu'un coéquipier a utilisé une réponse enregistrée (macro) dans une conversation.
Détails de la requête
Sélectionner une requête dans la liste ouvre son panneau de détails. Les quatre sections suivantes couvrent chaque étape de l'exécution du connecteur de données :
Exécution
Requête
Réponse
Traitement de la réponse
Chacune des quatre sections représente une phase distincte de la requête du connecteur de données :
Exécution couvre tout le cycle de vie de la requête du début à la fin. Elle montre ce qui a déclenché le connecteur de données — par exemple, Fin AI Agent, une Procédure, ou un coéquipier dans l'Inbox.
Requête est ce que Fin envoie au système externe. S'il y a une erreur ici, la requête n'a jamais été envoyée. Cela est généralement causé par un problème avec l'URL, la charge utile de la requête ou la configuration du connecteur. Si la cause n'est pas claire, contactez le support avec les détails du journal d'exécution.
Réponse est ce que le système externe renvoie à Fin. Un code de statut 200 indique un succès. Les codes de statut dans la plage 5XX (comme 500 ou 502) indiquent une erreur côté serveur sur le système externe — partagez la réponse d'erreur avec le fournisseur du service externe pour enquête. Les codes de statut dans la plage 4XX indiquent une erreur côté client : 404 signifie que la ressource demandée n'a pas été trouvée, tandis que 401 et 403 indiquent des problèmes d'authentification ou d'autorisation. En général, les erreurs 4XX signifient que la requête a envoyé des données invalides, incomplètes ou non autorisées.
Traitement de la réponse est l'étape où Fin applique le mappage de la réponse configuré dans la configuration du connecteur de données. Si cette étape échoue, cela signifie généralement que la réponse API a une structure différente de celle attendue par le connecteur. Consultez le mappage de la réponse dans les paramètres du connecteur, et contactez le support avec les détails du journal si le problème persiste.
Pourquoi mon connecteur de données réussit-il mais Fin dit qu'il ne trouve rien ?
Un connecteur de données peut s'exécuter avec succès — renvoyant un code de statut 200 — mais provoquer quand même que Fin AI Agent dise qu'il n'a rien trouvé. Cela se produit généralement lorsque la charge utile de la réponse API est trop volumineuse ou non structurée pour que Fin puisse extraire les données pertinentes. Pour résoudre ce problème, optimisez la réponse API pour ne renvoyer que les champs spécifiques dont Fin a besoin, plutôt que d'envoyer un objet de données complet. Si le problème persiste après réduction de la taille de la réponse, contactez le support.
Astuce : Pour les problèmes spécifiques aux data connectors exécutés dans une Procédure, consultez Dépannage des Procédures Fin et des data connectors.