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

# Contatos: Importe, Pesquise e Gerencie sua Base de CRM

> Crie, importe, marque, pesquise e exporte contatos no PanÐá Zap. Mantenha seu CRM organizado com importação em massa, remoção de duplicados e utilitários de formatação de número.

A página de **Contatos** é sua agenda central. Você pode criar contatos um a um, importar em massa a partir de uma planilha, pesquisar e filtrar por qualquer atributo, exportar sua base completa e executar utilitários de manutenção para manter seus dados precisos e sem duplicidades.

## Acesso

Navegue até **Atendimento → Contatos** na barra lateral principal.

***

## Criando Contatos Manualmente

Para adicionar um único contato:

1. Clique em **+ Adicionar Contato**.
2. Preencha os dados do contato:
   * **Nome** *(obrigatório)*
   * **Número** *(obrigatório)* — veja a observação de formato abaixo
   * **E-mail**
   * **Carteira** — o agente ao qual esse contato está atribuído
   * **Tags** — uma ou mais etiquetas para segmentação
3. Clique em **Salvar**.

<Note>
  Os números de telefone devem ser informados em **formato internacional**: DDI + DDD + número, sem espaços, traços ou caracteres especiais. Por exemplo, um número de celular brasileiro deve ser informado como `5511999999999` (55 = código do Brasil, 11 = DDD de São Paulo, 999999999 = número).
</Note>

***

## Importando Contatos em Massa

Use o recurso **Importação Inteligente** para enviar centenas ou milhares de contatos de uma só vez.

<Steps>
  <Step title="Abra a Importação Inteligente">
    Clique no botão **Importação Inteligente** na página de Contatos.
  </Step>

  <Step title="Baixe o template CSV (opcional)">
    Clique em **Baixar Template CSV** para obter a estrutura de colunas esperada. Use isso como ponto de partida para evitar erros de mapeamento.
  </Step>

  <Step title="Envie seu arquivo">
    Arraste e solte seu arquivo na área de upload, ou clique para selecionar. Formatos aceitos: **CSV**, **XLS**, **XLSX**, **TXT**. Tamanho máximo do arquivo: **30 MB**.
  </Step>

  <Step title="Mapeie suas colunas">
    Associe cada coluna do seu arquivo ao campo de contato correspondente. **Nome** e **Telefone** são mapeamentos obrigatórios. Todos os outros campos são opcionais.
  </Step>

  <Step title="Processe a importação">
    Clique em **Processar**. O PanÐá Zap validará cada linha e criará ou atualizará os contatos. Linhas com erros serão sinalizadas para revisão.
  </Step>
</Steps>

***

## Pesquisando e Filtrando

Use a barra de ferramentas no topo da tabela de contatos para encontrar os contatos que você precisa:

* **Barra de busca** — pesquise por nome, e-mail ou número de telefone
* **Filtrar por tag** — filtre contatos com uma tag específica, com lógica **qualquer** (corresponde a pelo menos uma) ou **todas** (deve ter todas as tags selecionadas)
* **Filtrar por carteira** — mostre apenas contatos atribuídos a um agente específico
* **Alternar colunas visíveis** — mostre ou oculte colunas opcionais como CPF, cidade, CEP, status de bloqueio e outras

***

## Exportando Contatos

Para baixar sua base de contatos:

1. Aplique os filtros de busca desejados para delimitar a exportação (ou deixe-os limpos para exportar todos os contatos).
2. Clique em **Contatos → Exportar Contatos**.

A exportação é baixada como uma planilha e inclui **todos os campos e todas as tags** de cada contato na visualização filtrada atual.

***

## Ações por Contato

Cada linha na tabela de contatos tem um conjunto de ícones de ação à direita:

| Ícone            | Ação                  | Descrição                                                                          |
| ---------------- | --------------------- | ---------------------------------------------------------------------------------- |
| 💬 Balão de chat | Iniciar conversa      | Abre uma nova conversa com este contato; será solicitado que você escolha um canal |
| 👁 Olho          | Pré-visualizar perfil | Veja um resumo somente leitura dos dados do contato                                |
| ✏️ Lápis         | Editar contato        | Abre o formulário do contato para atualizar qualquer campo                         |
| 🗑 Lixeira       | Excluir contato       | Exclui o contato permanentemente — esta ação não pode ser desfeita                 |

***

## Utilitários de Manutenção da Base

Clique no botão **Utilitários** para acessar ferramentas que ajudam a manter sua base de contatos precisa.

### Sincronizar Contatos

Atualiza a lista de contatos buscando os dados mais recentes do seu dispositivo ou canal conectado. Use isso se contatos adicionados recentemente não estiverem aparecendo.

### Remover Duplicados

Busca contatos com o mesmo número de telefone e os mescla em um único registro, preservando todos os dados associados.

### Verificar 9º Dígito

Corrige automaticamente números de celular brasileiros, adicionando ou removendo o **9º dígito** com base no DDD de cada número, seguindo o plano de numeração das operadoras brasileiras.

***

## O Problema de Duplicidade por LID

Em **conexões não oficiais do WhatsApp** (como integrações baseadas em Baileys), o WhatsApp às vezes identifica um contato por um código numérico longo chamado **LID**, em vez do número de telefone. Isso faz com que o mesmo contato apareça duas vezes na sua base — uma vez com o número real e outra com o LID.

<Tip>
  **Corrigir um único contato:** abra a conversa com o contato duplicado, clique no **ícone de informação (ⓘ)** para abrir o painel do contato, vá até a **aba Utilitários** e clique em **Atualizar LID**. O PanÐá Zap revinculará o LID ao número de telefone correto.

  **Corrigir todos os contatos de uma vez:** vá em **Contatos → Utilitários → Agrupar LID** para resolver automaticamente todas as duplicidades por LID em toda a sua base de contatos em uma única operação.
</Tip>