Obter Todos

Com essa operação, a automação pode obter uma lista completa de pessoas cadastradas dentro do sistema, o que é útil para análise de dados, segmentação ou ações em massa.

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": "[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
  }
}

---

🚀 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.