Cole aqui os dados do seu App no Meta for Developers. Veja o passo a passo completo no arquivo README.md do projeto.
Webhook (para status de entrega e leitura)
No painel da Meta, em WhatsApp > Configuration > Webhook, configure:
Callback URL: a URL pública (gerada abaixo, ou de um servidor definitivo) + /webhook
Verify Token: o mesmo valor da variável WEBHOOK_VERIFY_TOKEN no seu arquivo .env.
Marque para receber o campo messages no webhook.
Preencha isso só quando migrar pra um servidor de verdade — a partir daí, imagens enviadas nas campanhas usam esse endereço fixo automaticamente, sem precisar de túnel nenhum.
Túnel de teste (ngrok)
Liga um túnel temporário pra expor esse sistema na internet, só enquanto você estiver testando. Precisa ter o ngrok baixado e instalado no seu PC (é gratuito).
⚠️ Deixe ligado só durante o teste, e desligue depois — não é recomendado deixar rodando o tempo todo. Quando migrar para um servidor definitivo, isso deixa de ser necessário.
Carregando...
Reserve um grátis em dashboard.ngrok.com (seção Domains) — assim a URL nunca muda, e você só cola na Meta uma vez.
Esse servidor já tem um domínio público fixo configurado acima, então o túnel de teste (ngrok) não é necessário aqui — essa opção só aparece quando o "Domínio público do servidor" está em branco.
Números para envio (multi-loja)
Cadastre aqui números adicionais (Phone Number IDs) da sua conta Meta, um pra cada loja/número. Na hora de criar a campanha, você escolhe qual número usar.
📣 SÓ DOS LEMBRETES — promoções dos clientes (pizzaria, fast food...): velocidade de cada número, por qualidade
⚠️ Isto NÃO mexe nas campanhas (Montreal, Pernambucanas e as suas). Elas continuam com a velocidade que você escolhe em cada campanha, até 1.000 por minuto.
Quantas mensagens por minuto cada número manda nas promoções dos clientes dos Lembretes (somando todos os clientes). Número com qualidade média ou baixa anda mais devagar para ajudar a melhorar, e só entra se você permitir nele (Editar).
Ao adicionar um número, o sistema já ativa ele sozinho na Meta usando este PIN (é o da "verificação em duas etapas"). Ordem: primeiro adicione e verifique o número no WhatsApp Manager, depois adicione aqui.
O sistema verifica sozinho a cada 15 minutos se algum número foi banido, restrito, ou teve queda de qualidade — e avisa na tela Campanhas. Os nomes exatos desses status vêm direto da Meta e podem mudar; o WhatsApp Manager sempre tem a informação mais precisa.
Perfil do número (foto e dados que o cliente vê)
Perfis prontos
Um perfil por cliente (foto, "sobre", descrição, site). Escolha os números e aplique com um clique — vale na hora.
Carregando...
Aqui você define a foto, o "sobre", o site e o endereço de cada número — é o que aparece pra
quem recebe a mensagem, nos dados do contato. O nome que aparece no lugar do número não é aqui:
esse é aprovado pela Meta no WhatsApp Manager
(Perfil → Nome de exibição).
JPG ou PNG, quadrada (ex: 640×640), até 5 MB.
Avisos de campanha no WhatsApp
O sistema pode te mandar um WhatsApp quando uma campanha pausar por problema,
passar da metade ou terminar. Você escolhe quais desses avisos quer
em cada campanha (na tela da campanha ou ao criar). Aqui você só define o número que
recebe e cria, uma vez, o template de aviso que a Meta precisa aprovar.
Quando um fone junta esse tanto de bloqueio numa campanha, o sistema para só ele (os outros seguem) e te avisa. Você pode retomar na tela da campanha. Padrão 12.
Template de aviso na Meta:
Carregando...
Ver o texto que vai pra Meta
Vefone: atualização automática da sua conta.
{{1}}
Este é um aviso do sistema, enviado porque você ativou os avisos nas configurações.
O {{1}} é preenchido pelo sistema com o aviso (ex: "A campanha Loja X foi pausada automaticamente por um problema no envio."). Categoria: Utilidade.
Você só usa o botão "Criar template de aviso" uma vez (no primeiro uso, ou se a Meta remover o template). Enquanto ele não estiver aprovado, os avisos não são enviados — o resto da campanha funciona normal.
Como abrir o sistema
Escolha como o sistema abre no seu computador. Vale a partir do próximo Iniciar.
Backup do sistema
O sistema já faz uma cópia de segurança do banco de dados sozinho quando liga e a cada 6 horas (guarda as 30 mais recentes, em C:\whatsapp-sender-dados\backups). Aqui você pode forçar uma cópia agora e baixar o arquivo pra guardar em outro lugar (pen drive, nuvem).
Acessos e tentativas
Registro das tentativas de entrar no sistema (certas e erradas), avisos falsos no webhook e tentativas de desligar sem login. Depois de 10 senhas erradas seguidas do mesmo IP, ele fica bloqueado por 15 minutos.
Quando
Evento
IP
Local
Navegador
Segurança
Encerrar a sessão automaticamente
Depois desse tempo desde que entrou, o sistema pede a senha de novo — o seu login no painel e o link do cliente, mesmo que o navegador tenha ficado aberto. Assim ninguém esquece o sistema aberto.
