Come eliminare le attività spam in Zoho Desk

L'eliminazione delle attività spam in Zoho Desk tramite API richiede l'invio di una richiesta DELETE a uno dei due endpoint dedicati — uno per rimuovere attività spam specifiche e un altro per svuotare completamente la coda spam.

Perché è importante

Se la tua istanza di Zoho Desk accumula attività spam nel tempo, lasciarle in place ingombra le visualizzazioni del carico di lavoro degli agenti e può ridurre l'accuratezza dei report. Automatizzare la pulizia tramite API ti consente di pianificare eliminazioni regolari senza intervento manuale. Questo è particolarmente utile per le operazioni di supporto ad alto volume, dove le attività spam si accumulano rapidamente.

Procedura passo dopo passo

Passaggio 1. Verifica che il tuo token OAuth includa lo scope corretto per le attività prima di effettuare qualsiasi chiamata. L'app connessa deve essere autorizzata con almeno Desk.tasks.DELETE — o il più ampio Desk.tasks.ALL — come parte degli scope OAuth di Zoho Desk. Senza questa autorizzazione, l'API rifiuterà la richiesta. ^[3]

Passaggio 2. Per eliminare attività spam specifiche, invia una richiesta DELETE all'endpoint /api/v1/tasks/spam. Passa i criteri di filtro o selezione richiesti come parametri di query nel dizionario p. Questa operazione agisce direttamente sulle attività spam e le rimuove dal sistema. ^[1]

DELETE /api/v1/tasks/spam

In Python, la chiamata si presenta così:

result = desk_api.delete_spam_tasks(p={"param_key": "param_value"})

Passaggio 3. Se il tuo obiettivo è svuotare l'intera coda delle attività spam in un'unica operazione — essenzialmente un'operazione di "svuota cestino" — utilizza invece l'endpoint separato /api/v1/tasks/spam/empty. Si tratta di un'eliminazione più aggressiva che cancella tutto ciò che si trova attualmente nello spam. ^[2]

DELETE /api/v1/tasks/spam/empty

In Python:

result = desk_api.delete_empty_spam_tasks()

Passaggio 4. Verifica la risposta di entrambe le chiamate. Un'eliminazione riuscita restituirà un codice di stato HTTP di successo appropriato. Se ricevi un errore, controlla che il tuo token di accesso sia ancora valido e non sia scaduto — in caso contrario, aggiornalo prima di riprovare. ^[8]

Passaggio 5. Tieni presente che Zoho Desk espone endpoint di eliminazione spam simili anche per altri tipi di record. Se hai bisogno di ripulire lo spam in modo completo, puoi anche chiamare DELETE /api/v1/activities/spam per le attività ^[4], DELETE /api/v1/contacts/spam per i contatti ^[5] e DELETE /api/v1/events/spam per gli eventi ^[7]. Eseguirli in sequenza ti consente di effettuare una pulizia spam completa su tutti i principali tipi di record.

Errori comuni

• Scope OAuth insufficiente. L'errore più comune è uno scope mancante o errato. Assicurati che Desk.tasks.DELETE o Desk.tasks.ALL sia esplicitamente incluso negli scope di Zoho Desk configurati — è facile trascurarlo quando si copiano le stringhe degli scope. ^[3]
• Confusione tra i due endpoint spam per le attività. L'endpoint /api/v1/tasks/spam elimina le attività spam (rimozione mirata), mentre /api/v1/tasks/spam/empty svuota completamente la cartella spam. Chiamare quello sbagliato può produrre risultati inattesi — ad esempio, svuotare tutto quando si intendeva solo una pulizia parziale. [^1, ^2]
• Token di accesso scaduti. Le operazioni DELETE falliranno silenziosamente o restituiranno errori di autenticazione se il token è scaduto. Controlla sempre la scadenza del token prima di eseguire chiamate distruttive e aggiornalo se necessario. ^[8]
• Classificazione del rischio delle operazioni distruttive. In configurazioni automatizzate o multi-ambiente, l'eliminazione dello spam è trattata come un'operazione distruttiva. Assicurati che la tua integrazione o il tuo test runner sia configurato per consentire azioni distruttive prima di eseguire queste chiamate in produzione. ^[6]

Cosa verificare

• Conferma dello scope: Verifica che Desk.tasks.DELETE (o Desk.tasks.ALL) compaia nell'elenco degli scope OAuth attivi prima di chiamare uno dei due endpoint. ^[3]
• Selezione dell'endpoint: Controlla attentamente se hai bisogno di un'eliminazione mirata (/api/v1/tasks/spam) o di uno svuotamento completo (/api/v1/tasks/spam/empty) — le due operazioni non sono intercambiabili. [^1, ^2]
• Validazione della risposta: Dopo il completamento della chiamata, conferma che la risposta HTTP indichi il successo; in caso contrario, esamina il payload dell'errore per problemi di scope o autenticazione prima di riprovare. ^[8]

---

*Beam Help fornisce supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale Zoho. Testa sempre le operazioni API distruttive in un'organizzazione sandbox prima di eseguirle sui dati di produzione.*