Les actions Katalyz dans les workflows HubSpot
L'application Katalyz ajoute cinq actions personnalisées aux workflows HubSpot : un deal qui avance dans votre pipeline peut ainsi créer un Espace, inviter le comité d'achat, y publier un message ou générer un lien magique pour un contact — sans que personne n'ouvre Katalyz.
Avant de commencer
- L'intégration HubSpot doit être connectée au niveau de l'organisation. Voir Connecter HubSpot.
- Un plan HubSpot qui inclut les workflows. Les workflows nécessitent une édition Professional ou Enterprise de Marketing Hub, Sales Hub, Service Hub, Data Hub (ex-Operations Hub), Smart CRM ou Revenue Hub. Au-delà, aucune exigence supplémentaire : les actions fournies par une application connectée — dont Katalyz — fonctionnent dans tous les types de workflow. (C'est l'action custom code qui exige spécifiquement Data Hub Professional ; les actions Katalyz n'en sont pas.)
- Vous avez besoin des permissions HubSpot permettant de créer ou modifier des workflows.
Les actions se trouvent dans l'éditeur de workflow, sous l'application Katalyz, au moment d'ajouter une action.
Les cinq actions en un coup d'œil
Action | S'exécute sur | Champs obligatoires | Sorties |
|---|---|---|---|
Créer une dealroom | Entreprise, Deal | Titre, Modèle |
|
Inviter le contact dans la dealroom associée | Contact | Rôle dans la dealroom, Notifier ?, Inviter à la dernière dealroom créée ? | Message d'erreur |
Inviter les contacts associés à la dealroom (avec liens magiques) | Entreprise, Deal | ID de la dealroom, Rôle dans la dealroom, Notifier les contacts, Filtre de position | Email du contact, Liens magiques, Total des invitations, Message d'erreur |
Envoyer un message dans la dealroom | Entreprise, Deal | ID de la dealroom, Message | Message d'erreur |
Generate Magic Link | Contact | Dealroom ID | Contact Email, Magic Link, Magic Token, Error Message |
Une langue en demi-teinte. Sur un portail HubSpot en français, quatre des cinq actions portent un nom traduit ; Generate Magic Link est restée en anglais. À l'intérieur d'une action, c'est mélangé aussi : certains champs sont traduits (ID de la dealroom, Message), d'autres non (Target record). Et surtout, les sorties apparaissent en anglais dans le sélecteur de jetons — vous y chercherez Dealroom ID et Error message, pas « ID de la dealroom » ni « Message d'erreur ». Les noms français ci-dessous sont ceux des champs de saisie ; les noms de jetons sont précisés là où ils diffèrent.
« S'exécute sur » désigne le type d'objet du workflow lui-même. Un workflow basé sur les deals peut utiliser Créer une dealroom ; un workflow basé sur les contacts peut utiliser Generate Magic Link ; et ainsi de suite. Une action n'apparaît pas dans un workflow dont elle ne prend pas en charge le type d'objet.
Créer une dealroom
Crée un Espace à partir d'un de vos modèles Katalyz et le relie à la fiche sur laquelle tourne le workflow.
S'exécute sur : les workflows basés sur les entreprises et sur les deals.
Champ | Obligatoire | Ce qu'il fait |
|---|---|---|
Titre | Oui | Le nom du nouvel Espace. |
Modèle | Oui | Le modèle de départ. La liste est récupérée en direct depuis votre espace de travail Katalyz : vos modèles publiés apparaissent dans le menu déroulant sans configuration supplémentaire. |
Sortie | Ce que vous récupérez |
|---|---|
| L'identifiant de l'Espace qui vient d'être créé. Toutes les autres actions qui ciblent un Espace attendent cette valeur. Dans le sélecteur de jetons, il apparaît comme Dealroom ID (1. Créer une dealroom). |
Message d'erreur | Vide en cas de succès ; le motif en cas d'échec. |
L'Espace arrive dans votre espace de travail déjà associé au deal ou à l'entreprise d'origine, exactement comme s'il avait été créé depuis la carte Katalyz.
Inviter le contact dans la dealroom associée
Invite le contact sur lequel tourne le workflow dans les Espaces qui lui sont déjà associés.
S'exécute sur : les workflows basés sur les contacts.
Champ | Obligatoire | Ce qu'il fait |
|---|---|---|
Filtre : Titre de la dealroom | Non | Restreint l'invitation aux Espaces dont le titre correspond. |
Filtre : ID de la dealroom | Non | Restreint l'invitation à un Espace précis. |
Rôle dans la dealroom | Oui | Viewer (Lecteur) ou Editor (Éditeur). |
Notifier ? | Oui | Envoie l'e-mail d'invitation au contact quand l'option est activée. |
Inviter à la dernière dealroom créée ? | Oui | Quand l'option est activée, seul l'Espace correspondant le plus récemment créé est utilisé. |
Sortie | Ce que vous récupérez |
|---|---|
Message d'erreur | Vide en cas de succès ; le motif en cas d'échec. |
Les deux filtres sont facultatifs, mais les laisser vides tous les deux revient à faire porter l'action sur tous les Espaces associés à ce contact. Combiner un filtre avec Inviter à la dernière dealroom créée ? est la façon habituelle de garder un résultat prévisible.
Inviter les contacts associés à la dealroom (avec liens magiques)
Reprend tous les contacts associés au deal ou à l'entreprise, invite ceux qui correspondent à votre filtre de position, et renvoie leurs liens magiques.
S'exécute sur : les workflows basés sur les entreprises et sur les deals.
Champ | Obligatoire | Ce qu'il fait |
|---|---|---|
ID de la dealroom | Oui | L'Espace dans lequel inviter. En général, la sortie ID de la dealroom d'une étape Créer une dealroom antérieure. |
Rôle dans la dealroom | Oui | Viewer (Lecteur) ou Editor (Éditeur). |
Notifier les contacts | Oui | Envoie l'invitation par e-mail à chaque contact quand l'option est activée. |
Filtre de position | Oui | « Filtrer les contacts par position. Plusieurs valeurs séparées par des virgules. » |
Sortie | Ce que vous récupérez |
|---|---|
Email du contact | L'adresse du contact invité. |
Liens magiques | Les liens générés pour les contacts invités. |
Total des invitations | Le nombre d'invitations envoyées par l'étape. |
Message d'erreur | Vide en cas de succès ; le motif en cas d'échec. |
Le Filtre de position est obligatoire : décidez donc délibérément de son contenu — c'est lui qui empêche un workflow d'inviter tous les contacts d'un grand compte.
Envoyer un message dans la dealroom
Publie un message dans un Espace existant.
S'exécute sur : les workflows basés sur les entreprises et sur les deals.
Champ | Obligatoire | Ce qu'il fait |
|---|---|---|
ID de la dealroom | Oui | L'Espace où publier. |
Message | Oui | Le corps du message. |
Sortie | Ce que vous récupérez |
|---|---|
Message d'erreur | Vide en cas de succès ; le motif en cas d'échec. |
Pratique comme étape de suivi : un deal passe à une étape plus avancée, et l'Espace reçoit un message qui explique à l'acheteur ce qui se passe ensuite.
Generate Magic Link
Génère un lien de connexion magique pour le contact sur lequel tourne le workflow, sans rien envoyer. C'est vous qui décidez ensuite quoi en faire : l'insérer dans un e-mail marketing HubSpot, l'écrire dans une propriété, le passer à une autre étape.
S'exécute sur : les workflows basés sur les contacts.
Champ | Obligatoire | Ce qu'il fait |
|---|---|---|
Dealroom ID (ID de l'Espace) | Oui | L'Espace que le lien doit ouvrir. |
Sortie | Ce que vous récupérez |
|---|---|
Contact Email (e-mail du contact) | Le contact auquel appartient le lien. |
Magic Link (lien magique) | Le lien lui-même. |
Magic Token (jeton magique) | Le jeton brut derrière le lien, si vous devez construire votre propre URL. |
Error Message (message d'erreur) | Vide en cas de succès ; le motif en cas d'échec. |
Les libellés de cette action n'existent qu'en anglais. Dans un portail en français, elle apparaît avec son nom et ses champs en anglais.
Les rôles : Viewer et Editor uniquement
Toutes les actions qui attribuent un accès proposent Viewer (Lecteur) et Editor (Éditeur) — et rien d'autre. Les Espaces Katalyz comptent quatre rôles (Propriétaire, Éditeur, Commentateur, Lecteur) ; les deux autres se règlent dans l'application Katalyz une fois la personne dans l'Espace. Choisissez Viewer pour un accès en lecture et Editor quand la personne doit contribuer.
Les sorties renvoyées par chaque action
Chaque action Katalyz renvoie un jeu de sorties, que HubSpot expose dans le panneau Tous les jetons de données à droite de l'éditeur d'action, sous Données d'action. Chaque jeton y est suffixé du numéro et du nom de l'étape qui l'a produit — par ex. Dealroom ID (1. Créer une dealroom).
Créer une dealroom renvoie Dealroom ID ; les actions d'invitation renvoient les liens magiques et le total des invitations ; et toutes renvoient un Error message, vide en cas de succès et porteur du motif en cas d'échec.
La possibilité d'injecter la sortie d'une action dans une étape ultérieure dépend de votre workflow et de ce que HubSpot expose à cet endroit : vérifiez-le dans l'éditeur de workflow plutôt que de le supposer. Si les sorties dont vous avez besoin ne sont pas disponibles en aval, renseignez explicitement l'ID de la dealroom sur chaque action.
Exemple complet
Un deal atteint l'étape Proposal sent, et vous voulez que l'acheteur arrive dans un Espace dans la minute.
- Déclencheur — un workflow basé sur les deals, qui inscrit les deals dont l'étape devient Proposal sent.
- Créer une dealroom — Titre construit à partir du nom du deal, Modèle réglé sur votre modèle de proposition.
- Branche si/alors — le Message d'erreur est-il connu ? Si oui, créez une tâche pour le propriétaire du deal et arrêtez-vous là. Sinon, continuez. (Brancher sur le Message d'erreur vaut après chacune de ces actions, pour que les échecs ne passent pas inaperçus.)
- Inviter les contacts associés à la dealroom (avec liens magiques) — Rôle dans la dealroom sur Viewer, Notifier les contacts activé, Filtre de position listant les intitulés de poste qui vous intéressent.
- Envoyer un message dans la dealroom — un message court qui présente la proposition et l'étape suivante.
Les étapes 4 et 5 réclament toutes deux un ID de la dealroom. La façon de le fournir dépend de votre configuration : vérifiez dans l'éditeur de workflow si la sortie de l'étape 2 y est disponible.
Le même schéma fonctionne pour les renouvellements, les lancements d'onboarding, ou toute étape où le passage de relais vers l'acheteur devrait être automatique plutôt que confié à la mémoire de quelqu'un.
Articles associés
Mis à jour le : 04/10/2026
Merci !