HubSpot — mappage des champs et objets personnalisés

Cet article explique comment les propriétés Katalyz s'associent aux propriétés standard et aux objets personnalisés de HubSpot.

Pour la référence principale sur le mappage des champs, voir Mappage et synchronisation des champs CRM — c'est l'article admin complet. Celui-ci se concentre sur les spécificités côté intégration.

Objets HubSpot pris en charge

• Contacts
• Companies (entreprises)
• Transactions
• Objets HubSpot personnalisés (si votre portail en utilise)
• Tâches
• Timeline events (événements de timeline)

Associer des objets HubSpot personnalisés

Associer un objet HubSpot personnalisé suit le même parcours que pour n'importe quel objet standard — utilisez l'interface de mappage documentée dans Mappage et synchronisation des champs CRM. Les objets personnalisés apparaissent dans le sélecteur à condition que votre installation HubSpot ait accordé les scopes crm.schemas.custom.read / crm.objects.custom.read|write (voir Connecter HubSpot).

Deux écrans, deux rôles

Le mappage se règle à deux endroits, et il vaut mieux savoir lequel sert à quoi.

Le catalogue des propriétés

Paramètres → Données → Objets personnalisés liste vos propriétés sous trois onglets — Espaces, Participants, Actions — avec un champ Rechercher, un tri et un filtre. Chaque ligne porte six colonnes :

• Propriété — son nom.
• Origine — Built-in pour les propriétés natives non modifiables (Entreprise, Transaction…), Katalyz pour celles créées chez vous, Importée depuis HubSpot pour celles rapatriées du CRM.
• Mappée avec — soit une pastille au logo HubSpot portant le nom de la propriété associée, soit un bouton Ajouter un mapping si la propriété n'est encore reliée à rien.
• Créée par — l'avatar de la personne.
• Utilisée dans — le nombre d'Espaces qui portent une valeur pour ce champ. Très utile avant de supprimer ou de renommer quoi que ce soit.
• Description.

C'est donc ici qu'on voit d'un coup d'œil ce qui n'est pas encore associé : toutes les lignes affichant Ajouter un mapping.

La vue d'ensemble des paires

Paramètres → Données → Hubspot, encadré Champs synchronisés (« Mappez vos champs Katalyz aux propriétés HubSpot »).

Chaque ligne est une paire reliée par une double flèche ⇄ : un champ Katalyz à gauche, une propriété HubSpot à droite. (Les deux en-têtes de colonne sont encore en anglais dans l'application — Katalyz field et HubSpot property.)

• + Ajouter une nouvelle cartographie, en haut à droite, ajoute une ligne vide en bas de la liste.
• Actualiser la liste, à côté, relit les propriétés depuis HubSpot. Utilisez-le après avoir créé une propriété côté HubSpot pour qu'elle apparaisse dans le sélecteur.
• Le × en bout de ligne supprime l'association.

Deux champs écrits par l'IA

Katalyz génère deux valeurs par Espace qu'il vaut la peine d'associer dès le premier jour :

Les deux sont rafraîchis au fil de l'évolution de l'Espace : la fiche CRM porte donc une lecture à jour de la santé du deal sans que personne n'ait à la mettre à jour à la main. Voir Paramètres IA.

Associations pré-configurées

En dehors de ces deux-là, il n'y a aucune association par défaut. Après avoir connecté HubSpot, vous partez d'une page blanche — toutes les autres associations sont celles que vous créez explicitement dans l'interface de mappage.

Importer les champs depuis HubSpot — recommandé

Plutôt que de créer chaque champ Katalyz à la main puis de l'associer à une propriété HubSpot, importez les champs directement depuis HubSpot. L'application elle-même marque cette voie Recommandé.

Cela ne se passe pas sur la page Hubspot mais dans Paramètres → Données → Objets personnalisés. Le bouton + Ajouter une propriété, en haut à droite, ouvre une boîte de dialogue à deux choix :

• Importer depuis HubSpot (Recommandé) — « Importez une propriété directement depuis HubSpot. Ses options et ses détails resteront automatiquement synchronisés dans le temps. »
• Créer une nouvelle propriété — « Créez une nouvelle propriété qui n'existera que dans Katalyz. Vous pourrez la mapper à des champs d'applications externes, mais ses options et ses détails ne resteront pas automatiquement synchronisés dans le temps. »

C'est en une phrase toute la différence entre les deux méthodes.

Concrètement, quand vous importez une propriété HubSpot :

• Katalyz recrée la même structure de champ côté Katalyz — même type (texte, nombre, date, liste déroulante…), mêmes options pour les listes déroulantes (valeurs et libellés alignés), même formatage (devise, date-heure, etc.).
• L'association est créée automatiquement — vous n'avez pas à repointer le champ Katalyz vers la bonne propriété HubSpot.
• La structure reste préservée : si vous ajoutez plus tard une option à une liste déroulante HubSpot, l'import garde les deux côtés alignés.

Pourquoi c'est préférable :

• Moins d'erreurs — pas d'options divergentes entre les deux listes déroulantes (voir ci-dessous).
• Plus rapide — une étape par champ au lieu de deux (créer + associer).
• Plus fiable — la source de vérité pour la structure des champs reste HubSpot ; Katalyz la reflète.

Quand la création manuelle a-t-elle du sens ? Pour les champs propres à Katalyz qui ne sont pas (et ne devraient pas être) dans HubSpot — par ex. un champ purement interne à la collaboration dans l'Espace.

Compatibilité des types de champ

Vous ne pouvez pas associer deux types incompatibles : la liste des propriétés HubSpot est filtrée par le type du champ Katalyz choisi sur la ligne.

Le parcours, sur une ligne vide :

1. Le sélecteur de droite reste grisé tant qu'aucun champ Katalyz n'est choisi.
2. Vous ouvrez le sélecteur de gauche : les champs Katalyz y sont regroupés par objet (Espace…), avec un champ Rechercher en haut. Ceux déjà associés sur une autre ligne sont grisés.
3. Dès qu'un champ Katalyz est choisi, le sélecteur de droite s'active et ne propose plus que les propriétés d'un type compatible, elles aussi regroupées par objet HubSpot (Entreprise…). Les propriétés déjà utilisées ailleurs sont grisées : une propriété ne sert qu'une fois.

Deux exemples relevés sur un portail réel :

Vous n'avez donc pas de tableau de correspondance à retenir : si une propriété n'apparaît pas dans la liste, c'est que son type ne convient pas au champ Katalyz sélectionné.

Les listes déroulantes : les options doivent correspondre

Le filtrage porte sur le type, pas sur les valeurs. Deux listes déroulantes sont toujours associables, même si leurs options diffèrent — et c'est la seule incompatibilité que l'interface laisse créer.

Elle n'est pas silencieuse : la ligne concernée affiche une pastille rouge à droite de la propriété HubSpot. Survolez-la pour voir ce qui manque de chaque côté, nommément :

Les options de ces champs Katalyz et CRM ne semblent pas correspondre. La synchronisation pourrait ne pas fonctionner.
Manquants dans le CRM : Not started, Qualified, Churned
Manquants dans Katalyz : Oppty: DM & timing & pricing, Win: signed & payment tbd…

Pour corriger, alignez les options des deux côtés — ou, plus simplement, importez le champ depuis HubSpot au lieu de le recréer à la main (voir ci-dessus) : l'import recopie les options à l'identique.

Articles associés

• Mappage et synchronisation des champs CRM
• Créer des propriétés personnalisées
• Connecter HubSpot

Mis à jour le : 04/10/2026