> ## 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 `client.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/java/instances-and-billing). Para chats, veja [Chats](/pt-BR/sdk/java/chats).

## Sessão

### `client.sessions().status(instanceId, options)`

```java theme={null}
var options = InstanceRequestOptions.builder().instanceToken("instance-token").build();
SessionStatusResponse status = client.sessions().status("VZ...", options);
System.out.println(status.data().connected());
```

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

1. `connected()` — sempre primeiro
2. `phone()`
3. `whatsappJid()`
4. `pushName()`
5. `businessName()`
6. `businessProfile()` — subcampos: `businessHoursTimezone()`, `categories()`, `profileOptions()`, `address()`, `email()`
7. `profilePictureId()`
8. `profilePictureUrl()`
9. `profileUrl()`
10. `verifiedName()` — `about`, `website` (quando aplicavel)

Quando desconectada, `data()` so tem `connected()` igual a `false`. Campos vazios sao omitidos.

### `client.sessions().qr(instanceId, options)`

```java theme={null}
JsonNode qr = client.sessions().qr("VZ...", options);
```

**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().pairCode(instanceId, phone, options)`

```java theme={null}
JsonNode pairCode = client.sessions().pairCode("VZ...", "5511999999999", options);
```

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

### `client.sessions().disconnect(instanceId, options)`

```java theme={null}
client.sessions().disconnect("VZ...", options);
```

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