# Obter por 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: `+5511999998888`). |

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": "+5511999998888",
      "is_whatsapp": true
    }
  ],
  "emails": [
    {
      "email": "ricardo.mendes@example.com"
    }
  ]
}
```

***

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


---

# 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-telefone.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.