Recuperar secciones de registros en Zoho CRM se puede lograr a través de la interfaz de usuario mediante el Componente Mirror para datos de registros relacionados en tiempo real, o de forma programática a través de la API GraphQL para consultar campos específicos en distintos módulos. Esta guía cubre ambos enfoques para que puedas elegir el método adecuado según tu caso de uso.
---
*Beam Help es soporte experto independiente para Zoho — no es el soporte oficial de Zoho.*
---
Por qué esto es importante
Al trabajar en Zoho CRM, los registros rara vez existen de forma aislada — un negocio se vincula a un contacto, un caso se relaciona con un cliente, y cada registro relacionado contiene contexto crítico. [1] Sin una forma estructurada de acceder a esos datos, los equipos pierden tiempo navegando entre módulos para encontrar el número de teléfono más reciente, la dirección de correo electrónico o el estado de la cuenta. [1] Ya sea que necesites una solución visual sin código o una consulta de API a nivel de desarrollador, saber cómo recuperar secciones de registros de manera eficiente mantiene a tu equipo enfocado y tus datos precisos.
---
Paso a paso
Opción A — Usar el Componente Mirror (interfaz de usuario, sin código)
Paso 1. Comprende qué hace el Componente Mirror. Actúa como una ventana en tiempo real hacia un registro relacionado, mostrando campos de ese registro vinculado directamente en la página de detalles del registro que estás viendo en ese momento — sin necesidad de cambiar de módulo. [1]
Paso 2. Confirma la elegibilidad de tu Centro de Datos. Según el último anuncio, el Componente Mirror está disponible para los centros de datos JP, CA, SA, UAE y AU. [1] Si tu organización está en un DC diferente, consulta las notas de versión de Zoho CRM para conocer las actualizaciones de disponibilidad. [7]
Paso 3. Navega a la página de detalles del registro donde deseas mostrar los datos relacionados — por ejemplo, un registro de Negocios vinculado a un Contacto. [1]
Paso 4. Abre el editor de diseño de página para ese módulo (a través de Configuración → Módulos y Campos → [Módulo] → Diseños) y agrega el Componente Mirror al diseño. Configúralo para que apunte al módulo relacionado (p. ej., Contactos) y selecciona los campos específicos que deseas reflejar, como el número de teléfono o la dirección de correo electrónico. [1]
Paso 5. Guarda el diseño y regresa a un registro activo. Los campos reflejados mostrarán ahora valores en tiempo real extraídos directamente del registro vinculado, de modo que tu equipo siempre vea los datos más actuales sin salir de la página. [1]
---
Opción B — Usar la API GraphQL (recuperación para desarrolladores/programática)
Paso 1. Verifica el acceso a la API. Las APIs GraphQL de Zoho CRM no están disponibles en las ediciones de prueba de ningún plan de CRM, así que asegúrate de que tu organización esté en una edición de pago antes de continuar. [2]
Paso 2. Comprende los dos tipos de consulta raíz disponibles. El tipo Meta te permite recuperar metadatos de fuentes como Módulos, Usuarios, Roles, Perfiles y Widgets. El tipo Records te permite recuperar datos de campos reales de cualquier módulo al que tu perfil tenga acceso, con filtrado y paginación compatibles en todos los módulos. [2]
Paso 3. Construye tu consulta GraphQL. Para recuperar secciones de registros (campos) de varios módulos en una sola solicitud, anida los módulos deseados bajo Records y especifica los nombres de los campos dentro de data. Por ejemplo, para obtener AccountName de Cuentas y Last_Name de Prospectos simultáneamente, tu consulta se vería así: [2]
query {
Records {
Accounts {
_data {
Account_Name {
value
}
}
}
Leads {
_data {
Last_Name {
value
}
}
}
}
}Paso 4. Envía la consulta al endpoint GraphQL de Zoho CRM usando tu cliente HTTP preferido o el SDK de JavaScript. El SDK proporciona código de ejemplo para obtener registros de módulos como Prospectos, y es compatible con múltiples versiones de API (V6, V7, V8). [3]
Paso 5. Analiza la respuesta. Los registros de cada módulo se devuelven bajo sus respectivos arrays _data, con cada campo exponiendo una propiedad value. [2] Mapea estos valores al modelo de datos de tu aplicación según sea necesario.
---
Errores comunes
- Bloqueo en edición de prueba: Intentar usar la API GraphQL en una cuenta de prueba fallará por completo — la API no está disponible explícitamente en versiones de prueba. [2] Actualiza primero a una edición de pago.
- Restricción de DC del Componente Mirror: Si el centro de datos de tu organización no está entre JP, CA, SA, UAE o AU, es posible que el Componente Mirror aún no esté disponible. [1] Consulta la página de notas de versión para conocer el estado de implementación en tu DC. [7]
- Campos de búsqueda vs. Componente Mirror: Los campos de búsqueda estándar establecen relaciones entre módulos, pero no pueden mostrar todos los datos de campos contextuales dentro del registro principal. [1] No confundas un campo de búsqueda con el Componente Mirror — sirven para propósitos diferentes.
- Brechas de visibilidad en móvil: Los campos de lista relacionada y los componentes configurados en el diseño web pueden no aparecer automáticamente en la aplicación móvil de CRM. [4] Prueba tu diseño en móvil después de realizar cambios.
---
Qué verificar
- Componente Mirror: Después de guardar el diseño, abre un registro activo y confirma que los campos reflejados muestran valores actuales del registro vinculado — no datos desactualizados o vacíos. [1]
- Consulta GraphQL: Verifica que los nombres de API de los campos utilizados en tu consulta (p. ej.,
AccountName,LastName) coincidan exactamente con los nombres de API definidos en la configuración de tu módulo de CRM, ya que las discrepancias devolverán valores nulos. [2] - Edición y DC: Confirma que tanto tu edición de CRM (de pago, no de prueba) como tu centro de datos sean compatibles con el método de recuperación que hayas elegido. [1][2]