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

# Sessão

> Status, QR code, pareamento e desconexão da sessão WhatsApp

Use `sessions` para pareamento, consulta de status e desconexão da sessão WhatsApp.

Para instâncias e billing, veja [Instâncias e billing](/pt-BR/sdk/python/instances-and-billing). Para chats, veja [Chats](/pt-BR/sdk/python/chats).

## Sessão

### `client.sessions.status(instance_id, instance_token=...)`

```python theme={null}
status = client.sessions.status("VZ...", instance_token="instance-token")
```

Retorna `SessionStatusResponse`. Campos de `data` nesta ordem:

1. `connected` — sempre primeiro
2. `phone`
3. `whatsapp_jid`
4. `push_name`
5. `business_name`
6. `business_profile` — subcampos: `businessHoursTimezone`, `categories`, `profileOptions`, `address`, `email`
7. `profile_picture_id`
8. `profile_picture_url`
9. `profile_url`
10. `verified_name` — `about`, `website` (quando aplicavel)

Quando desconectada, `data` so tem `connected=False`. Campos vazios sao omitidos.

### `client.sessions.qr(instance_id, instance_token=...)`

```python theme={null}
qr = client.sessions.qr("VZ...", instance_token="instance-token")
```

**Retorno:** envelope `{ code, success, data }`. Se ainda nao conectada, `data.qr_code` (data URL PNG). Se ja conectada, `data.status` e `data.phone`.

### `client.sessions.pair_code(instance_id, phone, instance_token=...)`

```python theme={null}
pair_code = client.sessions.pair_code(
    "VZ...",
    "5511999999999",
    instance_token="instance-token",
)
```

**Retorno:** envelope `{ code, success, data }` com `data.linking_code` (codigo de pareamento).

### `client.sessions.disconnect(instance_id, instance_token=...)`

```python theme={null}
client.sessions.disconnect("VZ...", instance_token="instance-token")
```

**Retorno:** `InstanceActionResponse` — `instance_id`, `status`, `details`.