Cómo obtener los seguidores de un ticket en Zoho Desk

Recuperar los seguidores de un ticket en Zoho Desk es sencillo mediante una única solicitud GET a la API REST de Desk: solo necesitas el ID del ticket de destino y credenciales OAuth válidas.

Por qué es importante

Cuando desarrollas automatizaciones, herramientas de auditoría o flujos de trabajo de notificaciones sobre Zoho Desk, a menudo necesitas saber exactamente quién está suscrito a las actualizaciones de un ticket determinado. Obtener la lista de seguidores de forma programática te permite sincronizar esos datos con sistemas externos, aplicar políticas de seguidores o mostrar recuentos de suscriptores en paneles personalizados. También es un complemento útil para las operaciones de agregar y eliminar seguidores, que te permiten gestionar la lista una vez que conoces su estado actual.

Paso a paso

Paso 1. Asegúrate de que tu token OAuth incluya los scopes correctos de Desk antes de realizar cualquier llamada a la API. Como mínimo, necesitas Desk.tickets.READ en tu conjunto de scopes autorizados; scopes de tickets más amplios, como Desk.tickets.ALL, también cumplen este requisito. ^[6]

Paso 2. Obtén el ticketId del ticket cuyos seguidores deseas consultar. Este es el identificador numérico interno que Zoho Desk asigna a cada registro de ticket, no el número de ticket legible que se muestra en la interfaz. Puedes recuperarlo de cualquier respuesta previa de la API de lista o detalle de tickets.

Paso 3. Envía una solicitud GET al endpoint de seguidores, sustituyendo el identificador real del ticket en la ruta:

GET /api/v1/tickets/{ticketId}/followers

El parámetro de consulta opcional p puede utilizarse para controlar la paginación si la lista de seguidores es extensa. ^[1]

Paso 4. En Python, si utilizas un wrapper ZohoDeskApi, llama al método como se muestra a continuación:

followers = api.get_ticket_followers(ticketId="your_ticket_id_here")
print(followers)

El wrapper realiza la solicitud GET subyacente y devuelve la respuesta procesada. ^[1]

Paso 5. Inspecciona el payload de la respuesta. El objeto devuelto contendrá los registros de seguidores de ese ticket. Presenta los campos clave —como el nombre y el correo electrónico del agente— a tus usuarios finales en un formato legible, omitiendo los valores vacíos o los IDs internos sin procesar. ^[5]

Paso 6. Si tu integración también necesita modificar la lista de seguidores, ten en cuenta que existen dos endpoints complementarios:

• Agregar seguidores: POST /api/v1/tickets/{ticketId}/addFollowers — acepta un cuerpo data con los agentes o contactos a suscribir. ^[3]
• Eliminar seguidores: POST /api/v1/tickets/{ticketId}/removeFollowers — acepta un cuerpo data que identifica a los seguidores a desuscribir. ^[4]

Estas son operaciones independientes de la llamada de lectura, por lo que tu token OAuth necesitará scopes de tickets con nivel de escritura (Desk.tickets.WRITE o Desk.tickets.ALL) si tienes intención de utilizarlos. ^[6]

Paso 7. Si tu token de acceso ha expirado, el cliente de la API debería actualizarlo automáticamente usando el refreshtoken almacenado. Confirma que tu lógica de actualización de tokens actualiza los valores accesstoken y tokenexpiresat persistidos en tu almacén de datos tras cada ciclo de actualización, para que las llamadas posteriores no fallen. ^[7]

Errores comunes

• orgId ausente o incorrecto: Zoho Desk requiere un encabezado de ID de organización en cada llamada a la API. Si tu cliente se inicializó sin un deskorgid válido, la solicitud será rechazada. El enfoque recomendado es llamar al endpoint de organizaciones en el primer uso para descubrir y persistir automáticamente el ID correcto. ^[7]
• Scopes OAuth insuficientes: Solicitar la lista de seguidores con un token que solo tiene Desk.contacts.READ o Desk.basic.READ no funcionará; necesitas específicamente un scope de lectura a nivel de tickets. Verifica la cadena de scopes configurada antes de buscar el problema en otro lugar. ^[6]
• Confundir el número de ticket con el ticketId: El parámetro de ruta {ticketId} es el ID interno del sistema, no el número con formato #1234 visible en la interfaz de Desk. Usar el número de visualización devolverá un error 404 o un resultado vacío.

Qué verificar

• Confirma que el token OAuth en uso incluye Desk.tickets.READ o Desk.tickets.ALL en sus scopes concedidos. ^[6]
• Verifica que el ticketId que estás pasando es el ID de registro interno de Desk y que el ticket realmente existe en tu organización.
• Tras una llamada exitosa, valida que la estructura de la respuesta coincide con lo que espera tu código posterior, especialmente si planeas encadenarla con los endpoints de agregar o eliminar seguidores. ^[3][4]

---

*Beam Help ofrece soporte experto independiente para productos Zoho y no es el soporte oficial de Zoho. Consulta siempre la documentación propia de Zoho para obtener las especificaciones de API más actualizadas.*