Revocar el acceso de un usuario

Revoca el acceso de un usuario a un número de WhatsApp específico.

API de WhatsApp y CRM

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

DELETE https://api.getincloud.ai/v1/devices/{deviceId}/team

Revoca el acceso de un usuario a un número de WhatsApp específico. Esta acción elimina al usuario de los miembros del equipo del número de WhatsApp y le restringe el acceso a este de forma inmediata.

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y prueba la API en el probador en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Cuerpo de la petición

Campo	Tipo	Obligatorio	Descripción
`email`	string	No	Elimina al agente por su correo electrónico. Si este campo no está definido, `id` debe estar definido. `minLength: 5` · `maxLength: 100` · `format: email`
`id`	string	No	Elimina al agente por su ID. Si este campo no está definido, `email` debe estar definido. `minLength: 24` · `maxLength: 24` · `pattern: ^[0-9A-Fa-f]{24}$`
`action`	string	No	Acción que se aplicará a todos los chats asignados al agente que se va a eliminar. Por defecto, se `unassign` todos los chats. `enum: ['unassign', 'reassign', 'resolve']` · `default: unassign`
`assign`	string	No	Obligatorio si `action` = `reassign`. Define el ID del agente de destino (24 caracteres hexadecimales) al que se reasignarán todos los chats que estaban asignados al agente que se va a eliminar. `minLength: 24` · `maxLength: 24` · `pattern: ^[0-9A-Fa-f]{24}$`
`remove`	boolean	No	Usa `true` para eliminar completamente al agente del sistema, incluso si tiene acceso a otros números de WhatsApp. `default: False`

Respuestas

Código	Descripción
`204`	Acceso del usuario revocado correctamente
`400`	Datos del cuerpo no válidos
`401`	Acceso no autorizado por token de API no válido o vencido
`403`	Falta el permiso de gestión de equipo, o se requiere actualizar el plan
`404`	Usuario o dispositivo no encontrado
`409`	Conflicto
`429`	Demasiadas solicitudes: inténtalo de nuevo más tarde
`500`	Error inesperado
`501`	No implementado
`503`	Operación no disponible: inténtalo de nuevo

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Revoke user access by ID in the current WhatsApp number and resolve all the user assigned chats
curl --request DELETE \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/team \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"id":"0f096004d10c300010500e41","action":"resolve"}'


// Revoke user access by email in the current WhatsApp number and unassign all the user chats
curl --request DELETE \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/team \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"id":"agent.name@company.com","action":"unassign"}'


// Revoke user access by email in the current WhatsApp number and re-assign all the user chats to a new user
curl --request DELETE \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/team \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"id":"agent.name@company.com","action":"reassign","assign":"NEW USER ID TO ASSIGN"}'

AnteriorReiniciar sesión SiguienteRevocar invitación de grupo

¿Te sirvió esta página?