Crear una consulta en el Developer Hub de Zoho CRM te permite definir operaciones de obtención de datos reutilizables y filtrables sobre módulos de CRM, bases de datos externas o APIs REST de terceros, todo desde una única interfaz de configuración.
Por qué esto es importante
Cuando necesitas extraer subconjuntos específicos de datos de CRM de forma programática — por ejemplo, todos los negocios abiertos vinculados a un contacto determinado — codificar llamadas a la API en cada integración se vuelve rápidamente inmanejable. La función Consultas de Zoho CRM te proporciona una consulta con nombre y versión que puedes referenciar en funciones, widgets y scripts de cliente sin duplicar la lógica. [1] Como equipo de expertos independientes (Beam Help — no soporte oficial de Zoho), encontramos esta función especialmente valiosa al crear dashboards o automatizaciones que dependen de conjuntos de registros filtrados y consistentes.
---
Paso a paso
Paso 1. Ve a Configuración → Developer Hub → Consultas. Se abrirá la ventana de Consultas, donde se listan todas las consultas ya definidas en tu organización. [1]
Paso 2. Haz clic en Agregar consulta para abrir el diálogo de creación. [1]
Paso 3. En el pop-up Crear consulta, introduce un Nombre de consulta legible y un Nombre de API (utilizado al referenciar la consulta de forma programática) y haz clic en Siguiente. [1]
Paso 4. En la sección Configuración, el tipo de fuente predeterminado es Módulo de Zoho CRM. Si necesitas una fuente diferente — como un endpoint de API REST, una base de datos relacional autoalojada (MySQL, Microsoft SQL, PostgreSQL) o una base de datos en la nube (Amazon RDS, Google Cloud Platform, Microsoft Azure) — haz clic en Cambiar para modificar el tipo de fuente. [1][7]
Paso 5. Selecciona el módulo de CRM que deseas consultar. Ten en cuenta que los subformularios también son compatibles como destinos consultables, lo que te da acceso granular a los datos de línea de artículos dentro de los registros. [1]
Paso 6. Si el módulo seleccionado contiene campos de búsqueda, puedes incorporar datos relacionados seleccionando hasta dos módulos relacionados en el menú desplegable Módulo relacionado. [1]
Paso 7. Elige los campos específicos que deseas obtener en el menú desplegable Campos. Puedes seleccionar un máximo de 50 campos por consulta. [1]
Paso 8. Configura la sección Criterios. Tienes tres opciones: [1]
- Ninguno — devuelve todos los registros sin aplicar ningún filtro.
- ID de registro — filtra la respuesta a un único registro por su identificador único.
- Criterios — aplica lógica condicional sobre uno o más campos. Puedes combinar condiciones usando los operadores AND / OR y utilizar comparadores adecuados para cada tipo de campo.
Paso 9. Para cada criterio, decide si proporcionarás un valor estático (fijo en el momento de crear la consulta) o un valor dinámico. Elegir dinámico significa que el valor real se pasa en tiempo de ejecución — por ejemplo, cuando la consulta se invoca desde una función o widget — lo que hace que la consulta sea reutilizable en diferentes registros o contextos. [1]
Paso 10. Guarda la consulta. Ahora aparecerá en la lista de Consultas y podrá ser referenciada por su nombre de API desde Funciones de Zoho CRM, Scripts de cliente, Widgets o llamadas SDK del lado del servidor. [1][8]
---
Errores comunes
- Límite de módulos relacionados: Solo puedes incluir datos de un máximo de dos módulos relacionados por búsqueda en una sola consulta. La interfaz de configuración no permitirá agregar más. [1]
- Límite de campos: No está permitido seleccionar más de 50 campos en una sola consulta. Si necesitas más campos, considera dividir la lógica en dos consultas separadas. [1]
- Fuentes de bases de datos externas — lista blanca de IPs: Al usar una base de datos MySQL, PostgreSQL o Microsoft SQL autoalojada como fuente de consulta, debes incluir en la lista blanca las direcciones IP de Zoho CRM en tu servidor de retransmisión y agregar el host a Dominios de confianza si no se expresa como una dirección IP sin formato. Omitir este paso provocará fallos de conexión. [7]
- SSL y configuración avanzada: Tanto para bases de datos estándar como en la nube, opciones como el tiempo de espera de conexión, la zona horaria y la aplicación de SSL se encuentran en Configuración avanzada dentro de la configuración de la fuente — fácil de pasar por alto si avanzas rápidamente por el asistente. [7]
- Valores dinámicos vs. estáticos: Un error común es establecer un valor como estático durante las pruebas y olvidar cambiarlo a dinámico antes de la implementación. Un criterio estático siempre filtrará por el mismo valor codificado, lo cual rara vez es el comportamiento deseado en flujos de trabajo en producción. [1]
---
Qué verificar
- La consulta devuelve los registros esperados: Después de guardar, usa la opción de prueba/vista previa integrada para confirmar que la lógica de criterios produce el conjunto de resultados filtrado correcto antes de conectar la consulta a cualquier automatización.
- El nombre de API es único y está referenciado correctamente: Verifica que el nombre de API asignado coincida exactamente con lo que se referencia en cualquier Función, Script de cliente o llamada SDK que consuma esta consulta. [1][8]
- Conectividad de la fuente (para fuentes externas): Si tu consulta apunta a una API REST externa o a una base de datos, confirma que la conexión está activa y que las IPs de Zoho CRM están en la lista blanca del host remoto antes de publicar. [7]