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

# Contatos

> Veja a lista de pessoas que já falaram com você, busque, filtre e abra a ficha de cada uma.

## Para que serve

**Contatos** é a agenda da organização inteira, independente do WhatsApp. Os contatos chegam sozinhos com as conversas do WhatsApp e do Instagram. Também dá para importar uma planilha ou criar um a um.

## Quem pode

* Ver a lista: quem tem acesso à tela. Quem só vê os próprios clientes enxerga só os contatos que são seus.
* **Novo contato**: quem tem acesso à tela de Contatos.
* **Importar contatos via CSV**: por padrão, todos os perfis menos o Operador. O Operador só importa se o Admin liberar essa capacidade. Veja [Como importar contatos por CSV](https://docs.stchat.app/subcontas/importar-contatos-csv.md). Para trazer contatos, funil e etiquetas de outro sistema, veja [Como trazer contatos de outro sistema](https://docs.stchat.app/subcontas/trazer-contatos-de-outro-sistema.md).
* Se aparecer **Sem acesso a este módulo**, o seu perfil não tem essa tela. Fale com quem administra a organização.

## Onde clicar

No menu, abra **Contatos**. A tela tem três partes.

* **Lateral cinza**: o total ("N na organização"), os botões **Todos**, **Pessoas** e **Grupos**, as **Visões salvas** e a seção **Segmentos** (com **Lista de bloqueio**, **Bloqueados**, **Arquivados** e **Novo segmento**).
* **Lista**: o título **Todos os contatos** com a contagem, os ícones **Novo contato** e **Importar contatos via CSV**, a busca e os filtros.
* **Ficha**: ao clicar num contato, a ficha dele abre ao lado. Veja [Ficha do contato](https://docs.stchat.app/subcontas/ficha-do-contato.md).

## Passo a passo

**1. Busque**

Digite no campo **Buscar nome, telefone, e-mail…**. A lista filtra enquanto você escreve. Se nada aparecer, a tela mostra **Nada encontrado** e **Tente outro termo**.

**2. Filtre**

Use os filtros abaixo da busca, como **Tipo** (**Pessoa física**, **Pessoa jurídica**, **Sem tipo**), **UF e cidade** e **Não perturbe**. Cada filtro ativo vira um chip com um X. Clique em **Limpar** para tirar todos.

**3. Salve a visão**

Com os filtros prontos, use **Salvar visão** em **Visões salvas**. Dê um nome. Quem é Dono, Admin ou Supervisor pode marcar **Compartilhar com a equipe**. A visão volta com um clique.

**4. Marque vários**

Clique na foto de um contato para marcá-lo. **Shift+clique** marca um intervalo. Aparece o painel de ações em massa: tags, responsável, exportar CSV, criar negócio, arquivar e excluir. O Operador vê **Peça a um supervisor** em algumas ações.

**5. Crie um contato**

Clique no ícone **Novo contato**. Só o nome e um telefone ou e-mail são obrigatórios.

## O que acontece depois

* Um clique numa linha abre a ficha ao lado.
* Quando há **possíveis duplicados**, aparece um aviso abaixo da busca com **Revisar**. Nada é unido sem você confirmar.
* Contatos **Arquivados** saem da lista, da busca e dos envios, mas conversas e histórico ficam. Eles aparecem em **Arquivados**.
* A lista carrega mais contatos conforme você rola: **Mostrando X de Y**.

## Erros comuns

* **Erro ao carregar** / **Não foi possível carregar os contatos agora. Confira a conexão e tente de novo.** Clique em **Tentar novamente**.
* **Nenhum contato com esses filtros**: clique em **Limpar filtros**.
* **Já existe uma visão com esse nome.** Escolha outro nome.
* **Módulo não liberado para esta organização.** Fale com a agência.

## Próximo passo

* [Ficha do contato](https://docs.stchat.app/subcontas/ficha-do-contato.md)
* [Como importar contatos por CSV](https://docs.stchat.app/subcontas/importar-contatos-csv.md)
* [Como trazer contatos de outro sistema](https://docs.stchat.app/subcontas/trazer-contatos-de-outro-sistema.md)
* [Listas e segmentos](https://docs.stchat.app/subcontas/listas-e-segmentos.md)
* [Kanban](https://docs.stchat.app/subcontas/kanban.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.