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, Historical Conversations Import).
Type d'API et Type d'objet – détails techniques pour identifier quel objet de données Salesforce ou point de terminaison 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 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 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 permissions ou de la visibilité des champs utilisés dans vos filtres dans Salesforce.
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 objet différent, 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 « Définir les champs d'audit lors de la création d'enregistrement » et « Mettre à jour les enregistrements avec des propriétaires inactifs ».
(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 obtenir de l'aide.
Objet : Case
Code d'erreur : FIELD_CUSTOM_VALIDATION_EXCEPTION
Comment corriger cette erreur :
Allez dans Déployer > Cases Salesforce > 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 Déployer > Cases Salesforce > 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 : 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’User 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 tâches à partir des enregistrements EmailMessage. Dans ce cas, assurez-vous que le même user a la permission d’accéder aux tâches, 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 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 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 a besoin de la capacité de créer des éléments de fil de case avec du texte enrichi.
Allez dans Configuration Salesforce → Paramètres Chatter
Cliquez sur Modifier
Sous Publications en texte enrichi activez « Autoriser les users à composer des publications 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 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 à Déployer > 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 flux Salesforce 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 Créer un Case Salesforce dans le workflow Fin messenger. Assurez-vous que l’user 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 à Déployer > 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 flux Salesforce 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 à Déployer > 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 flux Salesforce pour définir ou par défaut le champ à la bonne valeur.
Note : Si le champ n’est pas visible comme une étape Définir des données, allez à Déployer > Fin Messenger > Données et sélectionnez le champ Case dans la section Extraire des données de 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’user 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 de 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 afin 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 a besoin de la capacité de créer des éléments de fil de case avec du texte enrichi.
Allez dans Configuration Salesforce → Paramètres Chatter
Cliquez sur Modifier
Sous Publications en texte enrichi activez « Autoriser les users à composer des publications 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 Case Salesforce. 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.