Conectar por pairing code

Alternativa al QR: WhatsApp genera un código de 8 caracteres que se ingresa manualmente en el teléfono. Útil para integraciones headless (sin pantalla para escanear un QR) o cuando el QR no engancha.

1. Pedir el código

curl -X POST https://api.tudominio.com/sessions/<sessionId>/pairing-code \
  -H "x-api-key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"51987654321"}'

El phone va solo dígitos, sin + ni espacios, con código de país incluido.

Respuesta:

{ "code": "Y5P99AWC", "expiresAt": "2026-01-01T10:31:14.929Z", "method": "pairing_code" }

2. Ingresar el código en el teléfono

En el teléfono que va a quedar vinculado: WhatsApp → Dispositivos vinculados → Vincular un dispositivo → Vincular con número de teléfono, e ingresá el código.

3. Si expira

El código vence en ~60 segundos. Si no llegaste a tiempo, repetí el POST — regenera el código sin recrear la sesión.

Elegir pairing code desde el arranque

También se puede pedir directamente al crear la sesión:

curl -X POST https://api.tudominio.com/sessions \
  -H "x-api-key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"name":"mi-sesion","pairingMethod":"pairing_code","phone":"51987654321"}'

El método y el teléfono quedan guardados en la sesión, así que si necesita reconectarse automáticamente más adelante, vuelve a intentar con pairing code en vez de generar un QR.

Casos borde

Situación	Qué pasa
La sesión ya está connected	409 Conflict — no hace falta código
La sesión tiene credenciales válidas pero está desconectada	Se reconecta directo, sin pedir código nuevo
WhatsApp rechaza el número	400 Bad Request con el motivo devuelto