Manual de Uso
Guia completo do sistema Disparo em Massa — WhatsApp
Sumário
  1. Primeiro acesso e login
  2. Conectar o WhatsApp (QR Code)
  3. Dashboard — visão geral
  4. Gerenciar Contatos
  5. Templates de Mensagem
  6. Criar e Enviar Campanhas
  7. Conversas do WhatsApp
  8. Logs de Envio
  9. Configurações do Sistema
  10. Gerenciar Clientes (Admin)
1. Primeiro Acesso e Login
Autenticação no sistema
1
Acesse o sistema
Abra o endereço do painel no navegador. Você verá a tela de login.
2
Digite suas credenciais
Insira o email e senha fornecidos pelo administrador.
3
Clique em "Entrar"
Você será redirecionado ao Dashboard automaticamente.
Nunca compartilhe sua senha. Cada cliente tem credenciais exclusivas. Em caso de esquecimento, peça ao administrador para redefinir.

2. Conectar o WhatsApp
Vinculação via QR Code

Para enviar mensagens, seu WhatsApp precisa estar conectado ao sistema. Isso é feito uma única vez — a sessão fica salva automaticamente.

1
Acesse o Dashboard
No card "Status WhatsApp" você verá o status atual da conexão.
2
Aguarde o QR Code aparecer
Quando o status for Aguardando QR Code, a imagem do QR aparece no painel.
3
Escaneie com seu celular
No WhatsApp do celular: Menu (⋮) → Aparelhos conectados → Conectar um aparelho → aponte para o QR Code na tela.
4
Aguarde a confirmação
O status mudará para Conectado. A partir daí o sistema pode enviar mensagens.
Sessão persistente: Após conectar, o sistema mantém a sessão ativa mesmo após reinicializações. Você só precisará escanear novamente se desconectar manualmente pelo celular.
O QR Code expira em ~20 segundos. O sistema gera um novo automaticamente — aguarde aparecer o próximo se perder o tempo.

3. Dashboard
Visão geral do sistema

A tela inicial apresenta um resumo de tudo o que acontece no sistema.

CardO que mostra
Total de ContatosQuantidade de contatos cadastrados na sua conta
Mensagens EnviadasTotal histórico de mensagens enviadas com sucesso
Enviadas HojeMensagens enviadas no dia atual
Fila PendenteMensagens aguardando envio na fila
Status WhatsAppEstado da conexão + QR Code quando necessário
Atividade RecenteÚltimos 5 envios com status e horário
Quando o WhatsApp estiver Conectado, o botão "Sincronizar Contatos" aparece — use para importar automaticamente todos os contatos do seu celular.

4. Gerenciar Contatos
Cadastro e importação de destinatários

Os contatos são as pessoas que receberão as mensagens das suas campanhas.

Cadastro manual: Adicione um contato por vez com nome e telefone
Importar CSV: Envie uma planilha com centenas de contatos de uma vez
Sync WhatsApp: Importe direto da agenda do seu celular conectado
Sistema de Score: Contatos com falhas repetidas são bloqueados automaticamente
Formato do CSV para importação:
nome,telefone,status
João Silva,11999999999,novo
Maria Santos,11988888888,ativo

A coluna status é opcional (padrão: novo). Aceita: novo, ativo, inativo.

StatusSignificado
novoContato recém-cadastrado, nunca recebeu mensagem
ativoContato que já recebeu mensagens com sucesso
inativoContato pausado, não receberá novas mensagens

5. Templates de Mensagem
Modelos com variações para evitar bloqueios

Templates são modelos de mensagem reutilizáveis. O diferencial é suportar múltiplas variações — o sistema sorteia automaticamente qual texto enviar para cada contato, tornando os disparos mais naturais.

1
Acesse Templates → Novo Template
Dê um nome descritivo para identificar o template depois.
2
Escreva as variações da mensagem
Crie pelo menos 2–3 variações diferentes com o mesmo conteúdo mas palavras distintas. Use {nome} para personalizar com o nome do contato.
3
Salve o template
O template fica disponível para uso em campanhas.
Variável {nome}: Escreva {nome} em qualquer parte da mensagem. O sistema substituirá automaticamente pelo nome cadastrado do contato.

Exemplo: "Olá {nome}, temos uma oferta especial para você!"
Por que múltiplas variações? O WhatsApp pode detectar mensagens idênticas em massa e bloquear a conta. Com variações, cada envio parece único, reduzindo o risco.

6. Criar e Enviar Campanhas
Disparar mensagens em massa

Campanhas são disparos programados para um grupo de contatos usando um template específico.

1
Verifique os pré-requisitos
Antes de criar uma campanha você precisa de: WhatsApp conectado + ao menos 1 contato + ao menos 1 template.
2
Campanhas → Nova Campanha
Preencha o nome da campanha e selecione o template desejado.
3
Selecione os destinatários
Escolha entre Todos os contatos, Novos, Ativos ou selecione contatos específicos manualmente.
4
Clique em "Iniciar Disparo"
A campanha é adicionada à fila e começa a enviar automaticamente respeitando os limites configurados.
Sistema anti-bloqueio automático: O sistema aplica delays entre envios, pausas periódicas e respeita horários configurados para proteger sua conta WhatsApp.
Status da CampanhaSignificadoAção disponível
pendenteCriada, aguardando início
em_andamentoEnviando mensagens agoraPausar
pausadaPausada manualmenteRetomar
concluídaTodos os envios finalizados

7. Conversas do WhatsApp
Visualizar histórico de mensagens

A tela de Conversas exibe todas as conversas do WhatsApp conectado, igual a visualizar no celular.

Lista de todas as conversas com prévia da última mensagem
Busca por nome do contato ou número
Visualize o histórico completo de cada conversa
Suporte a grupos e conversas individuais
Esta tela é apenas para visualização. Para responder mensagens, use o WhatsApp normalmente no celular.

8. Logs de Envio
Histórico detalhado de todos os disparos

A tela de Logs registra cada tentativa de envio com resultado e timestamp, permitindo auditoria completa.

FiltroO que faz
Status: EnviadoMostra apenas mensagens entregues com sucesso
Status: ErroMostra mensagens que falharam (motivo do erro incluso)
CampanhaFiltra logs de uma campanha específica
NúmeroBusca logs de um número de telefone específico
Configurações de envio

Na mesma tela de Logs, clique em "Configurações" para ajustar:

ConfiguraçãoPadrãoDescrição
Limite diário20 msgs/diaMáximo de mensagens enviadas por dia
Delay mínimo8 segundosTempo mínimo entre envios
Delay máximo25 segundosTempo máximo entre envios (aleatório)
Pausar a cada10 mensagensPausa automática a cada N envios
Pausa mínima60 segundosDuração mínima da pausa periódica
Pausa máxima3 minutosDuração máxima da pausa periódica
Início do envio08:00Horário que o sistema começa a enviar
Fim do envio20:00Horário que o sistema para de enviar

9. Boas Práticas
Como usar o sistema com segurança
Use múltiplas variações: Sempre crie 3+ variações por template para evitar detecção
Limite diário moderado: Comece com 20–30 mensagens/dia e aumente gradualmente
Respeite os horários: Envie apenas das 8h às 20h para não parecer spam
Contatos qualificados: Envie apenas para quem tem interesse real no seu produto/serviço
Personalize com {nome}: Mensagens personalizadas têm muito mais engajamento
Monitore os Logs: Acompanhe diariamente os erros para identificar contatos problemáticos
Atenção: O WhatsApp pode banir contas que fazem spam. Use o sistema de forma responsável, enviando apenas para contatos que consentiram em receber suas mensagens.

10. Gerenciar Clientes
Exclusivo para Administradores

A tela de Clientes só aparece no menu para usuários com perfil Administrador.

1
Clientes → Novo Cliente
Preencha nome, email (que será o login) e senha do cliente.
2
Compartilhe as credenciais
Envie o endereço do painel + email + senha para o cliente.
3
Cliente faz login e conecta o WhatsApp
Cada cliente tem seu próprio QR Code, contatos, templates e campanhas — completamente isolados.
4
Acompanhe o status
Na tela de Clientes você vê o status de conexão WhatsApp de cada cliente em tempo real. Pode alterar a senha ou remover o cliente a qualquer momento.
Ao excluir um cliente, todos os dados (contatos, templates, campanhas, logs) são removidos permanentemente. Esta ação não pode ser desfeita.

Precisa de ajuda?
Entre em contato com o suporte para dúvidas ou problemas técnicos.