Eliminar un equipo en Zoho Desk a través de la API requiere una única solicitud DELETE autenticada dirigida al identificador único del equipo en cuestión. Aquí tienes todo lo que necesitas saber para hacerlo de forma limpia y segura.
Por qué esto es importante
Los equipos en Zoho Desk ayudan a enrutar tickets y organizar agentes, pero con el tiempo, los equipos redundantes o reestructurados pueden desordenar tu configuración. Ya sea que estés automatizando un script de limpieza o construyendo un flujo de trabajo de administración, saber cómo eliminar un equipo de forma programática es esencial para mantener tu configuración de Zoho Desk ordenada. Esta guía cubre el enfoque mediante API, que es el método más fiable para eliminaciones masivas o automatizadas.
> Nota: Beam Help es un recurso de soporte experto independiente, no el soporte oficial de Zoho.
---
Paso a paso
Paso 1. Confirma que tus permisos OAuth están configurados.
Antes de realizar cualquier llamada a la API que implique una acción destructiva, verifica que tu cliente OAuth conectado incluya los permisos necesarios de Zoho Desk. Las operaciones a nivel de configuración —incluida la gestión de equipos— requieren permisos como Desk.settings.ALL o, como mínimo, Desk.settings.DELETE en la configuración de tu token. [2]
Paso 2. Obtén el team_id que deseas eliminar.
Necesitarás el identificador único del equipo antes de emitir la solicitud de eliminación. Si aún no lo tienes almacenado, usa una solicitud GET al endpoint de equipos para listar todos los equipos y anota el team_id del que deseas eliminar. Ten este valor a mano para el siguiente paso.
Paso 3. Envía la solicitud DELETE al endpoint de equipos.
Envía un HTTP DELETE autenticado al siguiente endpoint, sustituyendo tu identificador de equipo real en lugar de {team_id}: [1]
DELETE /api/v1/teams/{team_id}En Python, usando el wrapper del cliente de Zoho Desk, se vería así:
def delete_team(self, team_id: str, p: dict = None):
return self.c.request("DELETE", f"/api/v1/teams/{team_id}", p, None)Pasa el team_id como argumento de tipo cadena. El parámetro opcional p puede incluir cualquier parámetro de consulta adicional si fuera necesario. [1]
Paso 4. Gestiona la respuesta de la API.
Una eliminación exitosa devolverá un código de estado HTTP de éxito apropiado. Si la respuesta indica un error —como un 404 (equipo no encontrado) o un 403 (permisos insuficientes)— revisa los pasos 1 y 2 para confirmar la configuración de permisos y la corrección del team_id que proporcionaste. [^1, ^2]
---
Errores comunes
- Endpoint incorrecto: grupos vs. equipos. Zoho Desk tiene un endpoint separado para eliminar grupos del Help Center (
DELETE /api/v1/helpcenter/{helpcenterid}/groups/{groupid}), que es un recurso completamente diferente al de un equipo. Asegúrate de apuntar a/api/v1/teams/{team_id}y no a un endpoint de grupos o departamentos. [4]
- Permisos OAuth ausentes o insuficientes. Si tu token fue generado sin
Desk.settings.DELETEoDesk.settings.ALL, la API rechazará la solicitud. Verifica la lista de permisos en tu configuración OAuth antes de buscar el problema en otro lugar. [2]
- Confundir equipos con departamentos. Los departamentos tienen su propio conjunto de endpoints (por ejemplo, para desasociar agentes o eliminar logotipos). La eliminación de un equipo no afectará la pertenencia ni la configuración de los departamentos, ya que se gestionan de forma independiente. [^3, ^5]
---
Qué verificar
- Cobertura de permisos: Confirma que tu token OAuth activo incluye al menos uno de los siguientes permisos:
Desk.settings.ALLoDesk.settings.DELETEantes de realizar la llamada. [2] - ID de recurso correcto: Verifica que el
team_idque estás pasando corresponde realmente a un equipo (y no a un departamento o grupo del Help Center) consultando primero la lista de equipos mediante GET. [1] - Estado de la respuesta: Tras completar la llamada DELETE, confirma que la respuesta HTTP indica éxito. Cualquier código de error debe investigarse en relación con tus credenciales y la validez del ID del equipo. [1]