Importar contatos por CSV
Envie um CSV, mapeie as colunas, opcionalmente marque tags e confirme a importação em lote.
A importação em volume fica em Contatos, no botão Importar contatos. O assistente tem quatro etapas: Arquivo, Mapeamento, Tags e Confirmar.
Enviar o arquivo
- No menu lateral, clique em Contatos.
- Clique em Importar contatos.
- No diálogo Importar contatos, a descrição é "Envie um CSV com cabeçalho na primeira linha para importar."
- Clique em Selecionar arquivo CSV (ou arraste o arquivo). O texto auxiliar é "Clique para escolher ou arraste o arquivo".
- Com o arquivo carregado, a tela mostra o nome e quantas linha(s) detectada(s). Clique em Próximo. Cancelar fecha sem importar.
Arquivo que não é CSV: Selecione um arquivo CSV. CSV vazio: O arquivo CSV está vazio ou não possui linhas de dados. Falha de leitura: Não deu para ler o arquivo CSV.
Mapear colunas
- O painel Importar contatos continua com as etapas. Em Mapeamento, o título é Mapeamento de colunas. A dica: telefone é obrigatório; nome é opcional (linha sem nome usa o telefone); cada campo do CRM só pode ser usado uma vez.
- Associe cada coluna do CSV a um campo do contato.
- Clique em Próximo.
Sem coluna de telefone mapeada: Mapeie a coluna de telefone do contato.
Tags e confirmação
- Em Tags, o bloco é Tags (opcional). Marque tags para aplicar a todos os contatos importados, ou pule a etapa.
- Em Confirmar, revise arquivo, mapeamento e tags.
- Em duplicata (mesmo telefone ou e-mail), escolha:
- Preencher campos vazios — só preenche campos em branco (recomendado).
- Ignorar duplicatas — mantém o contato existente sem alterar campos.
- Atualizar com dados do CSV — sobrescreve os campos enviados no arquivo.
- Clique em Importar seguido da quantidade, no formato Importar N contato(s).
Enquanto processa, aparece Importando contatos. O aviso típico é Importação de N contatos em andamento no servidor. Você não precisa esperar. No fim: quantos novo(s), atualizado(s) e, se houver, ignorado(s) ou com erro. Sem linhas válidas: Nenhuma linha válida para importar. Verifique o telefone. ou Nenhum contato foi importado.
Se não funcionar
O CSV precisa de cabeçalho na primeira linha e de uma coluna mapeada para telefone. Sem isso, Próximo ou a confirmação não avançam.
Arquivo com extensão errada ou vazio: use um .csv com dados e tente de novo.
Falha geral: Não deu para importar os contatos. Confira o arquivo e as tags, e rode a importação outra vez.
Continue aprendendo
Outros tutoriais de Contatos
Cadastrar e atualizar contatos
Crie o contato em Contatos, edite a ficha e inicie a conversa pelo WhatsApp quando precisar.
Ler tutorialTags, segmentos e filtros de contatos
Crie tags e segmentos em Configurações e use Tags, segmentos e Filtros na lista de Contatos.
Ler tutorialCadastrar empresas
Crie a empresa em Empresas ou pelo atalho Cadastrar empresa na ficha do contato.
Ler tutorialBloquear e marcar para não contatar
Pare o envio automático por LGPD ou bloqueie o contato por completo no WhatsApp e nas campanhas.
Ler tutorialIniciar conversa a partir do contato
Abra o WhatsApp pela ficha do contato, escolha o canal e envie texto livre ou template aprovado.
Ler tutorialMesclar contatos duplicados
Unifique fichas em Mesclar contatos escolhendo o contato principal.
Ler tutorialFiltrar contatos por responsável
Use Filtros avançados em Contatos para ver só a sua base ou a de um colega.
Ler tutorialExportar contatos em CSV
Baixe a base de Contatos com Exportar CSV quando seu papel permitir.
Ler tutorialEditar telefone e e-mail pelo negócio
Corrija a ficha do contato no painel do negócio sem sair do atendimento.
Ler tutorial