Passer à la nouvelle application Katalyz pour HubSpot

Katalyz a reconstruit son application HubSpot. La nouvelle version porte la carte Katalyz, les actions de workflow et la synchronisation sur une plateforme HubSpot plus récente — et la bascule est conçue pour que rien de ce sur quoi vous comptez déjà ne s'arrête. Cet article explique ce qui se passe pendant le changement, et le point qu'il vaut la peine de connaître avant de vous organiser.

⚠️ Nécessite le rôle d'organisation Admin côté Katalyz, et un accès admin HubSpot pour autoriser la nouvelle application.

En quoi consiste la bascule

La nouvelle version est une application HubSpot distincte, et non une mise à jour de celle que vous avez. Y passer signifie une nouvelle installation, avec son propre écran de consentement : vous l'autorisez comme vous aviez autorisé la première, vous passez en revue les scopes demandés par Katalyz, et vous approuvez.

Le déploiement est activé espace de travail par espace de travail, côté Katalyz : on vous préviendra quand votre portail sera prêt, vous ne découvrirez pas une nouvelle application un matin. Voir Connecter HubSpot pour la liste des scopes qui vous sera présentée.

Les deux applications restent installées

Pendant la bascule, l'ancienne et la nouvelle application sont toutes les deux installées dans votre portail. C'est volontaire, et c'est ce qui rend le changement sûr :

• Rien n'est désinstallé : rien ne perd sa connexion pendant que la nouvelle application se met en place.
• Les événements des deux applications arrivent jusqu'à Katalyz, mais seule l'application active est appliquée — une modification dans HubSpot n'est donc jamais traitée deux fois.
• Si quelque chose doit être annulé, votre espace de travail est simplement retiré du déploiement et l'ancienne application reprend la main.

Vous verrez deux applications Katalyz dans la liste de vos applications connectées HubSpot pendant un certain temps. C'est normal. Ne désinstallez pas l'ancienne — la section suivante explique pourquoi.

Côté Katalyz, c'est visible de la même façon : Paramètres → Intégrations affiche deux cartes, HubSpot (legacy) et HubSpot v2, chacune avec sa pastille verte. Le bouton Désinstaller de la carte legacy est grisé pendant toute la durée de la bascule — c'est le garde-fou qui vous empêche de couper l'ancienne application par mégarde.

Ce qui est conservé

Le point à connaître : les workflows existants ne sont pas migrés

Les workflows HubSpot que vous avez déjà construits continuent de tourner sur l'ancienne application, et ils ne sont pas transférés vers la nouvelle.

Ce n'est pas un défaut — c'est la façon dont HubSpot rattache une étape de workflow à une application. Chaque action d'un workflow pointe vers la définition d'action d'une application précise, et HubSpot ne réécrit pas ce lien quand une seconde application apparaît. Concrètement :

• Vos workflows existants continuent de fonctionner, inchangés, via l'ancienne application.
• Tout workflow que vous construisez après la bascule utilise les actions de la nouvelle application.
• Comme ces workflows existants restent rattachés à l'ancienne application, celle-ci doit rester installée. La désinstaller les casserait.

Il n'y a rien à faire dans l'immédiat. Si vous préférez tout avoir sur la nouvelle application, reconstruisez ces workflows avec les nouvelles actions à votre rythme — les champs d'entrée et les sorties sont identiques, il s'agit donc de rajouter les étapes, pas de repenser l'automatisation. Voir Les actions Katalyz dans les workflows HubSpot.

L'activité de timeline pendant la bascule

L'activité des Espaces et les événements de signature continuent d'apparaître sur vos timelines HubSpot tout du long. Pour l'instant, ils sont encore émis par l'ancienne application — c'est la deuxième raison de la laisser installée.

HubSpot doit approuver la nouvelle application pour les événements de timeline avant que cette partie puisse être transférée. En attendant, garder les deux applications en place maintient vos timelines complètes. Nous le signalerons ici quand cela changera.

À vérifier après la bascule

Une fois votre portail basculé, quelques minutes de vérification suffisent :

1. L'onglet de la fiche — ouvrez un deal qui a déjà un Espace et vérifiez que l'onglet Katalyz charge bien ses dealrooms, ses enregistrements et ses signatures.
2. La synchronisation — modifiez une propriété sur ce deal dans HubSpot et vérifiez que l'Espace la reprend ; modifiez un champ associé dans l'Espace et vérifiez qu'il revient bien dans HubSpot.
3. La timeline — vérifiez que l'activité récente de l'Espace s'affiche toujours sur la timeline du deal.
4. Les workflows — ouvrez un workflow qui utilise Katalyz et vérifiez qu'il inscrit et termine toujours comme avant. Vous n'avez rien à modifier ; vous vérifiez simplement qu'il n'a pas été perturbé.
5. Les applications connectées — vérifiez que les deux applications Katalyz sont listées, et laissez-les toutes les deux en place.

Si l'un de ces points ne vous paraît pas correct, contactez le support à support@katalyz.co plutôt que de désinstaller quoi que ce soit — le retour en arrière est simple de notre côté, et une désinstallation le complique.

Articles associés

• Connecter HubSpot
• HubSpot — synchroniser les Espaces avec les deals, entreprises et contacts
• Les actions Katalyz dans les workflows HubSpot
• La carte Katalyz dans HubSpot

Mis à jour le : 04/10/2026