# 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! 🚀