Comment récupérer les enregistrements en double dans Zoho

Les enregistrements en double dans Zoho peuvent être détectés par programmation grâce à un endpoint de recherche dédié, vous permettant d'identifier et de traiter les données redondantes avant qu'elles ne causent des problèmes de reporting ou de workflow.

Pourquoi c'est important

Les enregistrements en double gonflent les chiffres du pipeline, perturbent les agents du support et compromettent les règles d'automatisation qui supposent des entrées uniques. Que vous gériez un catalogue de produits dans Zoho Desk ou des contacts dans Zoho CRM, détecter les doublons tôt maintient vos données propres et vos processus fiables. En tant que support expert indépendant (et non le support officiel de Zoho), Beam Help vous guide à travers les mécanismes afin que votre équipe puisse automatiser cette vérification en toute confiance.

Étape par étape

Étape 1. Assurez-vous que votre connexion OAuth dispose des scopes corrects avant d'effectuer tout appel API. Pour Zoho CRM, vous avez besoin au minimum de ZohoCRM.modules.ALL ou des permissions de lecture équivalentes, et pour Zoho Desk vous avez besoin de Desk.search.READ ainsi que des scopes de module pertinents tels que Desk.contacts.READ. ^[1]

Étape 2. Authentifiez-vous et obtenez un jeton d'accès valide. La plateforme stocke les détails de votre connexion (jeton d'accès, jeton de rafraîchissement, domaine API et horodatage d'expiration) dans un enregistrement de connexion associé à votre compte utilisateur. Les jetons sont automatiquement rafraîchis environ deux minutes avant leur expiration pour éviter les échecs en cours de requête ; assurez-vous que votre intégration suit le même schéma. ^[5]

Étape 3. Si votre jeton a expiré, déclenchez un rafraîchissement en appelant ZohoOAuth.refreshtokens() avec le jeton de rafraîchissement stocké. En cas de succès, persistez les nouvelles valeurs accesstoken et tokenexpiresat mises à jour dans votre store de connexion afin que les appels suivants restent authentifiés. ^[3]

Étape 4. Pour récupérer les enregistrements en double, envoyez une requête GET vers l'endpoint suivant :

GET /api/v1/products/duplicate

Cette opération est identifiée en interne sous le nom searchforduplicate_records et accepte un dictionnaire de paramètres optionnel (p) que vous pouvez utiliser pour filtrer ou paginer les résultats. ^[6]

Étape 5. Transmettez les paramètres de filtre pertinents dans le dictionnaire p. Les clés prises en charge exactes dépendent de votre configuration Zoho Desk, mais l'objet de paramètres est transmis directement à l'API Zoho ; consultez donc la liste des champs de votre module pour affiner les résultats (par exemple, par catégorie de produit ou plage de dates). ^[6]

Étape 6. Gérez la réponse. Un appel réussi renvoie un objet résultat structuré. Si le résultat contient une clé error, affichez ce message à l'opérateur et arrêtez tout traitement ultérieur. Si le résultat est correct, itérez sur les enregistrements retournés pour les examiner, les fusionner ou les signaler selon vos besoins. ^[8]

Étape 7. Lorsque vous créez des liens vers des enregistrements en double individuels dans votre interface, utilisez les valeurs dc (centre de données), crmorgid, deskorgid et desk_portal stockées dans votre enregistrement de connexion pour construire des URL correctes spécifiques à chaque région. ^[2]

Pièges courants

• Scopes manquants. Si Desk.search.READ est absent de votre autorisation OAuth, l'endpoint de recherche de doublons renverra une erreur d'autorisation. Vérifiez attentivement la liste complète des scopes dans la configuration de votre client OAuth. ^[1]
• Jetons périmés. Appeler l'endpoint avec un jeton d'accès expiré produit une réponse 401. Intégrez un rafraîchissement proactif du jeton (au moins 120 secondes avant l'expiration) pour éviter cela en cours de requête. ^[5]
• Mauvais centre de données. Zoho héberge les données dans plusieurs régions. Si votre apidomain pointe vers zohoapis.eu mais que votre client est configuré pour zohoapis.com, les requêtes échoueront silencieusement ou retourneront des résultats vides. Extrayez le suffixe du centre de données depuis l'apidomain stocké lors du callback OAuth et utilisez-le de manière cohérente. ^[7]
• Paramètre p vide. Passer None au lieu d'un dictionnaire vide {} pour l'argument p peut provoquer un comportement inattendu selon la façon dont le client HTTP sous-jacent sérialise la requête. Utilisez {} par défaut lorsqu'aucun filtre n'est nécessaire. ^[6]

Ce qu'il faut vérifier

• Les scopes sont présents : Confirmez que Desk.search.READ (et tous les scopes de lecture au niveau du module) apparaissent dans votre autorisation OAuth active avant d'appeler l'endpoint de doublons. ^[1]
• Le jeton est à jour : Vérifiez que tokenexpiresat est au moins 120 secondes dans le futur au moment de la requête, et que votre logique de rafraîchissement met à jour la valeur stockée en cas de succès. ^[5]
• L'endpoint retourne des données : Confirmez que la réponse de GET /api/v1/products/duplicate contient un ensemble de résultats non vide et aucune clé error avant de procéder à tout workflow de fusion ou de suppression. ^[6]