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

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

• Depuis votre compte HubSpot, accédez à Gestion des données > Intégrations.
• Dans la liste des applications connectées, cliquez sur Salesforce. 
• Cliquez sur l'onglet État de la synchronisation. 
• Dans la section Utilisation des appels d'API, le nombre d'appels d'API que vous avez passés au cours des dernières 24 heures s'affiche. 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 de ces appels pouvant être attribués à HubSpot, modifiez le champ Attribué à HubSpot. 

Résoudre les erreurs de synchronisation

• Depuis votre compte HubSpot, accédez à Gestion des données > Intégrations.
• Dans la liste des applications connectées, cliquez sur Salesforce. 
• Cliquez sur l'onglet État de la synchronisation. 
• Dans Erreurs de synchronisation, vous verrez les cartes pour chaque type d'erreur, avec le nombre d'erreurs actuelles et les fiches d'informations affectées par chacune d'elles. Cliquez sur une carte de type d'erreur pour afficher les détails des erreurs dans le panneau de droite. Consultez la section ci-dessous pour en savoir plus sur les étapes de résolution pour chaque type d'erreur.  

Associations

Les fiches d'informations ne sont pas synchronisées car elles sont associées à des fiches d'informations qui n'ont pas encore été synchronisées avec HubSpot ou parce qu'elles sont associées à des fiches d'informations ayant atteint la limite d'associations de HubSpot. Dans la colonne Fiches d'informations affectées, vous trouverez toutes les fiches d'informations qui ne sont pas synchronisées en raison d'une association avec la fiche d'informations dans la colonne Fiche d'informations sur la gauche.

• Pour consulter les détails et les étapes de résolution d'une erreur, cliquez sur l'icône d'informations info dans la colonne Type d'erreur.
• Pour exécuter une action pour une fiche d'informations, cliquez sur [#] fiches d'informations dans la colonne Fiches d'informations affectées, puis cliquez sur Créer une vue pour créer une vue filtrée des fiches d'informations affectées. 
• Une fois que vous avez résolu les erreurs, revenez à la liste des erreurs Associations. Sélectionnez la case à cocher à gauche d'une erreur résolue et cliquez sur Resynchroniser.
• Pour exporter les erreurs, cliquez sur Exporter les erreurs dans l'angle supérieur droit.

Code personnalisé

Les fiches d'informations ne sont pas synchronisées en raison d'un problème lié à l'automatisation, aux flux ou aux règles de validation dans votre compte Salesforce. Les informations concernant la cause de l'erreur apparaitront dans la colonne Détails de l'erreur. 

• Pour consulter les détails et les étapes de résolution d'une erreur, cliquez sur l'icône d'informations info dans la colonne Type d'erreur.
• Selon les détails de l'erreur, vous devrez mettre à jour les fiches d'informations affectées ou modifier vos paramètres Salesforce. Pour exécuter une action pour une fiche d'informations dans HubSpot, cliquez sur [#] fiches d'informations dans la colonne Fiches d'informations affectées, puis cliquez sur Créer une vue pour créer une vue filtrée des fiches d'informations affectées.
• Une fois que vous avez résolu les erreurs, revenez à la liste des erreurs Code personnalisé. Sélectionnez la case à cocher à gauche d'une erreur résolue et cliquez sur Resynchroniser.
• Pour exporter les erreurs, cliquez sur Exporter les erreurs dans l'angle supérieur droit.

Doublons

Les fiches d'informations ne peuvent pas être créées car il existe un doublon concernant une fiche d'informations ou une valeur. Les fiches d'informations HubSpot et Salesforce affectées par l'erreur ainsi que la valeur dupliquée apparaitront.

• Pour consulter les détails et les étapes de résolution d'une erreur, cliquez sur l'icône d'informations info dans la colonne Type d'erreur.
• Cliquez sur HubSpot ou Salesforce dans la colonne Afficher la fiche d'informations dans pour accéder à la fiche d'informations et apporter des modifications.
• Une fois que vous avez résolu les erreurs, revenez à la liste des erreurs Doublons. Sélectionnez la case à cocher à gauche d'une erreur résolue et cliquez sur Resynchroniser.
• Pour exporter les erreurs, cliquez sur Exporter les erreurs dans l'angle supérieur droit.

Autorisations

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.

• Pour consulter les détails et les étapes de résolution d'une erreur, cliquez sur l'icône d'informations info dans la colonne Type d'erreur.
• Analysez et mettez à jour les autorisations pour l'utilisateur connecté dans vos paramètres Salesforce.
• Une fois que vous avez résolu les erreurs, revenez à la liste des erreurs Autorisations. Sélectionnez la case à cocher à gauche d'une erreur résolue et cliquez sur Resynchroniser.
• Pour exporter les erreurs, cliquez sur Exporter les erreurs dans l'angle supérieur droit.

Listes de sélection

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. La propriété HubSpot, le champ Salesforce à l'origine de l'erreur ainsi que le nombre de fiches d'informations affectées apparaitront pour chaque erreur. 

• Pour consulter les détails et les étapes de résolution d'une erreur, cliquez sur l'icône d'informations info dans la colonne Type d'erreur.
• Selon les détails de l'erreur, vous devrez mettre à jour les valeurs des fiches d'informations affectées, ou modifier la propriété ou le champ. Pour exécuter une action pour une fiche d'informations dans HubSpot, cliquez sur [#] fiches d'informations dans la colonne Fiches d'informations affectées, puis cliquez sur Créer une vue pour créer une vue filtrée des fiches d'informations affectées.
• Une fois que vous avez résolu les erreurs, revenez à la liste des erreurs Listes de sélection. Sélectionnez la case à cocher à gauche d'une erreur résolue et cliquez sur Resynchroniser. 
• Pour exporter les erreurs, cliquez sur Exporter les erreurs dans l'angle supérieur droit.

Mappage de propriétés

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éé.

• Pour consulter les détails et les étapes de résolution d'une erreur, cliquez sur l'icône d'informations info dans la colonne Type d'erreur.
• Mettez à jour vos mappages de propriétés. 
• Une fois que vous avez résolu les erreurs, revenez à la liste des erreurs Mappage de propriétés. Sélectionnez la case à cocher à gauche d'une erreur résolue et cliquez sur Resynchroniser. 
• Pour exporter les erreurs, cliquez sur Exporter les erreurs dans l'angle supérieur droit.

Valeurs de propriété

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.

• Pour afficher des informations supplémentaires et les étapes de résolution, cliquez sur l'icône d'informations info dans la colonne Type d'erreur.
• Mettez à jour les valeurs non valides dans HubSpot ou Salesforce. Pour afficher une liste des fiches d'informations affectées dans HubSpot, cliquez sur [#] fiches d'informations dans la colonne Fiches d'informations affectées, puis cliquez sur Créer une vue pour créer une vue filtrée. 
• Une fois que vous avez résolu les erreurs, revenez à la liste des erreurs Valeurs de propriété. Sélectionnez la case à cocher à gauche d'une erreur résolue et cliquez sur Resynchroniser. 
• Pour exporter les erreurs, cliquez sur Exporter les erreurs dans l'angle supérieur droit.

Autre

Les fiches d'informations ne sont pas synchronisées en raison d'une erreur inconnue. Veuillez contacter le Support HubSpot pour obtenir de l'aide.

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

Configurer les notifications d'erreur de synchronisation

• Depuis votre compte HubSpot, accédez à Gestion des données > Intégrations.
• Dans la liste des applications connectées, cliquez sur Salesforce. 
• Cliquez sur l'onglet État de la synchronisation. 
• Dans Erreurs de synchronisation, cliquez sur Gérer les notifications. 
• Dans la boîte de dialogue, cliquez sur le bouton Activer les notifications. 
• Sélectionnez la case d'option à côté de Instantanément, Quotidien ou Hebdomadaire pour définir la fréquence de vos notifications. 
• Cliquez sur Enregistrer.