> ## 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.

# Como importar contatos por CSV

> Traga vários contatos de uma vez a partir de uma planilha salva como CSV e confira quantos foram criados.

## Para que serve

Você tem uma planilha de clientes e quer colocá-los todos em **Contatos** de uma vez. A importação só aceita arquivo **.csv**. O sistema casa cada linha pelo telefone: quem já existe é atualizado, sem duplicar. Para trazer também funil, etiquetas e responsáveis de outro sistema, use o assistente [Como trazer contatos de outro sistema](https://docs.stchat.app/subcontas/trazer-contatos-de-outro-sistema.md).

## Quem pode

* Por padrão, todos os perfis menos o Operador.
* O Operador só importa se o Admin ligar essa capacidade para ele.
* Para a coluna de responsável valer, você precisa ser Dono, Admin ou Supervisor. Para os outros, a coluna é ignorada.

## Onde clicar

Em **Contatos**, clique no ícone **Importar contatos via CSV** (ao lado de **Novo contato**). Se a organização ainda não tem contatos, use o botão **Importar .csv** no meio da tela.

## Passo a passo

**1. Prepare a planilha**

Salve a planilha como CSV. A primeira linha é o cabeçalho e precisa ter pelo menos **nome** ou **telefone**. Para ver o formato, clique em **Baixar modelo de CSV** (arquivo `modelo-contatos.csv`).

**2. Escolha o arquivo**

Clique em **Solte o .csv aqui ou clique para escolher**. Outro tipo de arquivo é recusado: **Só arquivo .csv. Salve a planilha como CSV e escolha de novo.**

**3. Confira o mapeamento**

O sistema reconhece as colunas pelo nome do cabeçalho: nome, sobrenome, telefone, e-mail, empresa, notas (ou observação), tags, responsável, CPF/CNPJ (ou documento) e a coluna de consentimento (**Aceita receber**, com **Data do aceite**). Na tabela você vê as primeiras 100 linhas e os totais: **válidos**, **repetidos (vão atualizar)** e **ignorados**.

**4. Ajuste os avisos**

Na coluna **tags**, separe várias com ponto e vírgula, como `vip;financeiro`. Tags novas são criadas e a tela avisa quantas. Se houver consentimento, escolha o canal em **Vale para o canal**. Para trocar de arquivo, clique em **Trocar**.

**5. Importe**

Clique em **Importar N contatos**. Acompanhe **Importando X/Y…** até terminar.

## O que acontece depois

Abre a janela **Importação concluída** (ou **Importação concluída com avisos**) com o nome do arquivo e as linhas lidas. Os números são:

* **criados**: contatos novos.
* **atualizados**: contatos que já existiam e foram atualizados com os dados da planilha.
* **não entraram**: linhas com erro.

Na parte **Telefones** você pode ver números ajustados para +55 DDD (só o formato muda), contatos que já existiam com o mesmo número com ou sem o 9º dígito e números não reconhecidos. Para estes, use **Baixar lista (.csv)**, corrija e importe de novo. Depois, clique em **Ver contatos importados** ou **Fechar**.

**Onde fica o registro.** Na ficha de cada contato importado há o bloco **IMPORTADO**, com o arquivo, a data, quem importou e a **linha** da planilha. Quando aparece o link **Ver importação**, ele abre a tela **Importações**, com **Data**, **Origem**, **Quem fez · números** e **Situação**, além de **Baixar erros** e **Desfazer** quando disponíveis. As datas aparecem no fuso do seu navegador.

## Erros comuns

* **Não consegui identificar as colunas.** O cabeçalho precisa de **nome** ou **telefone**.
* **Linha sem nome e sem telefone.**
* **Telefone inválido: use DDD + número (mínimo 10 dígitos) ou +código do país.**
* **Email inválido.** Corrija o e-mail na linha.
* **Responsável não encontrado: ...** O nome ou e-mail da coluna não bate com nenhum membro da organização.
* **Telefone repetido no arquivo: esta linha vai atualizar o mesmo contato, sem duplicar.** É só um aviso.
* **Falha ao importar contatos.** A tela mostra a mensagem do problema. Confira o arquivo e tente de novo.
* **Sessão inválida. Recarregue a página.**

## Próximo passo

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


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