Come recuperare il conteggio dei contatti in Zoho Desk

Recuperare il conteggio dei contatti in Zoho Desk ti offre un'istantanea rapida di quanti record cliente esistono nel tuo portale — utile per la pianificazione della capacità, il reporting e l'audit del database di supporto.

Perché è importante

Conoscere il volume totale dei contatti aiuta i responsabili del supporto a monitorare la crescita, identificare problemi di qualità dei dati e valutare il carico di lavoro del team. Che tu stia eseguendo un audit periodico o costruendo una dashboard, disporre di un metodo affidabile per estrarre questo numero evita sforzi manuali. Questo è particolarmente rilevante quando i contatti vengono sincronizzati da sistemi esterni come Zoho CRM o Zoho FSM, dove i conteggi dei record possono divergere. In qualità di supporto esperto indipendente per Zoho (non supporto ufficiale Zoho), Beam Help ti guida attraverso gli approcci più affidabili di seguito.

Procedura passo dopo passo

Passaggio 1. Apri Zoho Desk e vai alla scheda Clienti nella barra di navigazione superiore. Sia i Contatti che gli Account si trovano qui, quindi assicurati di selezionare la sottosezione Contatti per circoscrivere correttamente la visualizzazione. ^[5]

Passaggio 2. Utilizza le Visualizzazioni elenco contatti per filtrare e raggruppare i contatti in base a criteri definiti — ad esempio, tutti i contatti aggiunti oggi, o quelli mappati su Zoho CRM. Ogni visualizzazione salvata mostra i record che corrispondono al suo filtro, e il conteggio dei record visualizzato in cima all'elenco riflette quanti contatti soddisfano tali condizioni. ^[4]

Passaggio 3. Per ottenere un conteggio totale senza filtri, seleziona la visualizzazione elenco predefinita Tutti i contatti. Il numero visualizzato accanto all'elenco rappresenta il conteggio completo dei contatti per il tuo portale. Se hai bisogno di un conteggio per un segmento specifico (ad es., contatti collegati a un account o canale particolare), crea o seleziona la visualizzazione personalizzata appropriata. ^[4]

Passaggio 4. Se hai bisogno del conteggio in modo programmatico — ad esempio, per alimentare un report o un'automazione — lo strumento getrecordcount può essere invocato sul modulo Contatti. Questo strumento accetta un parametro module (impostato su Contacts) e un parametro opzionale criteria per restringere l'ambito. Il risultato viene restituito come valore di conteggio strutturato che può essere utilizzato a valle. ^[1]

Passaggio 5. Quando si utilizza un'interfaccia di query assistita da AI (come Zpilot connesso al tuo portale Zoho Desk), puoi porre una domanda in linguaggio naturale come "Quanti contatti ci sono in Desk?" Il sistema rileva le query di tipo conteggio, risolve il modulo corretto e chiama getrecordcount con i parametri appropriati automaticamente. Il risultato viene quindi mostrato direttamente nella risposta della chat. ^[1]

Passaggio 6. Se i tuoi contatti Zoho Desk sono anche sincronizzati con Zoho FSM, tieni presente che il conteggio visibile in Desk riflette solo i record lato Desk. I contatti inviati o collegati a Zoho FSM vengono comunque conteggiati come contatti Desk, ma il lato FSM mantiene il proprio set di record separato. Verifica sempre quale sistema stai interrogando per evitare doppi conteggi. ^[2]

Errori comuni

• Visualizzazioni filtrate che distorcono il conteggio. Se stai guardando una visualizzazione elenco personalizzata anziché la visualizzazione predefinita "Tutti i contatti", il conteggio mostrato è limitato ai criteri di quel filtro — non al conteggio totale del portale. Passa sempre alla visualizzazione di tutti i contatti non filtrata per ottenere il totale reale. ^[4]

• Contatti collegati e non collegati nelle integrazioni FSM. Quando i contatti Zoho Desk sono collegati a record Zoho FSM, scollegare un account prima che i contatti associati vengano scollegati genererà un errore. Questo può lasciare record di contatti orfani che gonfiano inaspettatamente il conteggio in Desk. Scollega i contatti prima di scollegare il loro account padre. ^[2]

• Maiuscole/minuscole nel nome del modulo API. Quando si chiama getrecordcount in modo programmatico, il parametro module deve corrispondere esattamente all'identificatore del modulo previsto. Passare un nome di modulo non riconosciuto genererà una domanda di chiarimento anziché restituire un conteggio, bloccando la tua automazione. ^[8]

• La scorciatoia di conteggio è attiva solo per il tipo di app CRM. La logica della scorciatoia di conteggio nel backend è esplicitamente limitata al tipo di app crm — il che significa che se stai eseguendo query tramite una sessione con ambito CRM anziché una sessione con ambito Desk, il percorso della scorciatoia restituirà un risultato vuoto e passerà al flusso di conteggio generale. Assicurati che la tua sessione sia impostata sull'app corretta. ^[8]

Cosa verificare

• Conferma di visualizzare la visualizzazione elenco corretta — verifica che il nome della visualizzazione sia "Tutti i contatti" (o il segmento desiderato) prima di registrare il conteggio come valore di riferimento. ^[4]
• Verifica che la connessione al portale sia attiva — se la connessione a Zoho Desk non è autenticata, la chiamata getrecordcount restituirà un errore di connessione anziché un numero; riconnettiti tramite le impostazioni di integrazione se necessario. ^[1]
• Confronta con eventuali sistemi sincronizzati — se i contatti provengono da Zoho CRM o Zoho FSM, verifica un campione per confermare che i record non siano duplicati o mancanti sul lato Desk dopo una sincronizzazione recente. ^[2]