Errores de Integración OAuth de Zoho CRM con Make API

Este error aparece cuando Make (anteriormente Integromat) no puede completar el handshake OAuth o las llamadas a la API contra Zoho CRM; típicamente verás fallos de OAUTHSCOPEMISMATCH, respuestas 401/403, o fallos intermitentes de "token inválido" mientras construyes o ejecutas escenarios.

Qué significa — explicación concreta ligada a la superficie de la API de Zoho

Make está solicitando ámbitos OAuth, o intentando llamadas a la API, que no coinciden con la configuración OAuth de Zoho CRM o los permisos del usuario conectado. La API de Zoho aplica grupos de ámbitos y permisos de extensión a nivel de administrador; si faltan ámbitos, han caducado, o el usuario de Zoho autorizado carece del acceso de administrador/extensión requerido, la emisión de tokens o las llamadas a la API fallan ^[1][2]. Incidentes transitorios del servicio de Zoho o la superación de cuotas/límites pueden producir errores similares a fallos de autenticación cuando las solicitudes son rechazadas a mitad de camino ^[6][7].

Causas comunes

• Ámbitos OAuth incorrectos o incompletos solicitados en Make; los grupos de ámbitos como ZohoCRM.modules.ALL deben coincidir exactamente con lo que espera la aplicación ^[2].
• El usuario de Zoho que autorizó la conexión carece de privilegios de administrador/extensión necesarios para otorgar integraciones del marketplace o ciertos ámbitos de la API de CRM ^[1].
• Token de acceso o de actualización caducado, revocado o no almacenado correctamente por la conexión de Make, causando repetidos 401/403 ^[1].
• Incidente del servicio de Zoho o límites de tasa/cuota que bloquean las solicitudes; los errores se parecen a fallos de autenticación cuando las llamadas son limitadas o se agota el tiempo de espera ^[6][7].

Cómo solucionarlo

1. Reautorizar desde Make usando una cuenta de administrador: En Make, elimina la conexión existente de Zoho CRM y crea una nueva mientras inicias sesión como administrador de Zoho CRM (Perfil > Configuración > Marketplace/Extensiones si necesitas verificar los privilegios de extensión) ^[1].
2. Solicitar ámbitos explícitos: En la configuración OAuth de Make, incluye los ámbitos de CRM exactos que tu escenario necesita (por ejemplo, ZohoCRM.modules.ALL). Evita combinar grupos de ámbitos incorrectos que activen OAUTHSCOPEMISMATCH ^[2].
3. Confirmar el ciclo de vida del token: Asegúrate de que Make reciba y almacene tanto los tokens de acceso como los de actualización. Si ves expiraciones frecuentes, fuerza una nueva concesión OAuth y verifica que la configuración del conector de Make muestre una conexión activa.
4. Comprobar los permisos del usuario en CRM: Verifica que el perfil del usuario que autoriza tenga acceso a extensiones y a la API (Configuración > Usuarios y Control > Control de Seguridad / Perfiles) y que los permisos a nivel de módulo cubran las operaciones que realiza Make ^[1].
5. Descartar incidentes del servicio y límites: Consulta el estado de Zoho y el uso/cuota de API de tu organización. Si alcanzas los límites por minuto o diarios, ajusta el ritmo de los escenarios o solicita límites más altos a través del soporte de Zoho ^[6][7].

Cuándo escalar

Escala al soporte de Zoho cuando la reautorización, los ámbitos correctos y las comprobaciones de permisos de administrador no resuelvan el error, o cuando se requiera un incidente confirmado del lado de Zoho o un ajuste de cuota; incluye registros que muestren el código de error exacto, la marca de tiempo y los ámbitos OAuth utilizados.

^[1]: CRM | Troubleshooting | Knowledge Base

^[2]: User permissions for translation (scope-related example)

^[6]: Impact/Best Practices when "US Zoho Services Availability - Incident, Zoho Deluge is down"

^[7]: Exceed Limit Execution