Pular para o conteúdo principal
Use este fluxo quando um token já existe, mas o dispositivo WhatsApp ainda não foi escaneado.
Se o token já foi escaneado anteriormente e os arquivos de sessão locais ainda existem, chamar /session/connect pode restaurar a sessão sem a necessidade de um novo escaneamento de QR code.

Conectar o token

curl -X POST http://localhost:1337/session/connect \
  -H "Content-Type: application/json" \
  -H "token: YOUR_TOKEN" \
  -d '{
    "Subscribe": ["All"],
    "Immediate": true,
    "Phone": ""
  }'

Obter o QR code

curl -H "token: YOUR_TOKEN" \
  http://localhost:1337/session/qr
Exemplo de resposta:
{
  "code": 200,
  "data": {
    "QRCode": "data:image/png;base64,..."
  },
  "success": true
}
Renderize o QRCode como uma imagem em sua aplicação web.

Realizar polling enquanto aguarda

Para aplicações web, faça polling no endpoint /session/status a cada poucos segundos para detectar quando LoggedIn se tornar true. Obtenha o /session/qr quando precisar atualizar o QR code exibido. Não chame /session/logout durante o polling. O logout desvincula o dispositivo e força um novo escaneamento.

Desconectar

Desconecte a conexão WebSocket ativa sem deslogar o dispositivo:
curl -X POST http://localhost:1337/session/disconnect \
  -H "token: YOUR_TOKEN"

Logout

O logout remove o dispositivo vinculado e exige um novo escaneamento de QR code na próxima vez:
curl -X POST http://localhost:1337/session/logout \
  -H "token: YOUR_TOKEN"