Cómo eliminar comentarios de tareas en Zoho Desk

Eliminar un comentario de tarea en Zoho Desk se realiza mediante una única llamada autenticada a la API con el método DELETE, que apunta a la tarea y al comentario específicos por sus respectivos IDs.

Por qué esto es importante

Al gestionar flujos de trabajo de soporte en Zoho Desk, los comentarios de tareas pueden acumular notas desactualizadas, entradas de prueba o información sensible que debe eliminarse. Saber cómo eliminar estos comentarios mediante programación es esencial para los equipos que crean automatizaciones, ejecutan scripts de limpieza o integran Zoho Desk con sistemas externos. Esto es especialmente relevante si gestionas datos de Desk a gran escala y necesitas un control preciso sobre los registros de tareas. *(Nota: Beam Help es soporte experto independiente para Zoho — no somos el soporte oficial de Zoho.)*

---

Paso a paso

Paso 1. Asegúrate de que tu token OAuth incluya el scope correcto de Zoho Desk para las operaciones de tareas. El scope requerido para eliminar datos relacionados con tareas es Desk.tasks.DELETE (o el más amplio Desk.tasks.ALL). Sin este scope en tu token, la API rechazará la solicitud. ^[2]

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

• taskId — el identificador único de la tarea que contiene el comentario.
• commentId — el identificador único del comentario específico que deseas eliminar.

Ambos valores son cadenas de texto y deben pasarse en la URL de la solicitud. ^[1]

Paso 3. Construye y envía la solicitud DELETE al siguiente endpoint:

DELETE /api/v1/tasks/{taskId}/comments/{commentId}

Reemplaza {taskId} y {commentId} con los IDs reales. No se requiere cuerpo en la solicitud — la operación queda completamente descrita por la ruta de la URL. ^[1]

Paso 4. Si utilizas un cliente Python, la llamada se corresponde con el método deletetaskcomment. Pasa el ID de la tarea y el ID del comentario como argumentos posicionales de tipo cadena. Hay disponible un parámetro opcional de diccionario p para cualquier parámetro de consulta adicional que tu integración pueda requerir. ^[1]

result = desk_client.delete_task_comment(
    taskId="your_task_id_here",
    commentId="your_comment_id_here"
)

Paso 5. Comprueba la respuesta de Zoho Desk. Una eliminación exitosa devolverá un estado HTTP 2xx. Si la respuesta contiene una clave error, revisa el mensaje para determinar si el problema es un scope faltante, un ID inválido o un problema de permisos. ^[5]

---

Errores comunes

• Scope incorrecto: Usar únicamente Desk.tasks.READ o Desk.tasks.WRITE no es suficiente. La operación de eliminación requiere específicamente que Desk.tasks.DELETE o Desk.tasks.ALL estén incluidos en tu lista de scopes OAuth. ^[2]

• Confundir comentarios de tareas con comentarios de tickets: El endpoint de comentarios de tareas (/api/v1/tasks/{taskId}/comments/{commentId}) es distinto del endpoint de comentarios de tickets (/api/v1/tickets/{ticketid}/comments/{commentid}). Enviar el ID de un comentario de tarea al endpoint de tickets — o viceversa — resultará en un error de no encontrado. ^[1][6]

• Confundir con otros tipos de comentarios: Zoho Desk tiene endpoints de eliminación separados para comentarios de llamadas (/api/v1/calls/{callId}/comments/{commentId}), comentarios de contactos (/api/v1/contacts/{contactId}/comments/{commentId}) y comentarios de contratos (/api/v1/contracts/{contractId}/comments/{commentId}). Asegúrate de estar apuntando a la ruta específica de tareas. ^[3][4][7]

• Tipos de ID incorrectos: Tanto taskId como commentId deben pasarse como cadenas de texto, no como enteros, aunque parezcan numéricos. ^[1]

---

Qué verificar

• Verificación del scope: Confirma que Desk.tasks.DELETE o Desk.tasks.ALL estén presentes en los scopes OAuth utilizados para generar tu token de acceso. ^[2]
• Ruta del endpoint correcta: Comprueba que la URL de tu solicitud use /api/v1/tasks/ y no una variante de tickets, llamadas o contactos del endpoint de comentarios. ^[1][6]
• Estado de la respuesta: Verifica que la API devuelva un código de estado 2xx; si en su lugar se devuelve un objeto de error, inspecciona el campo del mensaje para obtener detalles accionables. ^[5]