Como importar contatos por planilha (CSV)
Nível: Iniciante Tempo de leitura: 6 min Plano necessário: Todos os planos
Por que existe
A importação por CSV traz toda a sua base de contatos de uma vez, sem digitar um por um. Você sobe uma planilha, diz qual coluna é o quê (nome, telefone, email, e os campos do seu negócio) e a Wevi cria ou atualiza os contatos.
Use quando está migrando de outra ferramenta, subindo uma lista de leads de um evento, ou atualizando dados em massa de quem já está na sua base.
O que você precisa na planilha
Um arquivo .csv com a primeira linha sendo o cabeçalho (o nome de cada coluna). A Wevi entende os dois formatos mais comuns:
- Separador vírgula ou ponto e vírgula (o padrão do Excel brasileiro). Você não precisa escolher, a Wevi detecta sozinha.
- Campos entre aspas, inclusive quando o texto tem vírgula dentro.
Cada contato precisa ter pelo menos um telefone (WhatsApp) ou um email válido. Linhas sem nenhum dos dois são ignoradas na importação.
Para exportar do Excel ou do Google Sheets, use a opção "Salvar como CSV" ou "Baixar como .csv".
Se preferir começar do zero, na tela de importação tem um botão Baixar modelo de planilha. Ele baixa um arquivo de exemplo já com as colunas certas (Nome, Email, WhatsApp e algumas extras), é só apagar os exemplos e preencher com os seus contatos.
Passo a passo
- Abra Contatos no menu lateral e clique em Importar. Se quiser, clique em Baixar modelo de planilha para partir de um exemplo pronto.
- Suba o arquivo .csv (clique na área ou arraste o arquivo). A Wevi mostra o separador detectado e uma prévia das primeiras linhas.
- Vincule as colunas. Para cada coluna da planilha, escolha o campo de destino:
- Nome, Email ou WhatsApp (telefone), os campos padrão.
- Um campo personalizado que você já tem (ex: Empresa, Plano).
- Criar novo campo, se a coluna não tem um campo correspondente ainda. Você dá um nome e um tipo, e o campo é criado na hora.
- Ignorar, para colunas que não quer trazer. A Wevi já sugere o vínculo pelo nome da coluna (uma coluna "telefone" vira WhatsApp, "e-mail" vira Email, e assim por diante). Confira e ajuste.
- Escolha como identificar duplicados: por WhatsApp ou por Email. É a chave que a Wevi usa para saber se um contato da planilha já existe na sua base.
- Aplique tags (opcional). Marque uma ou mais tags para todos os contatos dessa importação, útil para saber a origem da lista depois.
- Clique em Importar. Ao terminar, você vê o resumo: quantos foram criados, atualizados e ignorados.
O que acontece com contatos que já existem
Quando uma linha da planilha bate com um contato que já está na sua base (pela chave que você escolheu, telefone ou email), a Wevi atualiza esse contato em vez de criar um duplicado. Nesse caso, os valores da planilha prevalecem: se a planilha traz um nome ou um campo diferente do que estava salvo, o valor da planilha substitui o antigo.
Por isso, confira a planilha antes de importar. Se ela tiver dados desatualizados, eles vão sobrescrever o que estava certo.
Contatos que não batem com ninguém são criados do zero.
Dicas para um bom resultado
- Telefone com DDD. A Wevi normaliza os números para o padrão brasileiro automaticamente, mas comece com o DDD certo (ex: 48 99999-0000). Telefone é a chave de duplicado mais confiável, porque é o que conecta o contato ao WhatsApp.
- Uma planilha limpa importa melhor. Tire colunas que você não vai usar e confira se cada coluna tem só um tipo de dado.
- Aplique uma tag de origem. Marcar a importação com uma tag (ex: "Lista evento maio") facilita segmentar e medir essa base depois. Veja Como usar tags de contato.
- Crie os campos na hora. Se a planilha tem uma coluna "Empresa" e você ainda não tem esse campo, crie no próprio mapeamento. Ele passa a valer para todos os contatos. Veja Como criar e usar campos personalizados.
- Limite por importação: até 20.000 contatos por vez. Para bases maiores, divida em arquivos.
E depois?
- Os contatos importados entram sem dono de carteira. Eles caem na regra normal de atendimento. Veja Carteira de contatos.
- Os campos preenchidos já ficam disponíveis nos prompts dos agentes e como variáveis nas campanhas. Veja Campos personalizados.
- Para manter a base sincronizada com outro sistema de forma contínua (e não pontual), use o Webhook de Contatos.
- Para o caminho inverso, filtrar a base e baixar em CSV, veja Como exportar e filtrar contatos.