Le moteur d'IA Zia de Zoho CRM peut faire remonter des enregistrements qui ressemblent étroitement à un enregistrement donné — utile pour repérer les doublons, trouver des prospects connexes ou effectuer des recoupements entre comptes — le tout via un seul appel API.
Pourquoi c'est important
Lorsque vous devez identifier par programmation des enregistrements partageant des caractéristiques similaires à un enregistrement connu, parcourir manuellement votre CRM est impraticable à grande échelle. Le point de terminaison des enregistrements similaires de Zia vous permet d'automatiser cette recherche au sein de n'importe quel module pris en charge, en injectant les résultats dans des workflows en aval, des routines de déduplication ou des moteurs de recommandation. Cela est particulièrement utile combiné aux fonctionnalités d'intelligence plus larges de Zia, telles que le scoring d'attrition, où la compréhension de la similarité entre enregistrements peut affiner les prédictions. [3]
---
Étape par étape
Étape 1. Comprendre la structure du point de terminaison.
L'opération dont vous avez besoin est une requête GET envoyée à /{m}/{rid}/zia/similar_records, où {m} est le nom API du module (par exemple, Leads, Contacts ou Deals) et {rid} est l'identifiant unique de l'enregistrement pour lequel vous souhaitez trouver des similarités. [1]
Étape 2. Identifier vos deux paramètres obligatoires.
Avant d'effectuer l'appel, rassemblez les éléments suivants :
m— le nom API du module Zoho CRM contenant votre enregistrement source.rid— l'identifiant unique de l'enregistrement spécifique dont vous souhaitez récupérer les enregistrements similaires.
Les deux paramètres sont obligatoires ; la requête ne pourra pas aboutir sans eux. [1][2]
Étape 3. Construire et envoyer la requête.
En utilisant le client HTTP ou le SDK de votre choix, émettez une requête GET vers le chemin entièrement résolu. En Python, l'appel ressemble à ceci :
result = client.get_zia_similar_records(m="Leads", rid="4876876000000123456")En interne, cela se résout en GET /Leads/4876876000000123456/zia/similar_records contre l'URL de base de l'API Zoho CRM. [1][2]
Étape 4. Traiter la réponse.
Le corps de la réponse contiendra les enregistrements que Zia a identifiés comme similaires à celui que vous avez spécifié. Analysez le contenu retourné selon votre cas d'usage — par exemple, signaler des doublons potentiels, pré-remplir des suggestions d'enregistrements connexes, ou injecter des scores de similarité dans un tableau de bord de reporting. [2]
Étape 5. Itérer sur les modules selon les besoins.
Étant donné que le nom du module est un paramètre de chemin plutôt qu'une valeur fixe, vous pouvez réutiliser le même schéma d'appel sur n'importe quel module CRM en remplaçant {m}. Cela facilite la création d'une boucle qui vérifie la similarité sur les Contacts, les Leads et les Comptes en une seule exécution de script. [1]
---
Erreurs courantes
- Nom API du module incorrect. Le paramètre
{m}doit correspondre exactement au nom API du module, et non à son libellé d'affichage. Par exemple, utilisezContactset noncontactouCONTACTS. Une valeur incorrecte retournera une erreur ou un ensemble de résultats vide. [1] - Identifiant d'enregistrement invalide ou inaccessible. Si
{rid}appartient à un enregistrement auquel l'utilisateur authentifié ne peut pas accéder, ou si l'identifiant est mal formé, le point de terminaison ne retournera pas de données utiles. Validez toujours l'identifiant de l'enregistrement avant de construire la requête. [1] - Fonctionnalités Zia non activées. Les capacités d'intelligence de Zia, y compris la détection de similarité, doivent être actives pour votre organisation. Si Zia n'a pas été configuré ou n'est pas disponible dans votre offre, le point de terminaison peut ne retourner aucun résultat même pour des entrées valides. [3]
---
Ce qu'il faut vérifier
- Confirmez le nom API du module en accédant à la configuration de votre Zoho CRM et en vérifiant la chaîne exacte utilisée dans l'API — les noms d'affichage et les noms API peuvent différer.
- Vérifiez le format de l'identifiant d'enregistrement en recoupant la valeur
ridavec un enregistrement connu récupéré via l'API d'enregistrements standard avant d'appeler le point de terminaison Zia. - Confirmez que Zia est actif dans les paramètres de votre organisation, car la fonctionnalité d'enregistrements similaires dépend du moteur analytique de Zia, qui doit être activé et entraîné sur vos données. [3]
---
*Beam Help est une ressource d'assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Pour toute question relative aux droits au niveau de la plateforme, contactez Zoho directement.*