Articles sur : Intégrations

Connecter HubSpot

L'intégration HubSpot relie votre espace de travail Katalyz à votre portail HubSpot — pour que les Espaces, les deals, les contacts et l'activité restent synchronisés.


⚠️ Nécessite le rôle d'organisation Admin.


Avant de commencer


Il vous faut :

  • un accès admin HubSpot (pour autoriser la connexion) ;
  • aucun niveau de plan HubSpot minimum n'est requis pour installer l'application Katalyz. Utiliser les actions de workflow Katalyz suppose un plan HubSpot qui inclut les workflows — une édition Professional ou Enterprise de Marketing Hub, Sales Hub, Service Hub, Data Hub, Smart CRM ou Revenue Hub.


Connecter l'intégration (niveau organisation)


  1. Allez dans Paramètres → Intégrations.
  2. Repérez la carte HubSpot v2 dans la liste — « Installez la nouvelle application Katalyz HubSpot tout en conservant l'intégration historique pendant le déploiement. »
  3. Cliquez sur Installer.
  4. Vous êtes redirigé vers HubSpot pour l'autorisation OAuth.
  5. Choisissez le portail que vous voulez connecter.
  6. Passez en revue les permissions demandées par Katalyz et cliquez sur Authorize (autoriser).
  7. Vous êtes redirigé vers Katalyz. La carte porte maintenant une pastille verte en haut à droite, et son bouton est devenu Désinstaller.


Deux cartes HubSpot, et c'est normal. La liste contient HubSpot (legacy) et HubSpot v2. La première est l'application historique ; si votre organisation l'utilise encore, elle reste connectée et son bouton Désinstaller est grisé — on ne la retire pas soi-même. C'est HubSpot v2 que l'on installe aujourd'hui. Voir Passer à la nouvelle application Katalyz pour HubSpot.


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 également autoriser HubSpot depuis son propre profil pour que l'intégration fonctionne pleinement pour lui — ses propres actions (créer un Espace depuis un deal, mettre à jour une propriété, synchronisation retour) s'authentifient alors avec ses propres permissions CRM.


Cela se passe dans Paramètres → Profil. Tout en haut de la page, avant les champs d'identité, se trouve la liste des comptes que vous avez reliés à titre personnel : une ligne par service, avec son logo, l'adresse utilisée et un bouton rouge Supprimer.


Une fois la connexion personnelle faite, une ligne au logo HubSpot y apparaît avec votre adresse. À partir de là, vos actions utilisent votre propre token HubSpot. Si aucune ligne HubSpot n'y figure, c'est que l'étape n'a pas été faite.


Sans cette étape, l'intégration au niveau de l'organisation reste saine, mais les actions individuelles de cet utilisateur ne se synchronisent pas. Voir Mon CRM ne se synchronise pas pour le modèle complet à deux niveaux.


Les accès demandés par Katalyz


L'installation de l'application HubSpot affiche la liste complète des scopes demandés par Katalyz, répartis entre obligatoires et facultatifs.


Scopes obligatoires


Scope

Pourquoi Katalyz le demande

oauth

Permet à Katalyz de finaliser la connexion OAuth et d'inspecter les détails d'autorisation du token / du compte.

crm.objects.companies.read

Lire les entreprises HubSpot pour que Katalyz puisse relier les Espaces aux comptes / entreprises et afficher les données de compte du CRM.

crm.objects.companies.write

Créer ou mettre à jour des fiches entreprise HubSpot depuis Katalyz quand la synchronisation CRM est activée.

crm.lists.read

Lire les listes HubSpot pour que les utilisateurs puissent sélectionner des segments de liste CRM pour les workflows et la création d'Espaces.

crm.lists.write

Gérer ou mettre à jour les données liées aux listes HubSpot utilisées par les workflows CRM de Katalyz.

crm.objects.deals.read

Lire les deals HubSpot pour relier les Espaces aux opportunités / deals et importer les données de deal.

crm.objects.deals.write

Créer ou mettre à jour des deals HubSpot avec les identifiants d'Espace, les statuts et les champs synchronisés de Katalyz.

crm.objects.contacts.read

Lire les contacts associés aux entreprises / deals pour que Katalyz puisse inviter ou synchroniser les participants.

crm.objects.contacts.write

Créer ou mettre à jour des contacts HubSpot depuis Katalyz quand la synchronisation des contacts est activée.

crm.objects.owners.read

Lire les propriétaires HubSpot pour associer les champs de propriétaire CRM et afficher leurs informations.


Scopes facultatifs


Utilisés uniquement si le compte HubSpot les expose ou si la fonctionnalité correspondante est activée.


Scope

Pourquoi Katalyz le demande

crm.objects.leads.read

Lire les leads HubSpot quand le portail connecté prend en charge les objets de type lead.

crm.objects.leads.write

Créer ou mettre à jour des leads HubSpot quand leur synchronisation est disponible.

crm.objects.appointments.read

Lire les objets de type rendez-vous quand ils sont utilisés dans les workflows CRM ou la synchronisation d'objets personnalisés.

crm.objects.appointments.write

Créer ou mettre à jour des objets de type rendez-vous quand ils sont pris en charge.

crm.objects.users.read

Lire les fiches utilisateur HubSpot pour un mappage utilisateur / propriétaire plus riche.

settings.currencies.read

Lire les paramètres de devise HubSpot pour que Katalyz traite correctement les montants et les devises des deals.

crm.schemas.companies.read

Lire les définitions de propriétés / schémas d'entreprise pour le mappage des champs personnalisés.

crm.schemas.companies.write

Créer ou mettre à jour les propriétés d'entreprise nécessaires aux champs de synchronisation Katalyz.

crm.schemas.contacts.read

Lire les définitions de propriétés / schémas de contact pour le mappage des champs personnalisés.

crm.schemas.contacts.write

Créer ou mettre à jour les propriétés de contact nécessaires aux champs de synchronisation Katalyz.

crm.schemas.custom.read

Lire les schémas d'objets personnalisés pour la prise en charge des objets CRM personnalisés.

crm.schemas.deals.read

Lire les définitions de propriétés / schémas de deal pour le mappage des pipelines et des champs personnalisés.

crm.schemas.deals.write

Créer ou mettre à jour les propriétés de deal nécessaires aux champs de synchronisation Katalyz.

crm.objects.custom.read

Lire les fiches d'objets personnalisés HubSpot quand des objets personnalisés sont utilisés.

crm.objects.custom.write

Créer ou mettre à jour des fiches d'objets personnalisés HubSpot quand leur synchronisation est activée.

timeline

Créer des événements de timeline HubSpot — par exemple l'activité Katalyz ou les événements de signature affichés sur les fiches CRM.

integration-sync

Prend en charge les capacités de synchronisation d'intégration HubSpot utilisées par l'application.

files

Accéder aux fichiers HubSpot utilisés par les workflows Katalyz, y compris les fichiers liés à la signature.

files.ui_hidden.read

Lire les fichiers HubSpot masqués qui peuvent être attachés aux workflows de l'application sans être visibles dans l'interface de fichiers standard.


Ce que l'application installe dans votre portail


Autoriser l'application ajoute trois choses dans HubSpot :


  • La carte Katalyz — mise à disposition pour les fiches deal, entreprise et contact, elle liste les dealrooms, les enregistrements et les signatures reliés à cette fiche, avec + New dealroom (nouvelle dealroom) et Nouvelle enveloppe sur la carte elle-même. Un admin HubSpot choisit son emplacement sur la fiche ; nous recommandons de lui donner son propre onglet. Voir Travailler depuis HubSpot : la carte Katalyz, et Passer à la nouvelle application Katalyz pour HubSpot si vous venez de l’application précédente.
  • Cinq actions de workflow — Créer une dealroom, Inviter le contact dans la dealroom associée, Inviter les contacts associés à la dealroom (avec liens magiques), Envoyer un message dans la dealroom et Generate Magic Link. Cela suppose un plan HubSpot incluant les workflows. Voir Les actions Katalyz dans les workflows HubSpot.
  • L'activité de timeline — les événements d'Espace et de signature publiés sur vos timelines HubSpot, pilotés par les cases Activités ci-dessous.


Après la connexion


Une fois l'intégration connectée, tout le reste se règle dans Paramètres → Données → Hubspot. La page tient en trois encadrés, dans cet ordre :


  • Champs synchronisés — « Mappez vos champs Katalyz aux propriétés HubSpot ». Une ligne par paire, reliée par une double flèche ⇄ ; + Ajouter une nouvelle cartographie en ajoute une, Actualiser la liste relit les propriétés depuis HubSpot. Deux de ces champs sont écrits par l'IA : Score → Katalyz health score, et Résumé exécutif → Katalyz AI executive summary.
  • Activités — « Choisissez quelles activités utilisateur synchroniser avec HubSpot ». Neuf cases à cocher, une par événement.
  • Tâches — « Types des tâches envoyées vers CRM. » Trois cases à cocher : Sync des étapes, Sync des actions, Sync des tâches.


Il n'y a pas de bouton Enregistrer : chaque case et chaque ligne est appliquée telle quelle.


Voir Mappage et synchronisation des champs CRM.


Déconnecter


Paramètres → Intégrations → HubSpot v2 → Désinstaller. Une intégration connectée affiche une pastille verte sur sa carte et son bouton indique Désinstaller ; une intégration non connectée affiche Installer.


Le bouton Désinstaller de la carte HubSpot (legacy) est grisé : l'application historique ne se retire pas depuis cet écran — passez par le support. Voir Déconnecter une intégration.


Articles associés

Mis à jour le : 04/10/2026

Cet article a-t-il répondu à vos questions ?

Partagez vos commentaires

Annuler

Merci !