Importar pessoas (CSV)
Esta tela cadastra várias pessoas de uma vez a partir de um arquivo CSV — útil para migrar uma base ou subir uma lista grande de contatos. Cada linha do arquivo vira uma pessoa, com detecção automática de duplicados.
Pré-requisitos
- Arquivo no formato CSV separado por vírgula (
,), com a primeira linha de cabeçalho. Outros separadores (ponto e vírgula, tabulação) não são reconhecidos. - Permissão CRM_PESSOA_IMPORTAR.
Como acessar
CRM → Pessoas → Importar pessoas (CSV) (rota /crm/pessoas/import).
O que você vê nesta tela
- Um bloco "Colunas reconhecidas no CSV" (clique para expandir) com a lista de colunas aceitas.
- Uma área de upload onde você arrasta o arquivo ou clica para escolher.
- Depois de importar, um bloco de Resultado com os números da operação.
Colunas reconhecidas no arquivo
A primeira linha do CSV deve conter o cabeçalho com os nomes das colunas. São aceitas (em qualquer ordem):
| Coluna | O que é |
|---|---|
| nome | Nome da pessoa (obrigatório em cada linha). |
| document | CPF ou CNPJ. |
| E-mail. | |
| telefone | Telefone. Se vier junto com area_code, os dois são gravados como um telefone com DDD. |
| area_code | DDD (usado em conjunto com telefone). |
| status_interno | Status interno da pessoa, informado como código numérico (não como texto). Deixe em branco se não souber. |
| origem / origem_ref | Origem do contato e referência da origem. |
| address, number, complement, district, zip, city, state | Endereço (logradouro, número, complemento, bairro, CEP, cidade, estado). |
Colunas extras que não estejam na lista são ignoradas sem erro.
O que dá pra fazer aqui
Importar um arquivo CSV
- Prepare o CSV com a primeira linha de cabeçalho e a coluna nome preenchida em todas as linhas.
- Arraste o arquivo para a área pontilhada ou clique em clique pra escolher e selecione o
.csv. - Confira o nome e o tamanho do arquivo. Se errou, clique em Trocar arquivo.
- Clique em Importar e aguarde o processamento.
- Veja o Resultado.
Ler o resultado da importação
| Número | Significado |
|---|---|
| Linhas lidas | Quantas linhas o sistema processou. |
| Pessoas criadas | Quantos cadastros novos foram feitos. |
| Duplicadas (puladas) | Linhas que correspondem a alguém já existente (por documento/e-mail) e foram ignoradas. |
| Erros | Linhas que não puderam ser importadas. |
Se houver erros, clique em Mostrar erro(s) para ver a lista detalhada (linha e motivo).
Dicas e observações
- Limite de 5.000 linhas por importação. Ao ultrapassar, o processamento para na linha 5.001 e registra um erro avisando do limite — as linhas seguintes não são importadas. Para bases maiores, divida em vários arquivos.
- A anti-duplicidade é automática: pessoas já cadastradas (mesmo documento ou e-mail) são puladas, não duplicadas.
- nome é obrigatório por linha — linhas sem nome entram como erro (e ainda contam em "Linhas lidas").
- A origem padrão das pessoas importadas é
csve a referência de origem, quando não informada, recebe o nome do arquivo enviado — útil para rastrear de qual importação cada contato veio. - A lista de erros mostra até 200 itens (linha e motivo); acima disso, corrija e reimporte.
- Salve o arquivo em CSV (não em XLSX). Para importar entregas em lote, use a tela de Entregas, que aceita CSV e XLSX.