Eliminar una vista en Zoho Desk es sencillo a través de la API: envía una solicitud DELETE al endpoint de vistas con el ID de la vista objetivo y Zoho Desk la eliminará de forma permanente.
Por qué es importante
Las vistas personalizadas ayudan a los agentes a filtrar y priorizar tickets, pero con el tiempo las vistas obsoletas o redundantes saturan la interfaz. Ya sea que estés realizando una limpieza periódica, desactivando un flujo de trabajo o automatizando la gestión del ciclo de vida de las vistas mediante un script, conocer la llamada correcta a la API ahorra tiempo y evita búsquedas manuales en la interfaz. Esto es especialmente útil cuando se gestionan vistas a escala en múltiples departamentos.
Paso a paso
Paso 1. Confirma que tienes los scopes de OAuth correctos configurados para tu integración con Zoho Desk. Como mínimo, tu token debe incluir Desk.settings.DELETE (e idealmente el scope completo Desk.settings.ALL) para autorizar operaciones destructivas sobre recursos de configuración como las vistas. [2]
Paso 2. Obtén el view_id de la vista que deseas eliminar. Puedes conseguirlo listando las vistas a través de la API de Zoho Desk previamente, o inspeccionando la URL de la vista en la interfaz de Zoho Desk. Guarda este ID a mano — es un parámetro de ruta obligatorio. [1]
Paso 3. Construye tu solicitud DELETE apuntando al endpoint /api/v1/views/{viewid}, sustituyendo {viewid} por el identificador real que obtuviste en el paso anterior. No se requiere cuerpo en la solicitud; el ID de la vista en la ruta es suficiente para identificar el recurso. [1]
Paso 4. Envía la solicitud. Usando Python, la llamada tiene este aspecto (parafraseado de la implementación subyacente):
# Assuming `client` is your authenticated Zoho Desk API client
client.request("DELETE", f"/api/v1/views/{view_id}", None, None)
Una respuesta exitosa confirmará que la vista ha sido eliminada. [1]
Paso 5. Si estás trabajando con vistas personalizadas de Zoho CRM en lugar de vistas de Zoho Desk, ten en cuenta que el endpoint es completamente diferente: DELETE /settings/custom_views/{vid}, y requiere un parámetro module (p. ej., "Leads", "Contacts") para identificar de qué módulo se está eliminando la vista. No confundas estos dos endpoints. [3]
---
> Beam Help es soporte experto independiente para Zoho — no somos el soporte oficial de Zoho. Prueba siempre las llamadas destructivas a la API en un entorno de pruebas o staging antes de ejecutarlas contra datos de producción.
---
Errores comunes
- Scope incorrecto: Si tu token de OAuth no incluye
Desk.settings.DELETEoDesk.settings.ALL, la API devolverá un error de autorización. Verifica tu lista de scopes en la configuración de tu entorno antes de depurar la solicitud en sí. [2]
- Confundir vistas de Desk con vistas personalizadas de CRM: El endpoint de eliminación de vistas de Zoho Desk (
/api/v1/views/{viewid}) y el endpoint de vistas personalizadas de Zoho CRM (/settings/customviews/{vid}) son completamente independientes. Usar el endpoint de CRM con un ID de vista de Desk (o viceversa) devolverá un 404 o fallará silenciosamente. [1][3]
- Eliminar un layout en lugar de una vista: Zoho Desk también expone un endpoint
DELETE /api/v1/layouts/{layoutId}para eliminar layouts — un tipo de recurso diferente. Confirma que estás apuntando a un ID de *vista* y no a un ID de *layout* antes de ejecutar la llamada. [7]
- Acción irreversible: La eliminación de vistas en Zoho Desk es permanente. No existe papelera de reciclaje ni mecanismo de deshacer expuesto a través de la API. Verifica siempre el
view_idantes de enviar la solicitud.
Qué comprobar
- Validación del scope: Confirma que tu token de OAuth activo incluye
Desk.settings.DELETEoDesk.settings.ALLy que el token no ha expirado. [2] - ID de vista correcto: Verifica que el
view_idque estás pasando corresponde realmente a la vista deseada — lista las vistas primero y compruébalas antes de eliminar. [1] - Confirmación tras la eliminación: Después de que la llamada
DELETEdevuelva una respuesta exitosa, intenta obtener la vista mediante una solicitudGETpara confirmar que ya no existe y que no ha sido simplemente desactivada. [1]