--- title: "Por dentro do motor da WAME: como a API não oficial conecta ao WhatsApp" description: "O caminho de uma mensagem da sua API até o WhatsApp no motor próprio da WAME: sessão de aparelho conectado, criptografia, recibos e o freio de envio no servidor." url: "https://wame.api.br/blog/motor-wame-api-nao-oficial-como-funciona" language: "pt-BR" og:type: "article" published_time: "2026-11-07" modified_time: "2026-11-07" author: "Raphael Serafim" keywords: "motor wame, api não oficial whatsapp segura, como funciona api não oficial whatsapp, aparelho conectado whatsapp api, motor próprio whatsapp" reading_time: "7 min de leitura" --- # Por dentro do motor da WAME: como a API não oficial conecta ao WhatsApp > O caminho de uma mensagem da sua API até o WhatsApp no motor próprio da WAME: sessão de aparelho conectado, criptografia, recibos e o freio de envio no servidor. 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](/nao-oficial). ## 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). ```bash 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: ```bash 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](/blog/motor-proprio-vs-baileys-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](/blog/por-que-whatsapp-bane-atendimento-ia-nao-e-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](/nao-oficial). ## Perguntas frequentes ### O que é o motor da WAME? É o software que fala com o WhatsApp em nome da sua instância na API não oficial. Ele é próprio, escrito e mantido pela WAME, e conecta o seu número como um aparelho conectado, do mesmo jeito que o WhatsApp Web. ### Preciso deixar o celular ligado? Não. Depois do pareamento, a sessão do aparelho conectado roda no motor da WAME. O celular continua sendo o aparelho principal do número e pode ficar desligado por um tempo, dentro das regras de aparelhos conectados do próprio WhatsApp. ### Onde o motor limita o envio? No servidor, antes de a mensagem sair. Toda instância tem um limite de envios por minuto e, na não oficial, um segundo limite de números diferentes por minuto. É o freio que impede uma instância de virar disparador em massa.