Comment supprimer les tâches spam dans Zoho Desk

La suppression des tâches spam dans Zoho Desk via l'API nécessite l'envoi d'une requête DELETE vers l'un des deux endpoints dédiés — l'un pour supprimer des tâches spam spécifiques, l'autre pour vider entièrement la file d'attente spam.

Pourquoi c'est important

Si votre instance Zoho Desk accumule des tâches spam au fil du temps, les laisser en place encombre les vues de charge de travail de vos agents et peut nuire à la précision des rapports. Automatiser le nettoyage via l'API vous permet de planifier des purges régulières sans intervention manuelle. Cela est particulièrement utile pour les opérations de support à fort volume où les tâches spam s'accumulent rapidement.

Étape par étape

Étape 1. Vérifiez que votre token OAuth inclut le scope de tâche correct avant d'effectuer tout appel. Votre application connectée doit être autorisée avec au minimum Desk.tasks.DELETE — ou le scope plus large Desk.tasks.ALL — dans le cadre de ses scopes OAuth Zoho Desk. Sans cette permission, l'API rejettera la requête. ^[3]

Étape 2. Pour supprimer des tâches spam spécifiques, envoyez une requête DELETE vers l'endpoint /api/v1/tasks/spam. Transmettez les critères de filtre ou de sélection requis en tant que paramètres de requête dans le dictionnaire p. Cette opération cible directement les tâches spam et les supprime du système. ^[1]

DELETE /api/v1/tasks/spam

En Python, l'appel ressemble à ceci :

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

Étape 3. Si votre objectif est de vider entièrement la file de tâches spam en une seule action — essentiellement une opération « vider la corbeille » — utilisez plutôt l'endpoint /api/v1/tasks/spam/empty. Il s'agit d'une purge plus agressive qui efface tout ce qui se trouve actuellement dans le spam. ^[2]

DELETE /api/v1/tasks/spam/empty

En Python :

result = desk_api.delete_empty_spam_tasks()

Étape 4. Vérifiez la réponse de l'un ou l'autre appel. Une suppression réussie renverra un statut HTTP de succès approprié. Si vous recevez une erreur, vérifiez que votre token d'accès est toujours valide et n'a pas expiré — si c'est le cas, actualisez-le avant de réessayer. ^[8]

Étape 5. Notez que Zoho Desk expose également des endpoints de suppression de spam similaires pour d'autres types d'enregistrements. Si vous devez nettoyer le spam de manière globale, vous pouvez également appeler DELETE /api/v1/activities/spam pour les activités ^[4], DELETE /api/v1/contacts/spam pour les contacts ^[5], et DELETE /api/v1/events/spam pour les événements ^[7]. Les exécuter en séquence vous offre une purge complète du spam sur tous les types d'enregistrements principaux.

Erreurs courantes

• Scope OAuth insuffisant. L'échec le plus fréquent est un scope manquant ou incorrect. Assurez-vous que Desk.tasks.DELETE ou Desk.tasks.ALL est explicitement inclus dans vos scopes Zoho Desk configurés — il est facile de l'oublier lors de la copie des chaînes de scope. ^[3]
• Confusion entre les deux endpoints de spam de tâches. L'endpoint /api/v1/tasks/spam supprime les tâches spam (suppression ciblée), tandis que /api/v1/tasks/spam/empty vide entièrement le dossier spam. Appeler le mauvais peut produire des résultats inattendus — par exemple, tout vider alors que vous ne souhaitiez qu'un nettoyage partiel. [^1, ^2]
• Tokens d'accès expirés. Les opérations DELETE échoueront silencieusement ou renverront des erreurs d'authentification si le token a expiré. Vérifiez toujours l'expiration du token avant d'exécuter des appels destructifs et actualisez-le si nécessaire. ^[8]
• Classification du risque des opérations destructives. Dans les configurations automatisées ou multi-environnements, la suppression du spam est traitée comme une opération destructive. Assurez-vous que votre intégration ou votre exécuteur de tests est configuré pour autoriser les actions destructives avant d'exécuter ces appels en production. ^[6]

Ce qu'il faut vérifier

• Confirmation du scope : Vérifiez que Desk.tasks.DELETE (ou Desk.tasks.ALL) apparaît dans votre liste de scopes OAuth actifs avant d'appeler l'un ou l'autre endpoint. ^[3]
• Sélection de l'endpoint : Vérifiez bien si vous avez besoin d'une suppression ciblée (/api/v1/tasks/spam) ou d'un vidage complet (/api/v1/tasks/spam/empty) — les deux opérations ne sont pas interchangeables. [^1, ^2]
• Validation de la réponse : Une fois l'appel terminé, confirmez que la réponse HTTP indique un succès ; sinon, inspectez le contenu de l'erreur pour détecter des problèmes de scope ou d'authentification avant de réessayer. ^[8]

---

*Beam Help fournit une assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Testez toujours les opérations API destructives dans une organisation sandbox avant de les exécuter sur des données de production.*