Referencia (endpoints)Números

Ver el QR de un número

Úsalo para mostrar en tu sistema el código QR de un número por QR y saber cuándo quedó conectado: devuelve la imagen, si ya está conectado y en cuántos segundos volver a pedirlo.

GET
/devices/{device}/qr

Escritura · requiere Números de WhatsApp → Crear, conectar y borrar.

🔑 Da el control de un WhatsApp. Por eso pide Números de WhatsApp → Crear, conectar y borrar: crear un número ocupa un lugar del plan, y quien escanee su QR o use un link de alta conecta un teléfono a esta cuenta. Trata el QR y la URL del link como un secreto.

El código QR para conectar un número por QR: se escanea con la app de WhatsApp (Dispositivos vinculados). Si el número todavía no tiene sesión con el proveedor, la crea. Cada llamada trae el código de ese momento: WhatsApp lo cambia cada pocos segundos hasta que se escanea, y uno viejo no vincula («no se puede vincular el dispositivo ahora»). Pídelo de nuevo cada expires_in segundos (hoy 5, la misma cadencia del panel) y reemplaza la imagen con la última; no guardes ni reenvíes un QR. Con el número conectado, connected es true y qr_code es null; también llega el webhook device.connected.

qr_code es una imagen PNG en data URI (data:image/png;base64,...), o null mientras la sesión arranca: en ese caso deja de mostrar el QR anterior y vuelve a pedirlo después de expires_in segundos.

Solo para números por QR: un número oficial responde 422 provider_unsupported.

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

application/json
  1. response
data*
curl -X GET "https://example.com/devices/dev_Ac7Ku7iIZDXJTjdCu0UB1mX/qr"
{  "data": {    "connected": true,    "qr_code": "string",    "expires_in": 0  }}

Esto es lo que se copia para tu IA

Cargando…