Articles sur : Dépannage

Mon CRM ne se synchronise pas (HubSpot, Salesforce)

Votre intégration CRM (HubSpot ou Salesforce) fonctionnait, et maintenant les données ne circulent plus (ou seulement partiellement). 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 tomber à deux endroits, et il faut vérifier les deux :

Au niveau de l'organisation — un admin a connecté le CRM pour tout l'espace de travail depuis Paramètres → Intégrations.
Au niveau utilisateur — chaque utilisateur doit aussi connecter son propre compte CRM depuis son profil → Intégrations, pour que les actions qu'il déclenche (sync de l'Espace, mise à jour de propriété, etc.) s'authentifient avec ses propres droits.

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

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

Allez dans Paramètres → Intégrations (admin requis).
Trouvez votre CRM (HubSpot ou Salesforce) dans la liste.
Le statut doit afficher Connecté.

S'il affiche Déconnecté ou Erreur, le jeton OAuth a expiré ou l'autorisation a été révoquée côté CRM. Reconnectez-vous :

Cliquez sur Reconnecter
Authentifiez-vous avec le CRM
Accordez les autorisations

Étape 1b — Vérifiez votre connexion utilisateur

Ouvrez votre profil → Intégrations.
Vérifiez que votre CRM apparaît bien comme connecté pour votre compte utilisateur.

Si vous n'êtes pas connecté (ou si le statut indique une erreur), cliquez sur Connecter et authentifiez-vous avec votre compte CRM. Tant que ce niveau n'est pas en place, vos propres actions ne se synchronisent pas, même si l'intégration au niveau organisation est saine.

Étape 2 — Vérifiez les correspondances de champs

Même avec une connexion saine, certains champs peuvent ne pas se synchroniser si les correspondances sont rompues :

Allez dans Paramètres → HubSpot (ou Salesforce).
Examinez la section Champs synchronisés.
Recherchez les correspondances où un côté est vide ou signalé comme rompu (par exemple, une propriété renommée côté CRM).

Corriger les correspondances rompues :

Cliquez sur la ligne
Re-sélectionnez la propriété CRM correspondante
Enregistrez

Étape 3 — Vérifiez les autorisations de l'utilisateur côté CRM

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

Dans le CRM, vérifiez que l'utilisateur dispose toujours des bonnes autorisations
Sinon, faites en sorte qu'un autre utilisateur ré-autorise Katalyz

Étape 4 — Vérifiez des enregistrements spécifiques

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

Ouvrez l'enregistrement dans le CRM et vérifiez qu'il existe et que les champs attendus sont renseignés
Ouvrez l'Espace lié dans Katalyz et vérifiez les valeurs des propriétés personnalisées
Parfois, un seul mauvais enregistrement bloque la synchronisation uniquement pour cet enregistrement

Étape 5 — Fréquence de synchronisation

La synchronisation s'effectue selon une planification (pas en temps réel). Les changements récents peuvent prendre quelques minutes à se propager.

Patientez 5 à 10 minutes et rafraîchissez
Si toujours pas synchronisé après cela, c'est un vrai problème

Étape 6 — Vérifiez les paramètres de synchronisation des activités

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

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

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

Étape 7 — Déconnectez et reconnectez

Quand rien d'autre ne fonctionne, une ré-authentification complète peut parfois débloquer un état figé :

Paramètres → Intégrations → votre CRM → Déconnecter
Patientez une minute
Connectez à nouveau
Ré-authentifiez-vous

Cela réinitialise le jeton OAuth et rafraîchit la synchronisation.

⚠️ Après la reconnexion, vérifiez que les correspondances de champs sont toujours correctes. Parfois, les correspondances doivent être rétablies.

Étape 8 — Toujours en panne ?

Contactez contact@katalyz.co avec :

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

Nous pouvons vérifier les logs de synchronisation de notre côté.

Articles liés

Mis à jour le : 18/06/2026

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

Merci !