> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxenty.api.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar Sessão

> Obtém o QR Code e conclui a conexão via WhatsApp

Para conectar uma sessão no WhatsApp, você deve **obter o QR Code** e escanear pelo aplicativo.

<Note>
  O endpoint principal para obter QR Code é `GET /sessions/:id/qrcode`.
</Note>

## Path Parameters

<ParamField path="id" type="string" required>
  ID da sessão (UUID).
</ParamField>

## Resposta

<ResponseField name="qrCode" type="string">
  QR Code em formato texto.
</ResponseField>

<ResponseField name="sessionId" type="string">
  ID da sessão.
</ResponseField>

<ResponseField name="status" type="string">
  Status atual da sessão.
</ResponseField>

<ResponseField name="message" type="string">
  Mensagem de status.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X GET "https://api.oxenty.api.br/api/sessions/550e8400-e29b-41d4-a716-446655440000/qrcode" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={"system"}
  await client.sessions.connect('550e8400-e29b-41d4-a716-446655440000');

  const qr = await client.sessions.getQRCode('550e8400-e29b-41d4-a716-446655440000');
  console.log('Escaneie o QR Code:', qr.qr);
  ```

  ```python Python theme={"system"}
  client.sessions.connect('550e8400-e29b-41d4-a716-446655440000')

  qr = client.sessions.get_qrcode('550e8400-e29b-41d4-a716-446655440000')
  print(f"Escaneie o QR Code: {qr['qr']}")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "qrCode": "2@ABC123xyz...",
    "status": "QRCODE",
    "message": "Scan the QR code to connect."
  }
  ```

  ```json 404 Not Found theme={"system"}
  {
    "statusCode": 404,
    "error": "SESSION_NOT_FOUND",
    "message": "Sessão não encontrada"
  }
  ```
</ResponseExample>

## Fluxo de Conexão

<Steps>
  <Step title="Obter o QR Code">
    Chame `GET /sessions/:id/qrcode` e exiba `qrCode` para o usuário.
  </Step>

  <Step title="Usuário escaneia">
    O usuário abre o WhatsApp → Configurações → Dispositivos conectados → Conectar dispositivo.
  </Step>

  <Step title="Conexão estabelecida">
    A sessão atualiza para `status: connected` e dispara o webhook `session.connected`.
  </Step>
</Steps>

<Note>
  O QR Code expira após aproximadamente 60 segundos. Se expirar, chame `GET /sessions/:id/qrcode` novamente.
</Note>