Importar dados de uma planilha (CSV)
Carregue Contatos, Empresas ou Leads de um arquivo CSV, mapeando colunas para campos.
Você pode carregar muitos registros de uma vez a partir de um arquivo CSV (exportado do Excel, Google Sheets etc.). Na lista de um objeto, clique em "Importar".
- Abra o objeto (ex.: Contatos) e clique em Importar.
- Envie o arquivo CSV. A primeira linha deve conter os títulos das colunas.
- Relacione cada coluna do arquivo a um campo do objeto (o sistema já sugere por nome). Deixe em "Ignorar" o que não quiser importar.
- Se quiser evitar duplicados, escolha o campo-chave e o modo (criar / atualizar / ignorar).
- Confira a pré-visualização e clique em Importar.
Separador e acentuação automáticos
O sistema detecta sozinho o separador do arquivo (vírgula, ponto e vírgula ou tabulação), então planilhas do Excel em português (que usam ";") são reconhecidas sem ajustes. A acentuação também é resolvida automaticamente: se o arquivo estiver em Latin-1 (Windows-1252), como o Excel costuma salvar, ele é convertido para você e um aviso aparece para conferir os acentos na pré-visualização.
Deduplicação: criar, atualizar ou ignorar
Depois do mapeamento você escolhe um campo-chave (ex.: E-mail ou Documento) para o sistema encontrar registros que já existem, e o que fazer com eles:
- Criar novos: cada linha vira um registro novo (não procura duplicados).
- Atualizar existentes: se já houver um registro com o mesmo valor no campo-chave, ele é atualizado com as colunas do arquivo (os campos que não vieram na planilha são preservados); se não houver, um novo é criado.
- Ignorar duplicados: se já existir, a linha é pulada; se não, um novo é criado.
Formatos aceitos (datas, números, booleanos)
Na importação o sistema é tolerante com os formatos comuns das planilhas: datas como 31/12/2026, 31-12-2026 ou 2026-12-31 (em caso de ambiguidade assume dia/mês); números com vírgula decimal e ponto de milhar (1.234,56); e Sim/Não, Verdadeiro/Falso, 1/0 ou x para campos de sim-ou-não. Os valores são convertidos para o formato do campo; espaços em branco no começo e no fim são removidos.
Campos de relacionamento (ex.: Empresa)
Para um campo de relacionamento, informe o NOME na planilha (ex.: a coluna Empresa com "Acme"). Na importação, o sistema usa a empresa já cadastrada com esse nome ou cria uma nova automaticamente, sem duplicar quando o nome se repete.
Erros por linha e relatório para corrigir
Cada linha é processada de forma isolada: se uma linha tiver um problema (ex.: faltou um campo obrigatório como o e-mail do Contato), só ela é recusada e o motivo aparece na lista de erros; as demais são importadas normalmente. Ao final, o resumo mostra quantos foram criados, atualizados, ignorados e com erro, e um botão baixa um CSV só com as linhas que falharam (as colunas originais mais uma coluna "_erro") para você corrigir e reimportar.