Comprendre la clé de dédoublonnage

On me demande de choisir la clé de dédoublonnage du projet. Qu'est-ce que ça veut dire concrètement, et comment je décide ?

La clé est la propriété qui permet à HubSpot de dire « c'est la même fiche ». Par défaut. L'email pour les contacts, le nom de domaine pour les entreprises, l'ID de fiche pour tous les autres objets. Ce n'est pas un choix technique mais une décision métier, et elle se prend avant le premier import, parce qu'une propriété à valeur unique ne se configure qu'à sa création.

Le piège à connaître. La clé de dédoublonnage détermine ce que HubSpot considère comme un doublon. Deux fiches manifestement identiques pour un humain resteront séparées si la clé diffère.

Pourquoi la clé détermine ce que HubSpot considère comme un doublon

Le dédoublonnage est le sujet le plus sous-estimé d'un projet CRM. On le traite comme une action technique alors que c'est une logique métier. Décider que deux enregistrements sont la même chose, c'est décider ce qu'est un client pour l'entreprise.

Ce qui fait une bonne clé. Trois critères, et il est rare qu'une propriété les remplisse tous les trois :

Elle est stable dans le temps. L'email échoue ici. Il change quand la personne change d'employeur.
Elle est unique. Le nom d'entreprise échoue ici. Deux sociétés peuvent porter le même nom, et HubSpot ne contrôle rien là-dessus.
Elle est toujours renseignée. Le SIRET échoue souvent ici. Il est parfait sur le papier et absent dans la moitié des fichiers clients.

Les clés par défaut de HubSpot, objet par objet :

Contact. L'adresse email, ou à défaut l'ID de fiche.
Entreprise. Le nom de domaine, ou à défaut l'ID de fiche.
Transaction, ticket, activités, objets personnalisés. L'ID de fiche est la seule clé par défaut. Il n'existe aucune clé métier native.
Produit. L'ID de fiche ou le SKU.

Créer sa propre clé. HubSpot permet de créer une propriété personnalisée exigeant des valeurs uniques, par exemple pour un SIRET ou un code client. Les règles sont strictes. Dix propriétés à valeur unique maximum par objet, configurable uniquement au moment de la création de la propriété, et seulement sur les types texte, numéro de téléphone et nombre.

Et une asymétrie qu'il faut connaître avant de décider. Si vous définissez une clé unique personnalisée sur les contacts, l'email continue malgré tout d'exiger l'unicité. Sur les entreprises, en revanche, le nom de domaine n'exige plus l'unicité. Vous pourrez alors importer des domaines en double. Ce n'est pas symétrique, et cela change les conséquences de votre choix.

En pratique, comprendre la clé de dédoublonnage

La démarche est une décision, pas une manipulation.

Étape 1 — Regarder la donnée réelle, pas la donnée idéale

Sur le fichier source du client, mesurez le taux de remplissage de chaque candidat. Email, domaine, SIRET, code client.
Comptez les doublons internes au fichier pour chacun.
Vous saurez alors lesquels sont réellement utilisables, ce qui élimine souvent la moitié des candidats.

Étape 2 — Poser la question métier

Demandez au client. « Deux lignes qui ont le même [candidat], est-ce toujours le même client pour vous ? » Et la question inverse. « Deux lignes qui ont un [candidat] différent, est-ce toujours deux clients différents ? » Si l'une des deux réponses est non, ce n'est pas votre clé.

Étape 3 — Décider et documenter

Écrivez la clé retenue dans le document de cadrage, avec la règle appliquée aux cas limites. C'est ce document qui évitera les discussions six mois plus tard.

Étape 4 — Créer la propriété, si besoin

Allez dans Paramètres > Propriétés et sélectionnez l'objet.
Cliquez sur Créer une propriété.
Choisissez un type texte sur une ligne, nombre ou numéro de téléphone.
Ouvrez les options supplémentaires, puis l'onglet des règles.
Cochez l'option exigeant des valeurs uniques.
Créez la propriété. Cette case n'est plus modifiable ensuite.

Étape 5 — Traiter les doublons déjà présents

Allez dans CRM > Contacts ou Entreprises, puis Actions et la gestion des doublons. Examinez les paires proposées et fusionnez ou rejetez. La fusion en masse et les règles personnalisées demandent Data Hub Professional ou Entreprise.

À surveiller sur la clé de dédoublonnage HubSpot

La décision se prend avant, jamais après. Une propriété à valeur unique ne s'active pas après coup. Il faut créer une nouvelle propriété, migrer les valeurs, puis reprendre toutes les vues, rapports et workflows qui utilisaient l'ancienne.
Dix propriétés à valeur unique par objet. Largement suffisant, mais ce n'est pas illimité.
L'unicité n'est pas appliquée partout. Elle ne l'est pas dans les formulaires de l'ancien éditeur, ni dans les workflows, les chatflows et les pages de planification. À la conversion d'un visiteur en contact, une valeur qui violerait l'unicité est effacée.
Les entreprises créées par API échappent au dédoublonnage par domaine, et cela inclut les applications de synchronisation tierces. Votre clé ne protège pas ce flux.
L'email est une mauvaise clé et pourtant c'est celle par défaut. Il change. Prévoyez dès le départ la façon dont vous mettrez à jour un email sans créer de doublon, à savoir l'ID de fiche. Voyez Ce que change le choix de l'email comme clé d'import.
Les fusions sont irréversibles. L'outil de gestion des doublons ne couvre que les contacts et les entreprises, et demande un abonnement Professional ou Entreprise.
Une clé mal choisie ne se voit pas tout de suite. Elle se voit au troisième import, quand les doublons deviennent visibles et que le coût de la reprise a triplé. C'est pour cela que ce sujet mérite une heure de cadrage et non cinq minutes.

Quand nous contacter sur la clé de dédoublonnage HubSpot

Ce sujet ne se traite pas seul. Contactez Yuzu Corp au cadrage du projet, avant le premier import. Le choix de la clé conditionne tous les imports suivants, il n'est pas modifiable sans coût, et il dépend de la réalité de vos données autant que de votre logique métier. Ouvrez également un ticket avant toute création de propriété à valeur unique et avant toute fusion en masse.

Sources et date de vérification

Contenu vérifié sur la documentation officielle le 18 août 2026 par Yuzu Corp, partenaire HubSpot Diamond.