A planilha veio do comercial com 4 mil linhas. Tem telefone com parênteses, telefone sem DDD, dois números na mesma célula, nome em maiúsculas, nome em branco e uma coluna “obs” com tudo misturado. Se você tentar importar contatos desse jeito, metade não entra e a outra metade entra errada. O problema quase nunca é a ferramenta. É a planilha.
A resposta direta: para importar contatos numa plataforma de WhatsApp sem dor de cabeça, deixe uma linha por contato, um número por linha no formato 55 + DDD + número (só dígitos), nomes revisados, colunas extras mapeadas para campos personalizados e, antes de tudo, remova duplicados e quem pediu para não receber mensagens. Feito isso, a importação leva minutos.
Neste guia, nós mostramos como preparar a planilha, o padrão de número que evita falhas, como usar campos personalizados e o que conferir depois da importação.
Antes de importar contatos: de onde vem essa base?
Essa pergunta vem antes da técnica. A política de mensagens do WhatsApp Business exige que a empresa só contate pessoas que forneceram o número e deram permissão para receber mensagens, e que respeite qualquer pedido para parar. Está nas políticas do WhatsApp Business.
Na prática, separe a planilha em três grupos antes de importar:
- Clientes e leads que pediram contato. Preencheram formulário, compraram, chamaram no WhatsApp. Podem entrar.
- Contatos sem origem clara. Lista comprada, planilha herdada de outro vendedor, contatos de evento sem aceite. Não importe para campanhas.
- Quem pediu para sair. Esses vão para a blacklist, não para a base de envio.
Importar uma lista não dá permissão para mandar mensagem. A permissão vem do contato, não da planilha.
O padrão de número: DDI, DDD e número
A maior causa de falha na importação e no envio é o telefone mal formatado. A Meta recomenda, na documentação de números da Cloud API, incluir sempre o código do país. Sem ele, o sistema pode completar o número com o código do país da própria empresa, e a mensagem não chega ou chega para outra pessoa.
Para números do Brasil, adote este padrão em todas as linhas:
| Como está na planilha | Problema | Como deve ficar |
|---|---|---|
| (27) 99876-5432 | Parênteses, espaço e hífen | 5527998765432 |
| 99876-5432 | Sem DDD | Descobrir o DDD ou não importar |
| 027 99876 5432 | Zero de operadora à frente do DDD | 5527998765432 |
| +55 27 99876-5432 | Formatação mista | 5527998765432 |
| 27998765432 / 2733334444 | Dois números na mesma célula | Um contato por linha, ou o segundo em campo à parte |
| 5,5279E+12 | Excel converteu para notação científica | Formatar a coluna como texto e corrigir |
Celular ou fixo?
Números fixos podem ter WhatsApp Business, mas na maioria das bases de clientes o que você tem é celular. Um jeito simples de revisar: no Brasil, o número de celular depois do DDD tem nove dígitos e começa com 9. Linhas com oito dígitos depois do DDD merecem conferência antes de ir para uma campanha.
A armadilha do Excel
Excel adora transformar números longos em notação científica ou apagar zeros. Antes de colar ou digitar, selecione a coluna de telefone e formate como texto. Se a planilha já foi corrompida, volte ao arquivo original; não dá para recuperar dígitos perdidos.
Como preparar a planilha para importar contatos, passo a passo
- Exporte da origem em CSV ou XLSX. CRM, loja virtual, formulário. Evite copiar e colar de PDF.
- Deixe uma linha de cabeçalho só. Títulos simples: nome, telefone, e-mail, cidade. Sem células mescladas.
- Limpe o telefone. Use localizar e substituir para tirar parênteses, espaços, hífens e o sinal de mais. Depois, inclua o 55 onde faltar.
- Remova duplicados. Use a função de remover duplicados pela coluna de telefone. Se houver dois nomes para o mesmo número, decida qual fica.
- Revise os nomes. Nome é usado em variáveis de mensagem. “MARIA APARECIDA DA SILVA” vira “Maria”. Em branco vira problema (“Olá, !”).
- Separe o que é campo personalizado. Cidade, produto de interesse, data da última compra: cada informação numa coluna própria.
- Retire quem pediu para sair. Compare com a sua lista de opt-out e remova.
- Salve uma cópia de segurança. Guarde o arquivo original e o tratado, com data no nome.
Se você está trazendo contatos que estavam no celular da empresa, o processo de origem é outro; o nosso guia sobre exportar contatos do WhatsApp mostra como tirar essa lista de lá.
Campos personalizados: o que vale levar na importação
Campos personalizados são as colunas do seu negócio que não existem por padrão no cadastro: convênio, unidade, plano, placa do carro, data de aniversário. Eles servem para três coisas: personalizar mensagens, segmentar públicos e dar contexto ao atendente.
A regra é levar só o que alguém vai usar. Uma coluna “observações” com texto livre raramente ajuda. Já “produto de interesse” com valores padronizados ajuda muito.
| Negócio | Campos que costumam valer a pena |
|---|---|
| Loja virtual | Data da última compra, categoria favorita, cidade |
| Clínica | Unidade, especialidade, convênio |
| Correspondente bancário | Convênio, tipo de benefício, origem do lead |
| Imobiliária | Tipo de imóvel, bairro de interesse, faixa de valor |
| Escola ou curso | Curso de interesse, turno, situação da matrícula |
Padronize os valores
“SP”, “São Paulo” e “sao paulo” são três cidades diferentes para um filtro. Antes de importar, escolha uma forma e corrija o resto. Isso vale para qualquer campo que você pretende usar para segmentar. Nós aprofundamos a segmentação no guia de como segmentar contatos no WhatsApp.
Depois de importar contatos: o que conferir
- Quantidade. O total importado bate com o número de linhas da planilha tratada? Se não, descubra quais linhas ficaram de fora e por quê.
- Amostra. Abra dez contatos aleatórios e confira nome, telefone e campos personalizados.
- Duplicados com a base existente. Contatos que já estavam cadastrados podem ter entrado de novo. Veja como evitar isso em cadastros duplicados em automações do WhatsApp.
- Etiquetas. Marque o lote importado com uma etiqueta de origem e data. Isso facilita filtrar, medir e, se der errado, desfazer.
- Primeiro envio pequeno. Se a base vai para campanha, comece com uma parte e olhe o relatório de erros antes de enviar para todos.
Como importar contatos no ClikChat
No ClikChat, o módulo de contatos tem importação e exportação, com campos personalizados para guardar as informações do seu negócio. Confira na tela de importação quais colunas o sistema espera e como mapear as colunas extras para os campos que você criou.
Para campanhas, você também pode montar o público direto por planilha CSV ou XLSX, ou por etiqueta, se os contatos já estão na base. Quem pediu para sair vai para a blacklist: com o bloqueio ativo, o contato fica de fora das campanhas; com o receptivo, as mensagens de entrada dele são barradas.
Depois do envio, o relatório da campanha mostra o que foi enviado, entregue e o que deu erro, um bom termômetro da qualidade da planilha que você importou. Se a integração com o CRM estiver configurada, a API do ClikChat também cria e busca contatos automaticamente, sem planilha.
Perguntas frequentes
Qual o formato certo do número para importar contatos?
Só dígitos, com código do país, DDD e número: 55 + DDD + número. Sem parênteses, espaços, hífens ou zero de operadora.
Posso importar contatos em CSV e em Excel?
Na maioria das plataformas, sim. No ClikChat, o público de campanhas aceita planilha CSV ou XLSX. Em qualquer formato, formate a coluna de telefone como texto para não perder dígitos.
Importar contatos já autoriza enviar mensagens?
Não. A política do WhatsApp exige que o contato tenha dado permissão para receber mensagens da empresa. A importação só organiza dados que você já tem o direito de usar.
O que fazer com contatos sem DDD?
Tente descobrir o DDD pela origem do cadastro, como cidade ou loja. Se não for possível, não importe para campanhas, porque a chance de errar o destinatário é grande.
Quantos campos personalizados devo criar?
Só os que alguém vai usar para personalizar mensagem, filtrar público ou atender melhor. Campo que ninguém consulta vira bagunça na próxima importação.
Como evitar contatos duplicados na importação?
Remova duplicados pela coluna de telefone antes de importar e compare com a base atual. Depois, marque o lote com uma etiqueta para identificar o que entrou.
Conclusão
Para importar contatos sem retrabalho, o esforço está antes do botão: base com permissão, número no padrão 55 + DDD + número, nomes revisados, campos personalizados úteis e duplicados removidos. Com isso, a importação vira rotina e as campanhas começam com menos erro. Se quiser organizar a sua base com campos personalizados, etiquetas e blacklist, teste o ClikChat grátis por 3 dias.