Skip to main content
GET
https://api.oxenty.api.br
/
api
/
sessions
/
:id
/
qrcode
curl -X GET "https://api.oxenty.api.br/api/sessions/550e8400-e29b-41d4-a716-446655440000/qrcode" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "sessionId": "550e8400-e29b-41d4-a716-446655440000",
  "qrCode": "2@ABC123xyz...",
  "status": "QRCODE",
  "message": "Scan the QR code to connect."
}
Para conectar uma sessão no WhatsApp, você deve obter o QR Code e escanear pelo aplicativo.
O endpoint principal para obter QR Code é GET /sessions/:id/qrcode.

​
Path Parameters

​
id
string
required
ID da sessão (UUID).

​
Resposta

​
qrCode
string
QR Code em formato texto.
​
sessionId
string
ID da sessão.
​
status
string
Status atual da sessão.
​
message
string
Mensagem de status.
curl -X GET "https://api.oxenty.api.br/api/sessions/550e8400-e29b-41d4-a716-446655440000/qrcode" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "sessionId": "550e8400-e29b-41d4-a716-446655440000",
  "qrCode": "2@ABC123xyz...",
  "status": "QRCODE",
  "message": "Scan the QR code to connect."
}

​
Fluxo de Conexão

1

Obter o QR Code

Chame GET /sessions/:id/qrcode e exiba qrCode para o usuário.
2

Usuário escaneia

O usuário abre o WhatsApp → Configurações → Dispositivos conectados → Conectar dispositivo.
3

Conexão estabelecida

A sessão atualiza para status: connected e dispara o webhook session.connected.
O QR Code expira após aproximadamente 60 segundos. Se expirar, chame GET /sessions/:id/qrcode novamente.