Un error de conexión F7003 ("OAuth no válido") significa que Zoho CRM no pudo autorizar las llamadas a WorkDrive porque el apretón de manos OAuth o el token es inválido o falta. El CRM no puede adjuntar un token de acceso válido a la solicitud de WorkDrive.
Qué significa
Zoho CRM intentó una solicitud OAuth 2.0 para WorkDrive, pero el paso de autorización no devolvió un token utilizable o el token no pudo aplicarse a la llamada API. Esto aparece cuando la conexión se muestra como "Conectada" en CRM, pero las llamadas API devuelven fallos de autenticación, o cuando la redirección/metadatos OAuth no coinciden con la configuración del cliente registrado [1][3][5].
Causas comunes
- El token de acceso almacenado expiró o el refresco falló, por lo que las llamadas se envían sin credenciales válidas [1][6].
- La configuración del cliente OAuth (URI de redirección, estado o URL de solicitud) no coincide con el registro de la aplicación, lo que hace que el proveedor rechace el intercambio de tokens [3][5].
- La conexión en Developer Hub se creó con ámbitos o ID/secreto de cliente incorrectos, por lo que los tokens carecen de los ámbitos requeridos de WorkDrive [1][6].
- Un fallo en el manejo de solicitudes del lado de Zoho o un estado/URL OAuth mal formado (caracteres especiales o delimitadores de barra vertical) interrumpe el flujo y genera un error "URL de solicitud no válida" o similar [5][7].
Cómo solucionarlo
- Vuelve a conectar WorkDrive en Zoho CRM: ve a Configuración → Espacio del desarrollador → Conexiones, abre la conexión de WorkDrive y haz clic en Volver a conectar. Confirma el consentimiento OAuth y permite los ámbitos solicitados [1].
- Verifica las credenciales de la aplicación y las URI de redirección: en la Consola de API de Zoho (o proveedor OAuth externo) confirma que el ID del cliente, el secreto del cliente y la URI de redirección exacta coinciden con la configuración de la conexión del CRM. Corrige cualquier discrepancia y recrea la conexión si cambias los valores [3][5].
- Comprueba los ámbitos y permisos: asegúrate de que la conexión solicita los ámbitos de WorkDrive necesarios para las acciones que realizas. Si utilizaste ámbitos personalizados, actualízalos y vuelve a conectar para que el token incluya esos ámbitos [6].
- Borra los tokens cacheados: si volver a conectar no ayudó, elimina la conexión y crea una nueva para forzar un flujo de autenticación completo y nuevos tokens de acceso + refresco. Prueba una llamada API inmediatamente después de volver a conectar.
- Inspecciona los detalles del error y los registros: captura la respuesta completa del error de la API y los registros del CRM (Espacio del desarrollador → Conexiones → Ver registros) para detectar errores "CREDENTIALSMISSING", "invalidscope" o de URL/estado. Si controlas la aplicación cliente, evita caracteres especiales en el estado y problemas de codificación de URL que hayan causado fallos anteriormente [1][5][7].
Cuándo escalar
Abre un ticket de soporte de Zoho cuando las conexiones nuevas y la configuración correcta del cliente sigan fallando, o cuando los registros muestren errores del lado del proveedor como URLRULENOT_CONFIGURED o un comportamiento OAuth no estándar. Incluye los registros de conexión, la carga útil exacta del error, los valores de redirección OAuth y las marcas de tiempo para que el soporte pueda rastrear el intercambio OAuth [3][5].
[1]: Error 401 No autenticado – Integración de Zoho CRM con Google Sheets.
[3]: TeamInbox EU: Microsoft 365 no se conecta (URL no válida / URLRULENOT_CONFIGURED).
[5]: Error: El parámetro de estado OAuth 2.0 falla con delimitadores de barra vertical (Incumplimiento RFC 6749).
[6]: Migración a OAuth 2.0 (documentación para desarrolladores de Zoho).
[7]: Error de autenticación del plugin ChatGPT / servidor MCP (URL de solicitud no válida según metadatos OAuth).