# Contatos

# Contatos

O módulo de Contatos do Apre.Chat centraliza todos os contatos com os quais a empresa já interagiu ou que foram cadastrados manualmente. É a base de dados de pessoas e grupos do WhatsApp, onde você pode gerenciar informações, vincular contatos ao Apresenta.me e iniciar novos atendimentos.

Os contatos são criados automaticamente quando alguém envia uma mensagem pela primeira vez, ou podem ser importados em lote a partir do WhatsApp ou de um arquivo CSV.

**Rotina:**<span style="white-space: pre-wrap;"> Contatos</span>

#### **1. Navegação no módulo**

[![image.png](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/scaled-1680-/TTYimage.png)](https://ajuda.apresenta.me/uploads/images/gallery/2026-06/TTYimage.png)

<span style="white-space: pre-wrap;">Para acessar, clique em </span>**Contatos**<span style="white-space: pre-wrap;"> no menu lateral esquerdo do Apre.Chat.</span>

#### **2. Como funciona**

A tela principal exibe todos os contatos cadastrados com nome, número de WhatsApp e e-mail. A barra superior oferece filtros e ações de gerenciamento:

- **Grupos**, filtra para exibir somente grupos de WhatsApp.
- **Usuários**, filtra para exibir somente contatos individuais.
- **Setores**, filtra por setor responsável pelo contato.
- **Adicionar**, abre o formulário para cadastrar um novo contato manualmente.
- **Importar**, importa contatos do WhatsApp conectado ou de um arquivo CSV.
- **Exportar**, exporta a lista de contatos em formato CSV.

<p class="callout info"><span style="white-space: pre-wrap;">Contatos de grupos de WhatsApp são identificados pelo campo </span>**isGroup**. O número de um grupo não pode ser editado após o cadastro.</p>

#### **3. Cadastrando um contato**

<span style="white-space: pre-wrap;">Ao clicar em </span>**Adicionar**, um formulário é aberto com os seguintes campos:

<table id="bkmrk-campodescri%C3%A7%C3%A3oobriga" style="width: 100%; table-layout: fixed;"><colgroup><col style="width: 200px;"></col><col></col><col style="width: 110px;"></col></colgroup><tbody><tr><th style="width: 200px; white-space: nowrap;">Campo

</th><th>Descrição

</th><th class="align-center" style="width: 110px; white-space: nowrap; text-align: center;">Obrigatório

</th></tr><tr><td>Nome

</td><td>Nome do contato como aparecerá nos atendimentos e na listagem.

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>Número

</td><td>Número de WhatsApp com código do país e DDD, sem espaços ou caracteres especiais. Exemplo: 5547999990000. O número não pode ser alterado após o cadastro.

</td><td class="align-center" style="text-align: center;">Sim

</td></tr><tr><td>E-mail

</td><td>Endereço de e-mail do contato. Campo informativo, usado para registros e vinculação com o Apresenta.me.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Vinculação ao Apresenta.me

</td><td>Vincula o contato a uma Pessoa ou Negócio no sistema Apresenta.me. Permite abrir o registro do cliente diretamente do atendimento no Apre.Chat.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Apenas responsável

</td><td>Quando ativado, somente o usuário responsável pelo contato pode visualizar e atender suas conversas.

</td><td class="align-center" style="text-align: center;">Não

</td></tr><tr><td>Bloqueado

</td><td>Bloqueia o contato para que mensagens dele não gerem novos atendimentos no sistema.

</td><td class="align-center" style="text-align: center;">Não

</td></tr></tbody></table>

<p class="callout warning">O número de WhatsApp de um contato não pode ser editado após o cadastro. Se precisar corrigir um número, exclua o contato e crie um novo.</p>

#### **4. Importando contatos**

Dois métodos de importação estão disponíveis:

- **Importar do WhatsApp**, importa automaticamente os contatos da agenda do número de WhatsApp conectado. Útil para carregar rapidamente a base de contatos a partir de uma conexão Baileys.
- **Importar via arquivo CSV**, importa contatos a partir de uma planilha. O sistema permite mapear as colunas do arquivo para os campos do contato (nome, número, e-mail). Ideal para migrar bases de dados de outros sistemas.

<p class="callout success">Use a importação via CSV para cadastrar múltiplos contatos de uma só vez, como listas de clientes ou leads exportados de outros sistemas.</p>

#### **5. Vinculação com o Apresenta.me**

Cada contato do Apre.Chat pode ser vinculado a um registro no sistema Apresenta.me:

- **Pessoa**, vincula a uma pessoa física ou jurídica cadastrada no Apresenta.me.
- **Negócio**, vincula a um negócio específico no Apresenta.me.

Com o vínculo ativo, o operador pode abrir o cadastro do cliente diretamente do atendimento no Apre.Chat e registros de histórico podem ser sincronizados entre os dois sistemas.

<p class="callout info">A vinculação ao Apresenta.me não pode ser editada por operadores comuns. Apenas usuários com permissão específica podem alterar esse campo.</p>

#### **6. Iniciando um atendimento a partir de um contato**

Na listagem de contatos, clique sobre um contato para abrir o detalhamento. A partir daí, você pode iniciar um novo atendimento (ticket) com aquele contato, selecionar a conexão WhatsApp e o setor responsável.

#### **7. Perguntas frequentes**

**Os contatos são criados automaticamente quando alguém envia mensagem?**  
Sim. Quando um número desconhecido envia uma mensagem pelo WhatsApp, o Apre.Chat cria um contato automaticamente com o número e o nome salvo na agenda (quando disponível).

**Posso bloquear um contato específico?**  
Sim. Ao editar um contato e ativar o campo Bloqueado, mensagens futuras desse número não gerarão novos atendimentos no sistema.

**O que acontece com o histórico de atendimentos ao excluir um contato?**  
Os atendimentos (tickets) anteriores são preservados, mas ficam sem o vínculo ao contato. O número continua existindo nos registros históricos.

**Posso exportar toda a base de contatos?**  
<span style="white-space: pre-wrap;">Sim. Use o botão </span>**Exportar**<span style="white-space: pre-wrap;"> para baixar um arquivo CSV com todos os contatos cadastrados.</span>