Come svuotare le attività spam in Zoho Desk

Lo svuotamento delle attività spam in Zoho Desk avviene tramite un endpoint API dedicato che elimina definitivamente tutte le attività presenti nella cartella spam con una singola chiamata.

Perché è importante

Nel tempo, Zoho Desk può accumulare un gran numero di attività spam che ingombrano l'area di lavoro e consumano spazio di archiviazione. Invece di eliminare gli elementi uno per uno, l'operazione "svuota spam" consente di cancellare l'intera coda delle attività spam in una volta sola. Questo è particolarmente utile durante le operazioni periodiche di manutenzione o quando si migrano dati tra ambienti diversi. Tieni presente che questo è Beam Help — supporto esperto indipendente per Zoho, non il supporto ufficiale di Zoho.

---

Procedura passo dopo passo

Passaggio 1. Verifica che il tuo token OAuth includa lo scope corretto per le attività di Zoho Desk prima di effettuare qualsiasi chiamata distruttiva. L'applicazione connessa deve includere Desk.tasks.DELETE (o il più ampio Desk.tasks.ALL) negli scope autorizzati — senza questo, l'API rifiuterà la richiesta con un errore di autorizzazione. ^[3]

Passaggio 2. Decidi quale operazione ti serve effettivamente. Esistono due endpoint correlati ma distinti per le attività spam:

• Svuota attività spam — elimina definitivamente tutto ciò che si trova nella cartella spam: DELETE /api/v1/tasks/spam/empty ^[1]
• Elimina attività spam — rimuove specifiche attività spam (utile quando si desidera un controllo più preciso): DELETE /api/v1/tasks/spam ^[2]

Per un'eliminazione completa della cartella spam, è necessaria la variante /empty.

Passaggio 3. Invia la richiesta DELETE all'endpoint di svuotamento spam. Usando Python come esempio, la chiamata si presenta così:

# Assuming `api` is your initialised ZohoDeskApi client
response = api.delete_empty_spam_tasks()

Il metodo accetta un dizionario di parametri opzionale p nel caso in cui sia necessario passare parametri di query, ma per un'eliminazione semplice non sono richiesti parametri aggiuntivi. ^[1]

Passaggio 4. Controlla lo stato della risposta HTTP. Un'eliminazione riuscita restituirà un codice di stato 2xx. Se ricevi un errore 4xx, rivedi i tuoi scope OAuth (Passaggio 1) e verifica che il token di connessione non sia scaduto — in tal caso, aggiornalo prima di riprovare. ^[3]

Passaggio 5. Se il tuo flusso di lavoro coinvolge anche *attività*, *eventi* o *chiamate* spam, tieni presente che esistono endpoint separati per ciascuno di questi tipi di risorse. Lo svuotamento delle attività spam non cancella automaticamente quelle code:

• Attività spam: DELETE /api/v1/activities/spam ^[5]
• Eventi spam: DELETE /api/v1/events/emptySpam ^[6]
• Chiamate spam: DELETE /api/v1/calls/emptySpam ^[4]

Esegui ciascuna chiamata pertinente in modo indipendente se hai bisogno di una pulizia completa.

---

Errori comuni

• Scope insufficiente — Il problema più frequente è la mancanza dello scope Desk.tasks.DELETE o Desk.tasks.ALL nel token OAuth. Verifica sempre che il tuo elenco di scope includa i permessi di eliminazione a livello di attività prima di chiamare endpoint distruttivi. ^[3]

• Confusione tra i due endpoint per le attività spam — DELETE /api/v1/tasks/spam e DELETE /api/v1/tasks/spam/empty non sono la stessa operazione. Il primo agisce su specifici record di attività spam; il secondo svuota l'intera cartella spam. Chiamare quello sbagliato potrebbe lasciare elementi spam residui o eliminare più del previsto. ^[1][2]

• Token di accesso scaduto — Le chiamate distruttive DELETE falliranno silenziosamente o restituiranno errori di autenticazione se il token ha superato il suo tempo di scadenza. Assicurati che la tua integrazione aggiorni il token prima di effettuare la richiesta. ^[3]

• Irreversibilità — Lo svuotamento dello spam è permanente. Non esiste un cestino né la possibilità di annullare questa operazione. Conferma sempre di stare puntando all'ID organizzazione corretto prima di eseguire la chiamata, in particolare in configurazioni multi-organizzazione. ^[1]

---

Cosa verificare

• Verifica dello scope — Conferma che Desk.tasks.DELETE o Desk.tasks.ALL sia presente nell'elenco degli scope del token OAuth attivo per la tua connessione a Zoho Desk. ^[3]
• Endpoint corretto utilizzato — Verifica di aver chiamato DELETE /api/v1/tasks/spam/empty (e non /api/v1/tasks/spam) se il tuo obiettivo era svuotare l'intera cartella spam. ^[1][2]
• Stato della risposta — Assicurati che l'API abbia restituito uno stato 2xx; in caso contrario, esamina il corpo dell'errore per problemi di scope o autenticazione prima di riprovare. ^[3]