Faire correspondre les fiches entre deux outils
Les deux temps du rapprochement, les trois clés qui fonctionnent en pratique, et comment poser un code externe proprement.
Comment HubSpot sait-il qu'une fiche de notre autre outil correspond à une fiche du CRM, et comment garder ce lien dans le temps ?
Il faut distinguer deux temps, et c'est la clé du sujet.
Au premier passage, le rapprochement se fait sur une clé métier. L'adresse email pour les contacts et les leads, le nom ou le domaine pour les entreprises, le code produit ou le nom pour les produits.
Ensuite, le lien vit sur les identifiants d'enregistrement internes, de part et d'autre. La clé métier ne sert plus.
Conséquence pratique, et elle est structurante. Tout se joue avant la première synchronisation. Après, vous ne pilotez plus l'appariement, vous en héritez.
Le piège à connaître. Une fois deux fiches appariées, la synchronisation vit sur les identifiants internes et plus sur votre clé métier. Changer la clé ensuite ne s'applique qu'aux fiches non encore appariées.
Pourquoi la clé métier ne sert plus après le premier appariement
Pourquoi HubSpot bascule sur les identifiants internes. Une clé métier change. Une adresse email se corrige, une raison sociale évolue, un domaine est racheté. Si la synchronisation restait accrochée à la clé métier, chaque correction casserait le lien. En basculant sur les identifiants, HubSpot rend la liaison stable. C'est un bon choix technique, et il vous enlève la main.
Le rapprochement ne dépend pas des mappages. Deux fiches produit continueront d'être appariées sur le code produit même si vous avez coupé le mappage de ce champ. Autrement dit, désactiver un mappage ne désactive pas la logique d'appariement.
Sur une clé personnalisée, un avertissement explicite. La documentation signale qu'un choix de clé personnalisée peut produire des doublons, parce que la synchronisation dépend du rapprochement.
Côté import, le vocabulaire est différent mais la logique est la même. L'identifiant d'enregistrement est la clé par défaut pour les transactions, les tickets, les rendez-vous, les activités et les objets personnalisés. Et surtout, s'il est mappé, il prime sur toute autre clé.
Deux asymétries d'import à connaître. Pour les contacts, l'adresse email continue d'exiger des valeurs uniques même avec une clé personnalisée. Pour les entreprises, le domaine n'exige pas de valeurs uniques, ce qui autorise l'import de domaines en doublon.
Un piège d'écrasement silencieux. Si un fichier d'import contient à la fois une adresse email secondaire et un identifiant d'enregistrement, l'adresse secondaire remplace l'adresse principale.
En pratique, définir une clé de rapprochement tenable
La question à trancher avant tout montage
Quelle valeur, présente des deux côtés, identifie sans ambiguïté la même entité du monde réel ? Si vous n'avez pas de réponse, aucun outil ne la trouvera pour vous.
Les trois clés qui fonctionnent en pratique
L'adresse email pour une personne, à condition qu'elle soit nominative et non générique. Le domaine pour une entreprise, à condition qu'il soit renseigné et propre. Un code interne pour tout le reste, à stocker dans une propriété HubSpot dédiée et à exiger unique.
Comment poser un code externe proprement
- Créez une propriété de texte sur l'objet concerné, nommée sans ambiguïté, par exemple un identifiant de l'outil source.
- Activez l'exigence de valeurs uniques à la création, puisque ce réglage ne se pose qu'à ce moment.
- Alimentez-la avant la première synchronisation.
Le contrôle à faire avant d'élargir
Prenez vingt fiches au hasard des deux côtés et vérifiez l'appariement à la main. C'est fastidieux, et c'est infiniment moins coûteux qu'une reprise sur dix mille fiches.
Ce qu'il ne faut pas faire
S'appuyer sur le nom d'entreprise comme clé. La normalisation retire la casse et la ponctuation, et deux entités distinctes peuvent être appariées.
À surveiller sur la correspondance des fiches entre deux outils
- Après le premier appariement, le lien vit sur les identifiants internes, plus sur votre clé métier.
- Le rapprochement fonctionne même si le mappage du champ est coupé.
- Une clé personnalisée peut produire des doublons, la documentation le signale explicitement.
- À l'import, l'identifiant d'enregistrement prime sur toute autre clé dès qu'il est mappé.
- L'email reste unique pour les contacts, le domaine ne l'est pas pour les entreprises.
- Une adresse secondaire accompagnée d'un identifiant remplace l'adresse principale.
- L'exigence de valeurs uniques ne se règle qu'à la création de la propriété.
Articles liés à la correspondance des fiches entre deux outils
- Éviter les conflits et les doublons de synchronisation
- Migrer les associations entre objets
- Éviter les doublons d'entreprise à la création
Quand nous contacter sur la correspondance des fiches entre deux outils
Contactez Yuzu Corp pour définir votre clé de rapprochement. C'est la décision la plus déterminante d'un projet d'intégration, et la seule qui se prenne une fois pour toutes.
Pour aller plus loin, découvrez notre offre RevOps.
Auteur, sources et date de vérification
Rédigé par Quentin Préchoux
Fondateur de Yuzu Corp · 8 ans sur HubSpot · Nantes & Paris
Yuzu Corp est partenaire HubSpot Diamond et membre du Claude Partner Network
Publié le 5 septembre 2026 · Vérifié sur HubSpot le 1 septembre 2026