Cómo obtener registros de una vista en Zoho Desk

Recuperar registros de una vista específica en Zoho Desk es sencillo una vez que tienes el ID de vista correcto y los ámbitos OAuth adecuados configurados. Aquí encontrarás todo lo que necesitas saber para obtener registros de una vista a través de la API de Zoho Desk.

Por qué esto es importante

Zoho Desk organiza tickets, contactos y otras entidades en vistas — filtros guardados que agrupan registros según criterios como estado, responsable o prioridad. Si deseas obtener mediante programación los registros pertenecientes a una de esas vistas (con fines de informes, automatización o integración), debes llamar al endpoint dedicado de registros de vista en lugar de un endpoint de lista general. Esto también es útil cuando quieres reflejar lo que un agente ve en su cola de Desk dentro de una herramienta o panel de terceros.

Paso a paso

Paso 1. Confirma que tus ámbitos OAuth incluyen acceso de lectura a Desk.

Antes de realizar cualquier llamada a la API, verifica que tu token OAuth de Zoho Desk conectado tenga concedido como mínimo Desk.tickets.READ (o el ámbito del módulo correspondiente, como Desk.contacts.READ). Una integración completa normalmente también incluye Desk.basic.READ para que la API pueda resolver los metadatos de organización y departamento. Sin los ámbitos correctos, la solicitud devolverá un error de autorización. ^[2]

Paso 2. Obtén tu ID de organización.

Cada llamada a la API de Zoho Desk debe estar vinculada a una organización. Si aún no has almacenado el orgId, llama primero al endpoint de organizaciones. Itera sobre el array data devuelto, toma el campo id del primer elemento y guárdalo para reutilizarlo. Una vez obtenido, pasa este valor como encabezado orgId en todas las solicitudes posteriores. ^[4][6]

Paso 3. Identifica el ID de la vista de destino.

Navega a Zoho Desk en tu navegador, abre la vista que deseas consultar y anota el ID numérico en la URL — o recupéralo mediante programación desde el endpoint de lista de vistas. Pasarás este valor como parámetro de ruta view_id en el siguiente paso. ^[3]

Paso 4. Llama a GET /api/v1/views/{view_id}/records.

Realiza una solicitud GET autenticada al endpoint que se muestra a continuación, sustituyendo tu ID de vista real:

GET /api/v1/views/{view_id}/records

El nombre de la operación es getviewrecords. Los parámetros admitidos son:

| Parámetro | Descripción |

|-----------|-------------|

| view_id | El ID numérico de la vista (parámetro de ruta) |

| p | Diccionario opcional de paginación o filtro pasado como parámetros de consulta |

Una llamada mínima en Python tiene este aspecto:

result = desk_api.get_view_records(view_id="123456", p={"limit": 50})

El cliente realiza la solicitud GET y devuelve la respuesta JSON analizada que contiene los registros coincidentes. ^[3]

Paso 5. (Opcional) Recupera solo el recuento de registros.

Si solo necesitas saber cuántos registros existen en una vista — por ejemplo, para mostrar un contador de insignia o decidir si paginar — utiliza la variante de recuento del mismo endpoint:

GET /api/v1/views/{view_id}/records/count

La operación es getviewrecordscount y acepta los mismos parámetros viewid y p. ^[7]

Paso 6. Construye enlaces directos a los registros devueltos.

Una vez que tengas la respuesta, puedes construir URLs navegables en el navegador para cada registro. Para los tickets, el patrón es:

https://desk.zoho.{dc}/agent/{portal}/tickets/details/{TicketId}

Para contactos y cuentas, la ruta base sigue {deskrecordsroot}/contacts o {deskrecordsroot}/accounts respectivamente. Si no hay un slug de portal disponible, se utiliza el ID de organización en su lugar. ^[1][5]

Errores comunes

• Encabezado orgId ausente. Zoho Desk requiere el ID de organización en cada solicitud. Si el deskorgid almacenado está en blanco o desactualizado, la API rechazará las llamadas. El patrón de detección automática (obtener las organizaciones en el primer uso y persistir el resultado) evita que esto falle silenciosamente. ^[4][6]
• Combinaciones de ámbitos incorrectas. Solicitar Desk.tickets.ALL no cubre automáticamente contactos o tareas. Cada módulo necesita su propio ámbito (Desk.contacts.READ, Desk.tasks.READ, etc.). Verifica la lista completa de ámbitos si recibes errores 403 en tipos de registros específicos. ^[2]
• Discrepancia de centro de datos. Zoho aloja datos en múltiples regiones (.com, .eu, .in, etc.). Asegúrate de que la URL base coincida con el centro de datos donde se creó la cuenta — por ejemplo, https://desk.zoho.eu para cuentas de la UE — de lo contrario, las solicitudes fallarán o redirigirán de forma inesperada. ^[5]

Qué verificar

• Los ámbitos están presentes y activos — confirma que Desk.tickets.READ (y cualquier otro ámbito de módulo que necesites) aparecen en la lista de ámbitos concedidos del token antes de pasar a producción. ^[2]
• El view_id es válido para tu organización — los IDs de vista son específicos de la organización; un ID de vista de un portal de Zoho Desk no funcionará en otro. ^[3]
• La paginación está gestionada — si el parámetro p admite un limit o desplazamiento de página, verifica que tu código recorra todas las páginas para que no se pierda ningún registro silenciosamente. ^[3][7]

---

*Beam Help es un recurso de soporte experto independiente para productos Zoho y no es el soporte oficial de Zoho. Para problemas de facturación o a nivel de cuenta, contacta directamente con Zoho.*