Obter por e-mail

Com essa operação, a automação pode localizar o cadastro de uma pessoa no sistema apenas pelo 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": "[phone]",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "[email protected]"
    }
  ]
}

---

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