Como criar uma lista de contatos

Use este passo a passo quando você precisar:

• subir uma base nova de contatos no painel;
• organizar contatos por campanha, origem ou etapa comercial;
• importar um CSV pela primeira vez;
• entender por que o painel mostra válidos, inválidos e duplicados;
• evitar abrir suporte por erro simples de planilha.

Uma lista boa não é só “um monte de números”. Ela precisa ter lógica operacional. Antes de importar, pense assim:

1. A lista precisa ter um objetivo claro

Evite criar lista genérica como:

• `contatos`
• `lista nova`
• `clientes`
• `base whatsapp`

Prefira nomes que deixem claro quem é aquele grupo e para que ele existe.

Exemplos melhores:

• `Leads site junho`
• `Clientes ativos loja centro`
• `Pós-venda semana 1`
• `Orçamentos pendentes março`
• `Feira agosto 2026`

2. A lista deve reunir contatos parecidos

Evite misturar no mesmo arquivo:

• clientes antigos com leads novos;
• pós-venda com cobrança;
• contatos frios com contatos quentes;
• origens muito diferentes sem necessidade.

Quanto mais misturada a lista, mais difícil fica:

• revisar erro;
• entender resultado;
• validar depois;
• usar corretamente em campanhas.

3. A lista deve nascer “limpa o suficiente”

O painel mostra problemas na importação, mas isso não substitui organização mínima da base.

Antes de importar, tente evitar:

• telefones vazios;
• nomes de lista confusos;
• linhas repetidas no próprio arquivo;
• contatos jogados sem critério;
• arquivo salvo em formato errado.

Se o cliente ainda nunca criou lista no sistema, o melhor caminho é este:

Passo 1 — Definir um único objetivo para a planilha

Antes de abrir Excel ou Google Sheets, responda:

• essa lista é de leads, clientes, pós-venda, cobrança ou outro grupo?
• essa lista vai servir para uma campanha específica ou para organização interna?
• faz sentido esse público ficar junto?

Se a resposta estiver confusa, pare e organize primeiro. O problema de muita importação ruim começa antes do painel.

Passo 2 — Criar uma planilha simples

A forma mais segura para primeira importação é começar com só duas colunas:

```csv nome,telefone Maria Souza,47999999999 Carlos Lima,48988888888 Ana Costa,47977777777 ```

O que isso significa na prática:

• uma linha = um contato;
• uma coluna = uma informação;
• a primeira linha precisa ser o cabeçalho;
• o telefone precisa ficar em uma coluna chamada telefone ou numero;
• o nome pode ficar em nome;
• se não tiver nome, ainda assim a importação pode funcionar, porque nome é opcional.

Passo 3 — Usar nomes de coluna reconhecidos

O frontend reconhece a coluna de telefone quando ela vem com nomes como:

• `telefone`
• `numero`

E reconhece coluna de nome como:

• `nome`
• `name`

Para reduzir erro, use o padrão mais simples:

```csv nome,telefone ```

A estrutura recomendada para minimizar suporte é esta:

```csv nome,telefone João Silva,48999999999 Maria Souza,47988888888 Empresa XPTO,47977777777 ```

Regras práticas para montar a planilha

• deixe o cabeçalho na primeira linha;
• coloque um contato por linha;
• não junte vários números na mesma célula;
• não deixe a coluna de telefone com outro nome aleatório;
• não misture linhas úteis com anotações no meio da planilha;
• se tiver dúvida, use só `nome` e `telefone`.

O que acontece se faltar a coluna de telefone

Se o CSV não tiver a coluna correta, o sistema mostra erro equivalente a:

• Nenhum contato válido
• o CSV precisa da coluna telefone (ou numero)
• nome é opcional

Ou seja: sem a coluna de telefone correta, a importação não segue do jeito esperado.

Antes de exportar ou salvar sua planilha:

• confira se o cabeçalho está certo;
• veja se cada linha tem telefone;
• remova linhas vazias;
• revise se o nome da lista faz sentido;
• confirme se o arquivo final está em .csv;
• se a base estiver muito bagunçada, faça um teste primeiro com poucos contatos.

Planilha certa

```csv nome,telefone Maria Souza,47999999999 Carlos Lima,48988888888 Ana Costa,47977777777 ```

Por que essa estrutura funciona bem:

• cabeçalho claro na primeira linha;
• uma linha por contato;
• coluna de telefone com nome reconhecido;
• sem observações misturadas no meio;
• fácil de revisar antes de importar.

Planilha errada

```csv cliente,cel 1,observacao Maria,47999999999,ligar depois Carlos / Ana,47988888888 / 47977777777,duas pessoas na mesma linha , ,sem telefone ```

Por que isso costuma dar problema:

• cabeçalho confuso ou fora do padrão recomendado;
• mais de um contato na mesma linha;
• mais de um telefone na mesma célula;
• linha vazia ou sem telefone útil;
• observações misturadas com estrutura de importação.

Nome bom

• `Leads site junho`
• `Pós-venda semana 1`
• `Clientes ativos loja centro`
• `Orçamentos pendentes abril`

Nome ruim

• `lista`
• `nova`
• `contatos`
• `base whatsapp`
• `clientes 2`

Regra prática: se alguém olhar o nome da lista daqui 15 dias, ainda precisa entender rapidamente quem está ali e para que aquela lista serve.

Antes de confirmar no painel, passe por esta checagem rápida:

• o nome da lista faz sentido?
• o arquivo escolhido é o certo?
• o resumo mostra contatos válidos suficientes?
• os inválidos foram entendidos?
• os duplicados fazem sentido ou mostram base repetida?
• você está importando o público correto, e não uma mistura errada?

Se qualquer resposta for “não sei”, não confirme ainda. Ajuste a planilha primeiro.

Se o painel mostrar que não há contatos válidos:

1. volte para a planilha;
2. confira se a primeira linha é o cabeçalho;
3. confirme se a coluna está como telefone ou numero;
4. veja se existe pelo menos um telefone preenchido por linha;
5. salve novamente em .csv;
6. tente importar um arquivo menor de teste;
7. se continuar igual, aí sim vale chamar o suporte.

Depois da criação, você pode seguir com mais segurança para os próximos passos do módulo:

• abrir a lista para conferência;
• adicionar mais contatos via CSV na mesma lista;
• renomear a lista se o nome não ficou bom;
• fazer validação de WhatsApp depois, se isso fizer parte da operação.

Esse ponto precisa ficar claro para reduzir suporte:

• a importação cria a lista e adiciona contatos;
• isso não significa que o número já foi validado como conta WhatsApp nesse momento;
• a validação de WhatsApp é uma etapa separada e opcional dentro do módulo Listas.

Ou seja: criar lista e validar WhatsApp são coisas diferentes.

• Nome da lista — como esse grupo vai aparecer no painel;
• Arquivo CSV — arquivo que leva os contatos para a lista;
• telefone / numero — coluna obrigatória para o sistema reconhecer o contato;
• nome — coluna opcional, mas recomendada para facilitar revisão;
• Válidos — contatos aceitos no preview;
• Inválidos — linhas com problema;
• Duplicados — linhas repetidas no arquivo.

• crie listas com finalidade clara;
• separe uma lista por origem, etapa ou objetivo;
• use sempre cabeçalho simples e previsível;
• para primeira importação, comece com uma planilha enxuta;
• se tiver dúvida, faça teste com poucos contatos primeiro;
• abra a lista logo após importar e revise antes de seguir para outras ações.

Chame o suporte da VG Tech quando:

• o arquivo está em `.csv`, com coluna `telefone` ou `numero`, e ainda assim o sistema mostra zero válidos;
• o modal de importação não lê o arquivo;
• a lista some ou não aparece depois do processo;
• o resumo mostra comportamento incoerente com a planilha revisada;
• você já corrigiu a estrutura do CSV e o problema continua;
• existe dúvida operacional fora do fluxo normal do módulo.