Las vistas personalizadas en Zoho CRM se pueden recuperar como una lista completa para un módulo determinado o como una vista individual por su ID, utilizando dos endpoints dedicados disponibles a través de la API de configuración del CRM.
Por qué es importante
Cuando construyes integraciones o automatizaciones sobre Zoho CRM, a menudo necesitas saber qué vistas personalizadas existen para un módulo — por ejemplo, para replicar un filtro guardado en un panel externo o para validar que una vista existe antes de referenciarla de forma programática. Obtener una vista específica por ID te permite inspeccionar su configuración exacta sin tener que traer la lista completa. Como soporte experto independiente (no soporte oficial de Zoho), Beam Help documenta estos endpoints para que tu equipo pueda utilizarlos con confianza.
Paso a paso
Paso 1. Para recuperar todas las vistas personalizadas de un módulo, envía una solicitud GET al endpoint /settings/customviews, pasando el nombre de la API del módulo como parámetro de consulta module.[1] Por ejemplo, para listar todas las vistas personalizadas del módulo Leads, tu solicitud apuntaría a /settings/customviews?module=Leads.[1]
Paso 2. La llamada subyacente sigue este patrón — tu cliente emite un GET a /settings/custom_views con {"module": m} como carga útil del parámetro, donde m es la cadena con el nombre del módulo.[1] Esta operación se clasifica como una llamada de configuración y ha sido verificada como SAFE, por lo que no conlleva riesgo de modificar datos.[3]
Paso 3. Para recuperar una vista personalizada individual por su ID, utiliza el endpoint /settings/custom_views/{vid}, donde {vid} es el identificador único de la vista.[2] Debes seguir proporcionando el nombre del módulo como parámetro de consulta junto con el ID de la vista.[2]
Paso 4. La llamada a una vista individual sigue este patrón — tu cliente emite un GET a /settings/custom_views/{vid} con {"module": m} como parámetro, y vid es la cadena del ID de la vista que deseas inspeccionar.[2] Al igual que el endpoint de lista, esta operación se clasifica como SAFE y no tiene efectos secundarios de escritura.[8]
Paso 5. Si trabajas dentro de la capa de herramientas de Beam Help, la herramienta getcustomview envuelve este endpoint y acepta m (nombre del módulo) y view_id como sus parámetros.[7] Pasa ambos valores y la herramienta se encarga de construir la ruta por ti.[7]
Errores comunes
- Omitir el parámetro de módulo. Ambos endpoints requieren el parámetro
module— omitirlo producirá una respuesta fallida o ambigua, ya que las vistas personalizadas de Zoho CRM siempre están asociadas a un módulo específico.[1][2] - Confundir los dos endpoints.
/settings/customviews(sin sufijo en la ruta) devuelve la lista completa de un módulo, mientras que/settings/customviews/{vid}apunta a una vista específica. Usar el endpoint de lista cuando ya tienes un ID de vista es ineficiente y devuelve más datos de los necesarios.[1][2] - IDs de vista desactualizados. Los IDs de vista son estables, pero pueden volverse inválidos si una vista personalizada se elimina desde la interfaz del CRM. Gestiona siempre de forma adecuada una respuesta de vista no encontrada en tu código de integración.[8]
Qué verificar
- Confirma que el nombre de la API del módulo que estás pasando coincide exactamente con el nombre interno utilizado por Zoho CRM (p. ej.,
Leads,Contacts,Deals) — una discrepancia no devolverá resultados.[1] - Verifica que el ID de vista que proporcionas a
/settings/custom_views/{vid}fue obtenido de una llamada de lista previa o desde la configuración del CRM, para evitar referenciar una vista eliminada o inexistente.[2][8] - Asegúrate de que tus credenciales de API tienen acceso al ámbito de configuración, ya que ambos endpoints se encuentran bajo
/settings/y pueden requerir permisos elevados más allá del acceso estándar a nivel de registros.[3][8]