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

# Filas

> Inspecione e gerencie filas de mensagens e operações com o SDK Python

Use `client.queues` para monitorar mensagens e operações pendentes de uma instância.

Campos comuns em todas as chamadas:

| Campo            | Tipo     | Obrigatório | Descrição           |
| ---------------- | -------- | ----------- | ------------------- |
| `instance_id`    | `string` | Sim         | ID da instância.    |
| `instance_token` | `string` | Sim         | Token da instância. |

## `client.queues.list_messages(...)`

Lista a fila de mensagens pendentes.

```python theme={null}
messages = client.queues.list_messages(
    instance_id="VZ...",
    instance_token="instance-token",
)
print(messages)
```

**Retorno:** envelope `{ code, success, data }` com `count` e `messages[]` (`id`, `type`, `status`, etc.).

## `client.queues.remove_message(...)`

Remove uma mensagem específica da fila.

```python theme={null}
client.queues.remove_message(
    instance_id="VZ...",
    instance_token="instance-token",
    message_id="queue-message-id",
)
```

**Retorno:** envelope `{ code, success, data }` com `message_id`, `count`, `details`.

## `client.queues.purge_messages(...)`

<Warning>
  Remove todos os itens pendentes da fila de mensagens. Use apenas quando estiver certo.
</Warning>

```python theme={null}
client.queues.purge_messages(
    instance_id="VZ...",
    instance_token="instance-token",
)
```

**Retorno:** envelope `{ code, success, data }` com `count` de itens removidos.

## `client.queues.list_operations(...)`

Lista a fila de operações pendentes.

```python theme={null}
operations = client.queues.list_operations(
    instance_id="VZ...",
    instance_token="instance-token",
)
print(operations)
```

**Retorno:** envelope `{ code, success, data }` com fila de operacoes pendentes.

## `client.queues.remove_operation(...)`

Remove uma operação específica da fila.

```python theme={null}
client.queues.remove_operation(
    instance_id="VZ...",
    instance_token="instance-token",
    message_id="queue-operation-id",
)
```

**Retorno:** envelope `{ code, success, data }` com `message_id`, `count`, `details`.

## `client.queues.purge_operations(...)`

<Warning>
  Remove todos os itens pendentes da fila de operações. Use apenas quando estiver certo.
</Warning>

```python theme={null}
client.queues.purge_operations(
    instance_id="VZ...",
    instance_token="instance-token",
)
```

**Retorno:** envelope `{ code, success, data }` com `count` de itens removidos.