Obter por ID

Com essa operação, a automação pode buscar os dados de uma pessoa usando o ID dela e utilizar essas informações em outros blocos do fluxo.

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": "[phone]",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "[email protected]"
    }
  ],
  "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.