> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/contatos.md).
# Contatos
### Finalidade
A tela **Contatos** centraliza o cadastro de pessoas e empresas atendidas: criar, editar, filtrar, importar/exportar e iniciar atendimento por canal.
**Caminho:** menu lateral → **Contatos**
Também pode ser aberta de dentro do **Atendimento** (modo contatos do chat).
***
### O que você vê na tela
* Título **Contatos** e chip de **limite do plano** (ex.: X de Y contatos, ou ilimitado)
* Botões de ação no cabeçalho
* Filtros (busca, carteira, notas, etiquetas, canal, país/estado)
* Atalho alfabético (A–Z)
* Lista em modo **tabela** ou visão de **notas**
#### Ações do cabeçalho
| Ação | Quem usa | Função |
| ---------------------- | ------------- | -------------------------------------------------- |
| Adicionar | Todos | Abre o modal de novo contato |
| Importar | Todos | Importação CSV clássica |
| Importação Inteligente | Todos | CSV/XLS/XLSX com mapeamento e análise de conflitos |
| Exportar | Admin / Super | Baixa a base de contatos |
| Deletar duplicados | Admin / Super | Remove registros duplicados |
| Alternar visão | Todos | Troca entre lista de contatos e página de notas |
***
### Filtros e busca
| Filtro | Descrição |
| -------------------------- | ----------------------------------------- |
| Pesquisar Nome ou Telefone | Busca textual |
| Carteira | Filtra por carteira do atendente |
| Nota por palavra | Busca no conteúdo das notas |
| Etiquetas | Uma ou mais tags |
| Canal | WhatsApp, Instagram, Telegram, etc. |
| País / Estado / Região | Filtros geográficos (quando houver dados) |
| Letras A–Z | Atalho por inicial do nome |
***
### Lista de contatos
Cada contato pode mostrar:
* Nome (e selo de **Business verificado**, se houver)
* Número / Instagram / Telegram
* Status **Validado** / inválido para WhatsApp (ou WABA)
* E-mail
* Carteiras e etiquetas
* Ações rápidas por canal para **iniciar atendimento**
#### Iniciar atendimento a partir do contato
1. Clique no ícone do canal desejado (WhatsApp, WABA, Instagram, Facebook, Telegram, etc.).
2. Selecione o **canal/conexão** e a **fila** (quando pedido).
3. Confirme.
4. Se já existir atendimento em curso, o sistema pergunta se deseja abrir o ticket existente.
***
### Adicionar ou editar contato
Clique em **Adicionar** ou no ícone **Editar** do contato.
O modal tem três abas:
#### Geral
* Foto / avatar
* Nome, número (DDI + DDD + celular), e-mail
* Carteira e etiquetas
* Informações adicionais (pares descrição/informação)
* Verificação de número WhatsApp (marcar como validado)
* Atualizar nome/dados pelo WhatsApp (quando disponível)
#### Pessoa / Empresa
* Primeiro e último nome, nome da empresa
* CPF/CNPJ (com busca de dados do CNPJ, quando aplicável)
* Data de nascimento, gênero, estado civil, origem
* Website, categoria
#### Organização
* Dados organizacionais vinculados ao contato (quando usados no tenant)
Também é possível gerenciar **notas do contato** no fluxo de edição / modal de notas.
***
### Importar contatos
#### Importação clássica (CSV)
1. Clique em **Importar**.
2. (Opcional) Baixe o **modelo** de planilha.
3. Envie o CSV com colunas de Nome e Número (e demais campos mapeados).
4. Configure verificação WhatsApp / marcar como validado, se desejado.
5. Confirme. A página atualiza ao finalizar.
#### Importação Inteligente
Fluxo em etapas: **Arquivo → Mapeamento → Análise → Resultado**.
* Aceita **CSV, XLS ou XLSX**
* Mapeia colunas da planilha para campos do contato (telefone obrigatório)
* Analisa inconsistências/conflitos antes de importar
***
### Exportar e limpeza
* **Exportar** (admin/super): gera arquivo da base conforme filtros/contexto.
* **Deletar duplicados** (admin/super): remove duplicidades — ação irreversível.
***
### Excluir contato
A exclusão é **permanente**: apaga o contato e o histórico vinculado (tickets e mensagens), sem recuperação.
Confirme apenas se tiver certeza.
***
### Regras importantes
* O plano pode limitar a quantidade de contatos.
* Número deve seguir o padrão com DDI e DDD (ex.: celular BR com 9 dígitos após DDD).
* Contato duplicado (mesmo identificador) não é criado de novo.
* Contatos validados no WhatsApp entram melhor em campanhas.
* Em alguns perfis, dados sensíveis podem aparecer mascarados (**Dados ocultos**).
* Importação com verificação WhatsApp pode demorar.
***
### Mensagens e erros comuns
| Situação | Mensagem / comportamento |
| ---------------------- | -------------------------------------------- |
| Contato criado/editado | Contato criado! / Contato editado! |
| Duplicado | Este contato já está cadastrado! |
| Número inválido | Número Invalido |
| Importação ok | Contatos importados com sucesso! |
| Exportação ok | Contatos exportados com sucesso! |
| Exclusão | Contato deletado! / Não foi possível deletar |
| Ticket em curso | Oferece abrir o atendimento existente |
| Limite do plano | Chip/tooltip com uso atual vs máximo |
| Falha ao carregar | Erro ao carregar Contatos |
***
### Dicas de uso
* Use **etiquetas** e **carteira** para organizar a base antes das campanhas.
* Prefira a **Importação Inteligente** em planilhas complexas.
* Marque números como **validados** só quando tiver certeza (evita problemas em campanhas).
* Inicie o atendimento pelo ícone do canal correto no card do contato.