Comment rechercher des enregistrements dans Zoho

Rechercher des enregistrements dans Zoho CRM vous permet de localiser rapidement des contacts, des prospects, des affaires ou toute autre donnée de module à l'aide de filtres basés sur des critères — voici comment procéder efficacement.

Pourquoi c'est important

Lorsque votre CRM contient des milliers d'enregistrements, faire défiler manuellement les listes est peu pratique. Savoir construire une requête de recherche appropriée vous permet de faire remonter instantanément les enregistrements dont vous avez besoin — qu'il s'agisse de tous les prospects créés la semaine dernière, des contacts d'une entreprise spécifique ou des affaires dépassant une certaine valeur. C'est particulièrement utile lors de la création d'automatisations ou de l'audit de la qualité des données. En tant que ressource d'assistance experte indépendante (et non le support officiel de Zoho), Beam Help vous guide à travers les mécanismes ci-dessous.

Étape par étape

Étape 1. Identifiez le module dans lequel vous souhaitez effectuer une recherche. Zoho CRM organise les données en modules tels que Leads, Contacts, Deals, Accounts, et bien d'autres. Avant de construire votre recherche, confirmez le nom exact du module — il doit correspondre à la dénomination interne du CRM (par exemple, Contacts, et non Contact). ^[6]

Étape 2. Utilisez l'outil searchrecords (ou l'appel API équivalent) et transmettez le paramètre module ainsi qu'une chaîne criteria. La chaîne de critères suit un format structuré utilisant des noms de champs, des opérateurs et des valeurs. Par exemple, pour trouver tous les contacts dont l'adresse e-mail appartient à un domaine particulier, vos critères ressembleraient à (Email:endswith:@gmail.com). ^[6]

Étape 3. Pour les recherches par plage de dates, utilisez l'opérateur between dans vos critères. Par exemple, pour récupérer les prospects créés au cours d'une semaine spécifique, structurez vos critères comme suit : (Created_Time:between:YYYY-MM-DD:YYYY-MM-DD), en remplaçant les dates de début et de fin réelles. Cela est particulièrement utile pour les revues hebdomadaires ou mensuelles du pipeline. ^[6]

Étape 4. Si vous avez uniquement besoin du nombre d'enregistrements correspondants plutôt que de la liste complète, utilisez l'outil getrecordcount avec les mêmes paramètres module et criteria optionnels. Le système retournera un résultat en langage naturel tel que « Vous avez 42 enregistrements dans le module Contacts correspondant à ce filtre. » ^[4]

Étape 5. Une fois les résultats retournés, chaque enregistrement correspondant est accessible directement via son URL CRM. Le format du lien suit le modèle https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId}, où dc est la région de votre centre de données (par exemple, com, eu, in) et RecordId est l'identifiant unique de l'enregistrement. ^[1]

Étape 6. Assurez-vous que vos identifiants OAuth connectés incluent les portées correctes pour les opérations de recherche. La portée ZohoCRM.coql.READ est requise pour les recherches basées sur des requêtes, et ZohoCRM.bulk.ALL couvre la récupération d'enregistrements en masse. Sans ces portées autorisées, les requêtes de recherche échoueront avec une erreur de permissions. ^[2]

Étape 7. Si votre connexion API ne retourne aucun résultat ou renvoie une erreur d'authentification, le système tentera de rafraîchir automatiquement votre jeton d'accès à l'aide du jeton de rafraîchissement stocké. Si le rafraîchissement échoue (par exemple, parce que le jeton a été révoqué), vous devrez reconnecter votre compte Zoho CRM. ^[3]

Erreurs courantes

• Casse incorrecte du nom de module : Les noms de modules sont sensibles à la casse dans les critères et les paramètres. Utiliser contacts au lieu de Contacts peut entraîner un retour de zéro résultat ou une erreur. Utilisez toujours la forme avec majuscule telle qu'elle apparaît dans la liste des modules de votre CRM. ^[6]

• Portées OAuth manquantes : Si ZohoCRM.coql.READ n'est pas inclus dans vos portées autorisées, les requêtes de recherche seront rejetées. Vérifiez la configuration des portées de votre application connectée et réautorisez si nécessaire. ^[2]

• Syntaxe de critères malformée : La chaîne de critères doit suivre le format exact (FieldName:operator:value). Les erreurs courantes incluent des parenthèses manquantes, des espaces autour des deux-points, ou la référence à un nom de champ inexistant dans le module. Pour les plages de dates, une date de début et une date de fin sont toutes deux requises avec l'opérateur between. ^[6]

• Jetons expirés ou manquants : Si le jeton d'accès stocké a expiré et que le jeton de rafraîchissement est également invalide, l'instance API retournera null et aucune recherche ne pourra être effectuée. Dans ce cas, la connexion doit être rétablie depuis le début. ^[3]

Points à vérifier

• Confirmez que le nom du module correspond exactement à ce que Zoho CRM utilise en interne (par exemple, Leads, Contacts, Deals) avant d'exécuter votre recherche. ^[6]
• Vérifiez que les portées OAuth incluent au minimum ZohoCRM.coql.READ pour autoriser les recherches d'enregistrements basées sur des critères. ^[2]
• Testez l'URL directe de l'enregistrement en utilisant le format https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId} pour confirmer que les identifiants d'enregistrements retournés se résolvent correctement dans votre navigateur. ^[1]