# Obter por ID

A operação Obter Pessoa por ID recupera todas as informações de um registro de pessoa específico, utilizando o seu identificador único (`personId`).

Esta ação é uma das mais utilizadas em automações, pois permite carregar os dados de um contato conhecido para utilizá-los em etapas seguintes, como personalizar uma mensagem, tomar decisões com base em seus dados (ex: status do cliente) ou simplesmente verificar suas informações.

O resultado desta operação é um objeto completo contendo todos os campos da pessoa, incluindo campos personalizados.

#### 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 por ID".
3. No campo "ID da Pessoa" (`personId`), insira o identificador único da pessoa que você deseja consultar. Este valor geralmente é obtido de um gatilho ou de uma etapa anterior do fluxo.

***

### Parâmetros

| Campo                   | Tipo               | Obrigatório? | Descrição                                                                                                                                                 |
| ----------------------- | ------------------ | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID da Pessoa            | Texto              | ✅ Sim        | O ID único da pessoa a ser consultada.                                                                                                                    |
| Popular Dados da Pessoa | Booleano (Sim/Não) | ❌ Não        | Se definido como `true`, a busca pode retornar dados relacionados adicionais, como informações detalhadas de organizações ou outros registros associados. |

Exportar para as Planilhas

***

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

Após a execução, o resultado deste bloco será um objeto JSON com a estrutura abaixo, que pode ser acessado em passos seguintes (ex: `{{steps.1.result}}`):

JSON

```
{
  "id": "person_abcdef123456",
  "name": "Juliana Souza",
  "about": "Gerente de Marketing na Empresa Exemplo.",
  "photo_url": "https://example.com/juliana.jpg",
  "privacy": "granted",
  "customer_status": "customer",
  "is_blocked": false,
  "created_at": "2023-10-26T10:00:00Z",
  "updated_at": "2024-08-16T15:30:00Z",
  "users": [
    {
      "id": "user_xyz789",
      "name": "Carlos Andrade"
    }
  ],
  "phones": [
    {
      "type": "business",
      "phone": "+5511977775555",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "juliana.souza@example.com"
    }
  ],
  "custom_fields": {
    "data_ultima_reuniao": "2024-08-10",
    "nivel_satisfacao": "Muito Satisfeita"
  }
}
```

***

### 🚀 Exemplo de Caso de Uso

Objetivo: Enviar um e-mail de boas-vindas personalizado para um novo cliente assim que um negócio for marcado como "Ganho".

1. Crie um fluxo com o gatilho "Card Movido", configurado para a etapa "Ganha" do seu funil de vendas. O gatilho fornecerá o `cardId` e o `personId` associado.
2. Adicione o bloco "Pessoas" com a operação "Obter por ID".
3. No campo "ID da Pessoa", insira a variável correspondente do gatilho (ex: `{{trigger.person.id}}`).
4. Adicione um bloco de envio de e-mail na etapa seguinte.
5. No corpo do e-mail, personalize a saudação usando os dados obtidos no passo anterior. Por exemplo: "Olá, `{{steps.2.result.name}}`! Bem-vindo(a) à nossa empresa."

Desta forma, você utiliza os dados em tempo real da pessoa para criar uma comunicação muito mais pessoal e eficaz, de forma totalmente automatizada.


---

# 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-por-id.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.