Cómo eliminar tickets de spam en Zoho Desk

Eliminar tickets de spam en Zoho Desk puede hacerse de forma programática a través de la API REST de Zoho Desk mediante una única solicitud DELETE dirigida al endpoint de tickets de spam.

Por qué esto es importante

Las colas de soporte pueden acumular tickets de spam rápidamente, saturando las vistas de los agentes y distorsionando las métricas de informes. En lugar de revisar y eliminar cada uno manualmente, la API de Zoho Desk te permite eliminar en masa todos los tickets de spam en una sola llamada. Esto resulta especialmente útil para equipos que ejecutan scripts de mantenimiento automatizado o que desarrollan herramientas de administración sobre Zoho Desk.

Paso a paso

Paso 1. Asegúrate de que tu token OAuth incluya los scopes correctos de Zoho Desk antes de realizar cualquier llamada a la API. Como mínimo, tu token debe incluir Desk.tickets.ALL o Desk.tickets.DELETE para autorizar operaciones destructivas sobre registros de tickets. ^[2]

Paso 2. Confirma que tu integración o script se ha autenticado correctamente mediante el flujo OAuth de Zoho Desk y que hay un token de acceso válido disponible. Sin un token con los scopes adecuados, la API rechazará la solicitud con un error de autorización. ^[2]

Paso 3. Envía una solicitud DELETE al endpoint de tickets de spam:

DELETE /api/v1/tickets/spam

Esta única llamada indica a Zoho Desk que elimine de forma permanente todos los tickets que se encuentran actualmente en la cola de spam. ^[1]

Paso 4. Si utilizas un cliente Python con funciones de envoltura, la llamada al método equivalente tiene este aspecto:

delete_spam_tickets(p=None)

El parámetro opcional p acepta un diccionario de parámetros de consulta adicionales si tu integración los requiere; pasar None activa el comportamiento de eliminación masiva predeterminado. ^[1]

Paso 5. Si tu rutina de limpieza también necesita eliminar spam de otros tipos de registros, ten en cuenta que existen endpoints equivalentes para entidades relacionadas. Los contactos de spam pueden eliminarse mediante DELETE /api/v1/contacts/spam ^[7], las tareas de spam mediante DELETE /api/v1/tasks/spam ^[6], y los eventos de spam mediante DELETE /api/v1/events/spam. ^[4] Ejecutarlos en secuencia te proporciona una purga completa de spam en todo el modelo de datos de Zoho Desk.

Errores comunes

• Token ausente o con scopes insuficientes. Si tu cliente OAuth fue registrado únicamente con Desk.tickets.READ, la llamada DELETE fallará. Verifica que Desk.tickets.DELETE o Desk.tickets.ALL esté presente en tu cadena de scopes. ^[2]
• Confundir el spam de tickets con el de contactos o tareas. Cada tipo de entidad tiene su propio endpoint de spam dedicado. Llamar a /api/v1/tickets/spam no eliminará los contactos o tareas de spam; esos requieren sus propias llamadas DELETE independientes. ^[1][6][7]
• Acción irreversible. Un DELETE al endpoint de spam es permanente. La especificación de la API no contempla ningún paso de deshacer ni papelera de reciclaje, así que asegúrate de que los tickets estén correctamente clasificados como spam antes de ejecutar la llamada. ^[1]

Qué verificar

• Comprueba que el token de acceso OAuth en uso incluya Desk.tickets.DELETE o Desk.tickets.ALL entre sus scopes concedidos. ^[2]
• Confirma que el código de respuesta HTTP devuelto por DELETE /api/v1/tickets/spam indica éxito antes de asumir que la operación se completó. ^[1]
• Si también gestionas contactos, tareas o eventos, revisa las colas de spam correspondientes utilizando sus propios endpoints DELETE para garantizar una limpieza completa. ^[4][6][7]

---

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