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

# Obtener por filtro

La operación Buscar Registros por Filtro permite recuperar múltiples registros de una tabla del diccionario en función de criterios personalizados.

### 🎯 **¿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
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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hablla.com/hablla-docs-es/flujos-de-automatizaciones/todos-los-componentes/hablla/diccionario/obtener-por-filtro.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.