Vista de Funciones de Zoho: página en blanco con error TOO_MANY_REQUESTS

Este error aparece cuando la nueva vista de Funciones en Zoho CRM devuelve un error JSON: {"code":"TOOMANYREQUESTS","message":"Request skipped internally for Mitigation","status":"error"}, y la página de Funciones permanece en blanco. Significa que el frontend o backend del CRM rechazó la carga de la página porque el limitador de velocidad interno o la lógica de mitigación bloquearon una o más solicitudes utilizadas por la interfaz de usuario de Funciones ^[1].

Qué significa

La interfaz de usuario de Funciones de Zoho CRM carga varios puntos finales del backend (lista de funciones, metadatos, vistas previas). Una respuesta TOOMANYREQUESTS significa que una de esas llamadas alcanzó un umbral de limitación interna o una puerta de mitigación automatizada y fue omitida en lugar de devolver datos, por lo que la vista no tiene datos para renderizar. El JSON y la página en blanco provienen del punto final de Funciones del CRM que responde con ese error cuando la política de mitigación bloquea la solicitud ^[1].

Causas comunes

• Solicitudes repetidas y rápidas a los puntos finales de Funciones (abrir/actualizar varias pestañas, herramientas automatizadas) que activan los límites de velocidad del CRM o las reglas de mitigación ^[1].
• Extensiones del navegador o proxies que reproducen solicitudes (bloqueadores de anuncios, extensiones de privacidad, proxies corporativos) que causan llamadas duplicadas y activan la mitigación ^[1].
• Un evento de mitigación temporal en el backend de Zoho, en la capa de borde o de aplicación: protección transitoria que descarta algunas solicitudes ^[1].
• Corrupción de la sesión o las cookies que hace que la interfaz de usuario reintente las solicitudes en un bucle hasta que se active la mitigación ^[1].

Cómo solucionarlo

1. Reproducir limpiamente: abre Zoho CRM en una nueva ventana privada/incógnita, inicia sesión y luego ve a Configuración > Espacio del desarrollador > Funciones (vista de Funciones) para confirmar que el error se puede reproducir sin extensiones.
2. Remediación simple: espera 60–120 segundos y recarga la página de Funciones una vez. Las reglas de mitigación a menudo son de corta duración; un solo reintento después de una breve pausa suele tener éxito.
3. Detener solicitudes concurrentes: cierra otras pestañas/ventanas o trabajos automatizados que accedan a Funciones o a las API del CRM, y luego vuelve a intentarlo. Evita abrir la vista de Funciones varias veces simultáneamente.
4. Desactivar extensiones y verificar la red: desactiva temporalmente las extensiones del navegador (bloqueadores de anuncios/rastreadores) y los proxies corporativos. Abre Herramientas del desarrollador → Red y Consola y recarga; anota cualquier solicitud repetida o respuestas 429/TOOMANYREQUESTS y la URL del punto final que falla.
5. Capturar diagnósticos: si el error persiste, graba un archivo HAR (Herramientas del desarrollador → Red → Guardar HAR), anota las marcas de tiempo, el ID de la organización (Configuración > Detalles de la empresa), el correo electrónico del usuario afectado y la URL exacta que se muestra en la respuesta del error.
6. Si ejecutas scripts o integraciones que llaman a Funciones o API relacionadas del CRM, limita la tasa de solicitudes a un nivel más bajo e implementa un retroceso exponencial en las respuestas 429.

Cuándo escalar

Abre un ticket de soporte con el Soporte de Zoho cuando el problema continúe después de esperar y eliminar las causas locales, o cuando varios usuarios y organizaciones vean el mismo error. Adjunta el archivo HAR, capturas de pantalla, el JSON de error exacto, el ID de la organización, el correo electrónico del usuario, las marcas de tiempo y los pasos para reproducir, para que el Soporte pueda rastrear los eventos de mitigación internos.

^[1]: Informe de ejemplo de un usuario que muestra la vista de Funciones en blanco y la respuesta JSON TOOMANYREQUESTS de la URL de Funciones del CRM.