O que e o WAHA

WAHA significa WhatsApp HTTP API. E um projeto open source que transforma o WhatsApp em uma API REST, permitindo que desenvolvedores enviem e recebam mensagens programaticamente, sem depender da API oficial do Meta.

A ideia central e rodar um container Docker que emula o WhatsApp Web por baixo dos panos e expõe uma interface HTTP com documentação Swagger. Você faz um POST e a mensagem vai. Faz um GET e pega as mensagens recebidas. Simples assim.

O projeto e mantido pela devlikeapro e existe ha alguns anos em duas versões: Community (gratuita) e Plus (paga). Até o lançamento da versão 2026.6.1, a versão gratuita tinha limitacoes serias que empurravam muita gente para o plano pago.

O que mudou na versão 2026.6.1

A grande novidade e que a devlikeapro fundiu o WAHA Plus com o Community. A partir da versão 2026.6.1, todos os recursos que antes eram exclusivos do plano pago estão disponíveis gratuitamente para qualquer pessoa que rode o container.

Entre os recursos que deixaram de ser pagos estão: sessões ilimitadas, envio de mensagens de midia (imagem, áudio, vídeo, documento), suporte a múltiplos motores de conexão com o WhatsApp, armazenamento em PostgreSQL, MongoDB e S3, autenticação por API key, Swagger com autenticação, health checks e métricas.

A migração também foi simplificada: a imagem Docker agora se chama devlikeapro/waha em vez de devlikeapro/waha-plus. Quem já usava o Plus precisa apenas trocar o nome da imagem no compose e reiniciar.

Principais recursos disponíveis

Com o WAHA Community gratuito, você tem acesso a um conjunto robusto de funcionalidades para automação de WhatsApp:

  • Sessões ilimitadas: conecte múltiplos números no mesmo container.
  • Motores de conexão: WEBJS, WPP, GOWS, NOWEB e VENOM - cada um com características diferentes de estabilidade e compatibilidade.
  • API REST completa: envio de texto, imagens, áudio, vídeo, documentos, stickers e mensagens de localização.
  • Webhooks: receba eventos em tempo real quando chegar mensagem, quando o status mudar ou quando uma sessão cair.
  • Armazenamento externo: salve sessões e midias no PostgreSQL, MongoDB ou S3 em vez de depender do sistema de arquivos local.
  • Dashboard: interface web em /dashboard para monitorar sessões sem precisar de comandos.
  • Swagger UI: documentação interativa em /swagger para testar endpoints direto no navegador.
  • Integração MCP: suporte ao protocolo MCP para conectar com agentes de IA.

Como começar: instalacao em menos de 5 minutos

O jeito mais rápido de subir o WAHA e com Docker Compose. Crie um arquivo Docker-compose.yml e defina o serviço com a imagem devlikeapro/waha, mapeie a porta 3000, configure a variável WHATSAPP_API_KEY com uma chave secreta e monte um volume para persistir as sessões em ./waha-data.

Rode Docker compose up -d, aguarde o container iniciar e acesse http://localhost:3000/dashboard. Clique em Start session, escaneie o QR code com o WhatsApp do celular e pronto - sua sessão esta ativa. A partir dai você já pode enviar mensagens via POST em /api/sendText.

O processo inteiro leva menos de 5 minutos em qualquer máquina com Docker instalado. O container e leve e funciona tanto em Linux quanto em Windows e macOS.

Exemplo prático: enviando uma mensagem

Com a sessão ativa, enviar uma mensagem e um simples POST autenticado. Você envia para /api/sendText com header X-Api-Key contendo sua chave, e no body passa o chatId no formato [email protected], o texto da mensagem e o nome da sessão (geralmente default).

O campo chatId segue o formato nú[email protected] para contatos individuais ou [email protected] para grupos. A resposta da API inclui o ID da mensagem para rastreamento e confirmacao de entrega.

Para receber mensagens, configure um webhook no momento de criar a sessão, apontando para uma URL pública ou tunnel (ngrok, Cloudflare Tunnel) que receba os eventos via POST. Cada mensagem recebida gera um evento com o conteúdo, remetente e timestamp.

Comparacao com alternativas

O WAHA não e o único projeto que tenta expor o WhatsApp como API. As alternativas mais conhecidas são o Evolution API e o Baileys (biblioteca Node.js que o Evolution usa por baixo).

O Evolution API tem uma comunidade grande no Brasil e integração nativa com muitas ferramentas de atendimento. O Baileys e a biblioteca mais popular para quem quer controle total e não precisa de uma API REST pronta. Já o WAHA se destaca pelo foco em simplicidade de deploy, documentação Swagger bem cuidada e suporte a múltiplos motores de conexão.

Quando escolher o WAHA: quando você precisa de algo pronto para rodar em minutos, quer Swagger para testar, precisa de múltiplos motores ou já usa o ecossistema devlikeapro. Quando considerar Evolution API: quando precisar de integrações com plataformas de atendimento já prontas ou quiser uma comunidade maior em português.

Pontos positivos e limitacoes

Os pontos fortes do WAHA são claros: gratuito, self-hosted, Docker-first, documentação de qualidade, múltiplos motores e agora sem restrições de plano. E uma solução solida para automação de WhatsApp sem depender de terceiros.

As limitacoes existem e são importantes de conhecer. O maior risco e o banimento de conta: o WhatsApp não autoriza o uso de APIs não oficiais, e contas que enviam muitas mensagens automatizadas ou tem comportamento suspeito podem ser bloqueadas permanentemente. Isso vale para qualquer solução não oficial, não só o WAHA.

Outros pontos de atenção: o suporte oficial e limitado na versão gratuita, a estabilidade depende do motor escolhido e de atualizacoes do WhatsApp Web, e a escalabilidade para volumes muito altos exige infraestrutura e configuração cuidadosa.

Casos de uso reais

O WAHA e usado em cenários bem variados por times de tecnologia:

  • Notificações internas: sistemas que avisam a equipe sobre deploys, alertas de monitoramento ou tickets urgentes via WhatsApp.
  • Atendimento automatizado: chatbots que respondem duvidas frequentes, coletam dados de clientes ou encaminham para atendentes humanos.
  • Integração com n8n: fluxos de automação no n8n que disparam mensagens baseadas em eventos de outros sistemas (CRM, e-commerce, planilhas).
  • Confirmacoes de agendamento: clínicas, salões e prestadores de serviço que enviam lembretes e confirmacoes automaticamente.

Dicas e boas práticas

Quem já usa o WAHA em produção compartilha algumas licoes importantes. A primeira e usar sempre a variável WHATSAPP_API_KEY - nunca deixe a API aberta sem autenticação, mesmo em rede interna.

Escolha o motor com cuidado: NOWEB e mais leve e não depende de Chromium, mas tem menos compatibilidade com recursos avançados. WEBJS e mais estável para a maioria dos casos mas consome mais memoria. Faca testes antes de ir para produção.

Configure armazenamento externo desde o inicio se for usar em produção. Sessões salvas só em arquivo local se perdem se o container for recriado. Use PostgreSQL ou MongoDB para persistência real. E sempre mantenha a imagem atualizada - o WhatsApp Web muda com frequência e versões desatualizadas param de funcionar.

Vale a pena usar o WAHA?

Para desenvolvedores que precisam de automação de WhatsApp em ambiente controlado, self-hosted e sem custo de licença, o WAHA Community na versão 2026.6.1 e uma das melhores opcoes disponíveis agora. A fusão com o Plus eliminou a principal razão para não usa-lo.

Se você já usa o waha-plus pago, a migração e trivial: troque o nome da imagem Docker e reinicie. Se esta começando agora, comece direto com devlikeapro/waha e ignore a versão antiga.

O aviso importante fica: avalie o risco de banimento para o número que vai usar. Para números descartáveis ou contas dedicadas a automação, o risco e aceitável. Para o número principal de atendimento da empresa, pense duas vezes e estude as políticas do WhatsApp antes de colocar em produção.