guia 4 min de leitura

Como importar contatos por CSV

Aprenda a importar contatos no painel VG Tech usando planilha CSV, com validação de WhatsApp e preparação para campanhas.

Módulo: listas
listas csv contatos importação

Para que serve

A importação por CSV coloca telefones organizados em listas dentro do painel VG Tech. Essas listas são usadas depois em Campanhas para enviar mensagens pelo WhatsApp oficial.

Quando usar

Use quando você já tem contatos em planilha (Excel, Google Planilhas ou exportação de outro sistema) e quer subir tudo de uma vez, em vez de cadastrar número por número.

Antes de começar

  1. Faça login no painel em vginfo.com.br.
  2. Abra o menu Listas de Contato (`listas.html`).
  3. Prepare o arquivo .csv com colunas numero (obrigatório) e nome (opcional).
  4. Exemplo de linhas válidas:

``` nome,numero João Silva,48999999999 Maria Souza,47988888888 ```

  1. No painel, expanda Primeira vez? Siga estes 3 passos — lá há link para copiar o modelo no Google Planilhas.
  2. Verifique seus créditos de verificação WhatsApp (cada número novo consome 1 crédito na importação).

Passo a passo

  1. Na tela Listas de Contato, clique no botão verde Importar planilha (CSV) (ou 1. Importar planilha (CSV) na barra superior).
  2. Se for a primeira lista, informe o nome da lista (o sistema sugere a partir do nome do arquivo).
  3. Se já existir uma lista, você pode abrir o card da lista e usar Mais CSV para adicionar contatos nela.
  4. Clique para escolher o arquivo `.csv` (máximo 10 MB).
  5. Aguarde o resumo da importação: quantos válidos, inválidos, duplicados e tempo estimado.
  6. Se estiver tudo certo, clique em Confirmar importação.
  7. O sistema cria ou atualiza a lista e inicia a verificação WhatsApp dos números.
  8. Quando terminar, abra a lista com Ver para conferir contatos válidos e pendentes.
Campos importantes

| Campo / item | O que é | |--------------|---------| | numero ou telefone | Número com DDD (ex.: 48999999999). Obrigatório. | | nome | Nome do contato. Opcional. | | Nome da lista | Como a lista aparece no painel. | | Válidos | Linhas que serão importadas. | | Inválidos | Linhas com erro de formato — serão ignoradas. | | Verificação WhatsApp | Confere se o número tem conta WhatsApp ativa. |

Erros comuns
Erros comuns
  • Arquivo não é CSV — use extensão `.csv` (exporte do Google Planilhas: Arquivo → Baixar → CSV).
  • Sem coluna de telefone — renomeie para `numero` ou `telefone`.
  • Nenhum contato válido — revise DDD, tire caracteres especiais e evite linhas vazias.
  • Arquivo muito grande — limite de 10 MB; divida em arquivos menores se necessário.
  • Faltam créditos de verificação — use Recarregar via PIX na tela ou divida o CSV.
  • Números sem WhatsApp — após importar, use Limpar números sem WhatsApp no menu da página de listas.
Boas práticas
  • Comece com um arquivo pequeno (50–100 linhas) para testar.
  • Mantenha um padrão de número (só dígitos, com DDD).
  • Use nomes reais na coluna nome — ajuda no atendimento e no CRM.
  • Depois da importação, vá em Campanhas só com lista validada.
  • Não reimporte a mesma base várias vezes sem necessidade — evita duplicidade e gasto de créditos.
Dúvidas frequentes
Posso importar para uma lista que já existe?
Sim. No card da lista, use Mais CSV ou Importar contatos no menu (três pontinhos).
O modelo oficial está onde?
Na própria tela Listas, em Primeira vez? Siga estes 3 passos → link Fazer cópia do modelo no Google Planilhas. Também existe `modelo-contatos.csv` no sistema.
A importação já envia mensagem?
Não. Só cadastra e valida contatos. O envio é feito em Campanhas, com template aprovado.
Quanto tempo demora?
Depende da quantidade de números novos a verificar. O resumo mostra uma estimativa antes de confirmar.
Quando chamar o suporte

Chame o suporte VG Tech pelo WhatsApp se:

  • O CSV correto aparece como zero válidos sem motivo claro.
  • A importação trava ou não aparece na lista após confirmar.
  • Créditos de verificação não batem com o que você comprou.
  • Precisa importar volume muito acima do limite exibido no painel.