Desconectar un número
Úsalo para desconectar un número sin borrarlo, como «Desconectar» en el panel: conserva su lugar en el plan y su historial, y para volver a usarlo hay que conectarlo otra vez. No se puede deshacer. Requiere Números de WhatsApp → Crear, conectar y borrar.
⚠️ No se puede deshacer: cierra la conexión del número, que deja de mandar y recibir hasta que lo vuelvas a conectar: uno por QR, escaneando un código QR nuevo; uno oficial, con el alta oficial. Conserva su lugar en el plan y su historial.
Escritura · requiere Números de WhatsApp → Crear, conectar y borrar.
Lo mismo que «Desconectar» en el panel: cierra la conexión del número sin borrar su
información ni liberar su lugar en el plan. Se conservan el alias, el color, la imagen,
el historial y la identidad del número; number queda en null hasta que se vuelva a
conectar.
- Por QR: se cierra la sesión de WhatsApp. Para volver a conectarlo hay que escanear un
QR nuevo (
GET devices/{device}/qr). - Oficial: deja de enviar y recibir hasta que se conecte otra vez con el alta oficial;
vuelve el mismo número, en el mismo lugar. Si estaba conectado llega el webhook
device.disconnectedconreason: disconnected_by_user. Si el mismo teléfono también está en la cuenta por QR, ese número vuelve a recibir los chats uno a uno.
httpAuthorizationBearer <clave>device*stringThe device ID
^dev_[A-Za-z0-9]{23}$El número desconectado en data, y en numbers_capacity el uso de los lugares del plan (no aparece si no se pudo calcular).
application/json- response
data*array<unknown>numbers_capacity*string|nullcurl -X POST "https://example.com/devices/dev_Ac7Ku7iIZDXJTjdCu0UB1mX/clean"{ "data": [ null ], "numbers_capacity": "string"}Ver el estado de un número GET
Úsalo para chequear el estado de la sesión de WhatsApp de un número, por ejemplo antes de lanzar envíos o para monitorear tus números. Con una clave nunca trae el código QR: para conectar o reconectar un número, usa un link de alta.
Ver la salud de un número oficial GET
Úsalo para ver la salud de un número de WhatsApp Cloud (estado, identidad, nivel de throughput e historial de cambios) a partir del último dato guardado, sin consultar a Meta.