# Obter por filtro

### 🎯 **O que essa operação faz?**

Essa operação permite buscar registros dentro de uma tabela do dicionário utilizando filtros personalizados.

#### ✅ **Principais características:**

* Recupera múltiplos registros com base em critérios específicos.
* Permite aplicar filtros para refinar a busca.
* Pode ser usada para carregar listas dinâmicas ou validar informações.

### 📂 **Como Configurar a Operação "Buscar por Filtro"**

#### 1️⃣ **Acesse o Componente**

1. No **Hablla Studio**, abra o fluxo de automação onde deseja buscar registros no dicionário.
2. Adicione o bloco **"Dicionário"**.
3. No painel lateral direito, selecione a operação **"Buscar por Filtro"**.

#### 2️⃣ **Preencha os Campos Obrigatórios**

| **Campo**          | **Tipo de Dado** | **Obrigatório?** | **Descrição**                                                     |
| ------------------ | ---------------- | ---------------- | ----------------------------------------------------------------- |
| **Workspace ID**   | `string`         | ✅ Sim            | ID do workspace onde a tabela do dicionário está localizada.      |
| **Nome da Tabela** | `string`         | ✅ Sim            | Nome da tabela do dicionário onde os registros estão armazenados. |

#### 3️⃣ **Adicionar Filtros (Opcional)**

Além dos campos obrigatórios, você pode definir filtros para refinar a busca.

| **Filtro**                | **Tipo de Dado**               | **Descrição**                                                               |
| ------------------------- | ------------------------------ | --------------------------------------------------------------------------- |
| **Campos Personalizados** | `collection`                   | Permite selecionar quais campos do dicionário devem ser usados como filtro. |
| **Método de Filtro**      | `string` (`fields` ou `query`) | Define se a busca será baseada em campos específicos ou em query string.    |
| **Ordenação**             | `string` (`asc` ou `desc`)     | Define a ordem crescente (`asc`) ou decrescente (`desc`) dos resultados.    |
| **Página**                | `number`                       | Permite definir a página da busca para paginação dos resultados.            |
| **Limite**                | `number`                       | Define quantos registros devem ser retornados por vez.                      |

⚠️ **Atenção!**

* Se nenhum filtro for aplicado, a busca retornará todos os registros da tabela.
* Utilize a paginação para evitar retorno excessivo de registros.

#### 4️⃣ **Salvar a Configuração**

Após preencher os campos e definir os filtros, clique no botão **"Salvar"** ✅.

Agora, sempre que essa automação for acionada, os registros filtrados serão retornados automaticamente.

### 📌 **Exemplo de Uso no Fluxo de Automação**

📊 **Cenário:** Você deseja buscar todos os clientes cadastrados na tabela **"Clientes"** do dicionário que estão no status **"Ativo"**.

#### 🔹 **Fluxo de automação:**

1️⃣ **Bloco 1** → Disparar uma automação sempre que um cliente realizar uma ação.\
2️⃣ **Bloco 2** → Buscar no dicionário todos os clientes com status **"Ativo"**.\
3️⃣ **Bloco 3** → Enviar uma mensagem personalizada para esses clientes.

🚀 **Resultado:** A automação filtra e retorna apenas os registros relevantes, permitindo comunicações direcionadas e segmentadas.

### 🎉 **Conclusão**

A operação **Buscar Registros por Filtro no Dicionário** é ideal para encontrar informações específicas de maneira dinâmica e personalizada. Com essa funcionalidade, você pode otimizar buscas e tornar suas automações ainda mais inteligentes no Hablla Studio.

Se precisar de mais suporte, entre em contato com nossa equipe! 🚀


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/dicionario/obter-por-filtro.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.