Cómo recuperar registros relacionados en Zoho CRM

Zoho CRM ofrece varias formas de recuperar registros relacionados: desde un componente de interfaz sin código que refleja datos en tiempo real directamente en la página de detalle de un registro, hasta herramientas de consulta basadas en GraphQL y REST orientadas a desarrolladores para el acceso programático.

Por qué esto importa

Al trabajar en Zoho CRM, los registros raramente existen de forma aislada. Un negocio se vincula a un contacto; un caso se asocia a una cuenta. Sin una forma estructurada de acceder a esos datos relacionados, tu equipo pierde tiempo navegando entre módulos para encontrar un número de teléfono, una dirección de correo electrónico o una actualización de estado. Saber qué método de recuperación se adapta a tu caso de uso — basado en la interfaz o en la API — ahorra tiempo considerable y reduce los cambios de contexto.

Paso a paso

Opción A: Usar el Componente Mirror (Sin código, interfaz)

Paso 1. Comprende qué hace el Componente Mirror. Actúa como una ventana en tiempo real integrada directamente en la página de detalle de un registro, reflejando los valores de campo de un registro relacionado en tiempo real. Por ejemplo, un representante de ventas que trabaja en un negocio puede ver el número de teléfono o la dirección de correo electrónico del contacto vinculado sin salir del registro del negocio. ^[1]

Paso 2. Verifica la elegibilidad de tu centro de datos. En la última versión, el Componente Mirror está disponible para los centros de datos JP, CA, SA, UAE y AU. Si tu organización está en uno de estos centros de datos, la función debería ser accesible desde la configuración de tu CRM. ^[1]

Paso 3. Navega a la página de detalle del registro donde deseas agregar el componente. El Componente Mirror se configura a nivel de diseño de página — abre Configuración → Módulos y Campos, selecciona el módulo correspondiente y abre el editor de diseño para la vista de detalle de ese módulo. ^[1]

Paso 4. Localiza la opción del Componente Mirror en la paleta de componentes del editor de diseño y arrástrala al lienzo. Configúralo seleccionando el campo de búsqueda que define la relación (por ejemplo, la búsqueda de Contacto en un Negocio) y luego elige qué campos del registro relacionado deseas mostrar. ^[1]

Paso 5. Guarda el diseño. Los miembros del equipo que vean ese registro ahora verán los campos reflejados actualizados en tiempo real, sin necesidad de navegar. ^[1]

---

Opción B: Usar la API de GraphQL (Desarrolladores, consultas de lectura intensiva)

Paso 1. Confirma que tu edición de CRM es compatible con GraphQL. La API de GraphQL no está disponible en versiones de prueba de ninguna edición de Zoho CRM — necesitas un plan de pago. ^[3]

Paso 2. Autentica tu cliente de API usando un token OAuth 2.0 válido para Zoho CRM. Una vez autenticado, puedes consultar tanto datos de registros como metadatos a través del tipo raíz Query, que expone dos campos de nivel superior: Records y Meta. ^[3]

Paso 3. Construye una consulta que obtenga campos de varios módulos relacionados en una sola solicitud. Por ejemplo, para recuperar nombres de cuentas junto con apellidos de prospectos en una sola llamada, estructura tu consulta de la siguiente manera: ^[3]

query {
  Records {
    Accounts {
      _data {
        Account_Name {
          value
        }
      }
    }
    Leads {
      _data {
        Last_Name {
          value
        }
      }
    }
  }
}

Paso 4. Usa el tipo Meta cuando necesites información estructural — como valores de api_name de roles o detalles de usuarios — en lugar de datos de registros. Tanto Meta como Records admiten filtrado y paginación para acotar conjuntos de resultados grandes. ^[3]

---

Opción C: Usar la función Queries (Desarrolladores, fuentes externas/base de datos)

Paso 1. Navega a Configuración → Espacio para Desarrolladores → Queries en Zoho CRM. Esta función te permite definir fuentes de datos y escribir consultas de estilo SQL contra ellas. ^[5]

Paso 2. Agrega una fuente. Los tipos de fuente compatibles incluyen:

• REST API — apunta a un endpoint externo con una URL base, parámetros predeterminados y encabezados. ^[5]
• Base de datos — conecta MySQL, Microsoft SQL o PostgreSQL proporcionando el host, puerto, nombre de la base de datos, credenciales y configuración SSL opcional. ^[5]
• Base de datos en la nube — conecta bases de datos de Amazon RDS, Google Cloud Platform o Microsoft Azure con campos de configuración similares. ^[5]

Paso 3. Si el host de tu fuente no está en formato de dirección IP, agrégalo a Dominios de Confianza en la configuración del CRM. Además, incluye en la lista blanca las direcciones IP de Zoho CRM en tu servidor de retransmisión para que el CRM pueda acceder a tu base de datos. ^[5]

Paso 4. Escribe y guarda tu consulta. Consulta la página de Límites dentro de la documentación de Queries para conocer los límites de fuentes de consultas SQL, las restricciones de consultas y las estructuras de ejemplo para diferentes operaciones. ^[5]

---

Errores comunes

• ¿El Componente Mirror no es visible? Verifica tu centro de datos. La función está actualmente limitada a los centros de datos JP, CA, SA, UAE y AU — las organizaciones en otros centros de datos aún no lo verán en el editor de diseño. ^[1]
• ¿GraphQL no devuelve nada en una cuenta de prueba? La API de GraphQL no está disponible explícitamente en ediciones de prueba. Actualiza a un plan de pago antes de intentar llamadas a la API. ^[3]
• ¿Las consultas de base de datos fallan? Las dos causas más comunes son una entrada de Dominios de Confianza faltante para tu host y las IPs de Zoho CRM no incluidas en la lista blanca de tu servidor de retransmisión. Resuelve ambas antes de probar la conectividad. ^[5]

---

Qué verificar

• Componente Mirror: Después de guardar el diseño, abre un registro activo y confirma que los campos reflejados muestran los valores actuales del registro relacionado, no datos desactualizados o en blanco. ^[1]
• GraphQL: Verifica que tu consulta devuelva los campos value esperados bajo _data para cada módulo, y que los parámetros de paginación funcionen correctamente si tu conjunto de datos es grande. ^[3]
• Queries / Fuentes de base de datos: Confirma que el estado de conexión de la fuente aparece como activo en la página de configuración de Queries, y ejecuta una consulta de prueba para validar la recuperación de filas antes de incorporarla en la automatización. ^[5]

---

*Beam Help es un recurso de soporte experto independiente para los productos de Zoho y no es el soporte oficial de Zoho. Para problemas a nivel de plataforma o preguntas de facturación, contacta directamente con Zoho a través del portal de tu cuenta.*