CSV de contatos: como conferir colunas, acentos e códigos

Antes de importar um CSV de contatos, confira se o programa está lendo as colunas e os valores como foram preparados. Um arquivo pode abrir sem aviso e ainda separar um campo no lugar errado, trocar acentos ou retirar zeros de um código. A prévia da importação ajuda a localizar essas diferenças antes que cheguem à base.

O guia de base de leads aborda origem, organização e uso dos contatos. Aqui, o recorte é a leitura do arquivo: separador, aspas, codificação e tipo de coluna. Essa conferência não substitui a avaliação de permissões de uso, duplicidades e regras de atualização do sistema.

Guarde a origem e saiba o que deve aparecer

Trabalhe numa cópia e identifique de onde o arquivo veio, quando foi exportado e qual destino foi previsto. Antes de abrir, registre os campos esperados e alguns valores de referência. Se um código é “0007”, esse é o valor a preservar; não basta conferir que a coluna continua com o nome “codigo”.

CSV é um arquivo de texto que organiza campos com um separador. Ele não preserva a apresentação de uma planilha, como cor, largura de coluna ou várias abas. O programa que recebe o arquivo precisa interpretar seu conteúdo. Por isso, uma grade visualmente organizada não comprova que os valores foram mantidos.

Na documentação de importação de texto do Excel, a Microsoft explica que a abertura de um CSV usa as configurações de interpretação disponíveis e que a importação permite controlar o tratamento das colunas. Para identificadores com zeros iniciais, o tipo texto pode ser necessário. Os comandos e opções variam conforme a versão usada.

Exemplo: uma vírgula dentro do interesse

Exemplo fictício: o trecho abaixo tem um cabeçalho e dois registros de demonstração. O separador é a vírgula, a codificação prevista é UTF-8 e “codigo” é um identificador textual. “Contato A” e “Contato B” não representam pessoas reais. O exercício não contém e-mail nem telefone e não é um modelo universal de importação para CRM.

codigo,nome,interesse
0007,Contato A,"Curso, consultoria"
0012,Contato B,Conteúdo

Registro de origem fictício

0007,Contato A,"Curso, consultoria". Separador: vírgula. Codificação prevista: UTF-8.

Três campos esperados

codigo: 0007. nome: Contato A. interesse: Curso, consultoria. A vírgula entre aspas pertence ao interesse e não cria outra coluna.

Conferência no destino

As aspas delimitam o campo, sem garantir o tipo textual do código em todo programa. Confira se 0007 permanece 0007. Estrutura conferida com leitor CSV local, sem teste no Excel ou em CRM.

Descrição da figura

O registro fictício de origem é 0007,Contato A,"Curso, consultoria". Três setas conduzem aos campos codigo com valor 0007, nome com valor Contato A e interesse com valor Curso, consultoria. A vírgula entre aspas pertence ao interesse. As aspas não garantem que todo programa trate 0007 como texto. A estrutura foi conferida com leitor CSV local, sem teste no Excel ou em CRM. Confira o tipo atribuído ao código no destino.

O resultado esperado é uma tabela de três colunas e dois registros. No primeiro registro, “Curso, consultoria” pertence inteiro ao campo interesse. A vírgula que está entre aspas faz parte do valor; as duas vírgulas fora desse campo separam as três colunas.

A RFC 4180 descreve a convenção de campos CSV separados por vírgula, incluindo aspas para valores que contêm vírgula. É um documento informativo. Na prática, programas também trabalham com outros separadores e exigências; confira o formato aceito pelo destino em vez de presumir que todo arquivo com extensão .csv será lido da mesma forma.

A leitura do trecho foi conferida localmente com um leitor CSV: os códigos permaneceram “0007” e “0012”, o interesse do primeiro registro ficou num único campo e “Conteúdo” manteve o acento. Isso verifica a estrutura deste exemplo, sem demonstrar como uma versão específica do Excel ou um CRM o importaria.

Separe erro de delimitador, codificação e tipo

A tabela aponta hipóteses de diagnóstico, sem garantir que cada sintoma tenha uma única causa. Um arquivo já alterado na origem pode continuar errado mesmo com a configuração de leitura correta. Compare com a cópia original antes de corrigir valores manualmente.

Para acentos, a orientação da Microsoft sobre CSV em UTF-8 apresenta caminhos de abertura e importação. Se a leitura vier incorreta, confira a origem e as opções de importação disponíveis. Salvar novamente um texto que já está corrompido não reconstrói automaticamente as letras perdidas.

Use a prévia antes de carregar os dados

No Excel com o recurso disponível, o caminho Dados, De Texto/CSV permite consultar a prévia e escolher o delimitador. Verifique cabeçalho, quantidade de colunas e valores conhecidos. Se uma configuração não produzir a estrutura prevista, interrompa a carga e descubra a diferença antes de avançar.

Depois, examine o tipo de cada campo. Um identificador não vira uma quantidade só porque contém algarismos. Defina o tratamento textual antes de uma conversão que retire os zeros e confira o resultado contra a origem. Se a conversão já aconteceu, volte ao arquivo preservado para recuperar o valor correto.

Evite mudar uma configuração geral do computador só para tentar abrir um arquivo. Primeiro examine as opções daquela importação. Se o sistema exigir outro separador ou um modelo próprio, prepare uma cópia compatível e documente a mudança. Não troque todas as vírgulas indiscriminadamente: algumas pertencem aos valores.

Confira também o mapeamento no sistema de destino

Uma prévia correta numa planilha é uma etapa, não a confirmação da importação no CRM. No destino, confira como os cabeçalhos se relacionam com os campos e como identificadores, datas e valores vazios serão tratados. O formato pode estar bem organizado e ainda não cumprir os requisitos daquele serviço.

Use o procedimento de teste autorizado da operação e um conjunto de demonstração adequado. Observe o que seria criado, atualizado ou rejeitado e mantenha os relatórios disponíveis. Não experimente uma carga completa sobre a base ativa apenas porque o arquivo abriu corretamente.

Arquivo, origem, data e cópia preservada:
Destino e formato aceito:
Separador e codificação previstos:
Cabeçalhos e quantidade de campos:
Valores de referência, incluindo acentos:
Identificadores e tratamento dos zeros iniciais:
Conversões identificadas e correções na cópia:
Mapeamento conferido no destino:
Teste autorizado e resultado observado:
Pendências antes da importação definitiva:

A conferência estará documentada quando outra pessoa conseguir localizar o arquivo de origem, reproduzir a leitura prevista e comparar os valores de referência. Registre separadamente o arquivo preparado, o teste no destino e a importação efetivamente realizada. São estados diferentes do trabalho.

Perguntas frequentes sobre CSV de contatos

Todo CSV usa vírgula como separador?

A vírgula é a convenção descrita na RFC 4180, mas há arquivos e programas que usam outros separadores. Confira o conteúdo e o formato aceito pelo destino.

Colocar um código entre aspas preserva os zeros em qualquer programa?

Não há essa garantia geral. Além da estrutura do campo, confira o tipo atribuído pela ferramenta e compare o valor importado com o arquivo de origem.

Se os acentos aparecerem errados, basta salvar como UTF-8?

Primeiro confira a codificação usada na leitura e a integridade da origem. Salvar um texto já corrompido não recupera automaticamente os caracteres corretos.

Abrir corretamente no Excel significa que posso importar no CRM?

Não. O CRM pode exigir cabeçalhos, tipos e regras próprias. Confira o mapeamento, as regras de atualização e o procedimento de teste autorizado antes da carga definitiva.

Se sua equipe precisa organizar a passagem entre arquivo, base e atendimento, converse conosco sobre o processo de dados dos contatos. Podemos ajudar a definir o escopo da orientação ou da implantação necessária.