> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://katalyz.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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 :

1. **Au niveau de l'organisation** — un admin a connecté le CRM pour tout l'espace de travail depuis **Paramètres → Intégrations**.
2. **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

1. Allez dans **Paramètres → Intégrations** (admin requis).
2. Trouvez votre CRM (HubSpot ou Salesforce) dans la liste.
3. 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

1. Ouvrez **votre profil → Intégrations**.
2. 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 :

1. Allez dans **Paramètres → HubSpot** (ou **Salesforce**).
2. Examinez la section **Champs synchronisés**.
3. 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](https://katalyz.crisp.help/fr/article/mapping-et-synchronisation-des-champs-crm-hubspot-salesforce-q9h678/) (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é :

1. **Paramètres → Intégrations** → votre CRM → **Déconnecter**
2. Patientez une minute
3. **Connectez** à nouveau
4. 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
* [Connecter HubSpot](https://katalyz.crisp.help/fr/article/connecter-hubspot-ihvxea/)
* [Connecter Salesforce](https://katalyz.crisp.help/fr/article/connecter-salesforce-h14s8f/)
* [Mapping et synchronisation des champs CRM](https://katalyz.crisp.help/fr/article/mapping-et-synchronisation-des-champs-crm-hubspot-salesforce-q9h678/)
* [Déconnecter une intégration](https://katalyz.crisp.help/fr/article/deconnecter-une-integration-ffmm7g/)