Come recuperare un'approvazione in Zoho Desk

Per recuperare un record di approvazione in Zoho Desk sono necessari l'ID del ticket e l'ID dell'approvazione — una volta ottenuti entrambi, una singola richiesta GET restituisce i dettagli completi dell'approvazione.

Perché è importante

I flussi di approvazione in Zoho Desk consentono ad agenti e responsabili di subordinare l'avanzamento dei ticket a convalide formali. Se hai bisogno di verificare una decisione di approvazione, visualizzarne lo stato corrente in una dashboard esterna o inviare i dati di approvazione a un'automazione a valle, devi essere in grado di recuperare quel record di approvazione specifico in modo programmatico. Conoscere l'endpoint corretto e i parametri richiesti fa risparmiare tempo ed evita query di elenco non necessarie.

Procedura passo dopo passo

Passaggio 1. Verifica di aver abilitato gli scope OAuth corretti per la tua integrazione con Zoho Desk. Il token deve includere almeno Desk.tickets.READ affinché le risorse secondarie a livello di ticket, come le approvazioni, siano accessibili. ^[5]

Passaggio 2. Identifica i due parametri di percorso obbligatori necessari prima di effettuare qualsiasi chiamata:

• ticketId — l'identificatore univoco del ticket a cui appartiene l'approvazione.
• approvalId — l'identificatore univoco del record di approvazione specifico che vuoi recuperare.

Entrambi i valori sono stringhe e devono essere presenti; l'endpoint non si risolverà senza di essi. ^[8]

Passaggio 3. Effettua una richiesta GET al seguente endpoint, sostituendo i valori reali ai segnaposto:

GET /api/v1/tickets/{ticketId}/approvals/{approvalId}

Ad esempio, se l'ID del ticket è 123456 e l'ID dell'approvazione è 789, il percorso risolto diventa /api/v1/tickets/123456/approvals/789. ^[8]

Passaggio 4. Passa il tuo token di accesso OAuth nell'intestazione Authorization. Se il token è scaduto, il client deve scambiare il refresh token memorizzato con un nuovo token di accesso prima di ripetere la richiesta. ^[3]

Passaggio 5. Facoltativamente, fornisci parametri di query aggiuntivi tramite il dizionario p (ad es., filtri di campo o suggerimenti di paginazione supportati dall'API di Zoho Desk). Se non hai parametri aggiuntivi, passa un oggetto vuoto o omettilo del tutto. ^[8]

Passaggio 6. Gestisci la risposta. Una chiamata riuscita restituisce l'oggetto approvazione in formato JSON. Se la risposta contiene una chiave "error", mostra quel messaggio all'utente o registralo per il debug prima di riprovare. ^[2]

---

> Nota: Beam Help è un servizio di supporto esperto indipendente per Zoho — non siamo il supporto ufficiale di Zoho. Verifica sempre il comportamento degli endpoint in base al tuo data center e alla versione API di Zoho Desk specifici.

Errori comuni

• ID mancanti o invertiti. Passare l'ID dell'approvazione al posto dell'ID del ticket (o viceversa) restituirà un errore 404 o un record non correlato. Controlla attentamente l'ordine: l'ID del ticket viene prima nel percorso, l'ID dell'approvazione secondo. ^[8]
• Scope OAuth insufficiente. Se l'app connessa è stata autorizzata senza Desk.tickets.READ, l'API rifiuterà la richiesta con un errore di autorizzazioni. Ri-autorizza il flusso OAuth includendo gli scope corretti. ^[5]
• Token di accesso scaduto. I token di accesso di Zoho hanno una durata limitata. Assicurati che la tua integrazione aggiorni automaticamente il token utilizzando il refresh token memorizzato quando viene ricevuta una risposta 401. ^[3]
• ID organizzazione non impostato. Le chiamate API di Zoho Desk sono limitate a un'organizzazione. Se l'intestazione orgId è assente o errata, le richieste potrebbero fallire o restituire dati dal portale sbagliato. Verifica che l'ID organizzazione sia risolto e allegato a ogni richiesta. ^[7]

Cosa verificare

• Verifica che i valori ticketId e approvalId che stai utilizzando esistano effettivamente nel tuo portale Zoho Desk prima di chiamare l'endpoint. ^[8]
• Conferma che il tuo token OAuth includa Desk.tickets.READ e non sia scaduto prima di effettuare la richiesta. ^[5]
• Controlla la risposta JSON per un campo "error" e gestiscilo correttamente nella logica della tua integrazione prima di tentare qualsiasi ulteriore elaborazione. ^[2]