Comment vider les tâches spam dans Zoho Desk

La suppression des tâches spam dans Zoho Desk s'effectue via un endpoint API dédié qui purge définitivement toutes les tâches présentes dans le dossier spam en un seul appel.

Pourquoi c'est important

Au fil du temps, Zoho Desk peut accumuler un grand nombre de tâches spam qui encombrent votre espace de travail et consomment du stockage. Plutôt que de supprimer les éléments un par un, l'opération « vider le spam » vous permet d'effacer l'intégralité de la file de tâches spam en une seule fois. Cela est particulièrement utile lors d'une maintenance périodique ou lors d'une migration de données entre environnements. Notez que ceci est Beam Help — support expert indépendant pour Zoho, et non le support officiel de Zoho.

---

Étape par étape

Étape 1. Vérifiez que votre token OAuth dispose du scope de tâches Zoho Desk approprié avant d'effectuer tout appel destructif. Votre application connectée doit inclure Desk.tasks.DELETE (ou le scope plus large Desk.tasks.ALL) dans ses scopes autorisés — sans cela, l'API rejettera la requête avec une erreur de permissions. ^[3]

Étape 2. Déterminez l'opération dont vous avez réellement besoin. Il existe deux endpoints distincts mais liés pour les tâches spam :

• Vider les tâches spam — supprime définitivement tout ce qui se trouve actuellement dans le dossier spam : DELETE /api/v1/tasks/spam/empty ^[1]
• Supprimer des tâches spam — supprime des tâches spam spécifiques (utile lorsque vous souhaitez un contrôle plus précis) : DELETE /api/v1/tasks/spam ^[2]

Pour une purge complète du dossier spam, utilisez la variante /empty.

Étape 3. Envoyez la requête DELETE vers l'endpoint de vidage du spam. En utilisant Python comme exemple, l'appel se présente ainsi :

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

La méthode accepte un dictionnaire de paramètres optionnel p si vous devez transmettre des paramètres de requête, mais pour une purge simple, aucun paramètre supplémentaire n'est nécessaire. ^[1]

Étape 4. Vérifiez le statut de la réponse HTTP. Une purge réussie retournera un code de statut 2xx. Si vous recevez une erreur 4xx, revérifiez vos scopes OAuth (Étape 1) et confirmez que le token de connexion n'a pas expiré — si c'est le cas, renouvelez-le avant de réessayer. ^[3]

Étape 5. Si votre flux de travail implique également des *activités*, des *événements* ou des *appels* spam, sachez qu'il existe des endpoints distincts pour chacun de ces types de ressources. Vider les tâches spam ne vide pas automatiquement ces files :

• Activités spam : DELETE /api/v1/activities/spam ^[5]
• Événements spam : DELETE /api/v1/events/emptySpam ^[6]
• Appels spam : DELETE /api/v1/calls/emptySpam ^[4]

Exécutez chaque appel concerné indépendamment si vous avez besoin d'une maintenance complète.

---

Erreurs courantes

• Scope insuffisant — L'échec le plus fréquent est l'absence du scope Desk.tasks.DELETE ou Desk.tasks.ALL sur le token OAuth. Vérifiez toujours que votre liste de scopes inclut les permissions de suppression au niveau des tâches avant d'appeler des endpoints destructifs. ^[3]

• Confusion entre les deux endpoints de tâches spam — DELETE /api/v1/tasks/spam et DELETE /api/v1/tasks/spam/empty ne correspondent pas à la même opération. Le premier cible des enregistrements de tâches spam spécifiques ; le second vide l'intégralité du dossier spam. Appeler le mauvais endpoint peut laisser des éléments spam résiduels ou en supprimer plus que prévu. ^[1][2]

• Token d'accès expiré — Les appels DELETE destructifs échoueront silencieusement ou retourneront des erreurs d'authentification si le token a dépassé sa durée de validité. Assurez-vous que votre intégration renouvelle le token avant d'effectuer la requête. ^[3]

• Irréversibilité — Le vidage du spam est permanent. Il n'existe pas de corbeille ni d'annulation pour cette opération. Confirmez toujours que vous ciblez le bon identifiant d'organisation avant d'exécuter l'appel, en particulier dans les configurations multi-organisations. ^[1]

---

Points à vérifier

• Vérification du scope — Confirmez que Desk.tasks.DELETE ou Desk.tasks.ALL apparaît dans la liste des scopes du token OAuth actif pour votre connexion Zoho Desk. ^[3]
• Endpoint correct utilisé — Vérifiez que vous avez appelé DELETE /api/v1/tasks/spam/empty (et non /api/v1/tasks/spam) si votre objectif était de purger l'intégralité du dossier spam. ^[1][2]
• Statut de la réponse — Assurez-vous que l'API a retourné un statut 2xx ; dans le cas contraire, inspectez le corps de l'erreur pour identifier des problèmes de scope ou d'authentification avant de réessayer. ^[3]