Conectar via telefone

Conecta a sessão via código de pareamento por número de telefone. Não requer câmera ou leitura de QR code.

Dica

Phone Pairing é ideal para automações server-side onde não há interface visual para exibir QR code.

Endpoint

POST /sessions/{id}/pairphone

Parâmetros

Nome	Tipo	Obrigatório	Descrição
id	string	Sim	ID da sessão (path param)
phone	string	Sim	Número com código do país, sem +

Request

cURL

curl -X POST https://endpoint.wi.api.br/sessions/01234567-89ab-cdef-0123-456789abcdef/pairphone \
  -H "x-api-key: $WIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone": "5511987654321"}'

JavaScript

const response = await fetch(
  "https://endpoint.wi.api.br/sessions/01234567-89ab-cdef-0123-456789abcdef/pairphone",
  {
    method: "POST",
    headers: {
      "x-api-key": process.env.WIAPI_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ phone: "5511987654321" }),
  }
);

const pairing = await response.json();

Python

import requests

response = requests.post(
    "https://endpoint.wi.api.br/sessions/01234567-89ab-cdef-0123-456789abcdef/pairphone",
    headers={"x-api-key": WIAPI_KEY},
    json={"phone": "5511987654321"},
)

pairing = response.json()

Response

{
  "code": "4A7B-2C9D",
  "expiresIn": 60
}

O campo code deve ser inserido no aplicativo WhatsApp em Dispositivos vinculados > Vincular dispositivo > Vincular com número de telefone. O código expira em 60 segundos.