L'eliminazione dei ticket spam in Zoho Desk può essere eseguita in modo programmatico tramite l'API REST di Zoho Desk utilizzando una singola richiesta DELETE rivolta all'endpoint dei ticket spam.
Perché è importante
Le code di supporto possono accumularsi rapidamente di ticket spam, intasando le visualizzazioni degli agenti e distorcendo le metriche di reportistica. Invece di esaminare e rimuovere manualmente ciascuno di essi, l'API di Zoho Desk consente di eliminare in blocco tutti i ticket spam con una sola chiamata. Questo è particolarmente utile per i team che eseguono script di manutenzione automatizzata o che sviluppano strumenti di amministrazione su Zoho Desk.
Procedura passo dopo passo
Passaggio 1. Assicurati che il tuo token OAuth includa gli scope corretti di Zoho Desk prima di effettuare qualsiasi chiamata API. Come minimo, il token deve contenere Desk.tickets.ALL o Desk.tickets.DELETE per autorizzare le operazioni distruttive sui record dei ticket. [2]
Passaggio 2. Verifica che la tua integrazione o il tuo script sia stato autenticato tramite il flusso OAuth di Zoho Desk e che sia disponibile un token di accesso valido. Senza un token con gli scope appropriati, l'API rifiuterà la richiesta con un errore di autorizzazione. [2]
Passaggio 3. Invia una richiesta DELETE all'endpoint dei ticket spam:
DELETE /api/v1/tickets/spamQuesta singola chiamata istruisce Zoho Desk a rimuovere in modo permanente tutti i ticket attualmente presenti nella coda spam. [1]
Passaggio 4. Se stai utilizzando un client wrapper basato su Python, la chiamata al metodo equivalente è la seguente:
delete_spam_tickets(p=None)Il parametro opzionale p accetta un dizionario di parametri di query aggiuntivi se la tua integrazione lo richiede; passare None attiva il comportamento predefinito di eliminazione in blocco. [1]
Passaggio 5. Se la tua routine di pulizia deve rimuovere lo spam anche da altri tipi di record, tieni presente che esistono endpoint equivalenti per le entità correlate. I contatti spam possono essere eliminati tramite DELETE /api/v1/contacts/spam [7], i task spam tramite DELETE /api/v1/tasks/spam [6], e gli eventi spam tramite DELETE /api/v1/events/spam. [4] Eseguendo questi in sequenza ottieni una pulizia completa dello spam nell'intero modello dati di Zoho Desk.
Errori comuni
- Token mancante o con scope insufficienti. Se il tuo client OAuth è stato registrato solo con
Desk.tickets.READ, la chiamata DELETE fallirà. Verifica cheDesk.tickets.DELETEoDesk.tickets.ALLsia presente nella stringa degli scope. [2] - Confusione tra spam dei ticket e spam di contatti o task. Ogni tipo di entità ha il proprio endpoint spam dedicato. La chiamata a
/api/v1/tickets/spamnon eliminerà i contatti o i task spam — questi richiedono chiamate DELETE separate. [1][6][7] - Azione irreversibile. Una DELETE all'endpoint spam è permanente. Non è prevista alcuna operazione di annullamento o cestino nella specifica API, quindi assicurati che i ticket siano stati correttamente classificati come spam prima di eseguire la chiamata. [1]
Cosa verificare
- Verifica che il token di accesso OAuth in uso includa
Desk.tickets.DELETEoDesk.tickets.ALLnegli scope concessi. [2] - Conferma che il codice di risposta HTTP restituito da
DELETE /api/v1/tickets/spamindichi il successo prima di considerare l'operazione completata. [1] - Se gestisci anche contatti, task o eventi, controlla le relative code spam utilizzando i loro endpoint DELETE dedicati per garantire una pulizia completa. [4][6][7]
---
*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non rappresenta il supporto ufficiale di Zoho. Testa sempre le operazioni API distruttive in un ambiente sandbox prima di eseguirle sui dati di produzione.*