CDP: Como validar sua base para importação

Criada por Jeisyka Salgueiro, Modificado em Qua, 29 Abr na (o) 10:16 AM por Mariana Benites

Para garantir uma importação de dados rápida e sem erros, é fundamental que seu arquivo de clientes esteja formatado corretamente. Este guia apresenta um checklist completo com todas as regras e padrões que sua base deve seguir antes de ser enviada para a Dito.



  • Nível de Acesso: Administrador, Editor.
    Persona: Analista de CRM, Analista de Marketing, Gerente de E-commerce.



Importação de Dados: Como validar sua base para importação



1. Formato do Arquivo e Separador


As bases de pessoas são arquivos que contêm informações de seus clientes, como nome, e-mail, telefone, custom data, etc. Para importar esses dados para a Dito, o arquivo deve estar obrigatoriamente no formato .csv (valores separados por vírgulas). Este formato consiste em um arquivo de texto que utiliza um caractere (vírgula ou ponto e vírgula) para separar os diferentes campos de dados.


Abaixo, um exemplo de arquivo .csv aberto em um editor de texto, usando o ponto e vírgula (;) como separador:


Ao ser aberto no Excel, o programa interpreta o separador e organiza os dados em colunas:

É importante escolher apenas um separador (vírgula ou ponto e vírgula) e usá-lo em todo o arquivo. Não é possível utilizar os dois ao mesmo tempo.


Se sua base estiver em outro formato (como .xlsx ou .xls), basta abri-la no Excel ou em outro editor de planilhas e salvá-la como .csv.



2. Regras para Cabeçalhos (Colunas)


O cabeçalho corresponde à primeira linha do seu arquivo e define o nome de cada coluna. Para que a importação funcione, os nomes das colunas não podem conter espaços, acentos ou caracteres especiais (como (), *, /, -, +).


Não Permitido: nome-da-mae, numero de associado, nome da mãe.

Permitido: nome_da_mae, numerodoassociado, nomedamae.

Use o underline (_) para separar palavras compostas. Veja o exemplo de um cabeçalho correto:



3. Regras para o Conteúdo (Linhas)


As linhas abaixo do cabeçalho contêm os dados dos seus clientes. Diferente dos cabeçalhos, os campos de dados podem conter acentos, espaços e a maioria dos caracteres. No entanto, alguns caracteres especiais não são permitidos, pois podem quebrar o layout do arquivo:


  • Caracteres não permitidos: &, #, *, ; , ø, ª, ¶, §, ∞, º

Exemplos de linhas inválidas devido a caracteres especiais:



4. Formatação de Datas


Se sua base possui colunas de data, como `created_at` (data de criação) ou `birthday` (data de aniversário), é essencial que todas as datas na coluna sigam um formato padrão. No momento da importação, você precisará selecionar qual formato está sendo utilizado.

Atenção aos separadores. Se a data em sua base é "12-04-2018", o formato a ser selecionado na plataforma deve ser "DD-MM-YYYY". Se for "12/04/2018", o formato deve ser "DD/MM/YYYY".




5. Formatação de Telefone Celular


Para que os números de telefone sejam importados corretamente, especialmente para o envio de SMS, eles devem seguir um dos seguintes formatos, contendo apenas números:

  • DDD + Número: 31912345678
  • DDI + DDD + Número: 5531912345678

Para mais detalhes, consulte nosso artigo sobre configuração e disparo de SMS.



6. Boas Práticas Adicionais


Evite colunas que não serão utilizadas: Se o seu arquivo possui colunas com informações que não serão usadas na Dito, remova-as antes de importar. Isso torna o processo mais limpo e rápido.


Delete colunas e linhas em branco: Linhas ou colunas completamente vazias podem causar erros durante o carregamento do arquivo. Certifique-se de que não há nenhuma linha ou coluna em branco no meio ou no final da sua base de dados.


Após seguir todas as validações, sua base estará pronta para o upload. Se precisar de ajuda com o processo de envio, consulte o artigo sobre Como importar uma base.




FAQ – Perguntas Frequentes


1. Pergunta: Qual o formato de arquivo aceito para importação na Dito?
Resposta: A plataforma aceita exclusivamente arquivos no formato .CSV (valores separados por vírgula ou ponto e vírgula).


2. Pergunta: Posso usar espaços ou acentos nos nomes das colunas (cabeçalho) do meu arquivo?
Resposta: Não. Os cabeçalhos não podem conter espaços, acentos ou caracteres especiais. Para separar palavras, utilize o underline (_), por exemplo: `data_nascimento`.


3. Pergunta: Minha planilha de clientes está em formato Excel (.xlsx). Como faço para importar?
Resposta: Você precisa converter seu arquivo para o formato .CSV. No Excel ou em outro editor de planilhas, utilize a opção "Salvar como" e escolha o tipo de arquivo "CSV (Separado por vírgulas)" ou "CSV (UTF-8)".


4. Pergunta: O que acontece se uma linha da minha base tiver um caractere especial como '&' ou '#'?
Resposta: Linhas com certos caracteres especiais (como &, #, *, ø, ª) não são permitidas e podem causar erros durante a importação. É importante revisar e remover esses caracteres dos dados antes de subir o arquivo para garantir o sucesso do processo.




Ficou com alguma dúvida ou identificou algum problema? Acione nosso time pelo chat disponível no app dito. (Horário de Atendimento de Segunda a Sexta das 9hrs as 18hrs)



TAGS DE BUSCA E TERMOS RELACIONADOS (SEO) importação de base, base de clientes, arquivo CSV, formatar CSV, validar base, planilha de clientes, upload de base, erro importação, custom data, cabeçalho planilha, formato de data, formato telefone, importar contatos, checklist importação. Como preparar minha base de clientes para Dito? Qual formato de arquivo para importar contatos? Erro ao importar planilha CSV. Como formatar colunas da base de clientes? Regras para importar base na Dito. Validar arquivo CSV para importação. Formato de telefone para SMS. Checklist para validar base. Padrão de importação Dito.

Este artigo foi útil?

Que bom!

Obrigado pelo seu feedback

Desculpe! Não conseguimos ajudar você

Obrigado pelo seu feedback

Deixe-nos saber como podemos melhorar este artigo!

Selecione pelo menos um dos motivos
A verificação do CAPTCHA é obrigatória.

Feedback enviado

Agradecemos seu esforço e tentaremos corrigir o artigo