Este error aparece cuando la llamada a la API de Zoho CRM/producto Zoho relacionado que debería devolver fallos de funciones personalizadas, en su lugar devuelve HTTP 204 (Sin Contenido) o un cuerpo 200 vacío, mientras que la interfaz de usuario web de Zoho todavía muestra funciones fallidas. La superficie de la API actualmente no tiene un endpoint "function-failures" documentado, por lo que el cliente ve "sin fallos" a pesar de que la vista de Fallos en el producto lista errores reales.[1]
Qué significa — explicación concreta ligada a la superficie de la API de Zoho
La API pública del producto no expone el mismo informe de fallos de funciones que utiliza la interfaz de usuario; los llamadores de los endpoints intentados o bien acceden a una ruta no documentada o a un endpoint que intencionadamente devuelve 204/200 vacío cuando no existe un feed de fallos a nivel de API. Esa discrepancia produce una respuesta de API vacía incluso cuando la interfaz de usuario tiene entradas para fallos de funciones personalizadas o errores de scripts de flujo de trabajo.[1]
Causas comunes
- Llamaste a un endpoint no documentado o no compatible (no existe una API oficial de fallos de funciones en la referencia).[ ^1]
- Consultaste el producto o endpoint del centro de datos (DC) incorrecto y accediste a una ruta que devuelve 204 para solicitudes entre centros de datos o no coincidentes.[1]
- Tu token de acceso o scope carece de los permisos para ver automatización o funciones, lo que hace que la API suprima los resultados.[1]
- Intentaste reutilizar una ruta de fallos de webhooks; los fallos de webhooks están documentados pero no informan sobre fallos de funciones personalizadas.[1]
Cómo solucionarlo
- Confirma la referencia de la API: consulta la documentación oficial de la API de Zoho para tu producto y DC para verificar si existe un endpoint de fallos de funciones. Si no se documenta ningún endpoint, planea usar la interfaz de usuario o los registros de la aplicación en su lugar.[1]
- Usa la vista de Fallos de la interfaz de usuario para una triaje inmediata: abre Zoho CRM (o el producto que ejecuta las funciones) > Configuración > Automatización > Funciones/Fallos para ver y volver a ejecutar funciones fallidas. Copia las marcas de tiempo y los nombres de las funciones para auditoría.[1]
- Si debes automatizar: instrumenta tus funciones para registrar fallos en un almacén de búsqueda (Zoho Analytics, un webhook personalizado o un servicio de registro externo) cuando capturen excepciones. Esto te proporciona un flujo de fallos accesible por API independiente del visor de fallos interno del producto.
- Verifica los scopes de OAuth y el DC: confirma que el cliente OAuth utiliza scopes que permiten leer metadatos de automatización/funciones y que tu URL base de API coincide con el DC de la organización. Vuelve a intentarlo después de corregir los scopes o la URL base.[1]
- Recopila evidencia y reproduce: captura la solicitud/respuesta de la API (encabezados, URL, cuerpo, estado HTTP), la fila de fallo de la interfaz de usuario (nombre de la función, hora, mensaje de error) y el DC de la cuenta. Prepara esto antes de contactar al soporte de Zoho.[1]
Cuándo escalar
Abre un ticket de soporte de Zoho cuando puedas reproducir la discrepancia con los registros de solicitud y la captura de pantalla de la interfaz de usuario; incluye marcas de tiempo, volcados de solicitud/respuesta y la cuenta/DC afectada. Escala si esto bloquea la recuperación de la automatización o si necesitas una API oficial para el monitoreo de fallos más allá de las verificaciones manuales de la interfaz de usuario.