El Componente Mirror de Zoho CRM te permite mostrar campos de un registro relacionado directamente en la página que estás viendo, sin necesidad de cambiar de pestaña. Combinado con la API de GraphQL, dispones tanto de una vía basada en la interfaz como de una vía orientada al desarrollador para recuperar los datos de un único registro relacionado.
Por qué esto importa
En Zoho CRM, los registros rara vez existen de forma aislada. Un negocio se vincula a un contacto; un caso se asocia a una cuenta. Históricamente, consultar el número de teléfono o el correo electrónico de un contacto vinculado mientras se trabaja dentro de un negocio implicaba salir de la vista, buscar el contacto y volver, interrumpiendo el flujo de trabajo. [1] Tanto si eres un representante de ventas que necesita contexto inmediato como si eres un desarrollador que consulta datos relacionados de forma programática, conocer el método de recuperación adecuado ahorra tiempo real.
---
Paso a paso
Opción A — Componente Mirror (interfaz, sin código)
Paso 1. Comprende qué hace el Componente Mirror. Actúa como una ventana en vivo integrada en la página de detalle de un registro, reflejando en tiempo real los campos de un registro relacionado. Por ejemplo, un representante de ventas que trabaja dentro de un negocio puede ver el número de teléfono o la dirección de correo electrónico actuales del contacto vinculado sin abandonar ese registro. [1]
Paso 2. Confirma que tu centro de datos es compatible. En el momento de redactar este artículo, el Componente Mirror está disponible para los centros de datos JP, CA, SA, UAE y AU. Si tu organización se encuentra en un DC diferente, consulta la página de notas de versión de Zoho CRM para conocer el estado de despliegue más reciente antes de continuar. [1]
Paso 3. Navega al registro donde deseas que aparezcan los datos relacionados; por ejemplo, abre un registro de Negocio. El Componente Mirror se añade a nivel de la página de detalle del registro, por lo que debes estar en la vista de registro del módulo correcto. [1]
Paso 4. Accede a la configuración de diseño de página o de personalización de componentes de ese módulo. Añade el Componente Mirror al diseño y configura el módulo relacionado (p. ej., Contactos) y los campos específicos (p. ej., teléfono, correo electrónico) que deseas reflejar. Una vez guardado, esos campos mostrarán datos en vivo extraídos del registro vinculado cada vez que se cargue la página. [1]
Paso 5. Verifica que el componente funciona abriendo un registro que tenga una relación de búsqueda completada. Los campos reflejados deben mostrar los valores actuales del registro relacionado sin ninguna actualización manual. [1]
---
Opción B — API de GraphQL (vía para desarrolladores)
Paso 1. Confirma la elegibilidad. La API de GraphQL de Zoho CRM no está disponible en las ediciones de prueba de ningún plan de CRM, así que asegúrate de que tu organización está en un nivel de pago antes de desarrollar sobre ella. [7]
Paso 2. Comprende la estructura de la consulta. La API de GraphQL expone dos tipos raíz: Meta (para metadatos de módulos, usuarios y roles) y Records (para datos reales de módulos). Utilizarás el tipo Records para obtener campos de un módulo relacionado. [7]
Paso 3. Escribe una consulta que apunte al módulo específico que contiene tu registro relacionado. Por ejemplo, para recuperar el AccountName del módulo Accounts junto con un LastName de Leads en una sola llamada, estructura tu consulta bajo la raíz Records y especifica solo los campos que necesitas dentro de _data. [7]
query {
Records {
Accounts {
_data {
Account_Name {
value
}
}
}
}
}Paso 4. Filtra la consulta a un único registro pasando el ID de registro relevante como parámetro de filtro dentro de la consulta. La API de GraphQL admite filtrado y paginación en todos los módulos accesibles, por lo que puedes limitar la respuesta a exactamente un registro relacionado en lugar de obtener una lista completa. [7]
Paso 5. Analiza el campo value del objeto de respuesta. Cada campo en el array _data devuelve una clave value que contiene los datos reales, lo que facilita su extracción y visualización en tu aplicación o función de Zoho. [7]
---
Errores comunes
- Disponibilidad del Componente Mirror por DC. Si tu centro de datos aún no está en la lista de compatibles (JP, CA, SA, UAE, AU), la opción del componente no aparecerá en el editor de diseño. Consulta el hilo de lanzamiento de la comunidad para conocer los anuncios de expansión en lugar de asumir que es un error de configuración. [1]
- GraphQL en cuentas de prueba. Intentar llamar al endpoint de GraphQL en una organización de prueba fallará. Usa la API REST como alternativa o actualiza la cuenta primero. [7]
- Campo de búsqueda requerido para el Componente Mirror. El Componente Mirror depende de una relación de búsqueda existente entre módulos. Si ningún campo de búsqueda conecta los dos módulos, no hay nada que el componente pueda reflejar: debes establecer la relación primero. [1]
- Datos en tiempo real frente a datos en caché. El Componente Mirror refleja los datos en tiempo real, lo que significa que los valores desactualizados que puedas ver probablemente se deban a la caché del navegador y no a un problema de sincronización del CRM. Una actualización forzada suele resolverlo. [1]
---
Qué verificar
- DC elegible confirmado — verifica que tu centro de datos de CRM está en la lista de compatibles antes de invertir tiempo en configurar el diseño del Componente Mirror. [1]
- Relación de búsqueda existente — asegúrate de que ya existe un campo de búsqueda que vincula los dos módulos implicados; sin él, ni el Componente Mirror ni una consulta GraphQL filtrada devolverán el registro relacionado. [1]
- Verificación de edición para GraphQL — si usas la vía de la API, confirma que la organización está en una edición de CRM de pago para que el endpoint de GraphQL sea accesible. [7]
---
*Beam Help es un recurso de soporte experto independiente para los productos de Zoho y no es el soporte oficial de Zoho. Consulta siempre la documentación más reciente de Zoho CRM para tu edición y centro de datos específicos.*