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

# Contatos

> Encontre, filtre, organize e edite os contatos, salve segmentos, importe e exporte listas, arquive e mescle contatos.

**Contatos** guarda todas as pessoas e empresas que já falaram com você ou que você cadastrou. O ChatClean cria o contato sozinho na primeira mensagem que chega por um canal. Abra pelo menu lateral, em **Atendimentos → Contatos**.

## Visões do menu

O item **Contatos** do menu lateral se abre em uma lista de visões:

| Visão | O que mostra |
| - | - |
| **Todos os Contatos** | Todos os contatos que não estão arquivados. |
| **Ativo** | Os contatos que estão online agora. |
| **Arquivados** | Os contatos arquivados. Veja [Arquivar um contato](#arquivar-um-contato). |
| Segmentos | Cada filtro de contatos que você salvou aparece como um item. Veja [Segmentos](#segmentos). |
| Etiquetas | As etiquetas marcadas com **Exibir etiqueta na barra lateral**. Cada uma mostra os contatos com aquela etiqueta. |

## A lista

Cada contato aparece como um cartão com nome, e-mail, telefone e localização, quando existem.

* **Ver detalhes** abre a página do contato.
* A seta à direita abre o cartão ali mesmo, com o formulário para editar os dados. Clique em **Atualizar contato** para salvar. O cartão aberto também tem **Arquivar contato** e a opção de excluir.

A lista mostra os contatos em páginas, com a contagem no rodapé (por exemplo, "Exibindo 1 - 15 de 230 contatos"). Nos resultados de uma busca, use **Carregar mais** para ver os próximos.

## Buscar

O campo **Pesquisar...** no topo procura pelo nome, e-mail, telefone ou identificador do contato.

## Filtrar

1. Clique no ícone de filtro, no topo.
2. Em **Filtrar contatos**, clique em **Adicionar filtro** e escolha o atributo, o operador e o valor.
3. Clique em **Aplicar filtros**.

Você pode filtrar por **Nome**, **E-mail**, **Número de telefone**, **Identificador**, **Nome do País**, **Cidade**, **Empresa**, **Criado em**, **Última atividade**, **Bloqueado**, **Etiquetas** e pelos atributos personalizados de contato. Veja [Atributos personalizados](https://docs.chatclean.com.br/configuracoes/atributos-personalizados.md).

**Limpar filtros** volta à lista completa. O filtro não aparece nas visões de etiqueta nem em **Ativo**.

## Segmentos

Um **segmento** é um filtro de contatos salvo com nome.

**1. Aplique um filtro**

Monte e aplique o filtro como em [Filtrar](#filtrar).

**2. Salve**

Clique no ícone de salvar, ao lado do filtro. Em "Você quer salvar este filtro?", dê um **Nome** e clique em **Salvar filtro**.

**3. Use pelo menu**

O segmento aparece no menu lateral, dentro de **Contatos**.

Dentro de um segmento, o ícone de editar abre **Alterar segmento**: mude as condições e clique em **Atualizar segmento**. O ícone da lixeira exclui o segmento, depois de confirmar.

## Ordenar

O botão de ordenação escolhe **Classificar por** (**Nome**, **E-mail**, **Empresa**, **País/região**, **Cidade**, **Última atividade** ou **Criado em**) e a **Ordenação** (**Crescente** ou **Decrescente**).

## Criar um contato

1. Abra o menu de ações, no topo, e clique em **Adicionar contato**.
2. Preencha os dados: nome, sobrenome, e-mail, telefone, cidade, país, biografia, empresa e redes sociais.
3. Clique em **Salvar contato**.

O ChatClean não deixa salvar dois contatos com o mesmo e-mail ou o mesmo telefone: "Esse endereço de e-mail já está sendo usado para outro contato."

## Importar e exportar

Administradores veem estas opções no menu de ações, no topo:

| Opção | Como funciona |
| - | - |
| **Importar contatos** | Envie um arquivo CSV. Use **Baixar um exemplo de csv.** para ver o formato, escolha o arquivo em **Escolher arquivo** e clique em **Importar**. Você recebe um e-mail quando a importação termina. |
| **Exportar contatos** | Gera um CSV com os dados dos contatos. Se você estiver num segmento, num filtro ou numa etiqueta, a exportação leva só esses contatos. Você recebe um e-mail quando o arquivo estiver pronto para baixar. |

## Selecionar vários contatos

Passe o mouse sobre a foto de um contato e marque a caixa que aparece. Com contatos selecionados, uma barra mostra quantos estão marcados e as ações:

| Ação | O que faz |
| - | - |
| **Selecionar todos** | Marca todos os contatos exibidos na lista. |
| **Atribuir rótulo** | Coloca etiquetas nos contatos selecionados. |
| **Remover Etiquetas** | Tira etiquetas dos contatos selecionados. |
| **Excluir** | Exclui os contatos selecionados para sempre. Só administradores veem esta ação. |
| **Limpar seleção** | Desmarca tudo. |

## A página do contato

Clique em **Ver detalhes** para abrir a página do contato. O topo tem:

* **Bloquear contato** (ou **Desbloquear contato**): as conversas novas de um contato bloqueado já entram como resolvidas.
* **Enviar mensagem**: começa uma conversa com o contato. Veja [Nova conversa](https://docs.chatclean.com.br/atendimento/conversas.md#nova-conversa).

À esquerda ficam a foto, o nome, quando o contato foi criado e a última atividade, as etiquetas do contato e o formulário com os dados. Clique em **Atualizar contato** para salvar as mudanças.

À direita ficam as abas:

| Aba | O que mostra |
| - | - |
| **Atributos** | Os atributos personalizados do contato, para preencher ou mudar. |
| **Oportunidades** | Os negócios do contato no funil de vendas. Veja [Negócios](https://docs.chatclean.com.br/vendas/negocios.md). |
| **Histórico** | As conversas anteriores do contato. |
| **Notas** | Anotações da equipe. Escreva em **Adicionar uma nota** e salve. |
| **Mídia** | As mídias trocadas com o contato. |
| **Mesclar** | Junta este contato com outro. Veja [Mesclar contatos](#mesclar-contatos). |

## Etiquetas de contato

As etiquetas de contato são as mesmas da conta, criadas em **Configurações → Etiquetas**. Elas são separadas das etiquetas de conversa: marcar um contato não marca as conversas dele. Veja [Etiquetas](https://docs.chatclean.com.br/configuracoes/etiquetas.md).

* Na página do contato, adicione ou tire etiquetas logo abaixo do nome.
* Na lista, use a seleção múltipla para etiquetar vários contatos de uma vez.
* Filtre por **Etiquetas** ou abra a etiqueta no menu lateral para ver os contatos marcados.

## Arquivar um contato

Arquivar tira o contato da lista e das buscas sem apagar nada. As oportunidades dele continuam e seguem contando nos relatórios.

1. Abra o contato (pela página ou pela seta do cartão).
2. Em **Arquivar contato**, clique em **Arquivar contato**.
3. Confirme. Se o contato tiver oportunidades em aberto, o ChatClean avisa quantas são antes de arquivar.

O contato vai para **Contatos → Arquivados**, com a marca **Arquivado**. Ele volta sozinho para a lista quando manda uma nova mensagem. Para trazer de volta antes disso, abra o contato e clique em **Desarquivar contato**.

## Mesclar contatos

Mesclar junta dois cadastros da mesma pessoa em um só, com todos os atributos e conversas. Em caso de conflito, valem os dados do contato que fica.

Na página do contato, abra a aba **Mesclar**:

1. Em **Contato principal**, busque o contato que vai ficar ("A ser salvo").
2. Confira: o contato que você está vendo aparece em **Para ser mesclado** ("Para ser excluído").
3. Clique em **Mesclar contatos**.

> [!WARNING]
>
> O contato mesclado é excluído. Os dados e as conversas dele passam para o contato principal.

Você também pode mesclar pelo painel do contato, dentro de uma conversa, com o botão **Mesclar contatos**. Ali, o contato da conversa é o que será excluído, e você escolhe em **Contato para mesclar** o que será mantido.

## Excluir um contato

Só administradores excluem contatos. Na página do contato, clique em **Excluir contato** e confirme. A exclusão é permanente.


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