Referencia (endpoints)Números

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.

POST
/devices/{device}/clean

⚠️ 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.disconnected con reason: 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.

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

device*string

The device ID

Patrón^dev_[A-Za-z0-9]{23}$

Cuerpo de la respuesta

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
  1. response
data*array<unknown>
numbers_capacity*string|null
curl -X POST "https://example.com/devices/dev_Ac7Ku7iIZDXJTjdCu0UB1mX/clean"
{  "data": [    null  ],  "numbers_capacity": "string"}

Esto es lo que se copia para tu IA

Cargando…