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

## Sessão

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

```ts theme={null}
const status = await vzaps.sessions.status('VZ...', {
  instanceToken: 'instance-token',
});
```

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: false`. Campos vazios sao omitidos.

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

```ts theme={null}
const qr = await vzaps.sessions.qr('VZ...', {
  instanceToken: 'instance-token',
});
```

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

### `sessions.pairCode(instanceId, phone, options?)`

```ts theme={null}
const pairCode = await vzaps.sessions.pairCode('VZ...', '5511999999999', {
  instanceToken: 'instance-token',
});
```

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

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

```ts theme={null}
await vzaps.sessions.disconnect('VZ...', {
  instanceToken: 'instance-token',
});
```

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