# Obtener por filtro

### 🎯 **¿Qué hace esta operación?**

Esta operación permite buscar registros dentro de una tabla del diccionario utilizando filtros personalizados.

#### ✅ **Características principales:**

* Recupera múltiples registros basados en criterios específicos.
* Permite aplicar filtros para refinar la búsqueda.
* Puede usarse para cargar listas dinámicas o validar información.

### 📂 **Cómo Configurar la Operación "Buscar por Filtro"**

#### 1️⃣ **Accede al Componente**

1. En **Hablla Studio**, abra el flujo de automatización donde desea buscar registros en el diccionario.
2. Agregue el bloque **"Diccionario"**.
3. En el panel lateral derecho, selecciona la operación **"Buscar por Filtro"**.

#### 2️⃣ **Completa los campos obligatorios**

| **Campo**              | **Tipo de Dato** | **¿Obligatorio?** | **Descripción**                                                           |
| ---------------------- | ---------------- | ----------------- | ------------------------------------------------------------------------- |
| **Workspace ID**       | `string`         | ✅ Sí              | ID del workspace donde se encuentra ubicada la tabla del diccionario.     |
| **Nombre de la Tabla** | `string`         | ✅ Sí              | Nombre de la tabla del diccionario donde los registros están almacenados. |

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

Además de los campos obligatorios, puede definir filtros para refinar la búsqueda.

| **Filtro**                | **Tipo de Dato**              | **Descripción**                                                                    |
| ------------------------- | ----------------------------- | ---------------------------------------------------------------------------------- |
| **Campos Personalizados** | `collection`                  | Permite seleccionar qué campos del diccionario deben usarse como filtro.           |
| **Método de Filtro**      | `string` (`fields` o `query`) | Define si la búsqueda se basará en campos específicos o en una cadena de consulta. |
| **Ordenación**            | `string` (`asc` o `desc`)     | Define el orden ascendente (`asc`) o descendente (`desc`) de los resultados.       |
| **Página**                | `número`                      | Permite definir la página de la búsqueda para la paginación de los resultados.     |
| **Límite**                | `número`                      | Define cuántos registros deben ser devueltos por vez.                              |

⚠️ **¡Atención!**

* Si no se aplica ningún filtro, la búsqueda devolverá todos los registros de la tabla.
* Utilice la paginación para evitar el retorno excesivo de registros.

#### 4️⃣ **Guardar la configuración**

Después de completar los campos y definir los filtros, haga clic en el botón **"Guardar"** ✅.

Ahora, siempre que se active esta automatización, los registros filtrados se devolverán automáticamente.

### 📌 **Ejemplo de uso en el flujo de automatización**

📊 **Escenario:** ¿Desea buscar todos los clientes registrados en la tabla **"Clientes"** del diccionario que están en el estado **"Activo"**.

#### 🔹 **Flujo de automatización:**

1️⃣ **Bloque 1** → Disparar una automatización siempre que un cliente realice una acción.\
2️⃣ **Bloque 2** → Buscar en el diccionario todos los clientes con estado **"Activo"**.\
3️⃣ **Bloque 3** → Enviar un mensaje personalizado a esos clientes.

🚀 **Resultado:** La automatización filtra y devuelve solo los registros relevantes, permitiendo comunicaciones dirigidas y segmentadas.

### 🎉 **Conclusión**

La operación **Buscar Registros por Filtro en el Diccionario** es ideal para encontrar información específica de manera dinámica y personalizada. Con esta funcionalidad, puede optimizar búsquedas y hacer sus automatizaciones aún más inteligentes en Hablla Studio.

Si necesitas más soporte, ¡contacta con nuestro equipo! 🚀


---

# 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/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/hablla/diccionario/obtener-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.