Como importar contatos na Leadster
Importar sua base de contatos corretamente é essencial para garantir o bom funcionamento das campanhas, evitar erros nos disparos e reduzir riscos de bloqueios no WhatsApp.
Abaixo, explicamos todo o processo de forma simples e prática.
Antes de começar (pré-requisitos importantes)
Antes de importar sua base, confirme se você atende aos requisitos abaixo:
- Canal de WhatsApp já conectado na Leadster
- Lista de contatos com telefones válidos
- Contatos que autorizaram o recebimento de mensagens
- Arquivo organizado corretamente (formato CSV recomendado)
💡 Importar uma base bem estruturada evita falhas no envio e possíveis problemas com a Meta.
Prepare o arquivo de contatos (CSV)
Crie um arquivo no formato .CSV com, no mínimo, a coluna de telefone.
Modelo de planilha: https://drive.google.com/file/d/1wFOm2RVmm4z1O8HmIeWIW4uLWjzgcppH/view?usp=sharing
Estrutura mínima recomendada
| Coluna | Obrigatório | Exemplo |
|---|---|---|
| name | Opcional | João Silva |
| phone_number | ✅ Sim | 5511999999999 |
| Opcional | joao@email.com | |
| labels | Opcional | campanha_julho |
⚠️ Atenção:
- O cabeçalho da coluna de telefone deve ser obrigatoriamente
phone_number. Caso utilizephone, o importador não reconhecerá o campo e os contatos serão rejeitados com o erro:Phone number is required. - Para importar etiquetas, utilize o cabeçalho
labels. O cabeçalhotagsnão é reconhecido para criação de etiquetas.
Além dos campos acima, você também pode utilizar:
identifiercompanycity
💡 Qualquer outra coluna será criada como um atributo personalizado do contato.
Boas práticas importantes 💡
-
O telefone deve estar no formato DDI + DDD + número
Exemplo:
5511999999999 - Não utilize parênteses, espaços ou traços
- Utilize uma linha por contato
- Evite acentos e caracteres especiais nos nomes das colunas
Como importar os contatos
- No menu lateral, clique em Contatos
- Em seguida, clique em Importar contatos

- Um pop-up será exibido. Clique em Escolher arquivo

- Selecione o CSV preparado anteriormente
- Aguarde o carregamento do arquivo
Após isso, a Leadster exibirá a tela de mapeamento de campos.
Nesta etapa, associe as colunas do seu arquivo aos campos da plataforma.
Exemplo de mapeamento
- Coluna
name→ Nome - Coluna
phone_number→ Telefone - Coluna
email→ E-mail - Coluna
labels→ Etiqueta
⚠️ Atenção: o campo Telefone é obrigatório para que o contato possa receber campanhas via WhatsApp.
Finalizando a importação
- Revise o resumo da importação
- Clique em Importar
- Aguarde a confirmação
Após a conclusão:
- Os contatos aparecerão na base
- Telefones inválidos serão ignorados
- Contatos duplicados poderão ser ignorados durante a importação
💡 Exemplo: em um arquivo com 68 contatos, 60 podem ser importados com sucesso e 8 rejeitados por duplicidade.
Se tiver dúvidas, entre em contato com nossa equipe de suporte.
Abraços 👋