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.
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.
httpAuthorizationBearer <clave>device*stringThe device ID
^dev_[A-Za-z0-9]{23}$application/json- response
data*curl -X GET "https://example.com/devices/dev_Ac7Ku7iIZDXJTjdCu0UB1mX/qr"{ "data": { "connected": true, "qr_code": "string", "expires_in": 0 }}Crear un número para conectar por QR POST
Sirve para sumar a tu cuenta, desde tu sistema y sin entrar al panel, un número que se conecta escaneando un código QR. Ocupa un lugar del plan; después pide su código con Ver el QR de un número.
Editar un número PUT
Sirve para cambiar los datos de un número: su alias, su color, su imagen o tu external_reference. Lo que no mandas no cambia.