Créer des propriétés personnalisées

Les propriétés personnalisées vous permettent d'étendre le modèle de données de Katalyz avec des champs qui correspondent au fonctionnement réel de votre activité — montants de deals, dates de closing, scores de prospects, secteurs, ou tout ce que vous voulez suivre Espace par Espace.

Une fois définies, les propriétés personnalisées peuvent être :

• Affichées dans les Espaces via le le widget Champ
• Utilisées comme variables (tapez $ dans un widget de texte) pour personnaliser le contenu de chaque Espace
• Mappées sur des champs HubSpot (ou d'un autre CRM) pour une synchronisation bidirectionnelle

⚠️ Nécessite le rôle d'organisation Admin. Rendez-vous dans Data settings.

Les quatre types d'objets

Katalyz regroupe les propriétés selon l'objet auquel elles appartiennent :

Chaque objet a son propre onglet dans les Data settings.

Types de propriété

Le sélecteur Type de propriété propose dix-huit types, rangés en cinq groupes :

Un champ Rechercher en haut de la liste filtre l'ensemble.

Créer une propriété

1. Allez dans Paramètres → Données → Objets personnalisés.
2. Choisissez l'onglet de l'objet concerné : Espaces, Participants ou Actions.
3. Cliquez sur + Ajouter une propriété, en haut à droite.
4. La fenêtre Ajouter une propriété propose deux voies :
5. • Importer depuis HubSpot, badgée Recommandé — « Importez une propriété directement depuis HubSpot. Ses options et ses détails resteront automatiquement synchronisés dans le temps. »
   • Créer une nouvelle propriété — « Créez une nouvelle propriété qui n'existera que dans Katalyz. Vous pourrez la mapper à des champs d'applications externes, mais ses options et ses détails ne resteront pas automatiquement synchronisés dans le temps. »
5. La seconde voie ouvre un formulaire :

L'indice d'extraction est le champ qui fait travailler l'IA pour vous. Son invite le dit : « Indiquez à l'IA quand et comment remplir le champ — à partir d'un enregistrement d'appel ou des données de l'espace… », et l'aide sous le champ précise qu'il « aide l'IA à préremplir ce champ à partir des enregistrements et des données de l'espace ».

Annuler à gauche, Ajouter à droite.

Consigne d'extraction — apprendre à l'IA à remplir la propriété

Chaque propriété possède un champ Extraction hint (consigne d'extraction), signalé par l'étincelle IA. C'est une ligne qui indique à l'assistant quand et comment remplir ce champ à partir d'un enregistrement d'appel ou des données de l'Espace — le placeholder indique « Indiquez à l'IA quand et comment remplir le champ — à partir d'un enregistrement d'appel ou des données de l'espace… ».

• Elle est recommandée à la création : « aide l'IA à préremplir ce champ à partir des enregistrements et des données de l'espace »
• Elle devient obligatoire la première fois que quelqu'un déclenche une mise à jour IA sur ce champ dans un Espace. Le panneau Données de l'Espace s'arrête sur un message demandant de renseigner les indices d'extraction avant de continuer et permet à l'utilisateur d'écrire la consigne manquante sur place — mais il est plus propre de la définir ici, une fois pour toutes, pour tous les Espaces.

Une bonne consigne dit quoi et comment : « La valeur annuelle du contrat en euros, telle qu'annoncée par le prospect » vaut mieux que « Amount ». Voir Remplir automatiquement les champs d'un Espace depuis un enregistrement.

Colonne Origine

Chaque propriété affiche une origine :

• Katalyz — créée directement dans Katalyz
• Importée depuis HubSpot — à l'origine une propriété HubSpot, désormais disponible dans Katalyz via l'intégration
• Importée depuis Salesforce — idem, depuis Salesforce

Les propriétés importées du CRM arrivent déjà liées à leur champ source.

Mapper sur des champs CRM

Toute propriété Katalyz peut être mappée sur un champ d'une intégration externe (HubSpot, Salesforce).

La colonne Mappée avec du tableau des propriétés affiche le mapping actuel :

• Vide (non mappée) — la propriété n'existe que dans Katalyz
• HubSpot / deal_amount — mappée sur le champ deal_amount de HubSpot

Pour créer un mapping, utilisez le bouton Ajouter un mapping de la ligne concernée ; une propriété déjà reliée affiche à la place une pastille au logo du CRM portant le nom de la propriété associée.

Certains champs ont canEditMapping: false — typiquement des propriétés importées de HubSpot qui doivent rester liées à leur origine. Les modifier casserait la synchronisation.

Suivi de l'utilisation

La colonne Utilisée dans indique combien d'Espaces utilisent activement chaque propriété. Cela vous aide à :

• Voir quelles propriétés votre équipe utilise réellement
• Repérer les candidates au nettoyage (les propriétés avec 0 utilisation)
• Mesurer l'impact d'une suppression (une propriété utilisée dans 57 Espaces est un engagement lourd à retirer)

Utiliser les propriétés personnalisées dans les Espaces

Une fois définie, une propriété peut alimenter :

Le widget Field

Ajoutez un bloc Champ dans un Espace. Reliez-le à une propriété personnalisée. Le widget affiche la valeur actuelle.

Les variables dans les widgets de texte

Tapez $ dans un widget de texte pour insérer une propriété sous forme de variable. La variable est remplacée par la valeur réelle au rendu de l'Espace.

Voir Utiliser des variables dans le texte.

Création d'un Espace — remplir les champs personnalisés d'emblée

Quand quelqu'un crée un Espace, l'étape des détails comporte une section Champs personnalisés. + Ajouter un champ ouvre un sélecteur sur le catalogue de votre organisation — les propriétés Espaces définies ici. Chaque champ ajouté affiche la saisie correspondant à son type, pour que la valeur soit renseignée avant même que l'Espace existe.

Les champs ajoutés se réordonnent, et chacun peut être retiré de l'Espace en cours de création.

Liste des Espaces — les champs personnalisés en colonnes

Sur la page Espaces, le bouton des colonnes (icône engrenage) ouvre un menu à deux panneaux :

1. Panneau 1 — les colonnes natives, chacune avec sa case à cocher, puis les champs personnalisés déjà ajoutés en colonnes avec leur badge de type. Un bouton en pied ouvre le panneau 2.
2. Panneau 2 — un sélecteur avec recherche sur tout le catalogue, sous forme de liste à cocher.

Les choix de colonnes sont mémorisés par navigateur.

Modifier et supprimer

• Modifier — changer le libellé, la description, la consigne d'extraction ou le mapping de la propriété. Le type de champ ne peut généralement pas être changé (cela corromprait les valeurs existantes).
• Supprimer — retire la propriété de tous les Espaces et de tous les modèles qui l'utilisent. Les widgets et placeholders qui y font référence cessent de fonctionner.

Avant de supprimer, vérifiez le décompte Utilisée dans. Une propriété utilisée dans des dizaines d'Espaces doit être retirée progressivement — mettez d'abord à jour les Espaces concernés.

Articles associés

• Mapping des champs HubSpot
• Utiliser des variables dans le texte
• Widget Field
• Remplir automatiquement les champs d'un Espace depuis un enregistrement

Mis à jour le : 04/10/2026