Comment obtenir les détails de liaison d'enregistrements dans Zoho CRM

La liaison d'enregistrements dans Zoho CRM vous permet de faire remonter des données connectées entre modules et applications externes — ce guide explique comment récupérer et exploiter ces détails de liaison à l'aide des fonctionnalités natives et des modèles d'URL au niveau de l'API.

Pourquoi c'est important

Lorsque vos enregistrements CRM sont associés à des contacts, des opportunités, des comptes, ou même à des systèmes externes comme Zoho Desk ou Zoho FSM, comprendre *comment* ces liens sont structurés vous aide à naviguer rapidement, à créer des automatisations et à éviter les références croisées entre modules défaillantes. Les équipes qui gèrent les services sur le terrain, les tickets de support ou des pipelines de vente complexes bénéficient particulièrement d'une compréhension précise de l'emplacement des données d'enregistrements liés et de la façon d'y accéder de manière programmatique ou via l'interface. En tant que support expert indépendant pour Zoho (et non le support officiel de Zoho), Beam Help constate que cette question revient fréquemment lorsque des clients créent des intégrations ou personnalisent des pages de détail d'enregistrement.

---

Étape par étape

Étape 1. Comprenez le modèle d'URL standard des enregistrements CRM avant de commencer à récupérer les détails de liaison. Chaque enregistrement Zoho CRM suit le format https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId} — où dc est votre centre de données (par ex., com, eu, in) et Module est le nom API du module (par ex., Contacts, Deals). Si votre organisation possède un identifiant d'organisation spécifique, l'URL peut également prendre la forme /crm/org{OrgId}/tab/{Module}/{RecordId}. Connaître ce modèle vous permet de construire ou de vérifier des liens directs vers n'importe quel enregistrement lié. ^[2]

Étape 2. Lors de la récupération de données d'enregistrement via l'API Zoho CRM, vérifiez dans la réponse les champs $se_module ou module de chaque objet d'enregistrement associé — ceux-ci indiquent à quel module appartient l'enregistrement lié. L'identifiant unique de l'enregistrement se trouve dans le champ id, ou dans un objet imbriqué details sous details.id si le id de niveau supérieur est absent. ^[4]

Étape 3. Pour identifier le nom d'affichage d'un enregistrement lié (utile pour étiqueter les liens dans des tableaux de bord ou des automatisations), recherchez ces champs par ordre de priorité dans l'enregistrement ou son sous-objet details : FullName, Name, Subject, DealName ou Account_Name. Si aucun de ces champs n'est renseigné, utilisez par défaut un libellé du type Record {RecordId}. ^[4]

Étape 4. Si vous travaillez avec des enregistrements également liés à Zoho Desk, les détails de liaison sont stockés dans une section dédiée. Sur l'enregistrement associé dans Zoho FSM (ou les modules adjacents à CRM), recherchez la section Zoho Desk Info dans le panneau de gauche — celle-ci affiche le lien direct vers le ticket Desk, le compte ou le contact d'origine. ^[1][6]

Étape 5. Pour afficher ou gérer les liens d'enregistrements entre systèmes depuis le côté Zoho Desk, ouvrez un enregistrement Ticket, Compte ou Contact dans Desk et accédez à l'onglet Zoho FSM. Vous pouvez y voir quels enregistrements FSM (Demandes, Devis, Ordres de travail, Rendez-vous de service, Actifs) sont liés, y accéder directement, ou utiliser l'icône lien pour associer un enregistrement existant. ^[1][7]

Étape 6. Pour une approche entièrement dans CRM permettant de consulter les données d'enregistrements associés sans quitter la page, utilisez le Mirror Component sur la page de détail d'un enregistrement. Cette fonctionnalité reflète les valeurs de champs en direct d'un enregistrement associé — par exemple, le numéro de téléphone ou l'adresse e-mail d'un contact affichés directement dans un enregistrement d'opportunité — afin que vous puissiez confirmer que la liaison est correcte et que les données sont à jour sans ouvrir séparément l'enregistrement lié. ^[3]

Étape 7. Si vous créez un connecteur ou une fonction devant invoquer des données d'enregistrements liés depuis un service tiers, configurez une Connection dans les paramètres développeur de Zoho CRM. Après avoir cliqué sur Create and Connect, la page résultante affiche le nom du lien (Link name), le nom du service (Service name) et le statut (Status), ainsi qu'un extrait de code prêt à l'emploi pour invoquer la connexion dans une fonction Deluge. La valeur Connection dans cet extrait correspond au Link name que vous avez attribué. ^[5]

---

Erreurs courantes

• Identifiant de module manquant : Si le champ $se_module est vide dans une réponse API, le système ne peut pas construire une URL d'enregistrement CRM valide. Vérifiez toujours que le nom API du module est présent avant de tenter de créer un lien direct. ^[4]
• Erreurs de liaison entre systèmes : Lors de la liaison d'un Contact Zoho Desk à un enregistrement Zoho FSM, le Contact doit déjà être associé à la bonne Entreprise FSM correspondant au Compte Desk. Omettre cette étape d'association déclenche une erreur et bloque la création de l'enregistrement. ^[1][6]
• L'ordre de dissociation est important : Si vous devez dissocier un Compte Desk de Zoho FSM, vous devez d'abord dissocier tous les Contacts associés à ce Compte. Tenter de dissocier le Compte alors que des Contacts y sont encore rattachés échouera — vérifiez d'abord l'onglet Contacts de l'enregistrement. ^[7]
• Disponibilité du Mirror Component : Selon les dernières annonces, le Mirror Component est disponible pour les centres de données JP, CA, SA, UAE et AU. Si votre organisation utilise un autre centre de données, cette méthode d'interface pour consulter les détails de liaison peut ne pas encore être accessible. ^[3]

---

Ce qu'il faut vérifier

• Confirmez que le nom API du Module et le RecordId dans votre URL construite correspondent à un enregistrement réel dans votre organisation CRM — accédez directement à https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId} pour valider. ^[2][4]
• Après avoir lié des enregistrements entre systèmes (par ex., Desk ↔ FSM), vérifiez que la section Zoho Desk Info apparaît dans le panneau de gauche de l'enregistrement FSM pour confirmer que le lien a bien été enregistré. ^[6]
• Lors de l'utilisation du Mirror Component, ouvrez l'opportunité ou l'enregistrement parent et confirmez que les champs reflétés (tels que l'e-mail ou le téléphone du contact) affichent des valeurs actuelles, indiquant que la relation de recherche est intacte. ^[3]