Connecter HubSpot
L'intégration HubSpot connecte votre espace de travail Katalyz à votre portail HubSpot — afin que les Espaces, deals, contacts et activités restent synchronisés.
⚠️ Nécessite le rôle d'organisation Admin.
Avant de commencer
Vous aurez besoin de :
- Un accès admin HubSpot (pour autoriser la connexion)
- Aucun niveau de plan HubSpot minimum n'est requis pour installer l'application Katalyz. Cependant, si vous souhaitez utiliser les déclencheurs et actions de workflow, Operations Hub Pro (ou supérieur) côté HubSpot est requis.
Connecter l'intégration (niveau organisation)
- Allez dans Paramètres → Intégrations.
- Trouvez HubSpot dans la liste.
- Cliquez sur Connecter.
- Vous êtes redirigé vers HubSpot pour l'autorisation OAuth.
- Choisissez le portail que vous souhaitez connecter.
- Vérifiez les permissions que Katalyz demande et cliquez sur Autoriser.
- Vous êtes redirigé vers Katalyz ; le statut de l'intégration affiche Connecté.
Connexion au niveau utilisateur
Une fois l'intégration HubSpot activée au niveau de l'espace de travail par un admin, chaque utilisateur doit aussi autoriser HubSpot depuis son propre profil pour que l'intégration fonctionne pleinement pour lui — ses propres actions (création d'Espace depuis un deal, mise à jour de propriété, sync rétroactive) s'authentifient alors avec ses propres droits CRM.
- Chaque utilisateur ouvre son profil.
- Il clique sur Sign in with HubSpot et autorise la connexion.
- À partir de là, ses actions utilisent son propre jeton HubSpot.
Sans cette étape, l'intégration au niveau organisation reste saine mais les actions individuelles de cet utilisateur ne se synchronisent pas. Voir Mon CRM ne se synchronise pas pour le détail des deux niveaux.
Ce à quoi Katalyz demande accès
L'installation de l'application HubSpot affiche la liste complète des scopes demandés par Katalyz, séparés entre requis et optionnels.
Scopes requis
Scope | Pourquoi Katalyz le demande |
|---|---|
| Permet à Katalyz de finaliser la connexion OAuth et d'inspecter les détails du jeton et de l'autorisation du compte. |
| Lire les entreprises HubSpot pour permettre à Katalyz de lier les Espaces aux comptes / entreprises et d'afficher les données CRM. |
| Créer ou mettre à jour des fiches entreprise HubSpot depuis Katalyz quand la sync CRM est activée. |
| Lire les listes HubSpot pour permettre aux utilisateurs de sélectionner des segments CRM pour les workflows et la création d'Espaces. |
| Gérer ou mettre à jour les données liées aux listes HubSpot utilisées par les workflows CRM de Katalyz. |
| Lire les deals HubSpot pour lier les Espaces aux opportunités / deals et importer les données des deals. |
| Créer ou mettre à jour les deals HubSpot avec les ID d'Espace Katalyz, les statuts et les champs synchronisés. |
| Lire les contacts associés aux entreprises / deals pour permettre à Katalyz d'inviter ou de synchroniser les participants. |
| Créer ou mettre à jour des contacts HubSpot depuis Katalyz quand la sync des contacts est activée. |
| Lire les owners HubSpot pour mapper les champs owner du CRM et afficher leur information. |
Scopes optionnels
Utilisés uniquement si le compte HubSpot les expose ou si la fonctionnalité correspondante est activée.
Scope | Pourquoi Katalyz le demande |
|---|---|
| Lire les leads HubSpot quand le portail connecté supporte l'objet Lead. |
| Créer ou mettre à jour des leads HubSpot quand la sync des leads est disponible. |
| Lire les objets rendez-vous quand ils sont utilisés dans les workflows CRM ou la sync d'objets personnalisés. |
| Créer ou mettre à jour des objets rendez-vous quand ils sont supportés. |
| Lire les fiches utilisateur HubSpot pour un mapping utilisateur / owner plus riche. |
| Lire les paramètres de devises HubSpot pour que Katalyz traite correctement les montants et devises des deals. |
| Lire la définition de propriétés / schéma des entreprises pour le mapping de champs personnalisés. |
| Créer ou mettre à jour les propriétés entreprise nécessaires aux champs synchronisés Katalyz. |
| Lire la définition de propriétés / schéma des contacts pour le mapping de champs personnalisés. |
| Créer ou mettre à jour les propriétés contact nécessaires aux champs synchronisés Katalyz. |
| Lire les schémas d'objets personnalisés pour le support des objets CRM custom. |
| Lire la définition de propriétés / schéma des deals pour le mapping de pipeline et de champs personnalisés. |
| Créer ou mettre à jour les propriétés deal nécessaires aux champs synchronisés Katalyz. |
| Lire les enregistrements d'objets personnalisés HubSpot quand des objets custom sont utilisés. |
| Créer ou mettre à jour des enregistrements d'objets personnalisés HubSpot quand la sync custom est activée. |
| Créer des événements timeline HubSpot — par exemple les événements d'activité ou de signature Katalyz affichés sur les fiches CRM. |
| Supporte les capacités d'integration sync HubSpot utilisées par l'application. |
| Accéder aux fichiers HubSpot utilisés par les workflows Katalyz, y compris les fichiers liés à la signature. |
| Lire les fichiers HubSpot masqués qui peuvent être attachés à des workflows mais ne sont pas visibles dans l'UI fichiers standard. |
Après la connexion
Une fois l'intégration connectée, configurez les détails dans Paramètres → HubSpot :
- Champs synchronisés — mappez les propriétés Katalyz aux propriétés HubSpot
- Activités — choisissez quels événements Katalyz sont publiés dans les timelines HubSpot
- Tâches — synchronisez les tâches Katalyz avec les tâches HubSpot
Voir Mappage et synchronisation des champs HubSpot.
Déconnexion
Paramètres → Intégrations → HubSpot → Déconnecter. Voir Déconnecter une intégration.
Articles liés
- HubSpot : synchroniser Espaces avec deals, entreprises et contacts
- Mappage et synchronisation des champs HubSpot
- Résoudre les problèmes de synchronisation HubSpot
Mis à jour le : 18/06/2026
Merci !