Eliminar un borrador de transición de "acciones intermedias" en Zoho Desk requiere una única llamada DELETE autenticada a la API de transiciones, apuntando al ticket y la transición específicos que deseas eliminar.
Por qué esto es importante
La función de blueprint de Zoho Desk te permite definir acciones que se ejecutan *durante* una transición entre estados. Cuando estás iterando sobre un diseño de blueprint, es posible que crees borradores de acciones intermedias que deban descartarse antes de publicar. Conocer el endpoint correcto de la API y los parámetros necesarios te permite limpiar borradores obsoletos de forma programática, en lugar de buscarlos manualmente en la interfaz. Esto es especialmente útil cuando gestionas blueprints a gran escala o automatizas la configuración de Desk mediante scripts.
---
Paso a paso
Paso 1. Reúne los identificadores necesarios.
Antes de realizar la llamada, necesitas dos datos: el ticketId del ticket cuya transición de blueprint estás editando, y el transitionId que identifica la transición específica que contiene el borrador de acciones intermedias que deseas eliminar. Ambos son valores de tipo cadena. [1]
Paso 2. Construye la solicitud DELETE.
Envía una solicitud HTTP DELETE al siguiente endpoint, sustituyendo tus valores reales por los parámetros de ruta:
DELETE /api/v1/tickets/{ticketId}/transitions/{transitionId}/duringActionsReemplaza {ticketId} con el ID de tu ticket y {transitionId} con el ID de la transición. [1]
Paso 3. Incluye los parámetros de consulta opcionales.
El endpoint también acepta un parámetro opcional p (pasado como un diccionario de consulta o cuerpo del payload según tu cliente). Si no tienes necesidades de filtrado adicionales, puedes omitirlo o pasar un objeto vacío. [1]
Paso 4. Ejecuta la llamada en Python (helper opcional).
Si estás utilizando un wrapper de la API de Zoho Desk basado en Python, la firma del método tiene este aspecto:
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)Llámalo pasando tu ticketId y transitionId como cadenas. El argumento p es opcional y tiene como valor predeterminado None. [1]
Paso 5. Verifica la respuesta.
Una eliminación exitosa devolverá una respuesta HTTP 200 o 204 sin cuerpo de error. Si la respuesta contiene una clave "error", el borrador no fue eliminado — verifica que ambos IDs sean correctos y que tu token OAuth tenga los permisos de blueprint de Desk necesarios. [1]
---
Errores comunes
- IDs incorrectos: Pasar un
ticketIdque no coincide con el ticket propietario de la transición resultará en un error 404 o de permisos. Confirma siempre que ambos IDs pertenecen al mismo par ticket-transición antes de llamar al endpoint. [1] - Tokens OAuth caducados: La API de Zoho Desk requiere un token bearer OAuth 2.0 válido con alcance para la gestión de blueprints y transiciones. Un token caducado o con alcance insuficiente hará que el DELETE falle silenciosamente o devuelva un error de autenticación. [1]
- Eliminar algo que no es un borrador: Esta operación apunta a una configuración de acciones intermedias en estado de *borrador*. Si la transición ya ha sido publicada, el endpoint puede no comportarse como se espera — confirma primero que la transición sigue en estado de borrador. [1]
---
Qué verificar
- Confirma que la transición ya no tiene acciones intermedias asociadas obteniendo el registro de la transición después de la eliminación y verificando que la lista de acciones intermedias esté vacía o ausente.
- Comprueba que tus credenciales de API tengan el alcance correcto para las operaciones de blueprint de Zoho Desk, especialmente si recibes una respuesta
401o403. - Valida ambos parámetros de ruta (
ticketIdytransitionId) como valores de cadena precisos extraídos de tu entorno de Zoho Desk antes de volver a intentarlo. [1]
---
*Beam Help es un recurso de soporte experto independiente para productos Zoho y no es el soporte oficial de Zoho. Prueba siempre los cambios en la API en un entorno de sandbox o de pruebas antes de aplicarlos en producción.*