Articles sur : Administration & espace de travail

Mapping et synchronisation des champs CRM (HubSpot, Salesforce)

Une fois votre CRM connecté à Katalyz, vous contrôlez exactement ce qui se synchronise entre les deux systèmes depuis Paramètres → HubSpot (ou Paramètres → Salesforce). La page comporte trois sections : Champs synchronisés, Activités et Tâches. L'interface est la même pour les deux CRM — choisissez celui que vous avez connecté.


⚠️ Nécessite le rôle org Admin. Nécessite que le CRM soit connecté — voir Connecter HubSpot ou Connecter Salesforce.



Champs synchronisés


Faites correspondre les propriétés Katalyz aux propriétés du CRM. Chaque correspondance définit une paire de champs : quand un côté est mis à jour, l'autre suit.


Le tableau de correspondance ressemble à ceci :


Champ Katalyz

Propriété CRM

Timing/Next

Timing/Next

Pipeline

Prospect pipeline

Score

Score de santé Katalyz

Résumé exécutif

Résumé exécutif IA Katalyz

Statut

Deal Stage (HubSpot) / Opportunity Stage (Salesforce)

Linkedin

LinkedIn URL Unique Id


Ajouter une correspondance


  1. Cliquez sur + Ajouter une nouvelle correspondance.
  2. Choisissez un champ Katalyz dans la liste déroulante.
  3. Choisissez une propriété CRM dans la liste déroulante.
  4. Enregistrez.


À partir de là, les deux champs restent synchronisés.


Lorsqu'une correspondance n'a pas de sens


Les types de champs doivent correspondre. Vous ne pouvez pas mapper un champ texte vers un nombre, ni une date vers une liste déroulante. Le sélecteur masque les combinaisons incompatibles.


Certains champs Katalyz sont gérés par le système (par exemple, importés depuis le CRM lors de la configuration) — ils apparaissent avec la synchronisation déjà établie et une icône de rafraîchissement 🔄. Vous pouvez relancer la récupération des dernières valeurs, mais vous ne pouvez pas changer la correspondance.


HubSpot vs Salesforce — une différence. Côté HubSpot, une action Import depuis le CRM permet de relancer une récupération à la demande. Côté Salesforce, cette action n'existe pas — la synchronisation est en temps réel, et il n'y a pas de bouton manuel de relance.


Activités


Activez ou désactivez les activités Katalyz publiées dans le CRM, sur le deal/opportunité ou contact lié. La liste exacte diffère entre HubSpot et Salesforce.


Format dans le CRM. Les activités HubSpot sont écrites comme notes HubSpot et, pour la nouvelle app HubSpot, comme événements de timeline. Les activités Salesforce sont écrites comme notes Salesforce et, optionnellement, comme publications Chatter si Chatter est activé.


Activités HubSpot


Activité

Description

Commentaire créé

Un utilisateur ajoute un commentaire public/partagé dans un Espace ou une tâche.

Commentaire supprimé

Un utilisateur supprime un commentaire.

Ressource consultée

Un utilisateur ouvre / consulte une ressource.

Ressource téléchargée

Un utilisateur télécharge une ressource.

Ressource supprimée

Un utilisateur supprime une ressource.

Espace rejoint

Un utilisateur rejoint ou est ajouté à un Espace.

Espace quitté

Un utilisateur quitte un Espace.

Espace consulté

Un utilisateur se connecte à / consulte l'Espace.

Tâche créée

Un utilisateur ajoute une tâche / action.

Tâche terminée

Un utilisateur marque une tâche comme terminée.

Tâche supprimée

Un utilisateur supprime une tâche / action.

Étape créée

Un utilisateur ajoute une étape.

Étape terminée

Un utilisateur marque une étape comme terminée.

Étape supprimée

Un utilisateur supprime une étape.

Date d'échéance de tâche définie

Un utilisateur définit une date d'échéance.

Date d'échéance de tâche mise à jour

Un utilisateur modifie ou retire une date d'échéance.

Note de tâche créée

Un utilisateur ajoute une description de tâche / action.

Note de tâche modifiée

Un utilisateur modifie une description de tâche / action.

Demande de signature envoyée

Une demande de signature est envoyée à un ou plusieurs signataires.

Signataire a signé

Un signataire termine sa signature.

Signataire annulé / refusé

Un signataire ou l'expéditeur annule / refuse une demande de signature.

Demande de signature complétée

Toutes les signatures requises sont complétées.


Activités Salesforce


Activité

Description

Commentaire créé

Un utilisateur ajoute un commentaire public/partagé dans un Espace ou une tâche.

Ressource créée

Un utilisateur ajoute une ressource.

Ressource consultée

Un utilisateur ouvre / consulte une ressource.

Ressource téléchargée

Un utilisateur télécharge une ressource.

Espace rejoint

Un utilisateur rejoint ou est ajouté à un Espace.

Espace quitté

Un utilisateur quitte un Espace.

Espace consulté

Un utilisateur se connecte à / consulte l'Espace.

Tâche créée

Un utilisateur ajoute une tâche / action.

Tâche mise à jour

Une tâche / action est mise à jour et synchronisée vers Salesforce lorsque c'est applicable.

Tâche terminée

Un utilisateur marque une tâche comme terminée.

Étape créée

Un utilisateur ajoute une étape.

Étape terminée

Un utilisateur marque une étape comme terminée.

Date d'échéance de tâche définie

Un utilisateur définit une date d'échéance.

Date d'échéance de tâche mise à jour

Un utilisateur modifie ou retire une date d'échéance.


Bonne pratique : activez les activités qui signalent une progression du deal, et laissez désactivées les plus bruyantes :

  • ✅ Activez : Espace rejoint, Espace consulté, Tâche terminée, Date d'échéance définie
  • ❌ Envisagez de laisser désactivé : Commentaire créé (risque d'inonder le CRM de bavardages)


Tâches



HubSpot

Salesforce

Synchroniser les tâches Katalyz avec les tâches du CRM

✅ disponible (bascules pour steps / actions / tâches génériques)

❌ non disponible aujourd'hui — les tâches restent uniquement dans Katalyz


Pour HubSpot, lorsque activé :

  • Créer une tâche dans un Espace Katalyz crée une tâche correspondante dans HubSpot
  • Marquer terminé dans un système met à jour l'autre
  • Les changements de date d'échéance circulent dans les deux sens


Bonne pratique : si votre équipe vit dans HubSpot pour la gestion quotidienne des tâches, activez ces bascules. Si elle vit dans Katalyz, laissez-les désactivées — la synchronisation ajoute du bruit dans HubSpot.


Direction de la synchronisation


Bidirectionnelle. Un champ mappé se met à jour à la fois dans Katalyz et dans le CRM — changez-le n'importe où, l'autre suit.


Fréquence de synchronisation


Temps réel, dans les deux sens. Les changements se propagent immédiatement. À la première connexion, Katalyz effectue une synchronisation initiale rétroactive — si un champ mappé a déjà une valeur des deux côtés, la valeur du CRM prend la priorité pour cette réconciliation initiale.


Dépannage


Si un champ ne se synchronise pas :


  1. Confirmez que l'intégration CRM est toujours connectée et autorisée — voir Connecter HubSpot ou Connecter Salesforce.
  2. Vérifiez que le champ est toujours mappé (les correspondances peuvent se rompre si une propriété du CRM est renommée).
  3. Vérifiez que les types de champs correspondent.
  4. Confirmez que l'utilisateur CRM dont le jeton OAuth est utilisé a toujours accès à la propriété.


Si la synchronisation est totalement rompue, voir Mon CRM ne se synchronise pas.


Articles associés

Mis à jour le : 18/06/2026

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

Partagez vos commentaires

Annuler

Merci !