# Importar contatos de CSV para o CRM, até 10.000 linhas | AiCrm

> Carregue seu CSV para o AiCrm: detecta apenas o delimitador e as colunas (nome, email, telefone, empresa, país, tags), importa em lotes de 100 com progresso e retoma sem duplicar se for interrompido. CSV de erros para corrigir e tentar novamente.

- **Fonte (source):** https://aistohire.com/pt/aicrm-crm-leve-com-api-109/f/importar-contatos-de-csv
- **Plataforma (platform):** AIstoHire
- **Idioma (language):** pt

## Em resumo

- Importe seus contatos de um CSV sem perder a noite
- Até 10.000 linhas por arquivo, com o delimitador e as colunas detectados automaticamente, e se a importação for interrompida, você a retoma de onde parou sem duplicar ninguém.
- Você não precisa preparar o arquivo
- As colunas vêm pré-mapeadas
- Realmente retomável

## Importe seus contatos de um CSV sem perder a noite

Você carrega o CSV e o AiCrm faz primeiro o trabalho sujo: verifica a primeira linha para saber se seu arquivo é separado por vírgulas, ponto e vírgula ou tabulações, remove o BOM que alguns programas deixam, entende as aspas duplas e as quebras de linha dentro de uma célula, e se o arquivo não estiver em UTF-8, ele tenta novamente em latin1 para que os 'eñes' e acentos não saiam quebrados. Aceita até 10.000 linhas por importação e até 50 MB de arquivo.

Depois, ele propõe o mapeamento de colunas por conta própria. Reconhece os cabeçalhos habituais em espanhol e inglês —nome, name, contato, email, correio, tel, móvel, celular, empresa, organização, país, country, notas, estado, tags, etiquetas— e, quando o cabeçalho não diz nada, ele olha para o próprio dado: se a célula tem um arroba, a trata como email, e se parece um número de telefone, a trata como telefone. Ele mostra as cinco primeiras linhas ao lado de cada coluna para que você verifique rapidamente se acertou, e qualquer coluna pode ser alterada para outro campo ou marcada como «Ignorar».

A importação é processada em lotes de 100 linhas e guarda um cursor com a última linha concluída. É isso que a torna retomável: se você fechar a aba, perder o Wi-Fi ou o celular adormecer no meio do processo, a importação aparece no histórico como «em processo» com seu botão de retomar, e ao clicar nele, continua exatamente da linha seguinte à última processada. Nada se repete, porque o cursor já havia avançado.

Ao terminar, ele fornece a contagem de criados, atualizados e erros, e marca cada contato importado com a tag «importacao-AAAA-MM-DD» mais as tags que você adicionou nas opções, para que você possa filtrar essa remessa completa a qualquer momento. Se alguma linha falhou, você baixa um CSV com o número da linha, o motivo e os dados originais, corrige na sua planilha e carrega apenas isso novamente.

## O que inclui

- **Você não precisa preparar o arquivo** — o delimitador (vírgula, ponto e vírgula ou tabulação), o BOM, as aspas, as quebras de linha dentro de uma célula e a codificação são resolvidos pelo AiCrm ao carregá-lo.
- **As colunas vêm pré-mapeadas** — o AiCrm as reconhece pelo nome do cabeçalho e, se não conseguir, pelo formato do dado. Você só revisa e corrige o que for necessário.
- **Realmente retomável** — o cursor persistente guarda onde parou a cada 100 linhas, então uma importação interrompida é retomada da linha exata em que parou, sem reprocessar nem duplicar o que já foi feito.
- **Você decide o que acontece com os que já tem** — por padrão, as linhas cujo e-mail já está na sua base são ignoradas e anotadas como duplicadas; se você marcar «atualizar existentes», essas linhas completam o registro de contato que você já tinha, sem alterar o e-mail nem o status e sem apagar dados com células vazias.
- **Cada lote fica identificado com a tag «importacao-AAAA-MM-DD», e você pode adicionar as suas antes de começar** — assim você filtra depois por «os 800 que carreguei na terça-feira».
- **As linhas inválidas não interrompem a importação** — são ignoradas com o seu motivo —nome vazio, e-mail inválido, e-mail duplicado— e você recebe um CSV de erros com linha, motivo e dados para corrigir e tentar novamente apenas essas.
- **Você vê o progresso real enquanto acontece** — barra de progresso, «processando X de Y» e, no final, a contagem de criados, atualizados e falhados. O histórico guarda suas últimas importações com o resultado.
- **Os contatos entram completos** — nome, email, telefone, empresa, país, notas, status e tags, e cada registro deixa sua entrada na linha do tempo do cliente como «registro por importação CSV».

## Perguntas frequentes

### Quantos contatos posso importar de uma vez?

Até 10.000 linhas por arquivo e 50 MB de tamanho. Se a sua lista for maior, divida-a em vários CSVs: cada importação é registrada separadamente no histórico com sua própria contagem e sua própria etiqueta de data, assim você não perde o controle de qual remessa é qual.

### O que acontece se a importação for interrompida no meio?

Nada grave. O AiCrm processa o arquivo em lotes de 100 linhas e guarda um cursor com a última linha concluída, assim a importação permanece «em processo» no histórico com um botão de retomar. Ao clicar nele, a importação continua da linha seguinte à última processada: as linhas já importadas não são novamente tocadas e não são criados contatos repetidos.

### O meu CSV precisa ter um formato específico?

Não é preciso prepará-lo. O AiCrm verifica a primeira fila e deteta se o delimitador é a vírgula, o ponto e vírgula ou o tabulador; remove o BOM, respeita as aspas duplas e as quebras de linha dentro de uma célula, e se o ficheiro não estiver em UTF-8, tenta novamente em latin1 para que os acentos não se quebrem. A única recomendação é que a primeira fila sejam os cabeçalhos, porque é o que ele usa para adivinhar o mapeamento.

### Preciso dizer qual coluna é cada coisa?

Apenas rever. O AiCrm propõe o mapeamento reconhecendo cabeçalhos habituais em espanhol e inglês (nome, name, email, correio, tel, telemóvel, empresa, país, notas, estado, tags de contacto) e, quando o cabeçalho não é reconhecível, deduz o campo pelo próprio dado: uma célula com arroba é um email, uma que parece um número de telefone é um telefone. No ecrã de mapeamento, vês cada coluna com um exemplo real e podes alterá-la ou marcá-la como «Ignorar». Basta que mapeies o nome ou o email para poder começar.

### O que faz com os contactos que já tenho e com as filas que falham?

Compara por email. Por defeito, se o email já existe na tua base, a fila é ignorada e anotada como duplicada; se selecionares a opção «atualizar existentes se o email coincidir», essa fila completa a ficha que já tinhas —sem alterar o email nem o estado, e sem apagar dados com células vazias— e combina as tags de contacto. As filas com nome vazio ou email mal escrito são ignoradas sem parar o processo, e ao terminar, descarregas um CSV com o número da fila, o motivo e os dados originais de cada uma para as corrigir e voltar a carregar apenas essas.

- [AiCrm — CRM leve com API para cadastrar clientes de qualquer sistema](https://aistohire.com/pt/aicrm-crm-leve-com-api-109)

## Sobre a plataforma

**AiCrm — CRM leve com API para cadastrar clientes de qualquer sistema** — uma aplicação de AIstoHire. Disponível em: https://aistohire.com/pt/aicrm-crm-leve-com-api-109/f/importar-contatos-de-csv

### Outros idiomas

- `es`: https://aistohire.com/es/aicrm-crm-ligero-con-api-109/f/importar-contactos-desde-csv
- `en`: https://aistohire.com/aicrm-lightweight-crm-with-api-109/f/import-contacts-from-csv
- `fr`: https://aistohire.com/fr/aicrm-crm-leger-avec-api-109/f/importer-contacts-depuis-csv
- `it`: https://aistohire.com/it/aicrm-crm-leggero-con-api-109/f/importare-contatti-da-csv
- `de`: https://aistohire.com/de/aicrm-leichtes-crm-mit-api-109/f/kontakte-aus-csv-importieren
- `bg`: https://aistohire.com/bg/aicrm-lesen-crm-s-api-za-upravlenie-na-klienti-i-liydove-109/f/importirane-na-kontakti-ot-csv
- `ja`: https://aistohire.com/ja/aicrm-lightweight-crm-with-api-109/f/import-contacts-from-csv
- `nl`: https://aistohire.com/nl/aicrm-eenvoudige-crm-met-api-om-klanten-en-leads-te-beheren-109/f/contacten-importeren-uit-csv
- `ko`: https://aistohire.com/ko/aicrm-api-gyeongnyang-crm-109/f/yeonlakcheo-csv-gajyeoogi
- `sv`: https://aistohire.com/sv/aicrm-enkelt-crm-med-api-for-att-hantera-kunder-och-leads-109/f/importera-kontakter-fran-csv
- `da`: https://aistohire.com/da/aicrm-enkelt-crm-med-api-til-at-styre-kunder-og-leads-109/f/importer-kontakter-fra-csv
- `ar`: https://aistohire.com/ar/aicrm-nzam-crm-bsit-ma-api-lidara-alamla-walamla-almhtmlin-109/f/istirad-jihat-ittisal-min-csv
- `no`: https://aistohire.com/no/aicrm-enkelt-crm-med-api-for-a-styre-kunder-og-leads-109/f/importer-kontakter-fra-csv
- `fi`: https://aistohire.com/fi/aicrm-yksinkertainen-crm-rajapinnalla-asiakkaille-ja-liideille-109/f/tuo-kontaktit-csv-tiedostosta
- `zh`: https://aistohire.com/zh/ai-crm-rest-api-webhooks-109/f/daoru-lianluoren-csv-crm
- `pl`: https://aistohire.com/pl/aicrm-prosty-crm-z-api-do-zarzadzania-klientami-i-leadami-109/f/import-kontaktow-z-csv
- `he`: https://aistohire.com/he/aicrm-crm-pshot-am-api-lnihol-lkochot-vlidim-109/f/yevu-anshei-kesher-mi-csv
- `cs`: https://aistohire.com/cs/aicrm-jednoduche-crm-s-api-pro-spravu-klientu-a-leadu-109/f/importovat-kontakty-z-csv
- `id`: https://aistohire.com/id/aicrm-crm-sederhana-dengan-api-untuk-mengelola-pelanggan-dan-lead-109/f/impor-kontak-dari-csv
