L'eliminazione di un tag in Zoho Desk può essere eseguita a due livelli: rimuovere un tag da un ticket specifico oppure eliminare definitivamente il tag dal tuo portale tramite API.
Perché è importante
I tag in Zoho Desk aiutano a categorizzare e filtrare i ticket di supporto, ma nel tempo la libreria dei tag può diventare disordinata con etichette obsolete o duplicate. Sapere come rimuovere un tag da un singolo ticket — rispetto all'eliminazione completa del tag dal sistema — mantiene il tuo spazio di lavoro ordinato e i tuoi report accurati. Questo è particolarmente rilevante per i team che gestiscono grandi volumi di ticket o che eseguono flussi di lavoro automatizzati che dipendono da una taggatura coerente.
Procedura passo dopo passo
Passaggio 1. Decidi quale operazione ti serve.
Tramite l'API di Zoho Desk sono disponibili due azioni distinte. La prima rimuove l'associazione di un tag da un ticket senza eliminare il tag a livello globale. La seconda rimuove definitivamente il tag dal tuo portale. Scegli l'endpoint corretto prima di procedere per evitare perdite di dati indesiderate. [1][2]
Passaggio 2. Raccogli gli identificatori necessari.
Per entrambe le operazioni avrai bisogno del tagId del tag su cui vuoi agire. Se stai rimuovendo un tag da un ticket specifico, avrai bisogno anche del ticketId di quel ticket. Puoi recuperare questi ID interrogando i tuoi tag o ticket tramite l'API di Zoho Desk prima di effettuare qualsiasi chiamata distruttiva. [1][2]
Passaggio 3. Per rimuovere un tag da un singolo ticket, chiama l'endpoint di rimozione tag dal ticket.
Invia una richiesta DELETE a /api/v1/tickets/{ticketId}/tags/{tagId}, sostituendo gli identificatori reali del ticket e del tag. Questo scollega il tag solo da quel ticket — il tag continua a esistere nel tuo portale e può ancora essere applicato altrove. [2]
DELETE /api/v1/tickets/{ticketId}/tags/{tagId}In Python, la chiamata equivalente è:
desk_api.remove_tags_from_ticket(ticketId="12345", tagId="67890")Passaggio 4. Per eliminare definitivamente un tag dal portale, chiama l'endpoint di eliminazione tag.
Invia una richiesta DELETE a /api/v1/tags/{tagId} con il tagId pertinente. Questa operazione rimuove il tag completamente da Zoho Desk — non apparirà più in nessun ticket, filtro o report. [1]
DELETE /api/v1/tags/{tagId}In Python:
desk_api.delete_tag(tagId="67890")Passaggio 5. Verifica che i tuoi scope OAuth includano le autorizzazioni necessarie.
Entrambe le operazioni richiedono che il tuo token OAuth di Zoho Desk includa lo scope appropriato. Lo scope Desk.settings.DELETE copre l'eliminazione dei tag a livello di portale, mentre Desk.tickets.DELETE copre la rimozione dei tag a livello di ticket. Se il tuo token non dispone di uno dei due scope, l'API restituirà un errore di autenticazione o autorizzazione. [4]
Passaggio 6. Gestisci la risposta dell'API.
Un'eliminazione riuscita restituirà una risposta HTTP 200 o 204 senza corpo o con un payload di conferma minimo. Se ricevi uno stato 401, le tue credenziali OAuth devono essere aggiornate o riconnesse. Qualsiasi messaggio di errore che fa riferimento a un ID non valido significa che il tagId o il ticketId fornito non esiste nel tuo portale. [6]
Errori comuni
- Confondere i due endpoint. Usare l'eliminazione a livello di portale (
/api/v1/tags/{tagId}) quando intendevi solo scollegare un tag da un ticket rimuoverà definitivamente quel tag ovunque. Verifica sempre quale endpoint stai chiamando. [1][2] - Scope OAuth mancanti. Se la tua integrazione è stata configurata senza
Desk.settings.DELETEoDesk.tickets.DELETE, l'API rifiuterà la richiesta. Controlla la configurazione degli scope e ri-autorizza se necessario. [4] - ID non validi o obsoleti. Gli ID di tag e ticket possono cambiare o essere rimossi da altri processi. Recupera gli ID aggiornati immediatamente prima dell'eliminazione anziché affidarti a valori memorizzati nella cache. [1][2]
- Errori di autenticazione. Una risposta
401significa che il token è scaduto o che la connessione deve essere ristabilita — non si tratta di un problema con l'ID del tag. [6]
Cosa verificare
- Verifica che il
tagIdche stai passando esista effettivamente nel tuo portale Zoho Desk prima di chiamare uno dei due endpoint di eliminazione. [1] - Conferma che il tuo token OAuth includa
Desk.settings.DELETE(per l'eliminazione a livello di portale) oDesk.tickets.DELETE(per la rimozione a livello di ticket) nei suoi scope attivi. [4] - Al termine della chiamata, interroga il ticket o l'elenco dei tag pertinente per confermare che il tag non appaia più come previsto. [2]
---
*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 prima di eseguirle sui dati di produzione.*