Come elencare tutti i thread nei ticket di Zoho Desk

Elencare tutti i thread in un ticket di Zoho Desk è semplice una volta che conosci il corretto endpoint API e i parametri richiesti. Questo articolo ti guida attraverso la chiamata, gli scope OAuth necessari e cosa verificare in seguito.

Perché è importante

I ticket di supporto in Zoho Desk accumulano più thread nel corso della loro vita — risposte dei clienti, risposte degli agenti e note interne. Quando hai bisogno di verificare una conversazione, costruire un'integrazione o visualizzare la cronologia dei thread in un'app personalizzata, devi essere in grado di recuperare ogni thread in modo programmatico anziché scorrere manualmente l'interfaccia utente.

Procedura passo dopo passo

Passaggio 1. Verifica che il tuo token OAuth includa gli scope corretti di Zoho Desk prima di effettuare qualsiasi chiamata. Come minimo hai bisogno di Desk.tickets.READ nell'elenco degli scope autorizzati; le integrazioni più ampie includono tipicamente anche Desk.tickets.ALL per coprire le operazioni di scrittura nella stessa sessione. ^[2]

Passaggio 2. Identifica il ticket_id del ticket di cui vuoi recuperare i thread. Questo è l'identificatore numerico che Zoho Desk assegna a ogni record di ticket — puoi trovarlo nell'URL del ticket all'interno del portale agente, che segue il pattern https://desk.zoho.com/agent/{portal}/tickets/details/{TicketId}. ^[4]

Passaggio 3. Invia una richiesta GET all'endpoint dei thread, sostituendo l'identificatore del tuo ticket nel percorso:

GET /api/v1/tickets/{ticket_id}/threads

Includi il tuo token Bearer nell'intestazione Authorization. L'endpoint accetta anche un parametro opzionale p (un dizionario di opzioni di query aggiuntive come i controlli di paginazione) se hai bisogno di scorrere un lungo elenco di thread. ^[3]

Passaggio 4. Analizza la risposta. Ogni elemento nella raccolta restituita rappresenta un thread del ticket — una risposta, un inoltro o una nota — con i propri metadati come mittente, timestamp e corpo del contenuto. Visualizza o memorizza i campi rilevanti per il tuo caso d'uso. ^[3]

Passaggio 5. Se hai bisogno solo dell'ultimo scambio più recente anziché dell'intera cronologia, utilizza invece l'endpoint dedicato all'ultimo thread:

GET /api/v1/tickets/{ticket_id}/threads/latest

Questo restituisce solo l'oggetto thread più recente ed è più efficiente quando hai bisogno solo di un rapido controllo dello stato. ^[7]

Errori comuni

• Token mancante o con scope insufficienti. Se al tuo client OAuth è stato concesso solo Desk.tickets.WRITE o Desk.tickets.CREATE ma non Desk.tickets.READ, l'API rifiuterà la richiesta. Verifica che Desk.tickets.READ (o Desk.tickets.ALL) sia presente nella stringa degli scope attivi. ^[2]

• Formato ID ticket errato. Passare una stringa oggetto o un ID record CRM invece dell'ID numerico del ticket Desk risulterà in una risposta 404 o vuota. Recupera sempre l'ID direttamente dai record dei ticket di Zoho Desk. ^[4]

• Paginazione dimenticata. I ticket con lunghe cronologie possono restituire risultati su più pagine. Usa il parametro p per iterare tra le pagine anziché presumere che la prima risposta contenga tutti i thread. ^[3]

• Mancata corrispondenza del data center. Zoho ospita i dati in più regioni (.com, .eu, .in, ecc.). Assicurati che l'URL base che utilizzi corrisponda al data center in cui è configurata la tua organizzazione Desk — ad esempio https://desk.zoho.eu per gli account ospitati nell'UE. ^[4]

Cosa verificare

• Verifica che il ticket_id nel percorso della tua richiesta corrisponda a un ticket reale nella tua organizzazione Zoho Desk e che il token dell'agente abbia almeno lo scope Desk.tickets.READ. [^2, ^3]
• Conferma che la risposta contenga il numero atteso di oggetti thread; se il conteggio sembra basso, controlla se la paginazione sta troncando i risultati e itera usando il parametro p. ^[3]
• Se avevi bisogno solo del messaggio più recente, confronta il risultato di /threads/latest con l'ultimo elemento restituito da /threads per assicurarti che corrispondano. ^[7]

---

*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale Zoho. Fai sempre riferimento alla documentazione API di Zoho Desk per le specifiche più aggiornate degli endpoint.*