Cómo recuperar los archivos adjuntos de transiciones en Zoho Desk

Recuperar los archivos adjuntos de transiciones en Zoho Desk requiere una solicitud GET sencilla contra la API REST de Desk, proporcionando tanto el identificador del ticket como el identificador de la transición para obtener todos los archivos adjuntos a un borrador de transición.

Por qué esto es importante

Cuando un ticket de Zoho Desk avanza a través de un blueprint o flujo de trabajo, los agentes pueden adjuntar documentos de soporte directamente a un borrador de transición. Si necesitas auditar esos archivos, mostrarlos en un portal personalizado o procesarlos de forma programática, debes saber cómo consultar el endpoint correcto. Este también es un paso previo necesario antes de decidir si eliminar un archivo adjunto específico de un borrador de transición.

Paso a paso

Paso 1. Confirma que tienes un token de acceso OAuth válido con el alcance de Zoho Desk. Tu token debe obtenerse mediante el flujo estándar de OAuth de Zoho — intercambiando un código de autorización por un token de acceso — antes de que cualquier llamada a la API tenga éxito. ^[8]

Paso 2. Identifica los dos identificadores clave que necesitarás: el ticketId del ticket en cuestión y el transitionId de la transición de blueprint específica cuyos archivos adjuntos deseas recuperar. Ambos valores son cadenas de texto y deben proporcionarse en la ruta de la URL. ^[1]

Paso 3. Envía una solicitud GET al siguiente endpoint, sustituyendo tus valores reales por los marcadores de posición:

GET /api/v1/tickets/{ticketId}/transitions/{transitionId}/attachments

Esta operación está documentada internamente como op15getattachmentof_transition y se describe como "Get Attachment of Transition Draft". ^[1]

Paso 4. Opcionalmente, pasa un parámetro p como diccionario en la cadena de consulta si necesitas aplicar opciones de paginación o filtrado compatibles con el endpoint. Cuando no se necesitan parámetros adicionales, este argumento puede omitirse o establecerse en None. ^[1]

Paso 5. En Python, el patrón de llamada es el siguiente:

result = client.op_15_get_attachment_of_transition(
    ticketId="123456",
    transitionId="789012",
    p=None  # or pass a dict of query params
)

La solicitud subyacente es un GET HTTP simple sin cuerpo de solicitud. ^[1]

Paso 6. Analiza la respuesta para obtener la lista de objetos de archivos adjuntos asociados a ese borrador de transición. Cada objeto contendrá los metadatos necesarios para identificar los archivos adjuntos individuales — necesitarás el valor attachmentId de esta respuesta si más adelante tienes intención de eliminar un archivo específico. ^[4]

Errores comunes

• Orden incorrecto de los identificadores. La ruta requiere ticketId primero y luego transitionId. Intercambiarlos resultará en un error 404 o una respuesta vacía inesperada. Verifica el orden con la firma del endpoint. ^[1]
• Token OAuth caducado o ausente. Todas las llamadas a la API de Zoho Desk requieren un token de acceso vigente. Si tu token ha caducado, renuévalo antes de volver a intentarlo — un token caducado devolverá un error de autenticación en lugar de los datos de los archivos adjuntos. ^[8]
• Confundir "obtener" con "eliminar". El endpoint de recuperación (GET …/attachments) y el endpoint de eliminación (DELETE …/attachments/{attachmentId}) comparten la misma ruta base, pero difieren en el método HTTP y en la presencia de attachmentId. Usar el método incorrecto no hará nada o eliminará un archivo de forma permanente. ^[4]

Qué verificar

• Verifica que ambos IDs sean correctos — confirma que el ticketId y el transitionId existen en tu organización de Zoho Desk antes de realizar la llamada, ya que un ID inválido devolverá un error en lugar de una lista vacía. ^[1]
• Confirma que la respuesta contiene metadatos de archivos adjuntos — si el borrador de transición no tiene archivos adjuntos, el array de respuesta estará vacío; este es el comportamiento esperado, no un error. ^[1]
• Anota los valores de attachmentId — si se necesitan acciones posteriores como la eliminación, captura esos IDs de esta respuesta ahora, ya que la operación de eliminación los requiere de forma explícita. ^[4]

---

*Beam Help es un recurso de soporte experto independiente para productos Zoho y no es el soporte oficial de Zoho. Prueba siempre las llamadas a la API en un entorno de pruebas antes de ejecutarlas con datos de producción.*