Beam Help
Solicitar ayuda

How-to · Zoho DESK

Cómo eliminar una etiqueta en Zoho Desk

Elimina etiquetas de tu cuenta de Zoho Desk cuando ya no las necesites.

Eliminar una etiqueta en Zoho Desk puede realizarse en dos niveles: quitar una etiqueta de un ticket específico o eliminar la etiqueta de forma permanente de tu portal mediante la API.


Por qué es importante


Las etiquetas en Zoho Desk ayudan a categorizar y filtrar los tickets de soporte, pero con el tiempo tu biblioteca de etiquetas puede llenarse de etiquetas obsoletas o duplicadas. Saber cómo quitar una etiqueta de un solo ticket —frente a eliminarla completamente del sistema— mantiene tu espacio de trabajo ordenado y tus informes precisos. Esto es especialmente relevante para equipos que gestionan grandes volúmenes de tickets o que ejecutan flujos de trabajo automatizados que dependen de un etiquetado coherente.


Paso a paso


Paso 1. Decide qué operación necesitas.


Existen dos acciones distintas disponibles a través de la API de Zoho Desk. La primera elimina la asociación de una etiqueta con un ticket sin borrar la etiqueta de forma global. La segunda elimina la etiqueta de forma permanente de tu portal. Elige el endpoint correcto antes de continuar para evitar pérdidas de datos no deseadas. [1][2]


Paso 2. Reúne los identificadores necesarios.


Para cualquiera de las dos operaciones necesitarás el tagId de la etiqueta sobre la que deseas actuar. Si vas a quitar una etiqueta de un ticket específico, también necesitarás el ticketId de ese ticket. Puedes obtener estos IDs consultando tus etiquetas o tickets a través de la API de Zoho Desk antes de realizar cualquier llamada destructiva. [1][2]


Paso 3. Para quitar una etiqueta de un solo ticket, llama al endpoint de eliminación de etiqueta de ticket.


Envía una solicitud DELETE a /api/v1/tickets/{ticketId}/tags/{tagId}, sustituyendo los identificadores reales del ticket y la etiqueta. Esto desvincula la etiqueta únicamente de ese ticket — la etiqueta sigue existiendo en tu portal y puede seguir aplicándose en otros lugares. [2]


DELETE /api/v1/tickets/{ticketId}/tags/{tagId}

En Python, la llamada equivalente es:


desk_api.remove_tags_from_ticket(ticketId="12345", tagId="67890")

[2]


Paso 4. Para eliminar una etiqueta del portal de forma permanente, llama al endpoint de eliminación de etiqueta.


Envía una solicitud DELETE a /api/v1/tags/{tagId} con el tagId correspondiente. Esta operación elimina la etiqueta completamente de Zoho Desk — ya no aparecerá en ningún ticket, filtro ni informe. [1]


DELETE /api/v1/tags/{tagId}

En Python:


desk_api.delete_tag(tagId="67890")

[1]


Paso 5. Confirma que tus permisos de OAuth incluyen los alcances necesarios.


Ambas operaciones requieren que tu token de OAuth de Zoho Desk tenga el alcance adecuado. El alcance Desk.settings.DELETE cubre la eliminación de etiquetas a nivel de portal, mientras que Desk.tickets.DELETE cubre la eliminación de etiquetas a nivel de ticket. Si tu token no incluye alguno de estos alcances, la API devolverá un error de autenticación o autorización. [4]


Paso 6. Gestiona la respuesta de la API.


Una eliminación exitosa devolverá una respuesta HTTP 200 o 204 sin cuerpo o con una carga de confirmación mínima. Si recibes un estado 401, tus credenciales de OAuth deben actualizarse o reconectarse. Cualquier mensaje de error que haga referencia a un ID no válido significa que el tagId o el ticketId proporcionado no existe en tu portal. [6]


Errores comunes


  • Confundir los dos endpoints. Usar la eliminación a nivel de portal (/api/v1/tags/{tagId}) cuando solo pretendías desvincular una etiqueta de un ticket eliminará esa etiqueta de forma permanente en todos los lugares. Comprueba siempre qué endpoint estás llamando. [1][2]
  • Alcances de OAuth faltantes. Si tu integración se configuró sin Desk.settings.DELETE o Desk.tickets.DELETE, la API rechazará la solicitud. Revisa la configuración de tus alcances y vuelve a autorizar si es necesario. [4]
  • IDs no válidos o desactualizados. Los IDs de etiquetas y tickets pueden cambiar o ser eliminados por otros procesos. Obtén los IDs actuales justo antes de la eliminación en lugar de depender de valores en caché. [1][2]
  • Errores de autenticación. Una respuesta 401 significa que el token ha expirado o que la conexión debe restablecerse — no es un problema con el ID de la etiqueta en sí. [6]

Qué verificar


  • Verifica que el tagId que estás pasando realmente existe en tu portal de Zoho Desk antes de llamar a cualquiera de los endpoints de eliminación. [1]
  • Confirma que tu token de OAuth incluye Desk.settings.DELETE (para la eliminación a nivel de portal) o Desk.tickets.DELETE (para la eliminación a nivel de ticket) en sus alcances activos. [4]
  • Una vez completada la llamada, consulta el ticket o la lista de etiquetas correspondiente para confirmar que la etiqueta ya no aparece según lo esperado. [2]

---


*Beam Help ofrece 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.*

Sources cited

  1. [1] DELETE /api/v1/tags/{tagId}
  2. [2] DELETE /api/v1/tickets/{ticketId}/tags/{tagId}
  3. [3] DELETE /settings/tags/{tid}
  4. [4] config.py
  5. [5] server.py: apply_plan
  6. [6] server.py: _clarifying_question_from_tool_error
  7. [7] run_llm_routing_suite.py
  8. [8] server.py: chat_plan_stream
Eliminar una etiqueta en Zoho Desk | Beam Help — Beam Help