---
title: "Pesquisar Contato"
slug: "pesquisar-contato"
updated: 2026-04-24T17:54:58Z
published: 2026-04-24T17:54:58Z
canonical: "docs.omnisiga.ai/pesquisar-contato"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnisiga.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pesquisar Contato

A caixa de **Pesquisa Contato** é utilizada para buscar, dentro do sistema, um contato já existente.

Essa etapa é fundamental para garantir que o fluxo de atendimento esteja vinculado a um contato previamente cadastrado.

---

## Configuração

- **Nome do elemento** Campo onde deve ser definido o nome da caixa no fluxo.
- **Variável para identificação do contato** Campo onde deve ser inserido o nome da variável que contém o identificador do contato.

> Exemplo: utilizar uma caixa de **[Coletar Dados](/v1/docs/coletar-dados)** e armazenar o valor em uma variável.
- **Pesquisar contato por** Define o tipo de identificação utilizado na busca. Opções disponíveis:
  - Número de WhatsApp
  - Instagram
  - E-mail
  - Facebook
  - Telegram
  - Identificador personalizado
- **Vincular contato ao atendimento atual** Checkbox que, quando marcado, vincula o contato encontrado ao fluxo de atendimento atual. ![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(709).png)

---

## Saídas do Fluxo

Após a execução da busca, é necessário definir o próximo passo:

- **Caso o contato seja encontrado, vai para:** Define o próximo passo do fluxo quando o contato é localizado.
- **Caso o contato não seja encontrado, vai para:** Define o próximo passo do fluxo quando nenhum contato é encontrado.

---

## Exemplo de uso

### Cenário

Identificar se um cliente já possui cadastro no sistema a partir do número de WhatsApp informado no início do atendimento.

### Fluxo

1. Utilizar uma caixa de **Coletar Dados** para capturar o número do cliente
  - Variável: `telefone_cliente`
2. Configurar a caixa **Pesquisa Contato**:
  - **Variável para identificação do contato:** `telefone_cliente`
  - **Pesquisar contato por:** Número de WhatsApp
  - **Vincular contato ao atendimento atual:** marcado
3. Definir saídas:
  - **Caso encontrado →** seguir para atendimento
  - **Caso não encontrado →** direcionar para criação de contato

---

## Boas Práticas

- Garantir que a variável de identificação esteja preenchida corretamente
- Padronizar o tipo de identificação utilizado (ex.: sempre usar WhatsApp quando possível)
- Utilizar essa caixa sempre no início do fluxo, quando necessário identificar o contato