Configurações da API oficial (Meta)

Cole aqui os dados do seu App no Meta for Developers. Veja o passo a passo completo no arquivo README.md do projeto.

Access Token (permanente ou temporário)

Phone Number ID

WhatsApp Business Account ID (WABA ID)

Meta App ID (opcional — só necessário pra criar templates com imagem/vídeo)

É o número que aparece na URL do seu app em developers.facebook.com/apps/<esse número>/...

Meta App Secret (recomendado — valida que o webhook veio mesmo da Meta)

Em developers.facebook.com → seu app → Configurações → Básico → "Chave Secreta do App". Enquanto não preencher, o webhook aceita qualquer chamada.

Cotação USD/BRL (para estimar custo, opcional)

Preço de custo (R$), o que a Meta cobra por mensagem

A Meta cobra valores diferentes por categoria e atualiza a tabela de tempos em tempos. Confira o valor atual em WhatsApp Manager ou na página de preços oficial e ajuste aqui.

UTILITY (utilidade) — ex: 0.03 a 0.04

MARKETING — ex: 0.33 a 0.35

AUTHENTICATION (autenticação)

Preço de venda (R$), o que você cobra do cliente por mensagem

Esse é o valor que aparece pro seu cliente no link público da campanha, e é usado para calcular seu lucro em cada campanha e no total do mês.

UTILITY (utilidade)

Imposto (%)

Comissão (%, se tiver)

MARKETING

Imposto (%)

Comissão (%, se tiver)

AUTHENTICATION (autenticação)

Imposto (%)

Comissão (%, se tiver)

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.

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...

Caminho do ngrok (opcional, só se não estiver no PATH do Windows)

Domínio fixo do ngrok (opcional, mas recomendado)

Reserve um grátis em dashboard.ngrok.com (seção Domains) — assim a URL nunca muda, e você só cola na Meta uma vez.

Domínio público do servidor (quando tiver um servidor definitivo)

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.

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.

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ê)

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).

Número

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.

Número que recebe os avisos (com DDI + DDD)

Pausar um número após quantos "spam-rate" (bloqueios)

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.

Janela própria — sem abas nem barra de endereço, ícone só do sistema (como está agora) Navegador normal — abre numa janela nova do navegador (Chrome/Edge), separada das suas abas, com a barra de endereço visível

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

Trocar senha de acesso

Verificação em duas etapas (Google Authenticator)

Carregando...