Cómo eliminar un comentario en Zoho Desk

Eliminar un comentario en Zoho Desk mediante la API es sencillo: basta con enviar una solicitud DELETE al endpoint correspondiente, proporcionando el ID del registro padre y el ID del comentario. Beam Help es soporte experto independiente para Zoho, no el soporte oficial de Zoho.

Por qué es importante

Los comentarios se acumulan en tickets, tareas, llamadas, contratos, eventos, cuentas y contactos en Zoho Desk. Ya sea que estés limpiando datos de prueba, eliminando información sensible publicada por error o automatizando una política de retención de datos, conocer el endpoint correcto para cada tipo de registro es fundamental. Usar el endpoint equivocado genera un error 404 o un error de permisos que puede ser difícil de diagnosticar sin una referencia clara.

Paso a paso

Zoho Desk expone un endpoint de eliminación de comentarios independiente para cada tipo de registro principal. Identifica qué tipo de registro contiene el comentario que deseas eliminar y sigue el paso correspondiente a continuación.

Paso 1. Reúne tus IDs.

Antes de llamar a cualquier endpoint necesitas dos valores: el ID del registro padre (ticket, tarea, llamada, etc.) y el ID del comentario específico. Ambos son devueltos por los endpoints de listado o consulta correspondientes y son cadenas de texto simples en la API de Zoho Desk.

Paso 2. Elimina un comentario en un ticket.

Envía una solicitud DELETE a /api/v1/tickets/{ticketid}/comments/{commentid}, reemplazando {ticketid} con el ID del ticket y {commentid} con el ID del comentario. Una llamada exitosa elimina el comentario de ese ticket de forma permanente. ^[3]

Paso 3. Elimina un comentario en una tarea.

Usa DELETE /api/v1/tasks/{taskId}/comments/{commentId} para comentarios asociados a registros de tareas. Proporciona taskId y commentId como parámetros de ruta. ^[1]

Paso 4. Elimina un comentario en una llamada.

Para comentarios a nivel de llamada, el endpoint es DELETE /api/v1/calls/{callId}/comments/{commentId}. Pasa el ID de la llamada y el ID del comentario en la ruta. ^[5]

Paso 5. Elimina un comentario en un evento.

Los comentarios de eventos se eliminan mediante DELETE /api/v1/events/{eventId}/comments/{commentId}, con eventId y commentId como parámetros de ruta. ^[6]

Paso 6. Elimina un comentario en un contrato.

Para eliminar un comentario de un registro de contrato, llama a DELETE /api/v1/contracts/{contractId}/comments/{commentId}. ^[2]

Paso 7. Elimina un comentario en una cuenta.

Los comentarios a nivel de cuenta usan DELETE /api/v1/accounts/{accountId}/comments/{commentId}, con accountId y commentId en la ruta. ^[4]

Paso 8. Elimina un comentario en un contacto.

Para registros de contactos, el endpoint es DELETE /api/v1/contacts/{contactId}/comments/{commentId}. ^[8]

Paso 9. Confirma tus permisos OAuth.

Todas las llamadas a la API de Zoho Desk requieren un token OAuth válido. Para operaciones con tickets, el token debe incluir como mínimo Desk.tickets.DELETE. Para tareas, eventos y registros relacionados con configuración, incluye Desk.tasks.DELETE, Desk.events.DELETE y Desk.settings.DELETE respectivamente. Asegúrate de que tu cliente OAuth esté configurado con los permisos que correspondan a los tipos de registro que estás utilizando. ^[7]

Errores comunes

• Tipo de registro y endpoint no coinciden. Cada tipo de registro tiene su propio sub-recurso de comentarios. Enviar el ID de un comentario de ticket al endpoint /tasks/ devolverá un error porque el comentario no existe bajo ese registro padre. Siempre relaciona el endpoint con el tipo de registro. ^[1][3]
• Permiso OAuth ausente o insuficiente. Si tu token fue generado sin el permiso DELETE para el tipo de registro correspondiente (p. ej., Desk.tickets.DELETE), la API rechazará la solicitud con un error de autorización. Vuelve a generar el token incluyendo los permisos correctos. ^[7]
• Formato de ID incorrecto. Tanto el ID del registro padre como el ID del comentario deben pasarse como cadenas de texto en la ruta. Pasar un número entero o un valor mal formado hará que la solicitud falle. ^[3]

Qué verificar

• Comprueba que el commentId que estás utilizando pertenezca realmente al ID del registro padre que usas en la ruta; una discrepancia generará un error de recurso no encontrado. ^[3][1]
• Confirma que tu token OAuth incluya el permiso DELETE para el tipo de registro específico (tickets, tareas, eventos, etc.) antes de realizar la llamada. ^[7]
• Después de que la llamada DELETE se complete correctamente, consulta la lista de comentarios del registro padre para confirmar que el comentario ya no aparece. ^[3]