# Obter por e-mail

A operação Obter Pessoa por E-mail localiza um registro de pessoa na sua base de contatos utilizando um endereço de e-mail como critério de busca.

Esta ação é crucial para integrações com plataformas onde o e-mail é o principal identificador, como ferramentas de automação de marketing, sistemas de e-commerce, formulários de site e plataformas de suporte via e-mail.

Se um contato com o e-mail exato for encontrado, a operação retorna o objeto completo da pessoa, permitindo que você use seus dados nas etapas seguintes do fluxo.

#### 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 E-mail".
3. No campo "E-mail" (`email`), insira o endereço de e-mail que você deseja usar para a busca. Este valor pode ser um texto fixo ou, mais comumente, uma variável vinda de um gatilho.

***

### Parâmetros

| Campo            | Tipo  | Obrigatório? | Descrição                                              |
| ---------------- | ----- | ------------ | ------------------------------------------------------ |
| E-mail (`email`) | Texto | ✅ Sim        | O endereço de e-mail exato da pessoa a ser localizada. |

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

Se uma pessoa for encontrada, o resultado será um objeto JSON completo, idêntico ao retornado pelas outras operações de busca.

JSON

```
{
  "id": "person_ghijkl789012",
  "name": "Ana Clara Costa",
  "customer_status": "customer",
  "is_blocked": false,
  "created_at": "2023-09-20T09:15:00Z",
  "phones": [
    {
      "type": "personal",
      "phone": "+5521988887777",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "ana.costa@example.com"
    }
  ]
}
```

***

### 🚀 Exemplo de Caso de Uso

Objetivo: Quando um cliente abre um ticket de suporte através de um formulário no site, buscar seu cadastro na Hablla para verificar se ele é um cliente do plano "Premium" e, em caso afirmativo, priorizar seu atendimento.

1. Crie um fluxo que começa com um gatilho de Webhook, recebendo os dados do formulário de suporte (incluindo o e-mail do cliente).
2. Adicione o bloco "Pessoas" com a operação "Obter por E-mail".
3. No campo "E-mail", insira a variável do e-mail vinda do gatilho (`{{trigger.body.email}}`).
4. Adicione um bloco de Condição (If) para verificar o valor do campo personalizado `plano` no resultado da busca: `{{steps.2.result.custom_fields.plano}}` é igual a `Premium`.
   * Se Sim: Adicione uma etapa para criar o ticket na plataforma de suporte com a prioridade "Urgente".
   * Se Não: Crie o ticket com a prioridade "Normal".

Com esta automação, você utiliza os dados que já possui sobre seus clientes para oferecer um serviço diferenciado e mais eficiente, sem qualquer esforço manual.


---

# 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-e-mail.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.