> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/dicionario/obter-por-filtro.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.