Comment supprimer un modèle de ticket dans Zoho Desk

La suppression d'un modèle de ticket dans Zoho Desk s'effectue via un unique appel API authentifié qui supprime définitivement le modèle à partir de son identifiant unique.

Pourquoi c'est important

Les modèles de tickets aident les agents à pré-remplir les champs courants, mais des modèles obsolètes ou en double peuvent encombrer l'interface et semer la confusion au sein de votre équipe support. Savoir comment supprimer proprement un modèle via l'API Zoho Desk permet aux administrateurs de maintenir un espace de travail ordonné sans recourir à des solutions manuelles. Cela est particulièrement utile lors de la gestion programmatique des modèles dans plusieurs départements ou lors d'un audit de configuration de Desk.

Étape par étape

Étape 1. Vérifiez que vous disposez des scopes OAuth corrects autorisés pour votre intégration Zoho Desk. Au minimum, votre token doit inclure Desk.settings.DELETE (et idéalement Desk.settings.ALL) pour effectuer des opérations destructives sur les ressources de niveau paramètres, telles que les modèles de tickets. ^[2]

Étape 2. Récupérez le templateId du modèle que vous souhaitez supprimer. Vous pouvez l'obtenir en listant vos modèles de tickets via l'API Zoho Desk et en notant l'identifiant unique retourné pour le modèle cible. Conservez cette valeur à portée de main — elle est requise dans le chemin de la requête. ^[1]

Étape 3. Envoyez une requête DELETE vers l'endpoint des modèles de tickets, en substituant l'identifiant de votre modèle dans le chemin :

DELETE /api/v1/ticketTemplates/{templateId}

Cet appel prend le templateId comme paramètre de chemin. Aucun corps de requête n'est nécessaire. ^[1]

Étape 4. Si vous travaillez en Python, l'appel suit ce schéma :

def delete_ticket_template(self, templateId: str, p: dict = None):
    return self.c.request("DELETE", f"/api/v1/ticketTemplates/{templateId}", p, None)

Passez l'identifiant du modèle en tant que templateId. Le paramètre optionnel p peut transporter tout paramètre de requête supplémentaire requis par votre environnement. ^[1]

Étape 5. Vérifiez le code de réponse HTTP. Une suppression réussie retournera un statut 2xx. Toute réponse 4xx indique généralement soit un templateId invalide, soit des permissions OAuth insuffisantes — reprenez les étapes 1 et 2 si cela se produit. ^[1]

> Remarque : Si vous souhaitez uniquement modifier un modèle plutôt que de le supprimer entièrement, utilisez plutôt PATCH /api/v1/ticketTemplates/{templateId}, qui accepte un payload data contenant les champs que vous souhaitez mettre à jour. ^[7]

Erreurs courantes

• Scope incorrect accordé. L'échec le plus fréquent est l'authentification avec un token qui ne dispose pas de Desk.settings.DELETE. Vérifiez que votre configuration OAuth inclut explicitement le scope DELETE de niveau paramètres, et pas seulement Desk.tickets.DELETE, qui couvre les enregistrements de tickets plutôt que les objets de configuration. ^[2]
• templateId obsolète ou incorrect. Les identifiants de modèles ne sont pas des noms lisibles par l'humain. Passer un nom d'affichage ou un identifiant de ticket au lieu de l'identifiant réel du modèle entraînera une erreur 404 ou similaire. Résolvez toujours l'identifiant de manière programmatique avant d'appeler l'endpoint de suppression. ^[1]
• Confusion entre la suppression de modèle et d'autres opérations DELETE. Zoho Desk expose plusieurs endpoints DELETE — pour les pièces jointes, les tags et les brouillons de transition — qui partagent une structure similaire. Assurez-vous de cibler /api/v1/ticketTemplates/{templateId} et non un endpoint de pièce jointe ou de tag. ^[3][5][6][8]

Points à vérifier

• Vérification du scope : Confirmez que votre token OAuth actif inclut Desk.settings.DELETE ou Desk.settings.ALL avant d'effectuer l'appel. ^[2]
• Exactitude de l'identifiant du modèle : Validez le templateId en récupérant d'abord la liste des modèles et en identifiant le bon enregistrement. ^[1]
• Statut de la réponse : Après l'appel DELETE, vérifiez qu'une réponse 2xx est retournée et que le modèle n'apparaît plus lorsque vous listez les modèles de tickets. ^[1]

---

*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 un environnement sandbox ou de staging avant de les exécuter sur votre instance Zoho Desk en production.*