HubSpot — mapping des champs & objets personnalisés
Cet article explique comment les propriétés Katalyz se mappent aux propriétés standard de HubSpot et aux objets personnalisés.
Pour la référence principale du mapping des champs, consultez Mapping des champs & synchronisation HubSpot — 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
- Entreprises
- Transactions
- Objets HubSpot personnalisés (si votre portail en utilise)
- Tâches
- Événements de timeline
Mapper des objets HubSpot personnalisés
Mapper un objet HubSpot personnalisé suit le même flux que le mapping de n'importe quel objet standard — utilisez l'interface de mapping des champs documentée dans Mapping des champs & synchronisation HubSpot. 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).
Mappings préconfigurés
Il n'existe aucun mapping par défaut prêt à l'emploi. Après avoir connecté HubSpot, vous partez d'une page blanche — chaque mapping est créé explicitement par vos soins via l'interface de mapping des champs.
Importer les champs depuis HubSpot — recommandé
Plutôt que de créer chaque champ Katalyz à la main puis de le mapper ensuite à une propriété HubSpot, importez directement les champs depuis HubSpot. C'est la voie recommandée pour la plupart des cas.
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, datetime, etc.).
- La correspondance est créée automatiquement — pas besoin de re-pointer le champ Katalyz vers la bonne propriété HubSpot.
- La structure reste conservée : si vous ajoutez plus tard une option à un menu déroulant côté HubSpot, l'import garde les deux côtés alignés.
Avantages :
- Moins d'erreurs — pas de mismatch de type ou d'options qui font échouer silencieusement la sync (voir le tableau de compatibilité plus bas).
- Plus rapide — un seul geste par champ au lieu de deux (création + mapping).
- Plus fiable — la source de vérité de la structure du champ reste HubSpot ; Katalyz miroite.
Quand préférer la création manuelle ? Pour les champs propres à Katalyz qui n'existent pas (et n'ont pas vocation à exister) dans HubSpot — par exemple un champ purement interne à la collaboration dans l'Espace.
Compatibilité des types de champs
Type de champ Katalyz | Types HubSpot compatibles |
|---|---|
Texte une ligne | Texte une ligne, Sélection unique |
Texte multi-lignes | Texte multi-lignes |
Nombre | Nombre |
Devise | Nombre (avec formatage devise) |
Date | Sélecteur de date, Datetime |
Liste déroulante | Liste déroulante (les valeurs doivent correspondre) |
Téléphone | Numéro de téléphone |
Un mapping entre types incompatibles fait échouer silencieusement la synchronisation pour ce champ.
Articles liés
Mis à jour le : 18/06/2026
Merci !