Comment supprimer des tâches dans Zoho Desk

La suppression de tâches dans Zoho Desk s'effectue via le point de terminaison API dédié aux tâches, qui accepte une requête DELETE et nécessite l'autorisation des scopes OAuth appropriés. Chez Beam Help — support expert indépendant pour Zoho (et non le support officiel de Zoho) — nous vous guidons pas à pas à travers tout ce dont vous avez besoin.

Pourquoi c'est important

Les tâches dans Zoho Desk sont des éléments de travail urgents associés à des tickets ou à des contacts. Au fil du temps, les tâches en double ou obsolètes peuvent encombrer les vues des agents et fausser les rapports. Savoir comment les supprimer par programmation — ou vérifier que les bonnes autorisations sont en place — permet de garder les données de votre helpdesk propres et votre équipe concentrée.

Étape par étape

Étape 1. Vérifiez que vos scopes OAuth incluent la suppression de tâches.

Avant qu'un appel DELETE puisse aboutir, votre application Zoho Desk connectée doit être autorisée avec les scopes appropriés. Le scope dont vous avez besoin est Desk.tasks.DELETE, et pour une gestion complète des tâches, vous devez également inclure Desk.tasks.ALL, Desk.tasks.READ, Desk.tasks.WRITE, Desk.tasks.CREATE et Desk.tasks.UPDATE. ^[1]

Vérifiez votre fichier de configuration OAuth (ou les paramètres de votre client API Zoho dans la console développeur) et assurez-vous que ces scopes sont présents dans la chaîne de scopes séparés par des virgules transmise lors de l'autorisation. Si le scope est manquant, réautorisez la connexion après l'avoir ajouté — les tokens existants n'obtiendront pas automatiquement de nouvelles autorisations. ^[1]

Étape 2. Identifiez la ou les tâches que vous souhaitez supprimer.

Avant d'émettre un appel destructif, récupérez les identifiants des tâches que vous souhaitez supprimer. Utilisez une opération de lecture (avec le scope Desk.tasks.READ) pour lister ou rechercher des tâches, et notez les identifiants concernés. Cela évite la suppression accidentelle de mauvais enregistrements. ^[1]

Étape 3. Appelez le point de terminaison de suppression des tâches.

Envoyez une requête DELETE vers /api/v1/tasks, en transmettant les paramètres de vos tâches dans le corps de la requête. Le nom de l'opération est delete_tasks, et elle accepte un dictionnaire de paramètres (p) qui identifie les tâches à cibler. ^[2]

DELETE /api/v1/tasks

En Python, en utilisant le wrapper client Zoho Desk, l'appel ressemble à ceci : ^[2]

result = desk_api.delete_tasks(p={"taskId": "<your-task-id>"})

Remplacez <your-task-id> par l'identifiant réel récupéré à l'étape 2.

Étape 4. Gérez la réponse.

Une suppression réussie renverra une confirmation de l'API Zoho Desk. Si la réponse contient une clé error, examinez le message — les causes courantes incluent un identifiant de tâche invalide, un scope insuffisant ou un token d'accès expiré. Si votre token a expiré, actualisez-le avant de réessayer. ^[5]

Étape 5. Vérifiez la suppression.

Une fois l'appel terminé, effectuez une requête de lecture de suivi pour le même identifiant de tâche afin de confirmer qu'il n'existe plus. S'il apparaît toujours, vérifiez si le scope DELETE était actif sur le token utilisé pour cette requête spécifique. ^[1]

Erreurs courantes

• Scope Desk.tasks.DELETE manquant. C'est la cause la plus fréquente des suppressions échouées. Le scope doit être explicitement listé — avoir uniquement Desk.tasks.READ ou Desk.tasks.WRITE n'est pas suffisant. ^[1]

• Tokens d'accès expirés. Si votre token a dépassé sa durée de validité, l'API rejettera la requête. Votre intégration doit vérifier l'horodatage d'expiration du token et l'actualiser avant d'effectuer des appels destructifs. ^[7]

• Considérer delete_tasks comme une opération à faible risque. Dans les suites de tests automatisés et la logique de routage, la suppression de tâches est classifiée comme un niveau d'autorisation destructive, ce qui signifie qu'elle nécessite un consentement explicite au-delà des autorisations standard read ou write. Assurez-vous que votre workflow ou votre automatisation a reçu une autorisation de niveau destructif avant de l'exécuter. ^[6]

• Envoi d'une structure de paramètres incorrecte. La fonction delete_tasks transmet les paramètres directement à l'API sous forme de dictionnaire. Un payload mal formé (par exemple, une clé d'identifiant de tâche manquante) entraînera une erreur ou une opération groupée non souhaitée. Validez toujours votre dictionnaire p avant d'appeler la fonction. ^[2]

Ce qu'il faut vérifier

• Liste des scopes : Confirmez que Desk.tasks.DELETE (ou Desk.tasks.ALL) apparaît dans la chaîne de scopes de votre token OAuth actif avant d'effectuer l'appel. ^[1]
• Validité de l'identifiant de tâche : Vérifiez que l'identifiant de tâche existe et appartient à votre organisation en le lisant au préalable — tenter de supprimer un identifiant inexistant renverra une erreur. ^[2]
• Fraîcheur du token : Vérifiez que votre token d'accès n'a pas expiré ; actualisez-le si l'horodatage d'expiration est dépassé avant d'émettre la requête DELETE. ^[7]