Articles sur : Dépannage

Mon CRM ne se synchronise pas (HubSpot, Salesforce)

Votre intégration CRM (HubSpot ou Salesforce) fonctionnait ; désormais les données ne circulent plus (ou seulement en partie). Le diagnostic est le même pour les deux — voici comment procéder.


L'intégration CRM a deux niveaux


Une intégration CRM peut casser à deux endroits, et il faut vérifier les deux :


  1. Niveau organisation — un Admin a connecté le CRM pour tout l'espace de travail depuis Paramètres → Intégrations.
  2. Niveau utilisateur — chaque utilisateur doit aussi connecter son propre compte CRM depuis Paramètres → Profil (bouton Sign in with HubSpot / Sign in with Salesforce), afin que les actions qu'il déclenche (synchronisation d'Espace, mise à jour de propriétés, etc.) s'authentifient avec ses propres permissions.


Si la synchronisation est cassée pour tout le monde, c'est très probablement le niveau 1. Si elle l'est uniquement pour vous ou pour un utilisateur précis, c'est très probablement le niveau 2.


Étape 1a — Vérifiez l'intégration au niveau organisation


  1. Allez dans Paramètres → Intégrations (rôle Admin requis).
  2. Repérez votre CRM (HubSpot ou Salesforce) dans la liste.
  3. Le statut doit afficher Connected (connecté).


S'il affiche Disconnected (déconnecté) ou Error (erreur), c'est que le jeton OAuth a expiré ou que l'autorisation a été révoquée côté CRM. Reconnectez :

  • Cliquez sur Reconnect (reconnecter)
  • Authentifiez-vous auprès du CRM
  • Accordez les permissions


Étape 1b — Vérifiez votre connexion au niveau utilisateur


  1. Allez dans Paramètres → Profil.
  2. Vérifiez que votre compte CRM apparaît bien sous Connected emails (e-mails connectés) pour votre utilisateur.


S'il n'y figure pas, cliquez sur Sign in with HubSpot / Sign in with Salesforce et authentifiez-vous avec votre compte CRM. Tant que ce niveau n'est pas en place, vos propres actions ne se synchroniseront pas — même si l'intégration au niveau organisation est saine.


Étape 2 — Vérifiez le mapping des champs


Même avec une connexion saine, certains champs peuvent ne pas se synchroniser si le mapping a cassé :


  1. Allez dans Paramètres → Hubspot (ou Salesforce).
  2. Passez en revue la section Champs synchronisés.
  3. Cherchez les correspondances dont un côté est vide ou signalé comme cassé (par ex. une propriété CRM renommée).


Corriger un mapping cassé :

  • Cliquez sur la ligne
  • Resélectionnez la propriété CRM correspondante
  • Enregistrez


Étape 3 — Vérifiez les permissions de l'utilisateur CRM


Le jeton OAuth est rattaché à l'utilisateur CRM qui a autorisé l'intégration. Si les permissions de cet utilisateur changent (retrait d'une équipe, perte d'accès aux deals/opportunités), la synchronisation casse.


  • Dans le CRM, vérifiez que l'utilisateur dispose toujours des bonnes permissions
  • Sinon, faites réautoriser Katalyz par un autre utilisateur


Étape 4 — Vérifiez des enregistrements précis


Si la synchronisation est cassée pour un deal/une opportunité mais fonctionne pour les autres :


  • Ouvrez l'enregistrement dans le CRM et confirmez qu'il existe et que les champs attendus sont remplis
  • Ouvrez l'Espace associé dans Katalyz et vérifiez les valeurs des propriétés personnalisées
  • Il arrive qu'un seul enregistrement défectueux bloque la synchronisation, pour lui seul


Étape 5 — Fréquence de synchronisation


La synchronisation s'exécute selon une planification (elle n'est pas en temps réel). Les changements récents peuvent mettre quelques minutes à se propager.


  • Attendez 5 à 10 minutes et actualisez
  • Si rien n'est synchronisé passé ce délai, c'est un vrai problème


Étape 6 — Vérifiez les paramètres de synchronisation d'activité


Si certains types d'activité n'apparaissent pas sur la timeline du CRM, vérifiez :


  • Paramètres → HubSpot → Activities (ou Salesforce → Activities) — confirmez que les événements concernés sont activés


Voir Mapping et synchronisation des champs CRM (la même interface s'applique à Salesforce).


Étape 7 — Déconnectez puis reconnectez


Quand rien d'autre ne marche, une réautorisation complète peut débloquer un état figé :


  1. Paramètres → Intégrations → votre CRM → Désinstaller (déconnecter)
  2. Attendez une minute
  3. Installer (connecter) à nouveau
  4. Réauthentifiez-vous


Cela réinitialise le jeton OAuth et relance la synchronisation.


⚠️ Après la reconnexion, revérifiez que le mapping des champs est toujours correct. Il faut parfois le redéfinir.


Étape 8 — Toujours cassé ?


Contactez contact@katalyz.co en indiquant :

  • Quel CRM (HubSpot ou Salesforce) et l'ID du portail / de l'instance
  • Quels Espaces / deals / opportunités sont concernés
  • Quels champs précisément ne se synchronisent pas
  • Quand cela fonctionnait pour la dernière fois


Nous pouvons consulter les journaux de synchronisation de notre côté.


Articles associés

Mis à jour le : 26/10/2026

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

Partagez vos commentaires

Annuler

Merci !