Come ottenere il conteggio dei record in Zoho Desk

Ottenere il conteggio dei record in Zoho Desk è semplice una volta che la connessione è autorizzata — chiedi all'assistente quale modulo vuoi contare e riceverai il totale (con filtri opzionali).

Perché è importante

Sapere quanti ticket, contatti, attività o altri record esistono in un determinato modulo di Zoho Desk aiuta i responsabili del supporto a monitorare il carico di lavoro, verificare la qualità dei dati e generare report sulla conformità agli SLA. Potresti aver bisogno di un totale grezzo per un modulo, oppure di un conteggio filtrato — ad esempio, tutti i ticket aperti assegnati a un reparto specifico. Senza un meccanismo di conteggio affidabile, i team ricorrono spesso a esportazioni manuali, che sono lente e soggette a errori.

Procedura passo dopo passo

Passaggio 1. Verifica che la connessione a Zoho Desk sia attiva.

Prima di poter recuperare qualsiasi conteggio, il sistema deve disporre di un token OAuth valido per la tua organizzazione Desk. Il backend utilizza un ZohoDeskClient inizializzato con il tuo dominio API, il token di accesso e l'ID organizzazione. Se l'ID organizzazione non è ancora memorizzato, viene rilevato automaticamente dalla prima chiamata API per elencare le tue organizzazioni. ^[8]

Passaggio 2. Assicurati che gli scope OAuth corretti siano concessi.

L'autorizzazione OAuth di Zoho Desk deve includere almeno Desk.tickets.READ, Desk.contacts.READ, Desk.tasks.READ e Desk.basic.READ — a seconda del modulo che vuoi contare. Il set di scope consigliato completo copre anche eventi, articoli, impostazioni e ricerca. ^[3]

Passaggio 3. Richiedi il conteggio dei record per modulo.

Nella chat dell'assistente Beam Help, digita una richiesta in linguaggio naturale come *"Quanti ticket ci sono in Zoho Desk?"* o *"Conta i miei contatti in Desk."* L'assistente la riconosce come una query di conteggio e la instrada automaticamente allo strumento getrecordcount. ^[2]

Passaggio 4. Specifica il modulo se richiesto.

Se il tuo messaggio non indica chiaramente un modulo, l'assistente chiederà: *"Quale modulo devo contare (ad es. Lead, Contatti, Trattative)?"* Rispondi con il nome del modulo — ad esempio, *"Ticket"* — e l'assistente procederà. ^[1]

Passaggio 5. Aggiungi un filtro (opzionale).

Puoi restringere il conteggio includendo criteri nella tua richiesta, ad esempio *"Quanti ticket aperti sono assegnati al reparto Fatturazione?"* Quando viene rilevato un parametro criteria insieme al modulo, l'assistente lo passa alla chiamata API e restituisce un totale filtrato. ^[1]

Passaggio 6. Leggi il risultato.

Once the API responds, the assistant displays one of two messages:

• *"Hai N record nel modulo [Modulo]."* — per un conteggio non filtrato. ^[7]
• *"Hai N record nel modulo [Modulo] corrispondenti al filtro."* — quando sono stati applicati dei criteri. ^[7]

Se il conteggio non può essere estratto dalla risposta API, vedrai *"Non sono riuscito a determinare il conteggio dei record per [Modulo]."* — in tal caso, consulta la sezione sugli errori comuni di seguito. ^[5]

Passaggio 7. Segui il link diretto (se fornito).

Dopo un conteggio riuscito, l'assistente potrebbe generare un link diretto al tuo portale Zoho Desk. Gli URL di Desk seguono il pattern https://desk.zoho.{dc}/agent/{portal}/tickets/details/{TicketId}, specifico per il tuo data center e il nome del portale. ^[6]

---

Errori comuni

• Connessione non autorizzata. Se l'istanza API di Zoho Desk non può essere inizializzata, riceverai un errore: *"Zoho non è connesso per questa app. Riconnettiti."* Esegui nuovamente l'autenticazione tramite le impostazioni di connessione per risolvere il problema. ^[4]

• ID organizzazione mancante o errato. Il ZohoDeskClient richiede un ID organizzazione Desk. Se è assente, il sistema tenta il rilevamento automatico dall'elenco delle tue organizzazioni. Se anche questo fallisce (ad es. a causa di uno scope Desk.basic.READ insufficiente), la chiamata di conteggio non raggiungerà Zoho Desk. Verifica che Desk.basic.READ sia incluso negli scope concessi. [^8, ^3]

• Zoho rifiuta la richiesta. Se l'API restituisce un oggetto di errore, l'assistente risponde con *"Zoho ha rifiutato la richiesta. Cosa devo modificare per riprovare?"* Questo di solito significa che manca uno scope, il nome del modulo non è valido o la sintassi dei criteri è errata. ^[5]

• Nome del modulo non riconosciuto. Il flusso di conteggio richiede un modulo chiaramente identificato. Le richieste vaghe senza un nome di modulo attiveranno sempre una domanda di chiarimento prima di effettuare qualsiasi chiamata API. ^[1]

---

Cosa verificare

• Scope OAuth: Conferma che tutti gli scope Desk.* richiesti — in particolare Desk.tickets.READ e Desk.basic.READ — siano presenti nella connessione autorizzata. ^[3]
• Persistenza dell'ID organizzazione: Verifica che l'ID organizzazione Desk sia memorizzato nel record di connessione; se è vuoto, il sistema tenterà il rilevamento automatico a ogni richiesta, aggiungendo latenza. ^[8]
• Formato della risposta: Se ricevi un messaggio "Non sono riuscito a determinare il conteggio dei record", verifica che l'API stia restituendo un campo di conteggio analizzabile anziché un payload di errore. ^[7]

---

*Beam Help è un servizio di supporto esperto indipendente per Zoho — non siamo il supporto ufficiale Zoho. Per problemi di fatturazione o relativi all'account, contatta direttamente Zoho.*