Come eliminare le azioni durante una transizione in Zoho Desk

Eliminare una bozza di transizione "durante le azioni" in Zoho Desk richiede una singola chiamata DELETE autenticata all'API delle transizioni, indirizzata al ticket e alla transizione specifici che desideri rimuovere.

Perché è importante

La funzionalità blueprint di Zoho Desk ti consente di definire azioni che si attivano *durante* una transizione tra stati. Quando stai lavorando su un progetto di blueprint, potresti creare bozze di azioni durante le transizioni che devono essere scartate prima della pubblicazione. Conoscere l'endpoint API corretto e i parametri richiesti ti permette di eliminare le bozze obsolete in modo programmatico, senza dover cercare nell'interfaccia utente. Questo è particolarmente utile quando si gestiscono blueprint su larga scala o si automatizza la configurazione di Desk tramite script.

---

Procedura passo dopo passo

Passaggio 1. Raccogli gli identificatori necessari.

Prima di effettuare la chiamata, hai bisogno di due informazioni: il ticketId del ticket di cui stai modificando la transizione del blueprint e il transitionId che identifica la transizione specifica contenente la bozza di azioni durante la transizione che desideri eliminare. Entrambi sono valori stringa. ^[1]

Passaggio 2. Costruisci la richiesta DELETE.

Invia una richiesta HTTP DELETE al seguente endpoint, sostituendo i valori reali ai parametri del percorso:

DELETE /api/v1/tickets/{ticketId}/transitions/{transitionId}/duringActions

Sostituisci {ticketId} con l'ID del tuo ticket e {transitionId} con l'ID della transizione. ^[1]

Passaggio 3. Includi eventuali parametri di query opzionali.

L'endpoint accetta anche un parametro opzionale p (passato come dizionario di query o payload del corpo a seconda del client). Se non hai esigenze di filtraggio aggiuntive, puoi ometterlo o passare un oggetto vuoto. ^[1]

Passaggio 4. Esegui la chiamata in Python (helper opzionale).

Se stai utilizzando un wrapper Python per l'API di Zoho Desk, la firma del metodo è la seguente:

def op_13_delete_during_actions_transition(self, ticketId: str, transitionId: str, p: dict = None):
    return self.c.request("DELETE", f"/api/v1/tickets/{ticketId}/transitions/{transitionId}/duringActions", p, None)

Chiamalo passando ticketId e transitionId come stringhe. L'argomento p è opzionale e ha come valore predefinito None. ^[1]

Passaggio 5. Verifica la risposta.

Un'eliminazione riuscita restituirà una risposta HTTP 200 o 204 senza corpo di errore. Se la risposta contiene una chiave "error", la bozza non è stata rimossa — verifica che entrambi gli ID siano corretti e che il tuo token OAuth disponga delle autorizzazioni necessarie per i blueprint di Desk. ^[1]

---

Errori comuni

• ID errati: Passare un ticketId che non corrisponde al ticket proprietario della transizione comporterà un errore 404 o un errore di autorizzazione. Conferma sempre che entrambi gli ID appartengano alla stessa coppia ticket-transizione prima di chiamare l'endpoint. ^[1]
• Token OAuth scaduti: L'API di Zoho Desk richiede un token bearer OAuth 2.0 valido con scope per la gestione di blueprint/transizioni. Un token scaduto o con scope insufficiente causerà il fallimento silenzioso della DELETE o restituirà un errore di autenticazione. ^[1]
• Eliminazione di una non-bozza: Questa operazione ha come target una configurazione di azioni durante la transizione in stato *bozza*. Se la transizione è già stata pubblicata, l'endpoint potrebbe non comportarsi come previsto — verifica prima che la transizione sia ancora in stato di bozza. ^[1]

---

Cosa verificare

• Conferma che la transizione non abbia più azioni durante la transizione collegate recuperando il record della transizione dopo l'eliminazione e verificando che l'elenco delle azioni durante la transizione sia vuoto o assente.
• Verifica che le tue credenziali API abbiano lo scope corretto per le operazioni sui blueprint di Zoho Desk, in particolare se ricevi una risposta 401 o 403.
• Valida entrambi i parametri del percorso (ticketId e transitionId) come valori stringa accurati estratti dal tuo ambiente Zoho Desk prima di riprovare. ^[1]

---

*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non rappresenta il supporto ufficiale Zoho. Testa sempre le modifiche API in un ambiente sandbox o di staging prima di applicarle alla produzione.*