La vinculación de registros en Zoho CRM te permite acceder a datos conectados entre módulos y aplicaciones externas — esta guía explica cómo recuperar y trabajar con esos detalles de vinculación usando funciones nativas y patrones de URL a nivel de API.
Por qué esto es importante
Cuando tus registros de CRM están relacionados con contactos, negocios, cuentas o incluso sistemas externos como Zoho Desk o Zoho FSM, saber *cómo* están estructurados esos vínculos te ayuda a navegar rápidamente, crear automatizaciones y evitar referencias rotas entre módulos. Los equipos que gestionan servicio de campo, tickets de soporte o pipelines de ventas complejos se benefician especialmente de entender exactamente dónde viven los datos de registros vinculados y cómo acceder a ellos de forma programática o a través de la interfaz. Como soporte experto independiente para Zoho (no soporte oficial de Zoho), Beam Help ve esta pregunta con frecuencia cuando los clientes están creando integraciones o personalizando páginas de detalle de registros.
---
Paso a paso
Paso 1. Comprende el patrón estándar de URL de registros de CRM antes de empezar a extraer detalles de vinculación. Cada registro de Zoho CRM sigue el formato https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId} — donde dc es tu centro de datos (p. ej., com, eu, in) y Module es el nombre de API del módulo (p. ej., Contacts, Deals). Si tu organización tiene un ID de org específico, la URL también puede tomar la forma /crm/org{OrgId}/tab/{Module}/{RecordId}. Conocer este patrón te permite construir o verificar enlaces directos a cualquier registro vinculado. [2]
Paso 2. Al recuperar datos de registros a través de la API de Zoho CRM, revisa el payload de respuesta en busca de los campos $se_module o module en cada objeto de registro relacionado — estos te indican a qué módulo pertenece el registro vinculado. El identificador único del registro se encuentra en el campo id, o dentro de un objeto anidado details bajo details.id si el id de nivel superior está ausente. [4]
Paso 3. Para identificar el nombre de visualización de un registro vinculado (útil para etiquetar vínculos en dashboards o automatizaciones), busca estos campos en orden de prioridad dentro del registro o su sub-objeto details: FullName, Name, Subject, DealName o Account_Name. Si ninguno de ellos está poblado, recurre a construir una etiqueta como Record {RecordId}. [4]
Paso 4. Si trabajas con registros que también están vinculados a Zoho Desk, los detalles de vinculación se almacenan en una sección dedicada. En el registro asociado dentro de Zoho FSM (o módulos adyacentes a CRM), busca la sección Zoho Desk Info en el panel izquierdo — esta muestra el enlace directo de vuelta al ticket, cuenta o contacto de Desk de origen. [1][6]
Paso 5. Para ver o gestionar vínculos de registros entre sistemas desde el lado de Zoho Desk, abre un registro de Ticket, Cuenta o Contacto en Desk y navega a la pestaña Zoho FSM. Desde allí puedes ver qué registros de FSM (Solicitudes, Presupuestos, Órdenes de trabajo, Citas de servicio, Activos) están vinculados, acceder a ellos o usar el icono de vínculo para adjuntar un registro existente. [1][7]
Paso 6. Para un enfoque puramente dentro de CRM que permita ver datos de registros relacionados sin salir de la página, usa el Mirror Component en la página de detalle de un registro. Esta función refleja valores de campo en tiempo real desde un registro relacionado — por ejemplo, el número de teléfono o correo electrónico de un contacto mostrado directamente dentro de un registro de negocio — para que puedas confirmar que la vinculación es correcta y los datos están actualizados sin abrir el registro vinculado por separado. [3]
Paso 7. Si estás creando un conector o función que necesita invocar datos de registros vinculados desde un servicio de terceros, configura una Connection en los ajustes de desarrollador de Zoho CRM. Después de hacer clic en Create and Connect, la página resultante muestra el nombre del enlace (Link name), el nombre del servicio (Service name) y el estado (Status), junto con un fragmento de código listo para usar para invocar la conexión dentro de una función de Deluge. El valor Connection en ese fragmento corresponde al Link name que asignaste. [5]
---
Errores comunes
- Identificador de módulo ausente: Si el campo
$se_moduleestá vacío en una respuesta de API, el sistema no puede construir una URL de registro de CRM válida. Verifica siempre que el nombre de API del módulo esté presente antes de intentar construir un enlace directo. [4] - Errores de vinculación entre sistemas: Al vincular un Contacto de Zoho Desk a un registro de Zoho FSM, el Contacto ya debe estar asociado con la Empresa de FSM correcta que corresponde a la Cuenta de Desk. Omitir este paso de asociación genera un error y bloquea la creación del registro. [1][6]
- El orden de desvinculación importa: Si necesitas desvincular una Cuenta de Desk de Zoho FSM, primero debes desvincular todos los Contactos asociados con esa Cuenta. Intentar desvincular la Cuenta mientras los Contactos siguen adjuntos fallará — revisa primero la pestaña Contacts del registro. [7]
- Disponibilidad del Mirror Component: Según los últimos anuncios, el Mirror Component está disponible para los centros de datos JP, CA, SA, UAE y AU. Si tu organización está en un DC diferente, es posible que este método de interfaz para ver detalles de vinculación aún no esté disponible. [3]
---
Qué verificar
- Confirma que el nombre de API del
Moduley elRecordIden tu URL construida correspondan a un registro real en tu organización de CRM — navega directamente ahttps://crm.zoho.{dc}/crm/tab/{Module}/{RecordId}para validarlo. [2][4] - Después de vincular registros entre sistemas (p. ej., Desk ↔ FSM), verifica que la sección Zoho Desk Info aparezca en el panel izquierdo del registro de FSM para confirmar que el vínculo se guardó correctamente. [6]
- Al usar el Mirror Component, abre el negocio o registro principal y confirma que los campos reflejados (como el correo electrónico o teléfono del contacto) muestran valores actuales, lo que indica que la relación de búsqueda está intacta. [3]