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.

Mapper des propriétés HubSpot à des champs Salesforce

Dernière mise à jour: 27 mars 2026

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

Après avoir installé l’intégration HubSpot-Salesforce, mappez les propriétés HubSpot avec les champs Salesforce afin de garantir la cohérence des données entre les deux systèmes. Lorsque les champs sont mappés, les mises à jour effectuées dans un système peuvent être synchronisées dans l’autre, en fonction de vos paramètres de synchronisation.

Par exemple, vous pouvez mapper une propriété de contact HubSpot, comme Intitulé de poste , à un champ de lead ou de contact Salesforce afin que les fiches d’informations restent alignées sur les deux plateformes.

Créer ou modifier des mappages de champs

Ajouter un nouveau mappage de champs

  1. 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.
  2. Dans la liste des applications connectées, cliquez sur Salesforce.
  3. Cliquez sur l’onglet correspondant à l’objet que vous souhaitez mapper : Contacts, Entreprises ou Transactions.
  4. Cliquez sur l’onglet Mappages de propriétés de [objet].

Remarque : La synchronisation d’objet doit être activée pour les entreprises ou les transactions entre HubSpot et Salesforce pour configurer des mappages de champs d’entreprise ou de transaction.

  1. Pour ajouter une nouvelle réunion de champ, cliquez sur Ajouter un nouveau mappage de champs.
  2. Dans le panneau de droite, utilisez les menus déroulants pour sélectionner la propriété HubSpot et le champ Salesforce que vous souhaitez mapper. Vous devez sélectionner une propriété et des champs compatibles pour créer un mappage. Le tableau suivant indique les types de champs de propriétés HubSpot qui peuvent être synchronisés avec Salesforce, les noms d’API correspondants et les types de champs Salesforce correspondants.
Type de champ de propriété HubSpot Type de champ Salesforce
Menu déroulant/case d’option

liste de sélection, référence

Plusieurs cases à cocher liste de sélection multiple
Case à cocher unique booléen
Nombre double/int
Texte sur une seule ligne chaîne, zone de texte
Texte de plusieurs lignes Zone de texte
Sélecteur de dates date, datetime

Remarque :

  • En cas d’incompatibilité de type ou si l’une des propriétés ou l’un des champs sélectionnés est déjà mappé, un message apparaîtra au-dessus des menus déroulants. Cliquez sur le message pour en savoir plus.
  • Aucune propriété personnalisée avec le type de champ utilisateur HubSpot ne peut être mappée aux champs Salesforce.

 

  1. Cliquez sur Suivant.

Sélectionnez une règle de synchronisation

  1. La règle de synchronisation pour votre mappage détermine la façon dont les données seront synchronisées entre HubSpot et Salesforce. Sélectionnez une règle de synchronisation parmi les options suivantes :
    • Préférer Salesforce à moins qu’elle ne soit vide
      • HubSpot ne transmettra des données à Salesforce que s’il n’y a actuellement aucune valeur dans Salesforce.
      • Si une valeur existe dans Salesforce, cette valeur remplacera toujours la valeur existante dans HubSpot.
      • Si vous supprimez la valeur dans Salesforce, la valeur sera également supprimée dans HubSpot.
    • Toujours utiliser Salesforce
      • HubSpot ne transmettra jamais de données à Salesforce, même si Salesforce ne contient aucune valeur.
      • Si une valeur existe dans Salesforce, elle remplacera toujours la valeur existante dans HubSpot.
      • Si vous supprimez la valeur dans Salesforce, la valeur sera également supprimée dans HubSpot.
    • Bidirectionnel
      • Les valeurs les plus récentes remplaceront toujours les valeurs existantes.
      • Si la valeur est supprimée dans HubSpot, elle le sera également dans Salesforce, et vice versa.
    • Ne pas synchroniser
      • Les données ne seront jamais transférées entre HubSpot et Salesforce.
      • Si la valeur est supprimée dans HubSpot, elle ne sera pas supprimée dans Salesforce, et vice versa.

Remarque :
  • Bien que votre compte HubSpot puisse afficher Préférez Salesforce à moins qu’elle ne soit vide pour le mappage du propriétaire, le mappage du propriétaire ne peut être mappé que de manière bidirectionnelle entre HubSpot et Salesforce. La valeur du champ Propriétaire doit correspondre exactement entre HubSpot et Salesforce.
  • Les valeurs existantes dans un mappage nouvellement créé ne seront pas synchronisées rétroactivement. Pour synchroniser des valeurs existantes, vous pouvez resynchroniser manuellement la fiche d’informations dans HubSpot à partir de la carte de synchronisation Salesforce, resynchroniser un segment HubSpot pour synchroniser en masse les valeurs avec Salesforce, ou exécuter un import Salesforce pour synchroniser en masse les valeurs avec HubSpot.
  1. Cliquez sur Enregistrer pour enregistrer le mappage.

Le nouveau mappage apparaîtra désormais dans la liste des mappages pour l’objet sélectionné. Pour modifier un mappage existant, placez le curseur dessus et cliquez sur Modifier le mappage.

Une fois les mappages ajoutés, commencez à synchroniser l’objet sélectionné avec Salesforce en activant le bouton Synchroniser [objet]. Pour les contacts, cette option est activée par défaut et ne peut pas être désactivée.

Remarque : Il existe une limite de 500 mappages de champs par objet.

Synchronisation du propriétaire

HubSpot considère les utilisateurs Salesforce Standard, PowerPartner, invités et en file d’attente comme des propriétaires Salesforce lorsque :

  • Ils sont importés dans HubSpot à partir de Salesforce.
  • L’utilisateur Salesforce est propriétaire d’une fiche d’informations de lead, de contact, de compte ou d’opportunité qui se synchronise avec HubSpot.

Par défaut, le champ ID du propriétaire d’une fiche d’informations Salesforce d’un lead, d’un contact, d’un compte ou d’une opportunité sera synchronisé avec la propriété Propriétaire du contact, de l’entreprise ou de la transaction HubSpot.

Comment fonctionne la synchronisation du propriétaire

Tous les propriétaires Salesforce peuvent se synchroniser avec HubSpot. Cependant, seuls les propriétaires de HubSpot qui correspondent au nom et à l’adresse e-mail d’un utilisateur Salesforce actif seront synchronisés avec Salesforce. Si HubSpot tente de synchroniser un propriétaire qui n’existe pas dans Salesforce, le champ ID du propriétaire sera réinitialisé sur la dernière valeur de Salesforce.

Les règles d’attribution du propriétaire Salesforce diffèrent selon les contacts, les entreprises et les transactions. Selon la règle, HubSpot peut créer un nouvel objet dans Salesforce ou synchroniser à un objet Salesforce existant. Si vous utilisez la synchronisation de la chronologie, découvrez-en davantage sur la façon dont les propriétaires sont synchronisés pour les activités.

Comportement d’attribution du propriétaire du contact

Si un contact HubSpot crée un nouveau lead Salesforce et se voit attribuer un propriétaire HubSpot qui correspond au nom et à l’adresse e-mail d’un utilisateur Salesforce actif avant la première synchronisation avec Salesforce, ce propriétaire sera attribué dans Salesforce. Dans le cas contraire, les règles d’attribution des leads de Salesforce s’appliqueront.

Après l’attribution initiale du propriétaire dans HubSpot ou Salesforce, les modifications apportées à la propriété Propriétaire du contact dans HubSpot ou au champ ID de propriétaire dans Salesforce seront synchronisées avec l’autre système.

Si un contact HubSpot se synchronise avec un lead Salesforce existant avec un propriétaire Salesforce actif, les règles d’attribution des leads Salesforce ne s’appliqueront pas et le propriétaire Salesforce existant sera maintenu lors de la première synchronisation. Lors des synchronisations suivantes, la valeur du propriétaire la plus récente sera mise à jour dans l’autre système.

Remarque : Salesforce exige que les fiches d’informations aient des valeurs de propriétaire . Lorsqu’une fiche d’informations HubSpot non attribuée est synchronisée avec Salesforce et qu’une nouvelle fiche d’informations est créée, son propriétaire sera défini comme étant l’utilisateur Salesforce qui l’a créée, c’est-à-dire l’utilisateur de l’intégration dans le compte HubSpot.

Mapper les champs de référence Salesforce avec HubSpot

Les valeurs des champs de référence Salesforce se synchronisent avec HubSpot en tant qu’ID de fiches d’informations à 18 chiffres et non en tant qu’étiquettes. Bien que HubSpot ne puisse pas récupérer automatiquement ces libellés, vous pouvez mapper les champs de référence Salesforce à une propriété de menu déroulant HubSpot afin de rendre les valeurs utilisables pour la segmentation et le reporting dans HubSpot. 

  1. Dans votre compte HubSpot, créez une propriété personnalisée HubSpot avec un type de champ à menu déroulant.
  2. Mappez le champ de référence Salesforce à la nouvelle propriété personnalisée HubSpot.
  3. Dans votre compte HubSpot, cliquez sur l'icône Paramètres settings dans la barre de navigation principale.
  4. Dans le menu latéral de gauche, accédez à Propriétés.
  5. Cliquez sur le nom de la propriété personnalisée utilisée dans le mappage de champs.
  6. Dans le menu latéral de gauche, cliquez sur Type de champ
  7. Dans la section Options du menu déroulant , la colonne Nom interne affiche l’ID de fiche d’informations à 18 chiffres pour chaque valeur de champ de référence de Salesforce. Saisissez les libellés de valeur de champ correspondants de Salesforce dans les champs Libellé .
  8. Dans le coin supérieur droit, cliquez sur Enregistrer.

Vous pourrez désormais segmenter le champ de référence en fonction des libellés des valeurs de champ, au lieu des ID de fiche d’informations des valeurs de champ.

Remarque : Cette méthode nécessite une maintenance continue. Si une nouvelle valeur est ajoutée au champ de référence Salesforce, le libellé de l’option correspondante dans la propriété HubSpot doit être modifié manuellement en suivant les étapes ci-dessus.

Résoudre les erreurs de mappage de champs

Lorsqu’un mappage de champs comporte des erreurs ou doit être mis à jour, il se peut que les données ne puissent pas être transférées entre HubSpot et Salesforce. Pour corriger ou actualiser les mappages de champs :

  1. 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.
  2. Cliquez sur Salesforce.
  3. Cliquez sur l’onglet État de synchronisation .
  4. S’il y a des erreurs ou des avertissements de synchronisation, ils apparaîtront dans la section Erreurs de synchronisation . Cliquez sur le type d’erreur de synchronisation pour voir plus d’informations, les fiches d’informations affectées et prendre d’autres mesures.
  5. Si un mappage comprend un champ de liste de sélection Salesforce, vous pouvez actualiser le champ pour rechercher de nouvelles options de liste de sélection dans Salesforce et ajouter les options à la propriété du menu déroulant correspondante dans HubSpot. Pour ce faire, passez le curseur de la souris sur le mappage et cliquez sur Actualiser.

Remarque : Lors de la resynchronisation en masse des mappages de champs d’entreprise/compte, HubSpot ne peut pas synchroniser plus de 200 000 entreprises en même temps. Cela peut entraîner une Impossible de synchroniser toutes vos mises à jour pour cette erreur de mappage .

Supprimer les mappages de champs personnalisés

Si vous ne souhaitez plus synchroniser les données entre une propriété HubSpot et un champ Salesforce dans un mappage de champs personnalisés, vous pouvez supprimer le mappage.

Remarque : Seuls les mappages de champs personnalisés peuvent être supprimés dans HubSpot. Les mappages de champs standards ne peuvent pas être supprimés, mais la synchronisation des données peut être arrêtée en définissant la règle de mise à jour sur Ne pas synchroniser. Cela ne s’applique pas à la propriété de contact Désabonné de tous les e-mails

  1. 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.
  2. Cliquez sur Salesforce.
  3. Cliquez sur l’onglet d’objet pour le mappage : Contacts, Entreprises ou Transactions.
  4. Cliquez sur l’onglet Mappages de propriétés de [objet].
  5. Passez le curseur de la souris sur le mappage et cliquez sur Supprimer le mappage.

Exporter les mappages de champs

Pour exporter la liste des mappages de champs :

  1. 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.
  2. Cliquez sur Salesforce.
  3. Cliquez sur l’onglet Objet pour les mappages que vous souhaitez exporter : Contacts, Entreprises ou Transactions.
  4. Cliquez sur l’onglet Mappages de propriétés de [objet].
  5. Cliquez sur Exporter des mappages de champs (CSV).
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.