Ignorer et passer au contenu principal
Avertissement : cet article est le résultat de la traduction automatique, l'exactitude et la fidélité de la traduction ne sont donc pas garanties. Pour consulter la version originale de cet article, en anglais, cliquez ici.

Gérer les appels d'API et les erreurs de synchronisation de l'intégration Salesforce

Dernière mise à jour: 27 mai 2025

Disponible avec le ou les abonnements suivants, sauf mention contraire :

Marketing Hub   Pro , Enterprise
Sales Hub   Pro , Enterprise
Service Hub   Pro , Enterprise
Operations Hub   Pro , Enterprise
Content Hub   Pro , Enterprise

L’intégration HubSpot-Salesforce peut rencontrer des erreurs de synchronisation qui empêchent la synchronisation des données. Vous pouvez identifier et résoudre ces erreurs de synchronisation dans les paramètres d'intégration Salesforce.

Ajuster la limite d’appels d’API

  • Dans votre compte HubSpot, cliquez sur l'icône Paramètres settings dans la barre de navigation principale. Dans le menu latéral de gauche, accédez à Intégrations > Applications connectées.
  • Dans la liste des applications connectées, cliquez sur Salesforce
  • Dans l’onglet État de synchronisation , dans la section Utilisation du appel d'API, consultez le nombre d’appels d’API que vous avez utilisés au cours des dernières 24 heures. Le nombre Limité par Salesforce correspond au nombre d'appels d'API que vous pouvez passer en fonction de vos paramètres Salesforce. Pour ajuster le nombre d’appels pouvant être alloués à HubSpot, modifiez le champ Attribué à HubSpot

sync-health-api-call-use

Afficher les erreurs de synchronisation Salesforce

  • Dans votre compte HubSpot, cliquez sur l'icône Paramètres settings dans la barre de navigation principale. Dans le menu latéral de gauche, accédez à Intégrations > Applications connectées.
  • Dans la liste des applications connectées, cliquez sur Salesforce
  • Dans l’onglet État de synchronisation , sous Erreurs de synchronisation, affichez des cartes pour chaque type d’erreur, avec le nombre d’erreurs actuelles et de fiches d’informations impactées. Cliquez sur une carte de type d'erreur pour afficher les détails des erreurs dans le panneau de droite. Découvrez-en davantage sur chaque type d’erreur et les recommandations de résolution

sync-health-sync-errors

  • Pour afficher plus de détails sur une erreur, cliquez sur l’icône info info dans la colonne Type d’erreur .
  • Pour agir sur des fiches d’informations individuelles, cliquez sur [#] fiches d’informations dans la colonne Fiches d’informations affectées , puis cliquez sur Actions > Créez une vue temporaire des fiches d’informations HubSpot pour créer une vue filtrée des fiches d’informations affectées. 
  • Une fois les erreurs résolues, revenez à la liste des erreurs. Sélectionnez la case à cocher à gauche d'une erreur résolue et cliquez sur Resynchroniser.
  • Pour exporter vos erreurs, cliquez sur Exporter les erreurs (CSV) dans l’angle supérieur gauche de la liste des erreurs.
Capture d’écran montrant le bouton permettant d’exporter les erreurs de synchronisation Salesforce dans HubSpot

Types d’erreurs de synchronisation Salesforce

Associations

Exemples d’erreurs d’associations 

  • Limite d’association atteinte
  • En attente de synchronisation du compte

Signification des erreurs

Les fiches d’informations ne sont pas synchronisées car elles sont associées à des comptes Salesforce qui ne se sont pas encore synchronisés avec HubSpot Entreprises ou parce qu’elles sont associées à des fiches d’informations qui ont atteint la limite d’association de fiche d'informations de HubSpot. 

Comment résoudre les erreurs 

Pour résoudre l’erreur Limite d’association atteinte, vous pouvez supprimer certaines des fiches d’informations associées ou les associer à une autre fiche d’informations Salesforce, puis procéder à la synchronisation.

Pour résoudre l’erreur En attente de synchronisation du compte, il est recommandé de procéder à un import des comptes Salesforce. 

Code personnalisé

Exemples d’erreurs de code personnalisé 

  • Automatisation de Salesforce
  • ID de contact manquant
  • Règle de validation des champs personnalisés Salesforce
  • Flux Salesforce

Signification des erreurs

Les fiches d’informations ne sont pas synchronisées en raison d’un problème causé par l’automatisation, les flux ou les règles de validation dans votre compte Salesforce.

Comment résoudre les erreurs

Étant donné que ces erreurs proviennent de Salesforce, il est recommandé de travailler avec votre administrateur Salesforce pour résoudre le problème dans votre code personnalisé dans Salesforce. 

Doublons

Exemples d’erreurs de doublons

  • E-mail déjà utilisé
  • Règle de doublon Salesforce

Signification des erreurs

Un lead ou contact Salesforce ne peut pas être synchronisé avec HubSpot car l’adresse e-mail existe déjà sur une fiche d’informations d’un contact HubSpot ou en raison d’une règle de déduplication dans Salesforce

Comment résoudre les erreurs

Pour résoudre l’erreur E-mail déjà utilisé , supprimez l’adresse e-mail du contact HubSpot existant.

Pour résoudre l’erreur de règle de duplication Salesforce, il est recommandé de vérifier les règles correspondantes de déduplication configurées dans Salesforce

Autorisations

Exemples d’erreurs d’autorisations

  • Accès insuffisant ou fiches d’informations Salesforce manquantes
  • Autorisation de champ Salesforce
  • Accès insuffisant à Salesforce

Signification des erreurs

Les modifications apportées dans HubSpot ne peuvent pas être synchronisées avec Salesforce car l'utilisateur connecté n'a pas accès au champ ou à l'objet requis dans Salesforce.

Comment résoudre les erreurs

Dans la plupart des cas, l’erreur Accès insuffisant ou fiche d’informations Salesforce manquante se produit lorsque l’intégration tente de mettre à jour un champ Salesforce avec une valeur incorrecte ou de créer une association incorrecte. 

Pour résoudre l’erreur d’autorisation de champ Salesforce, assurez-vous que l’utilisateur de l’intégration Salesforce dispose des autorisations de lecture et de modification sur le champ dans Salesforce. 

L’erreur Accès insuffisant à Salesforce se produit lorsque l’utilisateur de l’intégration Salesforce ne peut pas effectuer l’action dans Salesforce en raison de ses autorisations utilisateur dans Salesforce. Il est recommandé de vérifier les autorisations de l’utilisateur de l’intégration Salesforce dans Salesforce.

Listes de sélection

Exemples d’erreurs de liste de sélection

  • Option de liste de sélection Salesforce manquante
  • Valeur d’état ou de pays incompatible
  • Options inadaptées
  • Propriétaire Salesforce inactif
  • Valeur de liste de sélection restreinte
  • Phase d’opportunité inactive
  • Propriétaires Salesforce non synchronisés
  • Limite d’options dépassée
  • Processus de vente par défaut indisponible
  • Phase d’opportunité manquante ou invalide

Signification des erreurs

Les fiches d'informations ne sont pas synchronisées en raison d'une différence des valeurs des listes de sélection entre HubSpot et Salesforce. Cette erreur peut survenir lorsqu'une valeur de liste de sélection dans un système ne correspond à aucune valeur actuelle dans l'autre, lorsque la liste de sélection a atteint une limite de valeurs ou lorsque la valeur n'est pas valide.

Comment résoudre les erreurs

Pour résoudre l’erreur de valeur d’état ou de pays incompatible , il est recommandé de vérifier que les conditions suivantes sont remplies :

  • La valeur interne de l’option Pays propriété dans HubSpot doit correspondre à une option Pays existante dans vos paramètres de liste de sélection État et Pays/Territoire dans Salesforce. 
  • La valeur State doit exister en tant qu’option État/Province disponible pour la valeur Country de la fiche d’informations dans Salesforce. En outre, la valeur interne de l’option État propriété dans HubSpot doit correspondre à une option État existante dans Salesforce. 

Pour résoudre l’erreur Options incompatibles , il est recommandé de mettre à jour le nom interne/API des options de champ Salesforce pour qu’il corresponde à la valeur interne des options de propriété dans HubSpot. 

Pour résoudre l’erreur Propriétaire Salesforce inactif , réattribuez la fiche d’informations HubSpot à un utilisateur actif dans Salesforce. 

L’erreur Valeur de la liste de sélection restreinte se produit lorsque l’option Limiter la liste de sélection aux valeurs définies dans le paramètre de jeu de valeurs est activée pour le champ dans Salesforce. Lorsque cette option est activée dans Salesforce, la valeur que vous essayez de synchroniser de HubSpot vers Salesforce doit exister en tant qu’option dans la liste de sélection Salesforce. Il est recommandé de désactiver l’option Limiter la liste de sélection aux valeurs définies dans le paramètre de l’ensemble de valeurs dans Salesforce, afin que toutes les valeurs puissent être synchronisées de HubSpot à Salesforce. 

L’erreur Phase d’opportunité inactive se produit lorsqu’une opportunité Salesforce avec une phase d’opportunité inactive tente de se synchroniser avec HubSpot. Pour résoudre cette erreur, modifiez la phase d’opportunité dans Salesforce sur active ou déplacez-la vers une phase active. 

Pour résoudre l’erreur Propriétaires Salesforce non synchronisés , assurez-vous que le Type d’utilisateur des utilisateurs Salesforce est défini sur Standard, Partenaire Power ou Invité dans Salesforce. 

Pour résoudre l’erreur Limite d’options dépassée , il est recommandé de supprimer les options de propriété supplémentaires dans HubSpot et Salesforce que votre équipe n’utilise pas. En outre, assurez-vous que toutes les propriétés mappées ont des types de champs correspondants. 

Dans la plupart des cas, l’erreur Processus de vente indisponible par défaut se produit lorsque les opportunités Salesforce tentent de se synchroniser avec HubSpot avec un type de fiche d’informations manquant. Si vous avez activé les types de fiches d’informations dans Salesforce, mais que vous ne les utilisez pas, ou si vous avez des opportunités Salesforce sans type de fiche d’informations, il est recommandé de travailler avec Salesforce pour désactiver tous les types de fiches d’informations ou créer une nouvelle fiche d’informations Tapez

Pour résoudre l’erreur de phase d’opportunité manquante ou invalide , assurez-vous que la valeur de phase d’opportunité Salesforce existe dans le pipeline HubSpot. 

Mappage de propriétés

Exemples d’erreurs de mappage de propriétés 

  • Incompatibilité de types
  • ID Salesforce manquant
  • ID Salesforce non valide

Signification des erreurs

Les fiches d'informations ne sont pas synchronisées en raison d'une différence de mappage entre la propriété HubSpot et le champ Salesforce. En d'autres termes, les types de propriété et de champ ne sont pas compatibles, la propriété ou le champ n'existe plus ou un mappage de champ de référence Salesforce doit être créé.

Comment résoudre les erreurs 

Pour résoudre l’erreur d’incompatibilité de type , assurez-vous que le type de propriété dans HubSpot et le type de champ dans Salesforce sont compatibles. Découvrez-en davantage sur les types de champs de propriété HubSpot pouvant être synchronisés avec Salesforce

L’erreur ID Salesforce manquant se produit lorsque HubSpot tente de synchroniser une valeur autre qu’un identifiant Salesforce existant avec un champ de référence/recherche dans Salesforce. 

Pour résoudre l’erreur ID Salesforce non valide , il est recommandé de vérifier la règle de validation personnalisée configurée dans Salesforce

Valeurs de propriété

Exemples d’erreurs de valeurs de propriétés

  • Chaîne trop longue
  • E-mail non valide
  • Pays requis manquant
  • Valeur non valide
  • Attribution du propriétaire
  • Valeur unique restreinte
  • Valeur requise manquante

Signification des erreurs

Les fiches d'informations ne sont pas synchronisées entre HubSpot et Salesforce car elles incluent des valeurs de propriété qui ne sont pas valides. La résolution de ces erreurs nécessite généralement une mise à jour des fiches d'informations affectées.

Comment résoudre les erreurs

Pour résoudre l’erreur Chaîne trop longue , raccourcissez la valeur du champ dans Salesforce ou HubSpot ou augmentez la limite de caractères du champ dans Salesforce. 

Pour résoudre l’erreur E-mail non valide, mettez à jour le formatage de l’adresse e-mail sur la fiche d’informations Salesforce qui tente de se synchroniser avec HubSpot.

Pour résoudre l’erreur Pays requis manquant , il est recommandé de vérifier que les conditions suivantes sont remplies :

  • La valeur interne de l’option Pays propriété dans HubSpot doit correspondre à une option Pays existante dans vos paramètres de liste de sélection État et Pays/Territoire dans Salesforce. 
  • La valeur State doit exister en tant qu’option État/Province disponible pour la valeur Country de la fiche d’informations dans Salesforce. En outre, la valeur interne de l’option État propriété dans HubSpot doit correspondre à une option État existante dans Salesforce. 

Pour résoudre l’erreur Valeur non valide, il est recommandé de mettre à jour la valeur de propriété sur la fiche d’informations Salesforce afin de répondre aux exigences de HubSpot concernant la valeur de propriété. 

Dans la plupart des cas, l’erreur d’attribution du propriétaire se produit lorsqu’une activité HubSpot est synchronisée avec Salesforce en tant que tâche Salesforce et que HubSpot tente d’attribuer la tâche à un propriétaire de file d’attente Salesforce.

Pour résoudre l’erreur Valeur unique restreinte, il est recommandé de vérifier les règles correspondantes de déduplication configurées dans Salesforce. 

Pour résoudre l’erreur Valeur requise manquante, ajoutez une valeur à la fiche d’informations Salesforce pour toute propriété marquée comme requise dans HubSpot. 

Autre

Les fiches d'informations ne sont pas synchronisées en raison d'une erreur inconnue. Contactez le support HubSpot pour obtenir de l’aide concernant ces erreurs.

Remarque : Il est possible de resynchroniser en masse 100 erreurs Salesforce à la fois. Pour synchroniser plus de 100 erreurs, importez les enregistrements depuis Salesforce ou mettez à jour une propriété mappée.

Configurer les notifications d'erreur de synchronisation

  • Dans votre compte HubSpot, cliquez sur l'icône Paramètres settings dans la barre de navigation principale. Dans le menu latéral de gauche, accédez à Intégrations > Applications connectées.
  • Dans la liste des applications connectées, cliquez sur Salesforce
  • Cliquez sur l’onglet État de synchronisation
  • Dans Erreurs de synchronisation, cliquez sur Gérer les notifications
  • Dans la boîte de dialogue, activez l’option Activer les notifications
  • Sélectionnez la case d'option à côté de InstantanémentQuotidien ou Hebdomadaire pour définir la fréquence de vos notifications. 
  • Cliquez sur Enregistrer

sync-health-error-notifications

Cet article vous a-t-il été utile ?
Ce formulaire n'est utilisé que pour recueillir du feedback sur la documentation. Découvrez comment obtenir de l'aide sur HubSpot.