Introdução

Risco real de banimento — leia antes de usar

Esta API automatiza o WhatsApp Web por trás de um navegador Chromium headless (via whatsapp-web.js). Ela usa a API NÃO OFICIAL do WhatsApp — não é integração oficial da Meta. Isso significa:

• O número pode ser banido a qualquer momento, mesmo com todo cuidado.
• O AntiBanGuard (opt-in, blacklist, janela de horário, limite diário, espaçamento entre envios, circuito de saúde) reduz o risco, não o elimina.
• Teste sempre com um número descartável antes de conectar um número de produção.
• Opt-in é obrigatório para qualquer envio proativo — nunca envie para quem não pediu para receber mensagens.
• Nunca faça spam. Respeite os Termos de Serviço do WhatsApp.

Use por sua conta e risco.

O que é

A API WhatsApp é uma API HTTP multi-instância para automação de WhatsApp: cada "instância" é uma sessão real de WhatsApp Web, pareada por QR Code, associada a um número de telefone específico. Por trás de cada instância roda um navegador Chromium headless controlado pelo whatsapp-web.js, a mesma tecnologia que você usa ao abrir web.whatsapp.com num navegador — só que automatizado.

Além do envio e recebimento de mensagens, a API inclui:

• Fila de envio com espaçamento entre mensagens proativas.
• AntiBanGuard: um conjunto de regras (opt-in, blacklist, janela de horário, limite diário com warmup, circuito de saúde) que tenta manter o padrão de envio parecido com o de uma pessoa real.
• Webhooks para eventos da instância (mensagem recebida, mudança de status, QR code, etc).
• Portal de controle (/panel), uma SPA web para criar instâncias, parear por QR, configurar anti-ban, acompanhar métricas e testar envios sem precisar escrever código.

Para quem é

Para quem precisa automatizar conversas de WhatsApp a partir de um sistema próprio — atendimento, notificações transacionais, disparo para uma base com opt-in — e está confortável com o risco inerente de usar uma automação não oficial.

O que ela não é

• Não é a WhatsApp Business Cloud API oficial da Meta. A Cloud API é suportada contratualmente pela Meta, roda nos servidores dela e não depende de manter um navegador logado. Esta API é uma alternativa não oficial, mais barata e mais flexível, mas sem nenhuma garantia da Meta — inclusive quanto a banimento.
• Não é uma ferramenta de disparo em massa sem controle: o AntiBanGuard existe justamente para dificultar esse uso e reduzir o risco de banimento, não para maximizar volume.

Próximos passos

• Siga Primeiros passos para criar sua primeira instância e enviar uma mensagem de teste.
• Leia o Guia anti-ban antes de conectar um número que importa para você.
• Use o menu Referência da API para navegar pelos endpoints documentados, agrupados por módulo.