Obter por Telefone

Com essa operação, a automação pode localizar o cadastro de uma pessoa no sistema apenas pelo número de telefone.

A operação Obter Pessoa por Telefone localiza um registro de pessoa na sua base de contatos utilizando um número de telefone como critério de busca.

Esta ação é fundamental para automações que partem de uma interação por telefone ou canais de mensagem, como WhatsApp, SMS ou Telegram. Ao receber uma comunicação, você pode usar o número do remetente para buscar o perfil completo do contato na Hablla e personalizar o restante do fluxo.

Se um contato com o telefone especificado for encontrado, a operação retorna o objeto completo da pessoa. Caso contrário, o resultado será vazio.

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 Telefone".

3. No campo "Telefone" (phone), insira o número de telefone que você deseja usar para a busca. Este valor pode ser um texto fixo ou uma variável vinda de um gatilho.

---

Parâmetros

Campo	Tipo	Obrigatório?	Descrição
Telefone (phone)	Texto	✅ Sim	O número de telefone exato da pessoa a ser localizada. Recomenda-se o uso do formato internacional (ex: [phone]).

Exportar para as Planilhas

---

Estrutura da Saída (Exemplo de Resultado)

Se uma pessoa for encontrada, o resultado será um objeto JSON com a estrutura similar à da operação "Obter por ID".

JSON

{
  "id": "person_abcdef123456",
  "name": "Ricardo Mendes",
  "customer_status": "opportunity",
  "is_blocked": false,
  "created_at": "2023-11-05T14:00:00Z",
  "phones": [
    {
      "type": "personal",
      "phone": "[phone]",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "[email protected]"
    }
  ]
}

---

🚀 Exemplo de Caso de Uso

Objetivo: Quando um cliente envia uma mensagem para o WhatsApp da empresa, buscar seu cadastro na Hablla e direcionar a conversa para o vendedor responsável por ele.

1. Crie um fluxo que começa com um gatilho de "Nova Mensagem Recebida" do seu conector de WhatsApp. O gatilho fornecerá o número do remetente (trigger.sender.phone).

2. Adicione o bloco "Pessoas" com a operação "Obter por Telefone".

3. No campo "Telefone", insira a variável do número do remetente: {{trigger.sender.phone}}.

4. Adicione um bloco de Condição (If) para verificar se uma pessoa foi encontrada ({{steps.2.result.id}} não está vazio).

   • Se Sim: Use a operação "Obter Usuário por ID" para buscar os dados do responsável ({{steps.2.result.users[0].id}}) e, em seguida, transfira a conversa para ele.

   • Se Não: Crie uma nova pessoa com a operação "Criar Pessoa" e direcione a conversa para a fila de triagem geral.

Com esta automação, você oferece um atendimento imediato e personalizado, pois o sistema reconhece o cliente e o encaminha para a pessoa certa sem intervenção manual.