Este error aparece cuando los endpoints del pipeline de Módulos de Deals devuelven 204 No Content o un objeto de pipeline nulo, a pesar de que el CRM muestra el pipeline predeterminado (Estándar) en la interfaz de usuario. La API solo comienza a devolver datos del pipeline después de que se crea al menos un pipeline personalizado, lo que interrumpe las integraciones que esperan un registro de pipeline para cada cuenta [1].
Qué significa
Cuando llamas a los endpoints del pipeline de Zoho CRM para Deals y recibes 204 No Content o un pipeline nulo, la API no está exponiendo el pipeline Estándar incorporado si no existen pipelines personalizados en la cuenta. La página Administrar Pipelines en Configuración del CRM puede no mostrar pipelines configurados, pero el pipeline Estándar aún existe en la interfaz de usuario; la respuesta de la API lo omite hasta que se agrega un pipeline personalizado [1].
Causas comunes
- Un comportamiento/error de la plataforma donde la API omite el pipeline Estándar predeterminado a menos que exista un pipeline personalizado [1].
- La cuenta genuinamente no tiene pipelines personalizados configurados, lo que desencadena la respuesta 204 mientras la interfaz de usuario todavía muestra el pipeline Estándar implícito [1].
- La falta del alcance de configuración de pipeline en el token de la API puede impedir que se devuelvan los datos del pipeline; verifica que tus alcances de OAuth incluyan el alcance de configuración de pipeline si se utiliza [2].
- El código de integración trata el 204 como un error grave en lugar de un estado que significa "solo el pipeline predeterminado presente", por lo que falla en etapas posteriores [1].
Cómo solucionarlo
- Agrega un pipeline personalizado en la cuenta como una solución temporal: abre Configuración del CRM > Configurar > Administrar Pipelines (Pipelines) y crea cualquier pipeline personalizado. La API devolverá entonces el pipeline Estándar más el nuevo pipeline personalizado, restaurando los datos esperados para las integraciones [1].
- Actualiza tu integración para manejar 204 No Content de manera elegante: cuando el endpoint del pipeline devuelva 204, recurre a tratar la cuenta como si estuviera usando el pipeline Estándar (usa los valores del campo Etapa de Deals y tu mapeo predeterminado conocido). Esto evita bloquear el procesamiento cuando no se devuelve ningún objeto de pipeline [1].
- Si requieres IDs de pipeline programáticamente, crea un pipeline personalizado mínimo a través de la API o la interfaz de usuario para forzar a la API a devolver objetos de pipeline; captura los IDs de pipeline devueltos para uso futuro [1].
- Si no puedes crear pipelines personalizados en cuentas de clientes, agrega una detección robusta: ante un 204 de los endpoints de pipeline, consulta los registros de Deals para obtener valores de etapa para reconstruir las listas esperadas de pipeline/etapa y procede sin IDs de pipeline. Implementa reintentos y registra la ocurrencia del 204 para análisis posterior [1].
- Recopila registros y abre un ticket de soporte si necesitas una solución permanente en la plataforma: incluye pares de solicitud/respuesta de la API, marcas de tiempo, el ID de la organización y una secuencia reproducible (sin pipelines personalizados -> 204; agregar un pipeline personalizado -> aparecen objetos de pipeline) para que el soporte pueda escalar el comportamiento del backend [1].
Cuándo escalar
Escala a Soporte de Zoho cuando tu integración no pueda operar sin IDs de pipeline y crear un pipeline personalizado no sea una opción, o cuando el comportamiento 204 ocurra de manera inconsistente entre cuentas a pesar de configuraciones idénticas — incluye los registros de la API y el ID de la organización para una resolución más rápida [1].
[1]: https://help.zoho.com/portal/en/community/topic/zoho-crm-deal-api-returning-null-pipeline-in-case-of-default-pipeline
[2]: https://help.zoho.com/portal/en/kb/crm/troubleshooting/articles/troubleshooting-pipelines