Come eliminare un modello di ticket in Zoho Desk

L'eliminazione di un modello di ticket in Zoho Desk avviene tramite una singola chiamata API autenticata che rimuove definitivamente il modello tramite il suo identificatore univoco.

Perché è importante

I modelli di ticket aiutano gli agenti a precompilare i campi più comuni, ma modelli obsoleti o duplicati possono rendere l'interfaccia disordinata e creare confusione nel team di supporto. Sapere come rimuovere correttamente un modello tramite l'API di Zoho Desk consente agli amministratori di mantenere l'area di lavoro in ordine senza ricorrere a soluzioni manuali. Questo è particolarmente utile quando si gestiscono i modelli in modo programmatico su più reparti o durante un audit della configurazione di Desk.

Procedura passo dopo passo

Passaggio 1. Verifica di avere gli scope OAuth corretti autorizzati per la tua integrazione Zoho Desk. Come minimo, il token deve includere Desk.settings.DELETE (e idealmente Desk.settings.ALL) per eseguire operazioni distruttive su risorse a livello di impostazioni, come i modelli di ticket. ^[2]

Passaggio 2. Recupera il templateId del modello che desideri rimuovere. Puoi ottenerlo elencando i tuoi modelli di ticket tramite l'API di Zoho Desk e annotando l'identificatore univoco restituito per il modello di destinazione. Tieni questo valore a portata di mano — è richiesto nel percorso della richiesta. ^[1]

Passaggio 3. Invia una richiesta DELETE all'endpoint dei modelli di ticket, sostituendo l'identificatore del tuo modello nel percorso:

DELETE /api/v1/ticketTemplates/{templateId}

Questa chiamata accetta il templateId come parametro di percorso. Non è richiesto alcun corpo della richiesta. ^[1]

Passaggio 4. Se stai lavorando in Python, la chiamata segue questo schema:

def delete_ticket_template(self, templateId: str, p: dict = None):
    return self.c.request("DELETE", f"/api/v1/ticketTemplates/{templateId}", p, None)

Passa l'ID del modello come templateId. Il parametro opzionale p può contenere eventuali parametri di query aggiuntivi richiesti dal tuo ambiente. ^[1]

Passaggio 5. Controlla il codice di risposta HTTP. Un'eliminazione riuscita restituirà uno stato 2xx. Qualsiasi risposta 4xx indica in genere un templateId non valido o permessi OAuth insufficienti — rivedi i Passaggi 1 e 2 se ciò si verifica. ^[1]

> Nota: Se hai bisogno solo di modificare un modello anziché rimuoverlo completamente, usa invece PATCH /api/v1/ticketTemplates/{templateId}, che accetta un payload data con i campi che desideri aggiornare. ^[7]

Errori comuni

• Scope errato concesso. L'errore più frequente è l'autenticazione con un token privo di Desk.settings.DELETE. Verifica che la tua configurazione OAuth includa esplicitamente lo scope DELETE a livello di impostazioni, non solo Desk.tickets.DELETE, che riguarda i record dei ticket e non gli oggetti di configurazione. ^[2]
• templateId non aggiornato o errato. Gli ID dei modelli non sono nomi leggibili dall'utente. Passare un nome visualizzato o un ID ticket al posto dell'identificatore effettivo del modello produrrà un errore 404 o simile. Risolvi sempre l'ID in modo programmatico prima di chiamare l'endpoint di eliminazione. ^[1]
• Confusione tra l'eliminazione del modello e altre operazioni DELETE. Zoho Desk espone diversi endpoint DELETE — per allegati, tag e bozze di transizione — che condividono una struttura simile. Assicurati di puntare a /api/v1/ticketTemplates/{templateId} e non a un endpoint per allegati o tag. ^[3][5][6][8]

Cosa verificare

• Verifica dello scope: Conferma che il tuo token OAuth attivo includa Desk.settings.DELETE o Desk.settings.ALL prima di effettuare la chiamata. ^[2]
• Accuratezza dell'ID modello: Convalida il templateId recuperando prima l'elenco dei modelli e individuando il record corretto. ^[1]
• Stato della risposta: Dopo la chiamata DELETE, verifica che venga restituita una risposta 2xx e che il modello non compaia più quando elenchi i modelli di ticket. ^[1]

---

*Beam Help fornisce supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale Zoho. Testa sempre le operazioni API distruttive in un ambiente sandbox o di staging prima di eseguirle sulla tua istanza di produzione di Zoho Desk.*