Cómo eliminar una plantilla de ticket en Zoho Desk

Eliminar una plantilla de ticket en Zoho Desk se realiza mediante una única llamada autenticada a la API que elimina permanentemente la plantilla por su identificador único.

Por qué es importante

Las plantillas de ticket ayudan a los agentes a rellenar previamente los campos más comunes, pero las plantillas obsoletas o duplicadas pueden saturar la interfaz y confundir a tu equipo de soporte. Saber cómo eliminar una plantilla de forma limpia a través de la API de Zoho Desk permite a los administradores mantener su espacio de trabajo ordenado sin necesidad de soluciones manuales. Esto resulta especialmente útil cuando se gestionan plantillas de forma programática en varios departamentos o durante una auditoría de configuración de Desk.

Paso a paso

Paso 1. Confirma que tienes los ámbitos OAuth correctos autorizados para tu integración con Zoho Desk. Como mínimo, tu token debe incluir Desk.settings.DELETE (e idealmente Desk.settings.ALL) para realizar operaciones destructivas sobre recursos a nivel de configuración, como las plantillas de ticket. ^[2]

Paso 2. Obtén el templateId de la plantilla que deseas eliminar. Puedes conseguirlo listando tus plantillas de ticket a través de la API de Zoho Desk y anotando el identificador único que se devuelve para la plantilla objetivo. Guarda este valor a mano, ya que es necesario en la ruta de la solicitud. ^[1]

Paso 3. Envía una solicitud DELETE al endpoint de plantillas de ticket, sustituyendo el identificador de tu plantilla en la ruta:

DELETE /api/v1/ticketTemplates/{templateId}

Esta llamada toma el templateId como parámetro de ruta. No se requiere cuerpo en la solicitud. ^[1]

Paso 4. Si trabajas en Python, la llamada sigue este patrón:

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

Pasa el ID de la plantilla como templateId. El parámetro opcional p puede incluir cualquier parámetro de consulta adicional que requiera tu entorno. ^[1]

Paso 5. Comprueba el código de respuesta HTTP. Una eliminación exitosa devolverá un estado 2xx. Cualquier respuesta 4xx suele indicar un templateId no válido o permisos OAuth insuficientes; vuelve a revisar los pasos 1 y 2 si esto ocurre. ^[1]

> Nota: Si solo necesitas modificar una plantilla en lugar de eliminarla por completo, utiliza PATCH /api/v1/ticketTemplates/{templateId}, que acepta un payload data con los campos que deseas actualizar. ^[7]

Errores comunes

• Ámbito incorrecto concedido. El fallo más frecuente es autenticarse con un token que carece de Desk.settings.DELETE. Verifica que tu configuración OAuth incluya explícitamente el ámbito DELETE a nivel de configuración, y no solo Desk.tickets.DELETE, que cubre los registros de tickets y no los objetos de configuración. ^[2]
• templateId desactualizado o incorrecto. Los IDs de plantilla no son nombres legibles por humanos. Pasar un nombre visible o un ID de ticket en lugar del identificador real de la plantilla generará un error 404 o similar. Resuelve siempre el ID de forma programática antes de llamar al endpoint de eliminación. ^[1]
• Confundir la eliminación de plantillas con otras operaciones DELETE. Zoho Desk expone varios endpoints DELETE —para adjuntos, etiquetas y borradores de transición— que comparten una estructura similar. Asegúrate de que estás apuntando a /api/v1/ticketTemplates/{templateId} y no a un endpoint de adjuntos o etiquetas. ^[3][5][6][8]

Qué verificar

• Verificación del ámbito: Confirma que tu token OAuth activo incluye Desk.settings.DELETE o Desk.settings.ALL antes de realizar la llamada. ^[2]
• Exactitud del ID de plantilla: Valida el templateId recuperando primero la lista de plantillas y localizando el registro correcto. ^[1]
• Estado de la respuesta: Tras la llamada DELETE, verifica que se devuelve una respuesta 2xx y que la plantilla ya no aparece al listar las plantillas de ticket. ^[1]

---

*Beam Help ofrece soporte experto independiente para productos Zoho y no es el soporte oficial de Zoho. Prueba siempre las operaciones destructivas de la API en un entorno de pruebas o de staging antes de ejecutarlas en tu instancia de producción de Zoho Desk.*