Come recuperare i follower di un ticket in Zoho Desk

Recuperare i follower di un ticket in Zoho Desk è semplice tramite una singola richiesta GET all'API REST di Desk — è sufficiente l'ID del ticket di destinazione e credenziali OAuth valide.

Perché è importante

Quando si creano automazioni, strumenti di audit o flussi di notifica su Zoho Desk, spesso è necessario sapere esattamente chi è iscritto agli aggiornamenti di un determinato ticket. Recuperare l'elenco dei follower in modo programmatico consente di sincronizzare quei dati con sistemi esterni, applicare policy sui follower o visualizzare il conteggio degli iscritti in dashboard personalizzate. È anche un complemento utile alle operazioni di aggiunta e rimozione dei follower, che permettono di gestire l'elenco una volta nota la sua situazione attuale.

Procedura passo dopo passo

Passaggio 1. Assicurati che il tuo token OAuth includa gli scope Desk corretti prima di effettuare qualsiasi chiamata API. Come minimo è necessario Desk.tickets.READ nel set di scope autorizzati — scope di ticket più ampi come Desk.tickets.ALL soddisfano anch'essi questo requisito. ^[6]

Passaggio 2. Ottieni il ticketId del ticket di cui vuoi ispezionare i follower. Si tratta dell'identificatore numerico interno che Zoho Desk assegna a ogni record di ticket, non del numero di ticket leggibile dall'utente mostrato nell'interfaccia. Puoi recuperarlo da qualsiasi risposta precedente dell'API per l'elenco o il dettaglio dei ticket.

Passaggio 3. Invia una richiesta GET all'endpoint dei follower, sostituendo il tuo identificatore di ticket reale nel percorso:

GET /api/v1/tickets/{ticketId}/followers

Il parametro di query opzionale p può essere passato per controllare la paginazione se l'elenco dei follower è lungo. ^[1]

Passaggio 4. In Python, se stai utilizzando un wrapper ZohoDeskApi, chiama il metodo come mostrato di seguito:

followers = api.get_ticket_followers(ticketId="your_ticket_id_here")
print(followers)

Il wrapper esegue la richiesta GET sottostante e restituisce la risposta analizzata. ^[1]

Passaggio 5. Esamina il payload della risposta. L'oggetto restituito conterrà i record dei follower per quel ticket. Presenta i campi chiave — come nome e indirizzo email dell'agente — agli utenti finali in un formato leggibile, omettendo eventuali valori vuoti o ID interni grezzi. ^[5]

Passaggio 6. Se la tua integrazione deve anche modificare l'elenco dei follower, tieni presente che esistono due endpoint complementari:

• Aggiungere follower: POST /api/v1/tickets/{ticketId}/addFollowers — accetta un corpo data contenente gli agenti o i contatti da iscrivere. ^[3]
• Rimuovere follower: POST /api/v1/tickets/{ticketId}/removeFollowers — accetta un corpo data che identifica i follower da disiscrivere. ^[4]

Queste sono operazioni separate dalla chiamata di lettura, quindi il tuo token OAuth avrà bisogno di scope di ticket a livello di scrittura (Desk.tickets.WRITE o Desk.tickets.ALL) se intendi utilizzarle. ^[6]

Passaggio 7. Se il tuo token di accesso è scaduto, il client API dovrebbe aggiornarlo automaticamente utilizzando il refreshtoken memorizzato. Verifica che la logica di aggiornamento del token aggiorni i valori accesstoken e tokenexpiresat persistiti nel tuo archivio dati dopo ogni ciclo di aggiornamento, in modo che le chiamate successive non falliscano. ^[7]

Errori comuni

• orgId mancante o errato: Zoho Desk richiede un'intestazione con l'ID organizzazione per ogni chiamata API. Se il tuo client è stato inizializzato senza un deskorgid valido, la richiesta verrà rifiutata. L'approccio consigliato è chiamare l'endpoint delle organizzazioni al primo utilizzo per rilevare e persistere automaticamente l'ID corretto. ^[7]
• Scope OAuth insufficienti: Richiedere l'elenco dei follower con un token che ha solo Desk.contacts.READ o Desk.basic.READ non funzionerà — è necessario specificamente uno scope di lettura a livello di ticket. Verifica la stringa di scope configurata prima di cercare la causa del problema altrove. ^[6]
• Confusione tra numero di ticket e ticketId: Il parametro di percorso {ticketId} è l'ID di sistema interno, non il numero in stile #1234 visibile nell'interfaccia di Desk. Utilizzare il numero visualizzato restituirà un errore 404 o un risultato vuoto.

Cosa verificare

• Conferma che il token OAuth in uso includa Desk.tickets.READ o Desk.tickets.ALL negli scope concessi. ^[6]
• Verifica che il ticketId che stai passando sia l'ID del record interno di Desk e che il ticket esista effettivamente nella tua organizzazione.
• Dopo una chiamata riuscita, valida che la struttura della risposta corrisponda a ciò che il tuo codice a valle si aspetta — in particolare se prevedi di concatenarla con gli endpoint di aggiunta o rimozione dei follower. ^[3][4]

---

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