El motor de IA Zia de Zoho CRM puede mostrar registros que se asemejan estrechamente a un registro determinado — útil para detectar duplicados, encontrar prospectos relacionados o hacer referencias cruzadas de cuentas — todo mediante una única llamada a la API.
Por qué esto es importante
Cuando necesitas identificar de forma programática registros que comparten características similares a un registro conocido, analizar manualmente tu CRM resulta poco práctico a escala. El endpoint de registros similares de Zia te permite automatizar esta búsqueda dentro de cualquier módulo compatible, incorporando los resultados en flujos de trabajo posteriores, rutinas de deduplicación o motores de recomendación. Esto es especialmente valioso cuando se combina con las funciones de inteligencia más amplias de Zia, como la puntuación de abandono, donde comprender la similitud entre registros puede mejorar las predicciones. [3]
---
Paso a paso
Paso 1. Comprende la estructura del endpoint.
La operación que necesitas es una solicitud GET enviada a /{m}/{rid}/zia/similar_records, donde {m} es el nombre de la API del módulo (por ejemplo, Leads, Contacts o Deals) y {rid} es el ID único del registro para el que deseas encontrar similitudes. [1]
Paso 2. Identifica los dos parámetros obligatorios.
Antes de realizar la llamada, reúne lo siguiente:
m— el nombre de la API del módulo de Zoho CRM que contiene tu registro de origen.rid— el identificador único del registro específico cuyos registros similares deseas recuperar.
Ambos parámetros son obligatorios; la solicitud no se resolverá sin ellos. [1][2]
Paso 3. Construye y envía la solicitud.
Usando el cliente HTTP o SDK que prefieras, emite una solicitud GET a la ruta completamente resuelta. En Python, la llamada tiene este aspecto:
result = client.get_zia_similar_records(m="Leads", rid="4876876000000123456")Internamente esto se resuelve como GET /Leads/4876876000000123456/zia/similar_records contra la URL base de la API de Zoho CRM. [1][2]
Paso 4. Gestiona la respuesta.
El cuerpo de la respuesta contendrá los registros que Zia ha identificado como similares al que especificaste. Analiza el payload devuelto según tu caso de uso — por ejemplo, marcando posibles duplicados, pre-rellenando sugerencias de registros relacionados o incorporando puntuaciones de similitud en un panel de informes. [2]
Paso 5. Itera entre módulos según sea necesario.
Dado que el nombre del módulo es un parámetro de ruta en lugar de un valor fijo, puedes reutilizar el mismo patrón de llamada en cualquier módulo del CRM simplemente cambiando {m}. Esto facilita la creación de un bucle que compruebe la similitud en Contacts, Leads y Accounts en una sola ejecución del script. [1]
---
Errores comunes
- Nombre de API del módulo incorrecto. El parámetro
{m}debe coincidir exactamente con el nombre de la API del módulo, no con su etiqueta de visualización. Por ejemplo, usaContactsy nocontactniCONTACTS. Un valor incorrecto devolverá un error o un conjunto de resultados vacío. [1] - ID de registro no válido o inaccesible. Si
{rid}pertenece a un registro al que el usuario autenticado no puede acceder, o si el ID tiene un formato incorrecto, el endpoint no devolverá datos útiles. Valida siempre el ID del registro antes de construir la solicitud. [1] - Funciones de Zia no habilitadas. Las capacidades de inteligencia de Zia, incluida la detección de similitudes, deben estar activas en tu organización. Si Zia no ha sido configurada o no está disponible en tu plan, el endpoint puede no devolver resultados incluso para entradas válidas. [3]
---
Qué verificar
- Confirma el nombre de la API del módulo navegando a la configuración de tu Zoho CRM y verificando la cadena exacta utilizada en la API — los nombres de visualización y los nombres de la API pueden diferir.
- Verifica el formato del ID de registro cruzando el valor de
ridcon un registro conocido recuperado a través de la API de registros estándar antes de llamar al endpoint de Zia. - Confirma que Zia está activa en la configuración de tu organización, ya que la función de registros similares depende de que el motor analítico de Zia esté habilitado y entrenado con tus datos. [3]
---
*Beam Help es un recurso de soporte experto independiente para los productos de Zoho y no es el soporte oficial de Zoho. Para preguntas sobre derechos a nivel de plataforma, contacta directamente con Zoho.*