Obtener Todos

Con esta operación, la automatización puede obtener una lista completa de personas registradas en el sistema, lo cual es útil para análisis de datos, segmentación o acciones en masa.

La operación Obtener Todas las Personas recupera una lista de personas de su base de contactos. Por defecto, la lista está paginada para garantizar un buen rendimiento, incluso con un gran volumen de datos.

Esta acción es extremadamente versátil, ya que permite la aplicación de diversos filtros para segmentar la búsqueda, como buscar personas creadas en un periodo determinado, con un estado específico, asociadas a una organización, entre muchas otras opciones.

El resultado es una colección (array) de objetos, donde cada objeto representa a una persona que cumple con los criterios de búsqueda.

Cómo Configurar

1. En Hablla Studio, agregue el bloque "Personas" a su flujo de automatización.

2. En el campo "Operación", seleccione la opción "Obtener Todos".

3. Opcionalmente, haga clic en "Agregar Filtro" para especificar los parámetros de búsqueda y refinar sus resultados.

---

Filtros Disponibles

Puede combinar los filtros a continuación para crear consultas precisas.

Filtro	Tipo	Descripción
Página (page)	Número	El número de la página de resultados que desea obtener. El valor predeterminado es 1.
Límite (limit)	Número	La cantidad máxima de personas que se devolverán por página.
Ordenar por (order)	Lista de Opciones	Campo por el cual se ordenarán los resultados. Opciones: created_at, updated_at, name.
Dirección del Orden	Lista de Opciones	Define la dirección del ordenamiento. Opciones: asc (ascendente) o desc (descendente).
Fecha de Inicio	Fecha/Hora	Devuelve personas creadas a partir de esta fecha y hora.
Fecha de Fin	Fecha/Hora	Devuelve personas creadas hasta esta fecha y hora.
Nombre	Texto	Filtra personas por un nombre específico.
Correo electrónico	Texto	Filtra personas por una dirección de correo electrónico específica.
Teléfono	Texto	Filtra personas por un número de teléfono específico.
Búsqueda (search)	Texto	Realiza una búsqueda general por un término en varios campos principales de la persona.
Búsqueda Completa	Booleano	Si true, realiza una búsqueda más profunda y exhaustiva, lo que puede llevar más tiempo.
Posee Claves Duplicadas	Booleano	Si true, devuelve solo personas que poseen identificadores duplicados (ej: mismo correo electrónico).
Está Bloqueado	Booleano	Filtra personas por su estado de bloqueo (true para bloqueadas, false para no bloqueadas).
Organización	Lista de Opciones	Filtra personas que pertenecen a una organización específica.
Campos Personalizados	Clave-Valor	Filtra personas en función de los valores de sus campos personalizados.

---

Estructura de Salida (Ejemplo de Resultado)

La salida de este bloque será un objeto que contiene la lista de personas e información de paginación.

JSON

{
  "data": [
    {
      "id": "person_abcdef123456",
      "name": "Juliana Souza",
      "customer_status": "customer",
      "created_at": "2024-08-16T15:30:00Z",
      "emails": [{"email": "[email protected]"}]
    },
    {
      "id": "person_ghijkl789012",
      "name": "Marcos Almeida",
      "customer_status": "lead",
      "created_at": "2024-08-15T11:20:00Z",
      "emails": [{"email": "[email protected]"}]
    }
  ],
  "pagination": {
    "total": 527,
    "page": 1,
    "limit": 2
  }
}

---

🚀 Ejemplo de Caso de Uso

Objetivo: Generar un informe semanal con todos los nuevos leads calificados y enviarlo a una hoja de cálculo de Google Sheets.

1. Cree un flujo con un desencadenador programado para ejecutarse todos los lunes a las 9 h.

2. Agregue el bloque "Personas" con la operación "Obtener Todos".

3. Configure los siguientes filtros:

   • Fecha de Inicio: Use una expresión para definir la fecha de hace 7 días.

   • Fecha de Fin: Use una expresión para la fecha actual.

   • Estado del Cliente: Seleccione sales_qualified_lead.

4. Agregue un bucle (loop) para iterar sobre la lista de personas devuelta ({{steps.2.result.data}}).

5. Dentro del bucle, agregue un bloque de Google Sheets con la acción "Agregar Fila" y asigne los datos de cada persona (nombre, correo electrónico, teléfono, etc.) a las columnas de su hoja de cálculo.

Con este flujo, su equipo de ventas recibirá una lista actualizada de leads calificados al inicio de cada semana, de forma totalmente automática.