Skip to main content
GET
Get User State

Descripción

Gestiona el estado operativo de un usuario dentro de tu canal. Puedes consultar si un contacto está en modo manual o automático y actualizar esta configuración para controlar quién responde las conversaciones.

Obtener el Estado de un Usuario

Endpoint

Parámetros de Ruta

string
requerido
Número de teléfono del usuario (sin el signo +).

Ejemplo de Respuesta

Cambiar el Estado de un Usuario

Endpoint

Cuerpo de la Solicitud

number
Tiempo en segundos que permanecerá el estado manual antes de expirar automáticamente.
string
requerido
Identificador del canal asociado al usuario.
string
requerido
Número de teléfono del usuario (sin el signo +).
string
requerido
Estado objetivo. Valores permitidos: "manual" o "auto".

Ejemplo de Solicitud

cURL

Ejemplo de Respuesta

Cuando un usuario está en estado manual, el canal deja de responder automáticamente y es necesario enviar mensajes manuales usando los endpoints de envío. Asegúrate de coordinar el cambio de estado con tu equipo de soporte.

Errores Comunes

  • 400 - No se pudo obtener o actualizar el estado del usuario.
  • 401 - Credenciales inválidas o faltantes.
  • 404 - Usuario o canal no encontrados.

Autorizaciones

Authorization
string
header
requerido

Basic authentication using Base64 encoded clientId:clientSecret

Parámetros de ruta

userId
string
requerido

Phone number without + sign

Respuesta

User state retrieved

id
string
names
string
botId
string
groupId
string
state
enum<string>
Opciones disponibles:
auto,
manual