> ## 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.

# Chats

> Listar e gerenciar conversas de uma instância

Use `chats` para listar conversas e aplicar ações como arquivar, silenciar, fixar e expiração.

Para instâncias, veja [Instâncias e billing](/pt-BR/sdk/python/instances-and-billing). Para sessão, veja [Sessão](/pt-BR/sdk/python/session).

## Chats

### `client.chats.list(...)`

```python theme={null}
chats = client.chats.list(
    instance_id="VZ...",
    instance_token="instance-token",
    page=1,
    page_size=20,
)
```

**Retorno:** pagina `{ page, page_size, total, total_pages, content[] }` com metadados de cada chat.

### `client.chats.get(...)`

```python theme={null}
chat = client.chats.get(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Retorno:** `InstanceChatMetadata` — `phone`, `jid`, `name`, flags (`archived`, `pinned`, `muted`, etc.) e ultima mensagem quando disponivel.

### `client.chats.archive(...)`

```python theme={null}
client.chats.archive(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Retorno:** `{ status: "ok" }`.

### `client.chats.unarchive(...)`

```python theme={null}
client.chats.unarchive(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Retorno:** `{ status: "ok" }`.

### `client.chats.mute(...)`

```python theme={null}
client.chats.mute(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    duration_seconds=3600,
)
```

**Retorno:** `{ status: "ok" }`.

### `client.chats.unmute(...)`

```python theme={null}
client.chats.unmute(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Retorno:** `{ status: "ok" }`.

### `client.chats.pin(...)`

```python theme={null}
client.chats.pin(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Retorno:** `{ status: "ok" }`.

### `client.chats.unpin(...)`

```python theme={null}
client.chats.unpin(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Retorno:** `{ status: "ok" }`.

### `client.chats.read(...)`

```python theme={null}
client.chats.read(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Retorno:** `{ status: "ok" }`.

### `client.chats.unread(...)`

```python theme={null}
client.chats.unread(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
)
```

**Retorno:** `{ status: "ok" }`.

### `client.chats.clear(...)`

```python theme={null}
client.chats.clear(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    delete_media=False,
)
```

**Retorno:** `{ status: "ok" }`.

### `client.chats.delete(...)`

```python theme={null}
client.chats.delete(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    delete_media=False,
)
```

**Retorno:** `{ status: "ok" }`.

### `client.chats.set_expiration(...)`

```python theme={null}
client.chats.set_expiration(
    instance_id="VZ...",
    instance_token="instance-token",
    phone="5511999999999",
    expiration="7_DAYS",
)
```

**Retorno:** `{ status: "ok" }`.

Valores aceitos em `expiration`: `24_HOURS`, `7_DAYS`, `90_DAYS`, `OFF`.