> For the complete documentation index, see [llms.txt](https://docs.hablla.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/obter-por-telefone.md).

# 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: `+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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hablla.com/fluxos-de-automacoes/todos-os-componentes/hablla/pessoas/obter-por-telefone.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
