La suppression des tickets spam dans Zoho Desk peut être effectuée par programmation via l'API REST Zoho Desk en utilisant une seule requête DELETE ciblant l'endpoint des tickets spam.
Pourquoi c'est important
Les files d'attente de support peuvent accumuler rapidement des tickets spam, encombrant les vues des agents et faussant les métriques de reporting. Plutôt que de passer en revue et de supprimer chaque ticket manuellement, l'API Zoho Desk vous permet de supprimer en masse tous les tickets spam en un seul appel. Cela est particulièrement utile pour les équipes qui exécutent des scripts de maintenance automatisés ou qui développent des outils d'administration sur Zoho Desk.
Étape par étape
Étape 1. Assurez-vous que votre token OAuth inclut les scopes Zoho Desk appropriés avant d'effectuer tout appel API. Au minimum, votre token doit comporter Desk.tickets.ALL ou Desk.tickets.DELETE pour autoriser les opérations destructives sur les enregistrements de tickets. [2]
Étape 2. Confirmez que votre intégration ou votre script a été authentifié via le flux OAuth Zoho Desk et qu'un token d'accès valide est disponible. Sans un token correctement scopé, l'API rejettera la requête avec une erreur d'autorisation. [2]
Étape 3. Envoyez une requête DELETE vers l'endpoint des tickets spam :
DELETE /api/v1/tickets/spamCet unique appel demande à Zoho Desk de supprimer définitivement tous les tickets actuellement présents dans la file d'attente spam. [1]
Étape 4. Si vous utilisez un wrapper client basé sur Python, l'appel de méthode équivalent ressemble à ceci :
delete_spam_tickets(p=None)Le paramètre optionnel p accepte un dictionnaire de paramètres de requête supplémentaires si votre intégration en a besoin ; passer None déclenche le comportement de suppression en masse par défaut. [1]
Étape 5. Si votre routine de nettoyage doit également supprimer le spam d'autres types d'enregistrements, notez qu'il existe des endpoints équivalents pour les entités associées. Les contacts spam peuvent être supprimés via DELETE /api/v1/contacts/spam [7], les tâches spam via DELETE /api/v1/tasks/spam [6], et les événements spam via DELETE /api/v1/events/spam. [4] Exécuter ces appels en séquence vous permet d'effectuer une purge complète du spam sur l'ensemble du modèle de données Zoho Desk.
Erreurs courantes
- Token manquant ou avec des scopes insuffisants. Si votre client OAuth a été enregistré uniquement avec
Desk.tickets.READ, l'appel DELETE échouera. Vérifiez queDesk.tickets.DELETEouDesk.tickets.ALLest bien présent dans votre chaîne de scopes. [2] - Confusion entre le spam de tickets et le spam de contacts ou de tâches. Chaque type d'entité possède son propre endpoint spam dédié. Appeler
/api/v1/tickets/spamne supprimera pas les contacts ou les tâches spam — ceux-ci nécessitent leurs propres appels DELETE séparés. [1][6][7] - Action irréversible. Un DELETE vers l'endpoint spam est permanent. Aucune annulation ni corbeille n'est mentionnée dans la spécification de l'API ; assurez-vous donc que les tickets ont été correctement classés comme spam avant d'exécuter l'appel. [1]
Points à vérifier
- Vérifiez que le token d'accès OAuth utilisé inclut
Desk.tickets.DELETEouDesk.tickets.ALLdans ses scopes accordés. [2] - Confirmez que le code de réponse HTTP retourné par
DELETE /api/v1/tickets/spamindique un succès avant de supposer que l'opération s'est terminée. [1] - Si vous gérez également des contacts, des tâches ou des événements, vérifiez les files d'attente spam correspondantes en utilisant leurs propres endpoints DELETE pour garantir un nettoyage complet. [4][6][7]
---
*Beam Help est une ressource d'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 un environnement sandbox avant de les exécuter sur des données de production.*