# Obter Todos

A operação Obter Todas as Pessoas recupera uma lista de pessoas da sua base de contatos. Por padrão, a lista é paginada para garantir um bom desempenho, mesmo com um grande volume de dados.

Esta ação é extremamente versátil, pois permite a aplicação de diversos filtros para segmentar a busca, como buscar por pessoas criadas em um determinado período, com um status específico, associadas a uma organização, entre muitas outras opções.

O resultado é uma coleção (array) de objetos, onde cada objeto representa uma pessoa que atende aos critérios de busca.

#### Como Configurar

1. No Hablla Studio, adicione o bloco "Pessoas" ao seu fluxo de automação.
2. No campo "Operação", selecione a opção "Obter Todos".
3. Opcionalmente, clique em "Adicionar Filtro" para especificar os parâmetros de busca e refinar seus resultados.

***

### Filtros Disponíveis

Você pode combinar os filtros abaixo para criar consultas precisas.

| Filtro                   | Tipo            | Descrição                                                                                         |
| ------------------------ | --------------- | ------------------------------------------------------------------------------------------------- |
| Página (`page`)          | Número          | O número da página de resultados que você deseja obter. O padrão é 1.                             |
| Limite (`limit`)         | Número          | A quantidade máxima de pessoas a serem retornadas por página.                                     |
| Ordenar por (`order`)    | Lista de Opções | Campo pelo qual os resultados serão ordenados. Opções: `created_at`, `updated_at`, `name`.        |
| Direção da Ordem         | Lista de Opções | Define a direção da ordenação. Opções: `asc` (ascendente) ou `desc` (descendente).                |
| Data de Início           | Data/Hora       | Retorna pessoas criadas a partir desta data e hora.                                               |
| Data de Fim              | Data/Hora       | Retorna pessoas criadas até esta data e hora.                                                     |
| Nome                     | Texto           | Filtra pessoas por um nome específico.                                                            |
| E-mail                   | Texto           | Filtra pessoas por um endereço de e-mail específico.                                              |
| Telefone                 | Texto           | Filtra pessoas por um número de telefone específico.                                              |
| Busca (`search`)         | Texto           | Realiza uma busca geral por um termo em vários campos principais da pessoa.                       |
| Busca Completa           | Booleano        | Se `true`, realiza uma busca mais profunda e abrangente, o que pode levar mais tempo.             |
| Possui Chaves Duplicadas | Booleano        | Se `true`, retorna apenas pessoas que possuem identificadores duplicados (ex: mesmo e-mail).      |
| Está Bloqueado           | Booleano        | Filtra pessoas pelo seu status de bloqueio (`true` para bloqueadas, `false` para não bloqueadas). |
| Organização              | Lista de Opções | Filtra pessoas que pertencem a uma organização específica.                                        |
| Campos Personalizados    | Chave-Valor     | Filtra pessoas com base nos valores de seus campos personalizados.                                |

***

### Estrutura da Saída (Exemplo de Resultado)

A saída deste bloco será um objeto contendo a lista de pessoas e informações de paginação.

JSON

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

***

### 🚀 Exemplo de Caso de Uso

Objetivo: Gerar um relatório semanal com todos os novos leads qualificados e enviá-lo para uma planilha do Google Sheets.

1. Crie um fluxo com um gatilho agendado para ser executado toda segunda-feira às 9h.
2. Adicione o bloco "Pessoas" com a operação "Obter Todos".
3. Configure os seguintes filtros:
   * Data de Início: Use uma expressão para definir a data para 7 dias atrás.
   * Data de Fim: Use uma expressão para a data atual.
   * Status do Cliente: Selecione `sales_qualified_lead`.
4. Adicione um laço (`loop`) para iterar sobre a lista de pessoas retornada (`{{steps.2.result.data}}`).
5. Dentro do laço, adicione um bloco do Google Sheets com a ação "Adicionar Linha" e mapeie os dados de cada pessoa (nome, e-mail, telefone, etc.) para as colunas da sua planilha.

Com este fluxo, sua equipe de vendas receberá uma lista atualizada de leads qualificados no início de cada semana, de forma totalmente automática.


---

# 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/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/obter-todos.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.