Dépanner une intégration
Les problèmes les plus courants et leur solution.
La grande majorité des problèmes d'intégration sont liés à 3 causes : tokens expirés, scopes insuffisants, ou rate limits côté fournisseur. Ce guide couvre les symptômes et fixes associés.
Intégration déconnectée
Symptôme : badge rouge « Déconnectée » sur l'intégration, notification Nexte. Cause habituelle : token OAuth expiré (changement de mot de passe chez le fournisseur, révocation manuelle, MAJ de l'app).
- Paramètres → Apps → trouvez l'intégration concernée.
- Cliquez sur « Reconnecter ». Vous êtes redirigé vers l'écran OAuth du fournisseur.
- Validez les permissions. Retour automatique vers Nexte avec intégration verte.
- Les données déjà synchronisées restent intactes, la sync reprend immédiatement.
Données qui ne remontent pas
Symptôme : intégration verte mais rien ne se passe, nouvelles entrées côté fournisseur absentes de Nexte. Causes possibles : délai de sync (jusqu'à 5 min normalement), scope OAuth insuffisant, permissions restreintes côté fournisseur.
- Vérifier l'état : Paramètres → Apps → icône « i » à côté de l'intégration. Affiche dernière sync réussie, dernière erreur, nombre d'éléments synchronisés.
- Forcer resync : bouton « Rafraîchir » dans l'intégration. Utile si une sync automatique a échoué silencieusement.
- Vérifier les scopes : reconnectez l'intégration pour refresh les permissions (utile si de nouveaux scopes ont été ajoutés par une MAJ Nexte).
- Vérifier côté fournisseur : la donnée existe-t-elle vraiment ? Un email marqué lu, une page Notion archivée, un fichier Figma dans un espace non autorisé ne sont pas synchronisés.
Erreur 429 / rate limit
Symptôme : notification « Trop de requêtes » ou intégration qui lag. Cause : le fournisseur plafonne le nombre d'appels API par heure ou par jour. Nexte applique automatiquement un back-off exponentiel (1s, 2s, 4s, 8s, 16s, 32s) et relance chaque requête jusqu'à succès.
- Durée typique : résolution automatique sous 5-15 minutes.
- Si persiste > 1h : probablement un problème de quota Google/Microsoft/HubSpot de votre compte. Vérifiez votre dashboard fournisseur.
- Contournement : désactivez la sync en temps réel et passez en mode « Horaire » pour réduire la charge.
- Support : si persiste > 4h, contactez le support Nexte avec le log d'erreur (accessible dans l'écran de l'intégration).
Conflit de sync bidirectionnelle
Applicable surtout aux CRM (HubSpot, Pipedrive) quand une même entité est modifiée simultanément des deux côtés. Nexte applique une règle « last-write-wins » : la modification la plus récente gagne. L'autre est archivée dans un log d'audit consultable pendant 30 jours.
Intégration qui se re-déconnecte en boucle
Rare mais possible. Causes connues : 2FA activée sans app-password côté Google Workspace, politique de sécurité entreprise qui révoque les tokens OAuth automatiquement, antivirus qui intercepte les callbacks OAuth.
- Google Workspace : demandez à votre admin IT de whitelister l'app OAuth Nexte dans les settings Marketplace.
- Microsoft 365 : idem côté Entra ID. Admin consent peut être requis.
- 2FA : utilisez toujours OAuth (pas un mot de passe) — le flow 2FA est transparent pour Nexte.