Cómo obtener listas relacionadas en Zoho CRM

Recuperar listas relacionadas en Zoho CRM te permite mostrar registros vinculados — como contactos, negocios u órdenes de trabajo — directamente desde la página de detalle de un registro principal, y también de forma programática a través de la API REST.

Por qué esto es importante

Cuando tu equipo gestiona relaciones complejas entre módulos (por ejemplo, Socios → Órdenes de trabajo → Clientes), poder ver y manipular listas relacionadas es esencial para evitar silos de datos y la doble entrada. ^[1] Ya sea que estés construyendo un portal de clientes, automatizando flujos de trabajo o simplemente navegando por registros en el día a día, entender cómo funcionan las listas relacionadas en Zoho CRM ahorra un tiempo considerable. La función Mirror Component y las listas relacionadas de búsqueda de selección múltiple son dos de las herramientas más potentes — y a veces más incomprendidas — en este ámbito. [^1,3]

---

Paso a paso

Paso 1. Comprende los dos enfoques principales.

Zoho CRM te ofrece dos formas generales de trabajar con listas relacionadas: a través de la interfaz de usuario (en la página de detalle de un registro) y a través de la API REST (de forma programática). El camino que elijas depende de si necesitas visibilidad en tiempo real para los usuarios o operaciones de datos automatizadas para integraciones. ^[1]

Paso 2. Usa el Mirror Component para datos relacionados en tiempo real en la interfaz.

El Mirror Component es una función en la página de detalle de un registro que presenta datos relacionados relevantes sin que el usuario tenga que navegar a otra página. Una vez habilitado, mantiene todo lo que el usuario necesita en una sola vista. [^1,3] Para habilitarlo:

• Navega al módulo donde deseas agregar el Mirror Component.
• Abre Configuración → Personalización → Módulos y campos y selecciona el módulo correspondiente.
• En el editor de diseño, busca la opción Mirror Component y agrégala al diseño de la página de detalle.
• Configura qué datos del módulo relacionado deben reflejarse — por ejemplo, mostrar los detalles de una Orden de trabajo en un registro de Socio. ^[1]

> Nota (al momento de redactar este artículo): El Mirror Component está disponible en varios centros de datos, incluidos JP, CA, SA, UAE y AU. [^1,3]

Paso 3. Configura los campos de búsqueda para definir la relación.

Antes de que aparezca una lista relacionada, los módulos deben estar vinculados mediante un campo de búsqueda (Lookup) o un campo de búsqueda de selección múltiple (Multi-select Lookup). Por ejemplo, para vincular Socios → Órdenes de trabajo → Clientes, deberías crear campos de búsqueda en el módulo Órdenes de trabajo que apunten tanto al módulo Socios como al módulo Clientes. ^[1] Para hacerlo:

• Ve a Configuración → Personalización → Módulos y campos.
• Selecciona el módulo secundario (p. ej., Órdenes de trabajo).
• Agrega un campo Lookup y apúntalo al módulo principal (p. ej., Socios).
• Guarda y despliega el diseño. La lista relacionada aparecerá automáticamente en la página de detalle del registro principal. ^[1]

Paso 4. Recupera registros de listas relacionadas a través de la API REST.

Si necesitas obtener datos de listas relacionadas de forma programática, la API REST de Zoho CRM lo permite. Para una relación de búsqueda estándar, puedes usar el endpoint Get Related Records, estructurado en torno al módulo y al ID del registro principal. El patrón de URL del CRM para un registro sigue el formato https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId}, que refleja cómo la API organiza las referencias de módulos y registros. ^[2]

Para las listas relacionadas de Multi-select Lookup específicamente, existen dos métodos compatibles a través de la API: [^1,3]

1. Insert Records API — crea y asocia registros en una sola llamada.
2. Módulo de vinculación (Linking Module) — usa el módulo de vinculación intermediario que Zoho CRM genera automáticamente para las búsquedas de selección múltiple, con el fin de asociar registros existentes.

Elige el enfoque del módulo de vinculación cuando necesites asociar registros que ya existen en ambos módulos sin tener que recrearlos. [^1,3]

Paso 5. Verifica la configuración del centro de datos para las llamadas a la API.

Al construir solicitudes a la API o enlaces directos a registros del CRM, asegúrate de que la URL base refleje el centro de datos correcto. Para el DC .com, la base es https://crm.zoho.com; para los demás, sigue el patrón https://crm.zoho.{dc}. ^[2] Los centros de datos incorrectos son una causa frecuente de fallos en las llamadas a la API.

---

Errores comunes

• Campo de búsqueda ausente: Una lista relacionada no aparecerá en la página de detalle de un registro a menos que se haya configurado correctamente un campo de búsqueda entre los dos módulos. Verifica que el campo esté agregado al diseño activo. ^[1]
• Confusión con la búsqueda de selección múltiple: Muchos usuarios intentan asociar registros de búsqueda de selección múltiple usando únicamente la Insert Records API, pero el método del módulo de vinculación suele ser necesario para asociar registros preexistentes. Ambos métodos son válidos, pero sirven para casos de uso diferentes. [^1,3]
• Centro de datos incorrecto en las URLs de la API: Si tu organización está en un centro de datos distinto a .com (p. ej., AU, EU, IN), codificar crm.zoho.com de forma fija en las llamadas a la API o en los enlaces del portal causará fallos. Parametriza siempre el DC. ^[2]
• Disponibilidad del Mirror Component: Si no encuentras el Mirror Component en tu editor de diseño, confirma que el centro de datos de tu organización esté entre los compatibles antes de abrir un ticket de soporte. [^1,3]

---

Qué verificar

• El campo de búsqueda está presente y desplegado en el diseño del módulo secundario, y la lista relacionada resultante es visible en la página de detalle del registro principal.
• El endpoint de la API y el centro de datos coinciden con la región del CRM de tu organización (compruébalo en Configuración → Detalles de la empresa si no estás seguro). ^[2]
• El módulo de vinculación de búsqueda de selección múltiple existe en tu lista de módulos si estás usando la API para asociar registros en una relación MxN. [^1,3]

---

*Beam Help es un recurso de soporte experto independiente para productos Zoho — no somos el soporte oficial de Zoho. Para problemas de facturación o a nivel de cuenta, contacta directamente con Zoho.*