Lorsque Fin rencontre un problème de connexion avec Salesforce, les détails apparaissent dans Journaux d'erreurs. Ce guide vous aide à comprendre rapidement chaque erreur et comment la corriger.
Chaque entrée d'erreur comprend :
Code d'erreur – un identifiant unique pour l'erreur.
Erreur système – le message retourné par Salesforce.
Chemin de la requête – Le point de terminaison API Salesforce spécifique qui a déclenché l'erreur.
Méthode de requête – La méthode HTTP utilisée (par exemple, GET, POST ou PATCH).
Code d'état – Le code de réponse HTTP retourné par Salesforce (par exemple, 400 ou 403).
Fonctionnalité produit – où le problème est survenu (par exemple, Importation des conversations historiques).
Type d'API et Type d'objet – détails techniques pour identifier quel objet de données ou point de terminaison Salesforce est affecté.
Comment accéder aux journaux d'erreurs
Allez dans Paramètres > Journaux d'erreurs.
Sélectionnez une erreur liée à Salesforce pour ouvrir le panneau Détails de l'erreur.
Astuce : Vous pouvez cliquer sur Revoir la configuration pour ouvrir directement les paramètres de connexion ou d'autorisation Salesforce pertinents depuis les journaux d'erreurs.
Comment corriger les erreurs d'intégration courantes
Erreurs lors de l'importation de knowledge
Objet : Knowledge__kav
Code d'erreur : INVALID_QUERY_FILTER_OPERATOR
Message : Filtre invalide dans la requête d'article knowledge, probablement dû à une incompatibilité de type de données.
Comment corriger cette erreur :
Vérifiez vos filtres et essayez de synchroniser à nouveau vos articles.
Si la synchronisation fonctionnait auparavant, l'erreur peut être causée par des modifications des champs d'article knowledge dans Salesforce. Vérifiez si des champs utilisés dans vos filtres ont été mis à jour dans Salesforce.
Objet : Knowledge__kav
Code d'erreur : MALFORMED_QUERY
Message : Valeurs de filtre invalides dans la requête d'article knowledge.
Comment corriger cette erreur :
Vérifiez vos filtres et essayez de synchroniser à nouveau vos articles.
Si la synchronisation fonctionnait auparavant, l'erreur peut être causée par des modifications des champs d'article knowledge dans Salesforce. Vérifiez si des champs utilisés dans vos filtres ont été mis à jour dans Salesforce.
Objet : Knowledge__kav
Code d'erreur : NOT_FOUND
Message : L'article knowledge demandé est introuvable.
Comment corriger cette erreur : Lors du déclenchement d'une importation knowledge, nous recueillons un instantané des articles à synchroniser puis lançons la synchronisation. Entre la collecte et la synchronisation, il semble qu'un article ait été supprimé et n'est plus interrogeable. Aucune autre action n'est nécessaire, sauf peut-être rétablir l'article supprimé.
Objet : Knowledge__kav
Code d'erreur : INVALID_FIELD
Message : Des problèmes sont survenus lors de la construction de la requête d'article knowledge.
Comment corriger cette erreur :
Vérifiez et mettez à jour vos filtres, puis essayez de synchroniser à nouveau votre sélection d'articles.
Si la synchronisation fonctionnait auparavant, l'erreur peut être causée par des modifications des champs d'article knowledge dans Salesforce. Vérifiez si des mises à jour ont été faites sur les permissions ou la visibilité des champs utilisés dans vos filtres.
Objet : Knowledge__kav
Code d'erreur : UNKNOWN
Message : Des problèmes sont survenus lors de la construction de la requête d'article knowledge.
Comment corriger cette erreur : Nous ne supportons actuellement que l'importation des objets Knowledge__kav en tant qu'articles Salesforce. Si votre organisation Salesforce utilise un autre objet, veuillez contacter notre équipe de support pour assistance.
Erreurs avec les Cases Salesforce
Objet : Case
Code d'erreur : INVALID_FIELD_FOR_INSERT_UPDATE
Message : L'utilisateur d'intégration n'a pas les permissions pour mettre à jour les champs d'audit sur l'objet.
Comment corriger cette erreur :
Si l'erreur concerne Fin ne pouvant pas définir CreatedById ou LastModifiedById :
Allez dans Configuration Salesforce → Interface utilisateur.
Activez les permissions « Set Audit Fields upon Record Creation » et « Update Records with Inactive Owners ».
(Voir Activer la permission 'Create Audit Fields' dans Salesforce)
Si l'erreur concerne un autre champ :
Partagez les détails de l'erreur avec votre administrateur Salesforce, ou contactez notre équipe de support pour aide.
Objet : Case
Code d'erreur : FIELD_CUSTOM_VALIDATION_EXCEPTION
Comment corriger cette erreur :
Allez dans Deploy > Salesforce Cases > Workflow.
Faites l'une des actions suivantes :
Vérifiez que le champ causant l'erreur de validation personnalisée est correctement défini dans le workflow.
Si vous ne souhaitez pas que le workflow définisse ce champ, configurez un Flow Salesforce pour définir ou par défaut ce champ à la valeur correcte.
Objet : Case
Code d'erreur : CANNOT_EXECUTE_FLOW_TRIGGER
Comment corriger cette erreur : Un flow ou processus dans votre organisation Salesforce génère une erreur lorsque Fin met à jour ou crée un Case.
Partagez les détails de l'erreur système avec votre administrateur Salesforce afin qu'il puisse résoudre le problème dans le flow ou processus Salesforce.
Objet : Case
Code d'erreur : INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
Comment corriger cette erreur :
Allez dans Deploy > Salesforce Cases > Workflow.
Faites l'une des actions suivantes :
Mettez à jour le workflow pour vous assurer que le champ picklist causant l'erreur de picklist restreinte est correctement défini.
Si vous ne souhaitez pas que le workflow définisse ce champ, configurez un Flow Salesforce pour définir ou par défaut le champ picklist à la valeur correcte.
Objet : Case
Code d'erreur : UNABLE_TO_LOCK_ROW
Comment corriger cette erreur : Fin n’a pas pu mettre à jour le Case Salesforce car un autre processus le mettait à jour en même temps. Certaines mises à jour du Case peuvent ne pas avoir été enregistrées.
Si Fin est toujours assigné au Case, la prochaine mise à jour réessaiera automatiquement.
Si Fin n’est plus assigné, vous devrez peut-être copier manuellement les mises à jour de la conversation Fin dans le Case Salesforce.
Objet : Case
Symptôme : Les réponses des clients à un case existant créent de nouvelles conversations dans votre espace de travail Fin au lieu de s’intégrer au case original.
Comment corriger cette erreur : Cela se produit lorsque Lightning threading n’est pas activé dans Salesforce. Sans cela, Salesforce ne conserve pas les en-têtes de fil d’email dont Fin a besoin pour associer les réponses entrantes au case original.
Allez dans Salesforce Setup → Email → Email-to-Case.
Activez Lightning Threading et enregistrez vos modifications.
Note : Lightning threading s’applique à toute votre organisation Salesforce — cela affecte tous les cases et emails, pas seulement ceux gérés par Fin. Si votre équipe dépend du fait que le threading soit désactivé pour d’autres workflows, examinez l’impact sur votre configuration Salesforce avant de l’activer.
Objet : EmailMessage
Code d'erreur : INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY
Comment corriger cette erreur : L’objet Salesforce EmailMessage référence le Case via ParentId et un User via CreatedById et LastModifiedById. Assurez-vous que l’utilisateur Salesforce qui a connecté Fin a la permission d’accéder aux objets Case et User.
Si votre organisation Salesforce utilise Enhanced Email, Salesforce créera également des Tasks à partir des enregistrements EmailMessage. Dans ce cas, assurez-vous que le même utilisateur a la permission d’accéder aux Tasks, si la première étape ne résout pas le problème.
Objet : EmailMessage
Code d'erreur : UNABLE_TO_LOCK_ROW
Comment corriger cette erreur : Fin n’a pas pu créer un EmailMessage pour le Case Salesforce car un autre processus mettait à jour le Case en même temps.
Si Fin est toujours assigné au Case, la prochaine mise à jour créera automatiquement le EmailMessage et renverra l’email.
Objet : EmailMessage
Code d'erreur : INVALID_FIELD_FOR_INSERT_UPDATE
Comment corriger cette erreur : Si l’erreur concerne l’impossibilité pour Fin de définir CreatedById ou LastModifiedById :
Allez dans Salesforce Setup → User Interface.
Activez les permissions « Set Audit Fields upon Record Creation » et « Update Records with Inactive Owners ».
(Voir Activer la permission 'Create Audit Fields' dans Salesforce)
Si l’erreur concerne un autre champ :
Partagez les détails de l’erreur avec votre administrateur Salesforce, ou contactez notre équipe support pour obtenir de l’aide.
Objet : FeedItem
Code d'erreur : UNKNOWN_EXCEPTION
Message : L’utilisateur du contexte n’a pas la permission de créer du texte enrichi dans le fil
Comment corriger cette erreur : Fin doit pouvoir créer des éléments de fil de case avec du texte enrichi.
Allez dans Salesforce Setup → Chatter Settings
Cliquez sur Modifier
Sous Rich Text Posts activez « Autoriser les users à composer des posts en texte enrichi »
Cliquez sur Enregistrer.
Si l’erreur concerne un autre champ :
Partagez les détails de l’erreur avec votre administrateur Salesforce, ou contactez notre équipe support pour obtenir de l’aide.
Erreurs avec Fin Messenger
Objet : Case
Code d'erreur : INVALID_OR_NULL_FOR_RESTRICTED_PICKLIST
Message : Mauvaise valeur sélectionnée pour un champ picklist restreint.
Comment corriger cette erreur :
Allez à Deploy > Fin Messenger > Workflow.
Faites l’une des actions suivantes :
Mettez à jour le workflow pour vous assurer que le champ picklist à l’origine de l’erreur de picklist restreint est correctement défini.
Si vous ne souhaitez pas que le workflow définisse ce champ, configurez un Salesforce Flow pour définir ou par défaut le champ picklist à la bonne valeur.
Objet : Case
Code d'erreur : CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY
Comment corriger cette erreur : Fin ne peut pas créer un Case lors de l’étape Create Salesforce Case dans le workflow Fin messenger. Assurez-vous que l’utilisateur Salesforce qui a connecté Fin à Salesforce a la permission d’accéder à l’objet Case.
Objet : Case
Code d'erreur : FIELD_CUSTOM_VALIDATION_EXCEPTION
Message : Mauvaise valeur sélectionnée pour un champ picklist restreint.
Comment corriger cette erreur :
Allez à Deploy > Fin Messenger > Workflow.
Faites l’une des actions suivantes :
Mettez à jour le workflow pour vous assurer que le champ à l’origine de l’erreur de validation est correctement défini.
Si vous ne souhaitez pas que le workflow définisse ce champ, configurez un Salesforce Flow pour définir ou par défaut le champ à la bonne valeur.
Objet : Case
Code d'erreur : REQUIRED_FIELD_MISSING
Comment corriger cette erreur :
Allez à Deploy > Fin Messenger > Workflow.
Faites l’une des actions suivantes :
Mettez à jour le workflow pour vous assurer que le champ à l’origine de l’erreur de validation est correctement défini.
Si vous ne souhaitez pas que le workflow définisse ce champ, configurez un Salesforce Flow pour définir ou par défaut le champ à la bonne valeur.
Note : Si le champ n’est pas visible comme étape Set data, allez à Deploy > Fin Messenger > Data et sélectionnez le champ Case dans la section Pull data from Salesforce.
Objet : Case
Code d'erreur : INVALID_FIELD_FOR_INSERT_UPDATE
Comment corriger cette erreur : Fin ne peut pas définir certains champs sur l’objet Case Salesforce. Assurez-vous que l’utilisateur Salesforce qui a connecté Fin a les permissions correctes sur l’objet Case.
Si le problème persiste, partagez les détails de l’erreur avec votre administrateur Salesforce ou contactez notre équipe support pour obtenir de l’aide.
Objet : Case
Code d'erreur : INVALID_EMAIL_ADDRESS
Comment corriger cette erreur : Fin n’a pas pu créer un objet Case Salesforce. Veuillez vérifier que l’email fourni à Fin est valide.
Objet : Case
Code d'erreur : CANNOT_EXECUTE_FLOW_TRIGGER
Comment corriger cette erreur : Un flux ou un processus dans votre organisation Salesforce génère une erreur lorsque Fin met à jour ou crée un Case. Partagez les détails de l’erreur système avec votre administrateur Salesforce pour qu’il puisse résoudre le problème.
Objet : FeedItem
Code d'erreur : UNKNOWN_EXCEPTION
Message : L’utilisateur du contexte n’a pas la permission de créer du texte enrichi dans le fil
Comment corriger cette erreur : Fin doit pouvoir créer des éléments de fil de case avec du texte enrichi.
Allez dans Salesforce Setup → Chatter Settings
Cliquez sur Modifier
Sous Rich Text Posts activez « Autoriser les users à composer des posts en texte enrichi »
Cliquez sur Enregistrer.
Si l'erreur concerne un autre champ :
Partagez les détails de l'erreur avec votre administrateur Salesforce ou contactez notre équipe de support pour obtenir de l'aide.
Erreurs avec l'historique de synchronisation des cases
Objet : Emails
Code d'erreur : INVALID_TYPE
Message : L'utilisateur d'intégration ne peut pas accéder aux messages email attachés au case.
Comment corriger cette erreur : Fin ne peut pas accéder à la relation Emails sur l'objet Salesforce Case. C'est très probablement parce que Enhanced Email n'est pas activé dans votre organisation Salesforce.
Pour résoudre ce problème, faites l'une des actions suivantes :
Allez dans Salesforce Setup → Enhanced Email et activez Enhanced Email.
Désactivez la synchronisation de l'historique des conversations. Allez dans Fin Workspace → Settings → Salesforce integration et désactivez Sync case history from Salesforce.
Nous travaillons activement à la prise en charge des organisations Salesforce sans Enhanced Email. Contactez notre équipe de support pour les dernières mises à jour.
Objet : CaseFeed
Code d'erreur : INVALID_FIELD
Message : L'espace de travail nécessite que Digital Experiences soit activé.
Comment corriger cette erreur : Fin ne peut pas interroger le champ Visibility sur l'objet Salesforce CaseFeed. Assurez-vous que l'utilisateur Salesforce qui a connecté Fin a la permission d'accéder à ce champ.
Le champ Visibility est disponible uniquement lorsque Digital Experiences est activé dans Salesforce. Ce champ est nécessaire pour déterminer si un commentaire est interne ou public. Consultez Activer Digital Experiences dans Salesforce pour l'activer.
Si le problème persiste une fois activé, partagez les détails de l'erreur avec votre administrateur Salesforce ou contactez notre équipe de support.
Objet : Case
Code d'erreur : INVALID_FIELD
Comment corriger cette erreur : Fin ne peut pas interroger certains champs sur l'objet Salesforce Case. Vérifiez que l'utilisateur Salesforce qui a connecté Fin a la permission d'accéder à ces champs.
Si le problème continue, partagez les détails de l'erreur avec votre administrateur Salesforce ou contactez notre équipe de support.
FAQ
Comment savoir si une erreur est liée à Salesforce ?
Les erreurs liées à Salesforce afficheront API type: Salesforce REST API dans les détails de l'erreur.
Puis-je exporter les journaux d'erreurs Salesforce ?
Pas encore — mais vous pouvez cliquer sur Copy all details dans n'importe quel panneau d'erreur pour copier le journal complet à des fins de rapport ou de partage.
Où puis-je voir les erreurs résolues ?
Les problèmes résolus sont automatiquement supprimés de la vue Error logs une fois que Fin se reconnecte avec succès ou réessaie la requête échouée.