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

# Visão Geral

A seção **Contatos** permite gerenciar todos os contatos cadastrados no Evo CRM em um único local.
Nesta tela, é possível visualizar, pesquisar, criar e filtrar contatos de forma rápida e organizada.

## Acessando Contatos

Para acessar a área de contatos:

1. No menu lateral esquerdo, clique em **Contatos**

2. Em seguida, selecione a opção **Contatos**

3. A tela principal será exibida com a lista de todos os contatos cadastrados.

Cada contato é apresentado em formato de card, contendo informações básicas como nome, identificador e telefone.

<img src="https://mintcdn.com/evoai-683d737d/szX7NdPh3OLITLUA/user-guides/contacts/images/contacts-main-screen.png?fit=max&auto=format&n=szX7NdPh3OLITLUA&q=85&s=f7c8908c3b40bcc8b6b622cd52deeafe" alt="Tela principal de Contatos" width="474" height="576" data-path="user-guides/contacts/images/contacts-main-screen.png" />

## Pesquisando Contatos (Busca Rápida)

A barra de pesquisa permite localizar contatos rapidamente pelo nome.

### Como pesquisar

1. Na parte superior da tela, utilize o campo **Pesquisar contatos**

2. Digite o nome ou parte do nome do contato desejado

3. A lista de contatos será atualizada automaticamente conforme o termo digitado

<img src="https://mintcdn.com/evoai-683d737d/szX7NdPh3OLITLUA/user-guides/contacts/images/search-contacts.png?fit=max&auto=format&n=szX7NdPh3OLITLUA&q=85&s=8e6083d208a69b839c23c1079ec48bf4" alt="Buscando contatos por nome" width="974" height="387" data-path="user-guides/contacts/images/search-contacts.png" />

Esse recurso é ideal para encontrar contatos específicos sem a necessidade de aplicar filtros avançados.

## Criando um Novo Contato

É possível criar novos contatos diretamente pela tela de Contatos.

<img src="https://mintcdn.com/evoai-683d737d/szX7NdPh3OLITLUA/user-guides/contacts/images/new-contact-button.png?fit=max&auto=format&n=szX7NdPh3OLITLUA&q=85&s=69a92f9c22111cb3bb44f26ecdff2edf" alt="Botão para criar novo contato" width="485" height="235" data-path="user-guides/contacts/images/new-contact-button.png" />

### Passo 1: Abrir o modal de criação

1. Clique no botão **+ Novo Contato**, localizado no canto superior direito da tela

2. Um modal de criação de contato será exibido

### Passo 2: Preencher os detalhes do contato

No modal de criação:

1. Selecione o **Tipo de Contato** (ex: Pessoa)

2. Preencha as informações básicas:
   * Nome
   * Sobrenome
   * CPF (opcional)
   * E-mail
   * Telefone

3. Caso necessário, vincule o contato a uma empresa existente na seção **Informações da Empresa**

4. Após preencher os dados, finalize o cadastro conforme as opções disponíveis no modal

<img src="https://mintcdn.com/evoai-683d737d/szX7NdPh3OLITLUA/user-guides/contacts/images/new-contact-modal.png?fit=max&auto=format&n=szX7NdPh3OLITLUA&q=85&s=d6fdd70d10912f9e371c9316276fce18" alt="Modal de criação de novo contato" width="625" height="900" data-path="user-guides/contacts/images/new-contact-modal.png" />

Campos obrigatórios são indicados visualmente no formulário.

## Filtrando Contatos

Os filtros permitem refinar a lista de contatos com base em critérios específicos.
"

### Passo 1: Abrir filtros

Clique no botão **Filtros**, localizado ao lado da barra de pesquisa

<img src="https://mintcdn.com/evoai-683d737d/szX7NdPh3OLITLUA/user-guides/contacts/images/filters-button.png?fit=max&auto=format&n=szX7NdPh3OLITLUA&q=85&s=271a85ba36f800713c3a91a70f354bb3" alt="Botão de filtros de contatos" width="1058" height="310" data-path="user-guides/contacts/images/filters-button.png" />

### Passo 2: Configurar filtros

No modal **Filtrar Contatos**, selecione:

1. O campo a ser filtrado (ex: Nome)

2. O operador (ex: Igual a)

3. O valor desejado

4. Para adicionar mais critérios, clique em **Adicionar Filtro**

5. Após configurar os filtros, clique em **Aplicar Filtros**

<img src="https://mintcdn.com/evoai-683d737d/szX7NdPh3OLITLUA/user-guides/contacts/images/filter-contacts-modal.png?fit=max&auto=format&n=szX7NdPh3OLITLUA&q=85&s=9a2f274e609874161960666a6a314d98" alt="Modal de filtros de contatos" width="664" height="392" data-path="user-guides/contacts/images/filter-contacts-modal.png" />

### Opções adicionais

* **Limpar Filtros**: remove todos os filtros aplicados
* **Cancelar**: fecha o modal sem aplicar alterações

## Considerações Finais

* A tela de Contatos foi projetada para facilitar o gerenciamento de grandes volumes de contatos

* O uso combinado da busca rápida e dos filtros avançados otimiza a navegação e a organização dos dados

***

## Contatos de Grupo WhatsApp (a partir do v1.0.0-rc3)

A partir do `v1.0.0-rc3` (EVO-1018), o CRM distingue **contatos de grupo WhatsApp** de **contatos reais de cliente**:

* Grupos WhatsApp deixam de aparecer misturados na lista principal de contatos. A entidade "grupo" não é uma pessoa — ela representa a sala, não um interlocutor individual.
* Mensagens enviadas dentro de um grupo continuam sendo associadas ao **autor individual** da mensagem, que aparece como contato real.
* Reports e filtros que rodam sobre a base de contatos passam a refletir apenas pessoas — sem inflar métricas com IDs de sala.

Se você precisa visualizar grupos como entidade (raro), o filtro avançado expõe a opção de incluir grupos explicitamente.


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