CRM e contatos
Importar contatos de uma planilha
Suba um CSV com telefones, nomes, e-mails, tags e campos personalizados, sem duplicar quem já está na base.
Resposta rápida
Vá em Contatos e clique em Importar. Arraste o arquivo CSV, diga para onde vai cada coluna (a de Telefone (obrigatório) é a única exigida), confira o resumo e clique em Importar N contatos. Quem já existe com o mesmo telefone é atualizado, não duplicado.
Antes de começar
- O arquivo precisa ser CSV ou TXT, com a primeira linha trazendo os nomes das colunas. No Excel ou no Google Planilhas, use "Salvar como CSV".
- Separador vírgula, ponto e vírgula ou tab, e codificação UTF-8 ou Windows-1252 (o padrão de exportações da Hotmart, da Eduzz e do Excel em português) são detectados sozinhos.
- Quer que os contatos já entrem com campos personalizados? Crie os campos antes, em Tags e campos.
Passo a passo
- 1
Abra a importação
No menu lateral, clique em Contatos e depois em Importar, no canto de cima.
- 2
Suba o arquivo
Arraste a planilha para Arraste a planilha aqui ou clique em escolha um arquivo.
1- 1Arraste o arquivo ou clique em "escolha um arquivo"
- 3
Diga para onde vai cada coluna
Em Colunas, escolha o destino de cada coluna: Não importar, Telefone (obrigatório), Nome, E-mail, Tags (etiquetas) ou Campo: nome do campo. Cabeçalhos comuns como "telefone", "whatsapp", "celular", "nome" e "email" já vêm marcados. Use Ver amostra das 5 primeiras linhas para conferir.
12- 1Coluna do telefone
- 2Importar
- 4
Confira o resumo
Do lado, o quadro Vão entrar mostra quantos são Contatos novos, quantos Já existem (atualizar) e quantos são Telefone fixo. Se houver fixos, você pode marcar Não importar os N telefones fixos.
- 5
Ajustes opcionais
- Tags para todos: escolha ou digite tags que todos os contatos importados vão receber.
- Contatos internacionais: liga para números de fora do Brasil (não aplica o +55 nem o nono dígito).
- Ações na importação: registra ações nos contatos (Pra todos os contatos importados, Só nos contatos novos ou Só nos que já existiam). A ação fica na ficha, serve para filtrar depois e dispara os fluxos com o gatilho Ação Registrada daquela ação.
- 6
Importe
Clique em Importar N contatos. Ao terminar, a tela mostra por alguns segundos quantos foram importados, quantos atualizados e quantos falharam, e volta para a lista.
Como os telefones são tratados
O ZapFlow padroniza cada número antes de salvar: tira o que não é dígito, coloca 55 em números brasileiros sem o código do país e coloca o nono dígito só em celulares (fixos nunca ganham o 9). Os detalhes e exemplos estão em Contato duplicado ou com o nono dígito errado.
Fixos com 9 a mais
Se a tela avisar que alguns fixos "já existem na base com um 9 indevido no meio", são números gravados antes da correção de 22/09/2026. Eles vão virar contatos separados. Confira e apague o errado à mão.
Coluna de tags
Uma coluna mapeada como Tags (etiquetas) pode ter várias tags na mesma célula, separadas por vírgula, ponto e vírgula ou barra vertical: comprador; aula-1. Maiúsculas e acentos não criam tag repetida.
Se algo der errado
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| O botão de importar não libera | Nenhuma coluna está como Telefone | Escolha Telefone (obrigatório) na coluna do número |
| Acentos aparecem quebrados | Arquivo numa codificação incomum | Salve de novo como "CSV UTF-8" e suba outra vez |
| Tudo caiu numa coluna só | Separador diferente dos aceitos | Salve como CSV com vírgula ou ponto e vírgula |
| Alguns contatos falharam | O contato já existe e está atribuído a outra pessoa, e o seu acesso só vê os próprios leads (ele não é alterado) | Peça a importação a quem administra o projeto |
| Um campo personalizado veio vazio | O valor não combina com o tipo do campo (texto num campo de número, por exemplo) | Corrija o valor na planilha. O contato entra mesmo assim |
Perguntas frequentes
Importar de novo a mesma lista duplica os contatos?
Não. Quem já existe com o mesmo telefone é atualizado.
Posso importar direto do Excel (.xlsx)?
Não. Salve a planilha como CSV antes de subir.
Os contatos importados entram em algum fluxo?
Entram se você registrar uma ação na importação: cada contato que recebe a ação entra nos fluxos com o gatilho Ação Registrada daquela ação, numa fila, sem travar a importação. Quem já tinha a ação não dispara de novo. Tags adicionadas na importação não disparam o gatilho Tag Atribuída. Para colocar a lista num fluxo sem ação, filtre os contatos em Contatos e use Disparar fluxo na barra de ações em massa. Veja Filtros e ações em massa.
Dá para exportar os contatos depois?
A tela de Contatos não tem exportação. Para listas de participantes de grupos, use Exportar CSV na aba Participantes da campanha de grupos. Veja Proteger os grupos.
Artigos relacionados
Contato duplicado ou com o nono dígito erradoTags, campos personalizados e açõesFiltrar contatos e fazer ações em massaFazer um disparo em massa