Erreurs d'intégration OAuth Zoho CRM avec l'API Make

Cette erreur apparaît lorsque Make (anciennement Integromat) ne parvient pas à finaliser la négociation OAuth ou les appels API contre Zoho CRM — généralement, vous rencontrez des erreurs OAUTHSCOPEMISMATCH, des réponses 401/403, ou des échecs intermittents de "token invalide" lors de la création ou de l'exécution de scénarios.

Ce que cela signifie — explication concrète liée à la surface de l'API Zoho

Make demande des scopes OAuth, ou tente des appels API, qui ne correspondent pas à la configuration OAuth de Zoho CRM ou aux permissions de l'utilisateur connecté. L'API de Zoho applique des groupes de scopes et des permissions d'extension au niveau administrateur ; si les scopes sont manquants, expirés, ou si l'utilisateur Zoho autorisé manque des accès administrateur/extension requis, l'émission de tokens ou les appels API échouent ^[1][2]. Des incidents transitoires des services Zoho ou des atteintes aux quotas/limites peuvent produire des erreurs similaires à des échecs d'authentification lorsque les requêtes sont rejetées en cours de processus ^[6][7].

Causes courantes

• Scopes OAuth incorrects ou incomplets demandés dans Make — les groupes de scopes comme ZohoCRM.modules.ALL doivent correspondre exactement à ce que l'application attend ^[2].
• L'utilisateur Zoho qui a autorisé la connexion manque des privilèges administrateur/extension requis pour accorder des intégrations de marketplace ou certains scopes de l'API CRM ^[1].
• Le token d'accès ou de rafraîchissement a expiré, a été révoqué, ou n'est pas correctement stocké par la connexion Make, provoquant des 401/403 répétés ^[1].
• Incident des services Zoho ou limites de taux/quotas bloquant les requêtes ; les erreurs ressemblent à des échecs d'authentification lorsque les appels sont limités ou expirent ^[6][7].

Comment y remédier

1. Ré-autoriser depuis Make en utilisant un compte administrateur : Dans Make, supprimez la connexion Zoho CRM existante et créez-en une nouvelle en vous connectant en tant qu'administrateur Zoho CRM (Profil > Configuration > Marketplace/Extensions si vous avez besoin de vérifier les privilèges d'extension) ^[1].
2. Demander des scopes explicites : Dans la configuration OAuth de Make, incluez les scopes CRM exacts dont votre scénario a besoin (par exemple, ZohoCRM.modules.ALL). Évitez de combiner des groupes de scopes incorrects qui déclenchent OAUTHSCOPEMISMATCH ^[2].
3. Confirmer le cycle de vie du token : Assurez-vous que Make reçoit et stocke les tokens d'accès et de rafraîchissement. Si vous constatez des expirations fréquentes, forcez une nouvelle autorisation OAuth et vérifiez que les paramètres du connecteur de Make affichent une connexion active.
4. Vérifier les permissions utilisateur dans CRM : Vérifiez que le profil de l'utilisateur autorisant possède les accès aux extensions et à l'API (Configuration > Utilisateurs & Contrôle > Contrôle de sécurité / Profils) et que les permissions au niveau du module couvrent les opérations effectuées par Make ^[1].
5. Écarter les incidents de service et les limites : Vérifiez le statut de Zoho et l'utilisation/le quota API de votre organisation. Si vous atteignez les limites par minute ou quotidiennes, cadencé vos scénarios ou demandez des limites plus élevées via le support Zoho ^[6][7].

Quand escalader

Escaladez vers le support Zoho lorsque la ré-autorisation, les scopes corrects et les vérifications des permissions administrateur ne résolvent pas l'erreur, ou lorsqu'un incident confirmé côté Zoho ou un ajustement de quota est requis ; incluez les journaux montrant le code d'erreur exact, l'horodatage et les scopes OAuth utilisés.

^[1]: CRM | Dépannage | Base de connaissances

^[2]: Permissions utilisateur pour la traduction (exemple lié aux scopes)

^[6]: Impact/Bonnes pratiques lors de "Disponibilité des services Zoho US - Incident, Zoho Deluge est en panne"

^[7]: Dépassement de la limite d'exécution