Por dentro do motor da WAME: como a API não oficial conecta ao WhatsApp

Quem pesquisa "API não oficial de WhatsApp" quase sempre encontra a mesma coisa: um projeto aberto que alguém sobe num servidor e torce para não cair. A WAME seguiu outro caminho e escreveu um motor próprio. Este artigo abre a caixa e mostra o que acontece entre a sua chamada de API e a mensagem chegando no WhatsApp do cliente. Se você quer o resumo comercial, ele está na página da API não oficial da WAME.

O que é "o motor"

O motor é o programa que conversa com os servidores do WhatsApp em nome da sua instância. Do lado de fora, você só vê a API REST da WAME: um POST para enviar, um webhook para receber. Por dentro, o motor cuida de tudo o que o WhatsApp Web faz no navegador:

• abrir e manter a conexão com os servidores do WhatsApp;
• cifrar cada mensagem antes de sair e decifrar o que chega;
• confirmar entrega e leitura (os recibos);
• sincronizar contatos, grupos e conversas;
• reconectar sozinho quando a rede oscila.

Ele não é um navegador automatizado nem uma extensão clicando em botões. É um cliente de protocolo: fala com o WhatsApp no mesmo protocolo do cliente web oficial.

O pareamento: seu número vira um aparelho conectado

Tudo começa como no WhatsApp Web. Você cria a instância, pede a conexão e recebe um QR Code (ou um código de 8 dígitos, para quem conecta pelo próprio celular).

curl -X POST "https://server.wame.api.br/SUA_KEY/instance"

Ao ler o código em Aparelhos conectados, o WhatsApp registra a instância como mais um aparelho do seu número. A partir daí o motor guarda a sessão desse aparelho e o celular volta a ser só o aparelho principal. Nenhuma senha sua passa pela WAME: o pareamento é o mesmo do WhatsApp Web.

O caminho de uma mensagem

Quando você envia:

curl -X POST "https://server.wame.api.br/SUA_KEY/message/text" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5566997145103", "text": "Seu pedido saiu para entrega." }'

acontecem, em ordem:

1. A API valida o pedido e confere a instância.
2. O freio de envio olha o ritmo. Toda instância tem limite de envios por minuto; na não oficial há um segundo limite, de números diferentes por minuto. Uma conversa normal nunca chega perto. Uma lista fria esbarra no limite logo, e o ritmo dela é contido.
3. O motor resolve o destino perguntando ao próprio WhatsApp qual é a conta daquele número, em vez de adivinhar.
4. A mensagem é cifrada com o protocolo Signal, para cada aparelho do destinatário.
5. O WhatsApp devolve os recibos, e você recebe pelo webhook: enviada, entregue, lida.

Na volta, quando o cliente responde, o caminho se inverte e a mensagem chega no seu webhook no formato da Cloud API da Meta, o mesmo da API oficial.

Por que motor próprio importa para o seu número

O WhatsApp muda o protocolo com frequência. Num projeto aberto mantido por voluntários, cada mudança espera alguém ter tempo de consertar, e até lá as instâncias de todo mundo se comportam de um jeito que o WhatsApp não reconhece. Com motor próprio:

• quem atualiza é o time da WAME, com prioridade de produto, não de hobby;
• o comportamento é comparado com o do WhatsApp Web real a cada mudança;
• o freio de envio está no mesmo servidor, então não depende de cada cliente se comportar.

A comparação com as alternativas abertas está em motor próprio vs Baileys e Evolution.

O que o motor não faz

O motor não transforma um número em disparador. Ele foi construído para conversa: atendimento, IA, chatbot, grupos e ligação. Para disparo em massa, o caminho é a API oficial com template aprovado pela Meta, disponível na mesma conta. O porquê está em por que o WhatsApp bane e por que atendimento com IA não é spam.

Conclusão

A API não oficial da WAME não é um script rodando num servidor qualquer. É um motor próprio que conecta o seu número como aparelho conectado, cifra cada mensagem com o protocolo Signal, segue o ritmo do WhatsApp Web e freia no servidor o que pareceria spam. É essa combinação que permite usar a não oficial para atendimento sem viver com medo do número. Veja os detalhes e os planos na página da API não oficial.