Comment obtenir les listes associées dans Zoho CRM

Récupérer les listes associées dans Zoho CRM vous permet d'afficher les enregistrements liés — tels que les contacts, les opportunités ou les bons de travail — directement depuis la page de détail d'un enregistrement parent, ainsi que de manière programmatique via l'API REST.

Pourquoi c'est important

Lorsque votre équipe gère des relations complexes entre modules (par exemple, Partenaires → Bons de travail → Clients), la capacité à visualiser et à manipuler les listes associées est essentielle pour éviter les silos de données et les doubles saisies. ^[1] Que vous construisiez un portail client, automatisiez des workflows ou naviguiez simplement entre les enregistrements au quotidien, comprendre le fonctionnement des listes associées dans Zoho CRM vous fait gagner un temps considérable. La fonctionnalité Mirror Component et les listes associées de type multi-select lookup sont deux des outils les plus puissants — et parfois les moins bien compris — dans ce domaine. [^1,3]

---

Étape par étape

Étape 1. Comprendre les deux approches principales.

Zoho CRM vous offre deux grandes façons de travailler avec les listes associées : via l'interface utilisateur (sur la page de détail d'un enregistrement) et via l'API REST (de manière programmatique). Le chemin que vous choisissez dépend de si vous avez besoin d'une visibilité en temps réel pour les utilisateurs ou d'opérations de données automatisées pour les intégrations. ^[1]

Étape 2. Utiliser le Mirror Component pour les données associées en temps réel dans l'interface.

Le Mirror Component est une fonctionnalité de la page de détail d'un enregistrement qui présente les données associées pertinentes sans que l'utilisateur ait besoin de naviguer ailleurs. Une fois activé, il regroupe tout ce dont un utilisateur a besoin dans une vue unique. [^1,3] Pour l'activer :

• Accédez au module dans lequel vous souhaitez ajouter le Mirror Component.
• Ouvrez Configuration → Personnalisation → Modules et champs, puis sélectionnez le module concerné.
• Dans l'éditeur de mise en page, recherchez l'option Mirror Component et ajoutez-la à la mise en page de la page de détail.
• Configurez les données du module associé à refléter — par exemple, afficher les détails des Bons de travail sur un enregistrement Partenaire. ^[1]

> Remarque (au moment de la rédaction) : Le Mirror Component est disponible dans plusieurs centres de données, notamment JP, CA, SA, UAE et AU. [^1,3]

Étape 3. Configurer les champs de liaison pour définir la relation.

Avant qu'une liste associée n'apparaisse, les modules doivent être liés via un champ Lookup ou un champ Multi-select Lookup. Par exemple, pour lier Partenaires → Bons de travail → Clients, vous devrez créer des champs de liaison sur le module Bons de travail pointant vers les modules Partenaire et Client. ^[1] Pour ce faire :

• Accédez à Configuration → Personnalisation → Modules et champs.
• Sélectionnez le module enfant (par ex., Bons de travail).
• Ajoutez un champ Lookup et faites-le pointer vers le module parent (par ex., Partenaires).
• Enregistrez et déployez la mise en page. La liste associée apparaîtra alors automatiquement sur la page de détail de l'enregistrement parent. ^[1]

Étape 4. Récupérer les enregistrements des listes associées via l'API REST.

Si vous avez besoin d'extraire des données de listes associées de manière programmatique, l'API REST de Zoho CRM le permet. Pour une relation de type lookup standard, vous pouvez utiliser le point de terminaison Get Related Records, structuré autour du module et de l'identifiant de l'enregistrement parent. Le format d'URL CRM pour un enregistrement suit le modèle https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId}, ce qui reflète la façon dont l'API organise les références aux modules et aux enregistrements. ^[2]

Pour les listes associées de type Multi-select Lookup en particulier, deux méthodes sont prises en charge via l'API : [^1,3]

1. Insert Records API — créez et associez des enregistrements en un seul appel.
2. Module de liaison — utilisez le module de liaison intermédiaire que Zoho CRM génère automatiquement pour les multi-select lookups afin d'associer des enregistrements existants.

Privilégiez l'approche par module de liaison lorsque vous devez associer des enregistrements qui existent déjà dans les deux modules sans les recréer. [^1,3]

Étape 5. Vérifier la configuration du centre de données pour les appels API.

Lorsque vous construisez des requêtes API ou des liens directs vers des enregistrements CRM, assurez-vous que votre URL de base correspond au bon centre de données. Pour le centre de données .com, la base est https://crm.zoho.com ; pour les autres, elle suit le modèle https://crm.zoho.{dc}. ^[2] Une discordance de centre de données est une cause fréquente d'échec des appels API.

---

Erreurs courantes

• Champ de liaison manquant : Une liste associée n'apparaîtra pas sur la page de détail d'un enregistrement si un champ de liaison n'a pas été correctement configuré entre les deux modules. Vérifiez que le champ est bien ajouté à la mise en page active. ^[1]
• Confusion avec le multi-select lookup : De nombreux utilisateurs tentent d'associer des enregistrements multi-select lookup en utilisant uniquement l'Insert Records API, mais la méthode par module de liaison est souvent nécessaire pour associer des enregistrements préexistants. Les deux méthodes sont valides mais répondent à des cas d'usage différents. [^1,3]
• Mauvais centre de données dans les URLs API : Si votre organisation utilise un centre de données autre que .com (par ex., AU, EU, IN), coder en dur crm.zoho.com dans les appels API ou les liens du portail provoquera des erreurs. Paramétrisez toujours le centre de données. ^[2]
• Disponibilité du Mirror Component : Si vous ne trouvez pas le Mirror Component dans votre éditeur de mise en page, vérifiez que le centre de données de votre organisation fait partie des centres pris en charge avant d'ouvrir un ticket de support. [^1,3]

---

Ce qu'il faut vérifier

• Le champ de liaison est présent et déployé dans la mise en page du module enfant, et la liste associée résultante est visible sur la page de détail de l'enregistrement parent.
• Le point de terminaison API et le centre de données correspondent à la région CRM de votre organisation (vérifiez sous Configuration → Informations sur l'entreprise en cas de doute). ^[2]
• Le module de liaison multi-select lookup existe dans votre liste de modules si vous utilisez l'API pour associer des enregistrements dans le cadre d'une relation MxN. [^1,3]

---

*Beam Help est une ressource d'assistance experte indépendante pour les produits Zoho — nous ne sommes pas le support officiel de Zoho. Pour les questions de facturation ou relatives à votre compte, veuillez contacter Zoho directement.*