Comment supprimer un commentaire dans Zoho Desk

La suppression d'un commentaire dans Zoho Desk via l'API est simple — vous émettez une requête DELETE vers le point de terminaison approprié, en fournissant l'ID de l'enregistrement parent et l'ID du commentaire. Beam Help est un support expert indépendant pour Zoho, et non le support officiel de Zoho.

Pourquoi c'est important

Les commentaires s'accumulent sur les tickets, les tâches, les appels, les contrats, les événements, les comptes et les contacts dans Zoho Desk. Que vous nettoyiez des données de test, supprimiez des informations sensibles publiées par erreur, ou automatisiez une politique de conservation des données, il est essentiel de connaître le bon point de terminaison pour chaque type d'enregistrement. Utiliser le mauvais point de terminaison entraîne une erreur 404 ou une erreur de permission qui peut être difficile à diagnostiquer sans une référence claire.

Étape par étape

Zoho Desk expose un point de terminaison de suppression de commentaire distinct pour chaque type d'enregistrement principal. Identifiez le type d'enregistrement qui contient le commentaire que vous souhaitez supprimer, puis suivez l'étape correspondante ci-dessous.

Étape 1. Rassemblez vos IDs.

Avant d'appeler un point de terminaison, vous avez besoin de deux valeurs : l'ID de l'enregistrement parent (ticket, tâche, appel, etc.) et l'ID du commentaire spécifique. Ces deux valeurs sont renvoyées par les points de terminaison de liste ou de récupération correspondants et sont de simples chaînes de caractères dans l'API de Zoho Desk.

Étape 2. Supprimer un commentaire sur un ticket.

Envoyez une requête DELETE vers /api/v1/tickets/{ticketid}/comments/{commentid}, en remplaçant {ticketid} par l'ID du ticket et {commentid} par l'ID du commentaire. Un appel réussi supprime définitivement le commentaire de ce ticket. ^[3]

Étape 3. Supprimer un commentaire sur une tâche.

Utilisez DELETE /api/v1/tasks/{taskId}/comments/{commentId} pour les commentaires associés aux enregistrements de tâches. Fournissez taskId et commentId comme paramètres de chemin. ^[1]

Étape 4. Supprimer un commentaire sur un appel.

Pour les commentaires au niveau des appels, le point de terminaison est DELETE /api/v1/calls/{callId}/comments/{commentId}. Passez l'ID de l'appel et l'ID du commentaire dans le chemin. ^[5]

Étape 5. Supprimer un commentaire sur un événement.

Les commentaires d'événements sont supprimés via DELETE /api/v1/events/{eventId}/comments/{commentId}, avec eventId et commentId comme paramètres de chemin. ^[6]

Étape 6. Supprimer un commentaire sur un contrat.

Pour supprimer un commentaire d'un enregistrement de contrat, appelez DELETE /api/v1/contracts/{contractId}/comments/{commentId}. ^[2]

Étape 7. Supprimer un commentaire sur un compte.

Les commentaires au niveau du compte utilisent DELETE /api/v1/accounts/{accountId}/comments/{commentId}, avec accountId et commentId dans le chemin. ^[4]

Étape 8. Supprimer un commentaire sur un contact.

Pour les enregistrements de contacts, le point de terminaison est DELETE /api/v1/contacts/{contactId}/comments/{commentId}. ^[8]

Étape 9. Vérifiez vos portées OAuth.

Tous les appels à l'API Zoho Desk nécessitent un token OAuth valide. Pour les opérations sur les tickets, le token doit inclure au minimum Desk.tickets.DELETE. Pour les tâches, les événements et les enregistrements liés aux paramètres, incluez respectivement Desk.tasks.DELETE, Desk.events.DELETE et Desk.settings.DELETE. Assurez-vous que votre client OAuth est configuré avec les portées correspondant aux types d'enregistrements que vous ciblez. ^[7]

Erreurs courantes

• Type d'enregistrement et point de terminaison non concordants. Chaque type d'enregistrement possède sa propre sous-ressource de commentaires. Envoyer l'ID d'un commentaire de ticket au point de terminaison /tasks/ renverra une erreur, car le commentaire n'existe pas sous ce parent. Faites toujours correspondre le point de terminaison au type d'enregistrement. ^[1][3]
• Portée OAuth manquante ou insuffisante. Si votre token a été généré sans la portée DELETE pour le type d'enregistrement concerné (par exemple, Desk.tickets.DELETE), l'API rejettera la requête avec une erreur d'autorisation. Régénérez le token en incluant les portées correctes. ^[7]
• Format d'ID incorrect. L'ID de l'enregistrement parent et l'ID du commentaire doivent tous deux être passés sous forme de chaînes de caractères dans le chemin. Passer un entier ou une valeur malformée entraînera l'échec de la requête. ^[3]

Ce qu'il faut vérifier

• Vérifiez que le commentId que vous ciblez appartient bien à l'ID d'enregistrement parent que vous utilisez dans le chemin — une discordance entraînera une erreur de type « non trouvé ». ^[3][1]
• Confirmez que votre token OAuth inclut la portée de permission DELETE pour le type d'enregistrement spécifique (tickets, tâches, événements, etc.) avant d'effectuer l'appel. ^[7]
• Après le retour réussi de l'appel DELETE, récupérez la liste des commentaires de l'enregistrement parent pour confirmer que le commentaire n'apparaît plus. ^[3]