Comment récupérer le nombre de contacts dans Zoho Desk

Récupérer le nombre de contacts dans Zoho Desk vous donne un aperçu rapide du nombre d'enregistrements clients présents dans votre portail — utile pour la planification des capacités, le reporting et l'audit de votre base de données support.

Pourquoi c'est important

Connaître le volume total de vos contacts aide les responsables support à suivre la croissance, à identifier les problèmes de qualité des données et à évaluer la charge de travail des équipes. Que vous réalisiez un audit périodique ou que vous construisiez un tableau de bord, disposer d'un moyen fiable pour extraire ce chiffre évite les efforts manuels. C'est particulièrement pertinent lorsque les contacts sont synchronisés depuis des systèmes externes tels que Zoho CRM ou Zoho FSM, où les comptages d'enregistrements peuvent dériver. En tant qu'expert indépendant pour Zoho (et non le support officiel de Zoho), Beam Help vous guide à travers les approches les plus fiables ci-dessous.

Étape par étape

Étape 1. Ouvrez Zoho Desk et accédez à l'onglet Customers dans la barre de navigation supérieure. Les Contacts et les Comptes s'y trouvent tous les deux, veillez donc à sélectionner la sous-section Contacts pour délimiter correctement votre vue. ^[5]

Étape 2. Utilisez les vues de liste de contacts pour filtrer et regrouper les contacts selon des critères définis — par exemple, tous les contacts ajoutés aujourd'hui, ou ceux associés à Zoho CRM. Chaque vue enregistrée affiche les enregistrements correspondant à son filtre, et le nombre d'enregistrements affiché en haut de la liste indique combien de contacts répondent à ces conditions. ^[4]

Étape 3. Pour obtenir un nombre total sans filtre, sélectionnez la vue de liste par défaut All Contacts. Le nombre affiché à côté de la liste représente le nombre total de contacts pour votre portail. Si vous avez besoin d'un comptage pour un segment spécifique (par exemple, les contacts liés à un compte ou un canal particulier), créez ou sélectionnez la vue personnalisée appropriée. ^[4]

Étape 4. Si vous avez besoin du comptage de manière programmatique — par exemple, pour alimenter un rapport ou une automatisation — l'outil getrecordcount peut être invoqué sur le module Contacts. Cet outil accepte un paramètre module (défini sur Contacts) et un paramètre optionnel criteria pour affiner la portée. Le résultat est retourné sous forme de valeur de comptage structurée, utilisable en aval. ^[1]

Étape 5. Lorsque vous utilisez une interface de requête assistée par IA (telle que Zpilot connecté à votre portail Zoho Desk), vous pouvez poser une question en langage naturel comme « Combien de contacts y a-t-il dans Desk ? ». Le système détecte les requêtes de type comptage, identifie le bon module et appelle getrecordcount avec les paramètres appropriés automatiquement. Le résultat est ensuite affiché directement dans la réponse du chat. ^[1]

Étape 6. Si vos contacts Zoho Desk sont également synchronisés avec Zoho FSM, sachez que le comptage visible dans Desk ne reflète que les enregistrements côté Desk. Les contacts transmis à Zoho FSM ou liés à celui-ci sont toujours comptabilisés comme des contacts Desk, mais le côté FSM maintient son propre ensemble d'enregistrements distinct. Vérifiez toujours quel système vous interrogez pour éviter les doubles comptages. ^[2]

Erreurs courantes

• Les vues filtrées faussent le comptage. Si vous consultez une vue de liste personnalisée plutôt que la vue par défaut « All Contacts », le nombre affiché est limité aux critères de ce filtre — et non au comptage total du portail. Basculez toujours vers la vue tous-contacts non filtrée pour obtenir un total réel. ^[4]

• Contacts liés et non liés dans les intégrations FSM. Lorsque des contacts Zoho Desk sont liés à des enregistrements Zoho FSM, dissocier un compte avant que ses contacts associés ne soient dissociés génèrera une erreur. Cela peut laisser des enregistrements de contacts orphelins qui gonflent votre comptage Desk de manière inattendue. Dissociez les contacts avant de dissocier leur compte parent. ^[2]

• Casse du nom de module dans l'API. Lors de l'appel programmatique à getrecordcount, le paramètre module doit correspondre exactement à l'identifiant de module attendu. Passer un nom de module non reconnu déclenchera une question de clarification plutôt que de retourner un comptage, bloquant ainsi votre automatisation. ^[8]

• Le raccourci de comptage est actif uniquement pour le type d'application CRM. La logique de raccourci de comptage dans le backend est explicitement limitée au type d'application crm — ce qui signifie que si vous effectuez une requête via une session à portée CRM plutôt qu'une session à portée Desk, le chemin de raccourci retournera un résultat vide et basculera vers le flux de comptage général. Assurez-vous que votre session est limitée à la bonne application. ^[8]

Ce qu'il faut vérifier

• Confirmez que vous consultez la bonne vue de liste — vérifiez que le nom de la vue indique « All Contacts » (ou le segment souhaité) avant d'enregistrer le comptage comme valeur de référence. ^[4]
• Vérifiez que votre connexion au portail est active — si la connexion Zoho Desk n'est pas authentifiée, l'appel à getrecordcount retournera une erreur de connexion plutôt qu'un nombre ; reconnectez-vous via vos paramètres d'intégration si nécessaire. ^[1]
• Comparez avec les systèmes synchronisés — si des contacts proviennent de Zoho CRM ou Zoho FSM, vérifiez un échantillon pour confirmer que les enregistrements ne sont pas dupliqués ou manquants côté Desk après une synchronisation récente. ^[2]