La suppression d'un brouillon de transition « pendant les actions » dans Zoho Desk nécessite un seul appel DELETE authentifié à l'API des transitions, ciblant le ticket et la transition spécifiques que vous souhaitez supprimer.
Pourquoi c'est important
La fonctionnalité blueprint de Zoho Desk vous permet de définir des actions qui se déclenchent *pendant* une transition entre états. Lorsque vous itérez sur la conception d'un blueprint, vous pouvez créer des brouillons d'actions en cours qui doivent être supprimés avant la publication. Connaître le bon endpoint API et les paramètres requis vous permet de nettoyer les brouillons obsolètes par programmation plutôt que de les rechercher dans l'interface. C'est particulièrement utile pour gérer des blueprints à grande échelle ou automatiser la configuration de Desk via des scripts.
---
Étape par étape
Étape 1. Rassemblez vos identifiants requis.
Avant d'effectuer l'appel, vous avez besoin de deux informations : le ticketId du ticket dont vous modifiez la transition blueprint, et le transitionId qui identifie la transition spécifique contenant le brouillon d'actions en cours que vous souhaitez supprimer. Les deux sont des valeurs de type chaîne. [1]
Étape 2. Construisez la requête DELETE.
Envoyez une requête HTTP DELETE vers l'endpoint suivant, en substituant vos valeurs réelles aux paramètres de chemin :
DELETE /api/v1/tickets/{ticketId}/transitions/{transitionId}/duringActionsRemplacez {ticketId} par l'ID de votre ticket et {transitionId} par l'ID de la transition. [1]
Étape 3. Incluez les paramètres de requête optionnels.
L'endpoint accepte également un paramètre optionnel p (transmis sous forme de dictionnaire de requête ou de charge utile selon votre client). Si vous n'avez pas de besoins de filtrage supplémentaires, vous pouvez l'omettre ou passer un objet vide. [1]
Étape 4. Exécutez l'appel en Python (assistant optionnel).
Si vous utilisez un wrapper Python pour l'API Zoho Desk, la signature de la méthode ressemble à ceci :
def op_13_delete_during_actions_transition(self, ticketId: str, transitionId: str, p: dict = None):
return self.c.request("DELETE", f"/api/v1/tickets/{ticketId}/transitions/{transitionId}/duringActions", p, None)Appellez-la en passant votre ticketId et votre transitionId sous forme de chaînes. L'argument p est optionnel et vaut None par défaut. [1]
Étape 5. Vérifiez la réponse.
Une suppression réussie renverra une réponse HTTP 200 ou 204 sans corps d'erreur. Si la réponse contient une clé "error", le brouillon n'a pas été supprimé — vérifiez que les deux identifiants sont corrects et que votre jeton OAuth dispose des permissions blueprint Desk nécessaires. [1]
---
Erreurs courantes
- Identifiants incorrects : Passer un
ticketIdqui ne correspond pas au ticket propriétaire de la transition entraînera une erreur 404 ou une erreur de permission. Confirmez toujours que les deux identifiants appartiennent à la même paire ticket-transition avant d'appeler l'endpoint. [1] - Jetons OAuth expirés : L'API Zoho Desk requiert un jeton bearer OAuth 2.0 valide, limité à la gestion des blueprints/transitions. Un jeton expiré ou aux droits insuffisants entraînera l'échec silencieux du DELETE ou le renvoi d'une erreur d'authentification. [1]
- Suppression d'un élément non-brouillon : Cette opération cible une configuration d'actions en cours à l'état de *brouillon*. Si la transition a déjà été publiée, l'endpoint peut ne pas se comporter comme prévu — confirmez d'abord que la transition est toujours à l'état de brouillon. [1]
---
Ce qu'il faut vérifier
- Confirmez que la transition ne contient plus d'actions en cours attachées en récupérant l'enregistrement de la transition après la suppression et en vérifiant que la liste des actions en cours est vide ou absente.
- Vérifiez que vos identifiants API sont correctement limités aux opérations blueprint de Zoho Desk, notamment si vous recevez une réponse
401ou403. - Validez les deux paramètres de chemin (
ticketIdettransitionId) en vous assurant qu'il s'agit de valeurs de chaîne exactes extraites de votre environnement Zoho Desk avant de réessayer. [1]
---
*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 modifications d'API dans un environnement sandbox ou de préproduction avant de les appliquer en production.*