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