Cómo recuperar una aprobación en Zoho Desk

Recuperar un registro de aprobación en Zoho Desk requiere el ID del ticket y el ID de la aprobación — una vez que tienes ambos, una sola solicitud GET devuelve los detalles completos de la aprobación.

Por qué esto es importante

Los flujos de trabajo de aprobación en Zoho Desk permiten a los agentes y gestores condicionar el avance de los tickets a validaciones formales. Si necesitas auditar una decisión de aprobación, mostrar su estado actual en un panel externo o enviar datos de aprobación a una automatización posterior, debes poder obtener ese registro de aprobación específico de forma programática. Conocer el endpoint correcto y los parámetros necesarios ahorra tiempo y evita consultas de listado innecesarias.

Paso a paso

Paso 1. Confirma que tienes los scopes de OAuth correctos habilitados para tu integración de Zoho Desk. Como mínimo, tu token debe incluir Desk.tickets.READ para que los sub-recursos a nivel de ticket, como las aprobaciones, sean accesibles. ^[5]

Paso 2. Identifica los dos parámetros de ruta obligatorios que necesitarás antes de realizar cualquier llamada:

• ticketId — el identificador único del ticket al que pertenece la aprobación.
• approvalId — el identificador único del registro de aprobación específico que deseas recuperar.

Ambos valores son cadenas de texto y deben estar presentes; el endpoint no se resolverá sin ellos. ^[8]

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

GET /api/v1/tickets/{ticketId}/approvals/{approvalId}

Por ejemplo, si el ID de tu ticket es 123456 y el ID de tu aprobación es 789, la ruta resuelta será /api/v1/tickets/123456/approvals/789. ^[8]

Paso 4. Incluye tu token de acceso OAuth en la cabecera Authorization. Si tu token ha expirado, el cliente debe intercambiar el refresh token almacenado por un nuevo token de acceso antes de reintentar la solicitud. ^[3]

Paso 5. Opcionalmente, proporciona parámetros de consulta adicionales a través del diccionario p (por ejemplo, filtros de campos o indicaciones de paginación compatibles con la API de Zoho Desk). Si no tienes parámetros adicionales, pasa un objeto vacío u omítelo por completo. ^[8]

Paso 6. Gestiona la respuesta. Una llamada exitosa devuelve el objeto de aprobación en formato JSON. Si la respuesta contiene una clave "error", muestra ese mensaje al usuario o regístralo para depuración antes de reintentar. ^[2]

---

> Nota: Beam Help es soporte experto independiente para Zoho — no somos el soporte oficial de Zoho. Verifica siempre el comportamiento del endpoint según tu centro de datos y versión de API de Zoho Desk específicos.

Errores comunes

• IDs ausentes o intercambiados. Pasar el ID de aprobación donde se espera el ID del ticket (o viceversa) devolverá un error 404 o un registro no relacionado. Comprueba el orden: el ID del ticket va primero en la ruta, el ID de la aprobación en segundo lugar. ^[8]
• Scope de OAuth insuficiente. Si tu aplicación conectada fue autorizada sin Desk.tickets.READ, la API rechazará la solicitud con un error de permisos. Vuelve a autorizar el flujo OAuth incluyendo los scopes correctos. ^[5]
• Token de acceso expirado. Los tokens de acceso de Zoho tienen una vida útil limitada. Asegúrate de que tu integración actualice automáticamente el token usando el refresh token almacenado cuando reciba una respuesta 401. ^[3]
• ID de organización no configurado. Las llamadas a la API de Zoho Desk están limitadas a una organización. Si la cabecera orgId está ausente o es incorrecta, las solicitudes pueden fallar o devolver datos del portal equivocado. Confirma que el ID de organización está resuelto y adjunto a cada solicitud. ^[7]

Qué verificar

• Comprueba que los valores de ticketId y approvalId que estás utilizando existen realmente en tu portal de Zoho Desk antes de llamar al endpoint. ^[8]
• Confirma que tu token OAuth incluye Desk.tickets.READ y que no ha expirado antes de realizar la solicitud. ^[5]
• Inspecciona la respuesta JSON en busca de un campo "error" y trátalo correctamente en la lógica de tu integración antes de intentar cualquier procesamiento adicional. ^[2]