Comment créer des enregistrements liés dans Zoho CRM

Beam Help — support expert indépendant pour Zoho (pas le support officiel Zoho) — explique comment créer et associer des enregistrements liés dans Zoho CRM, couvrant à la fois l'approche par interface utilisateur et les méthodes basées sur l'API disponibles pour lier des modules et des relations de recherche multi-sélection.

Pourquoi c'est important

La puissance de Zoho CRM réside dans la connexion d'enregistrements entre modules — lier un Contact à un Compte, associer une Opportunité à des Activités, ou créer des relations plusieurs-à-plusieurs entre modules personnalisés. Comprendre la bonne méthode pour chaque type de relation vous fait gagner des heures de dépannage et prévient les problèmes d'intégrité des données à long terme. Que vous travailliez directement dans l'interface CRM ou que vous automatisiez la création d'enregistrements via l'API REST, l'approche diffère selon le type de relation impliquée.

Étape par étape

Étape 1. Identifiez le type de relation dont vous avez besoin.

Avant de créer des enregistrements liés, déterminez si vous avez besoin d'une recherche standard (un-à-plusieurs), d'une recherche multi-sélection (plusieurs-à-plusieurs via un module de liaison), ou d'une association de liste associée. Chacune a un chemin API distinct et un flux de travail UI différent. Pour les relations plusieurs-à-plusieurs, Zoho CRM utilise un module de liaison pour relier les deux côtés de la relation. ^[2]

Étape 2. Créez d'abord l'enregistrement principal.

Accédez au module pertinent dans Zoho CRM (par exemple, Contacts ou Comptes) et créez ou localisez l'enregistrement parent que vous souhaitez associer à d'autres. Chaque enregistrement lié doit référencer un ID d'enregistrement parent valide, donc confirmez que le parent existe avant de continuer. ^[1]

Étape 3. Utilisez le panneau Liste associée dans l'interface utilisateur.

Ouvrez l'enregistrement parent et faites défiler jusqu'à la section Listes associées en bas de la page de détail de l'enregistrement. Chaque module associé (par exemple, Opportunités, Activités ou Contacts) apparaît comme un onglet ou un panneau. Cliquez sur Nouveau ou Créer dans le panneau de liste associée pertinent pour ouvrir un formulaire de création qui est pré-lié à l'enregistrement parent. C'est le chemin sans code le plus rapide pour les associations ponctuelles.

Étape 4. Pour les relations de recherche multi-sélection, choisissez votre méthode API.

Lorsque vous travaillez avec des listes associées de recherche multi-sélection via l'API REST, il y a deux approches prises en charge : insérer des enregistrements directement via l'API d'insertion d'enregistrements, ou travailler via le module de liaison. L'approche du module de liaison est le chemin recommandé pour la nouvelle fonctionnalité de liste associée plusieurs-à-plusieurs dans Zoho CRM. ^[2]

Étape 5. Lors de l'automatisation avec Zoho Flow, récupérez d'abord l'ID de l'enregistrement associé.

Si vous créez un flux automatisé qui crée un enregistrement lié dans Zoho CRM (ou lie des enregistrements CRM à une autre application Zoho), vous devez récupérer l'ID de l'enregistrement que vous souhaitez associer *avant* l'étape de création. Chaque application maintient ses propres ID d'enregistrement uniques — un ID d'une application Zoho ne peut pas être utilisé directement dans une autre. Utilisez une action Récupérer dans Zoho Flow pour rechercher l'enregistrement par e-mail ou nom, puis mappez l'ID retourné dans le champ de relation de votre action de création. ^[4]

Étape 6. Vérifiez la structure d'URL de l'enregistrement pour la navigation directe.

Une fois qu'un enregistrement lié est créé, vous pouvez y accéder directement en utilisant le modèle d'URL CRM :

https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId}

Remplacez {dc} par le suffixe de votre centre de données (par exemple, com, eu ou in), {Module} par le nom API du module (par exemple, Contacts), et {RecordId} par l'ID numérique retourné par l'API. ^[1]

Étape 7. Pour les intégrations multi-produits, liez d'abord au niveau du compte ou du contact.

Lors de l'intégration de Zoho CRM avec d'autres produits Zoho (tels que Zoho Desk ou Zoho FSM), les enregistrements liés ne peuvent être créés qu'après que le Compte ou le Contact dans le produit externe soit lié à son homologue CRM. Tenter de créer un enregistrement enfant (tel qu'une Commande de travail ou un Ticket) avant que ce lien existe entraînera une erreur vous invitant à d'abord compléter l'association. ^[3]

Pièges courants

• Utiliser le mauvais ID entre les applications. Un ID de Contact dans Zoho CRM n'est pas la même valeur numérique que l'ID de Contact pour la même personne dans Zoho Desk ou Zoho Books. Récupérez toujours l'enregistrement dans l'application cible pour obtenir l'ID correct avant de créer un enregistrement lié. ^[4]

• Ignorer le module de liaison pour les relations plusieurs-à-plusieurs. Pour les listes associées de recherche multi-sélection, tenter d'associer des enregistrements sans passer par le module de liaison peut ne pas fonctionner comme prévu. Le module de liaison est le mécanisme pris en charge pour la fonctionnalité de relation plusieurs-à-plusieurs. ^[2]

• Enregistrement parent non encore lié au partenaire d'intégration. Dans les scénarios multi-produits, si le Compte ou le Contact CRM n'a pas été poussé vers ou lié au produit partenaire, la création d'enregistrement enfant échouera. Résolvez d'abord le lien de compte, puis procédez à la création d'enregistrements liés. ^[3]

• Expiration de la connexion OAuth dans les fonctions automatisées. Si vous utilisez des fonctions personnalisées ou des appels API avec une connexion OAuth nommée, une connexion expirée retournera une erreur UnAuthenticated Connection. Réautorisez la connexion depuis Configuration > Developer Hub > Connexions avant de réessayer. ^[6]

Ce qu'il faut vérifier

• Confirmez que l'ID d'enregistrement parent est valide en y accédant dans l'interface utilisateur CRM en utilisant le modèle d'URL standard avant d'exécuter toute API ou automatisation qui le référence. ^[1]
• Vérifiez le type de relation (recherche standard vs. recherche multi-sélection vs. liste associée) dans Configuration > Modules pour vous assurer que vous utilisez la bonne méthode API pour l'association. ^[2]
• Testez l'étape de récupération dans toute automatisation Flow en exécutant le flux avec un enregistrement connu et en confirmant que l'ID retourné correspond à l'enregistrement visible dans l'interface utilisateur CRM avant d'activer le flux pour une utilisation en production. ^[4]