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

# Contatos e empresas

> Lista de contatos, importação e exportação, etiquetas, ficha do contato e ficha da empresa.

Abra em **Atendimento → Conversas → Contatos** no menu lateral. A lista mostra os contatos do canal selecionado; quem atende em vários canais pode ver **Por canal** ou **Por pessoa** (a mesma pessoa em canais diferentes vira uma linha só).

![Lista de Contatos com abas, busca, filtros e os botões Novo contato, Acessar empresas, Sincronizar contatos, Importar e Exportar](https://mintcdn.com/stegia/qWT265Bog8mjt1jq/images/atendimento/contatos.png?fit=max\&auto=format\&n=qWT265Bog8mjt1jq\&q=85\&s=0985d36463d3afa875af0e145c1753f2)

Lista de contatos (contato de teste borrado)

## Lista de contatos

* Abas: **Todos**, **Favoritos**, **Grupos**, **Arquivados**, **Bloqueados**, **Anônimos** e **Sem canal**.
* **Buscar por nome ou telefone...**, **Filtrar por etiqueta**, **Filtrar por origem** e **Ocultar testes** / **Incluir testes**.
* Botões do topo: **Novo contato**, **Acessar empresas**, **Sincronizar contatos**, **Sincronizar grupos**, **Importar** e **Exportar**.

### Ações num contato

**Abrir chat**, **Editar contato**, **Gerenciar etiquetas**, **Canais deste contato**, favoritar, **Arquivar** / **Desarquivar**, **Corrigir número** e **Apagar contato**.

> [!WARNING]
>
> Apagar um contato apaga também todas as mensagens dele. Para só tirar da frente, use **Arquivar**.

### Ações em lote

Marque vários contatos para **Atualizar etiqueta**, **Padronizar cadastros** (escolher, campo a campo, o valor que vale em todos os canais da mesma pessoa) ou **Apagar selecionados**.

### Criar ou editar

Campos: **Nome**, **E-mail**, **Empresa**, **Cargo**, **Observações**, **Origem**, **Rastreamento UTM** (Source, Medium, Campaign) e **Metadados**: pares chave/valor livres, os mesmos do campo `customLabels` da [API de contatos](https://docs.brainchat.app/api/contatos.md) e dos [webhooks](https://docs.brainchat.app/api/webhook.md).

## Importar

**1. Prepare o arquivo**

CSV ou XLSX de até 5 MB e 1.000 contatos. Use **Baixar planilha modelo (.xlsx)** para começar. Telefone em formato internacional, por exemplo `5511999999999`.

**2. Envie**

Clique em **Importar** e arraste o arquivo.

**3. Mapeie as colunas**

Escolha a **Coluna de Telefone** e confira as demais (nome, e-mail, etiquetas, metadados). Metadados usam o formato `chave=valor;chave2=valor2`.

**4. Confira o resultado**

O resumo mostra **Importados**, **Atualizados**, **Sem alteração** e **Erros**.

Telefones que já existem são atualizados, não duplicados.

## Exportar

**Exportar** baixa os contatos da lista com os filtros aplicados.

## Etiquetas

Etiquetas são rótulos coloridos para organizar contatos (ex.: `vip`, `lead-quente`). Crie e edite em **Gerenciar etiquetas…**; aplique na lista, no painel do contato na conversa ou em lote. Agentes de IA e Flows também podem aplicar etiquetas.

## Ficha do contato

![Ficha do contato com identidade à esquerda, abas Visão geral, Atividades, Atendimentos e Notas, e empresa à direita](https://mintcdn.com/stegia/qWT265Bog8mjt1jq/images/atendimento/ficha-contato.png?fit=max\&auto=format\&n=qWT265Bog8mjt1jq\&q=85\&s=c7393044bda2b9111b4c36b07408af50)

Ficha do contato

Clique no nome do contato (ou em **Abrir a ficha do contato** na conversa) para abrir a **Ficha do contato**:

* **À esquerda**: atalhos **WhatsApp**, **E-mail** e **Ligar**, **Dados do contato**, **Atendimento** (departamento e responsável), **Etiquetas** e **Origem e campanha**. Em **Mais**: copiar telefone, **Corrigir número**, marcar como não lido e **Transferir para outro canal**.
* **Abas**: **Visão geral**, **Atividades**, **Atendimentos**, **Notas**, **E-mails**, **Ligações** e **Relações** (canais, empresa, formulários, agentes, tabelas, notas ligadas à pessoa).
* **À direita**: **Empresa** e colegas, mensagens **Agendado** (com cancelar) e a mesma pessoa **Em outros canais**.
* **Resumo**: um parágrafo sobre a relação com o contato, gerado na hora a partir do que a equipe registrou (usa créditos de IA). **Gerar de novo** atualiza.
* No topo: **Nova nota**, **Nova tarefa** e **Abrir conversa**.

## Empresas

Empresas são da organização inteira e agrupam contatos. Em **Contatos → Acessar empresas**:

* Filtros **Todas**, **Com contatos**, **Sem contatos** e **Repetidas**; busca por nome, domínio ou setor.
* **Nova empresa** (só o nome é obrigatório) e **Importar**.

A **Ficha da empresa** tem os dados editáveis à esquerda e as abas **Visão geral**, **Pessoas**, **Atividades**, **Atendimentos**, **Notas**, **E-mails**, **Ligações** e **Relações**, somando tudo das pessoas da empresa.


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