Cómo eliminar un perfil en Zoho Desk

Eliminar un perfil en Zoho Desk a través de la API es una operación sencilla de una sola llamada: se envía una solicitud DELETE al endpoint de perfiles con el ID del perfil objetivo. Como soporte experto independiente (no soporte oficial de Zoho), Beam Help te guía exactamente por lo que necesitas.

Por qué es importante

Los perfiles en Zoho Desk controlan lo que los agentes pueden ver y hacer dentro de tu servicio de asistencia. Con el tiempo, las organizaciones acumulan perfiles redundantes u obsoletos que deben limpiarse. Eliminar perfiles desactualizados mantiene tu estructura de permisos ordenada y reduce el riesgo de que los agentes operen bajo reglas de acceso incorrectas.

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. Los scopes que necesitarás incluyen Desk.settings.ALL o como mínimo Desk.settings.DELETE, que rigen las operaciones a nivel de configuración, como la gestión de perfiles. ^[2]

Paso 2. Identifica el profile_id del perfil que deseas eliminar. Puedes obtenerlo listando los perfiles existentes a través de la API de Zoho Desk y anotando el ID devuelto en la respuesta. Guarda este valor, ya que lo pasarás directamente en la solicitud de eliminación. ^[1]

Paso 3. Construye y envía la solicitud de eliminación. La operación apunta al siguiente endpoint:

DELETE /api/v1/profiles/{profile_id}

Reemplaza {profile_id} con el ID real que obtuviste en el Paso 2. ^[1]

Paso 4. Si utilizas un cliente Python, la llamada tiene este aspecto:

def delete_profile(self, profile_id: str, p: dict = None):
    return self.c.request("DELETE", f"/api/v1/profiles/{profile_id}", p, None)

Pasa el ID del perfil como cadena de texto; el parámetro opcional p puede incluir cualquier parámetro de consulta adicional si es necesario. ^[1]

Paso 5. Asegúrate de que tu cliente de API esté inicializado con un ID de organización de Zoho Desk válido (orgid). El cliente necesita este dato para enrutar las solicitudes correctamente a tu instancia de Desk. Si el orgid no está presente, el sistema puede descubrirlo automáticamente llamando primero al endpoint de organizaciones y conservando el ID devuelto. ^[6]

Errores comunes

• Scopes ausentes o incorrectos. Si tu token OAuth no incluye Desk.settings.DELETE (o el más amplio Desk.settings.ALL), la API rechazará la solicitud con un error de autorización. Verifica los scopes configurados en tu entorno. ^[2]

• ID de perfil incorrecto. Pasar un ID que no existe o que pertenece a un portal diferente resultará en una solicitud fallida. Verifica siempre el profile_id obteniendo la lista de perfiles antes de intentar la eliminación. ^[1]

• Restricción de operaciones destructivas. En flujos de trabajo automatizados o asistidos por IA, las operaciones de eliminación se clasifican como "destructivas" y pueden estar bloqueadas a menos que el sistema esté configurado explícitamente para permitir acciones destructivas. Confirma que tu integración o herramienta permite permisos de nivel destructivo antes de ejecutar esta llamada. ^[4]

• ID de organización ausente. Las solicitudes realizadas sin un org_id válido en el cliente de Desk no llegarán a la organización correcta. Asegúrate de que el ID de organización esté resuelto y asociado al cliente antes de ejecutar la eliminación. ^[6]

Qué verificar

• Confirma que el token OAuth en uso incluye Desk.settings.DELETE o Desk.settings.ALL en su lista de scopes. ^[2]
• Verifica que el profile_id que vas a utilizar es válido recuperando la lista de perfiles actual con antelación. ^[1]
• Tras la respuesta de la llamada de eliminación, intenta obtener el mismo ID de perfil para confirmar que ya no existe en Zoho Desk. ^[1]