WPPConnect vs WaSphere
Duas formas open-source de automatizar o WhatsApp, com objetivos diferentes. Este texto é escrito por quem mantém a WaSphere — parta do princípio de que temos um lado. O que dá para prometer é precisão: onde o WPPConnect é melhor, dizemos que é melhor.
O que é o WPPConnect
O WPPConnect é um projeto brasileiro, mantido pela comunidade JavaScript, que exporta funções do WhatsApp Web para o Node.js. Ele controla um Chromium via Puppeteer — na prática, é o WhatsApp Web rodando sem que você o veja, com uma API em cima.
O ecossistema tem mais de uma peça. A biblioteca wppconnect é a base; o wppconnect-server é um servidor pronto para uso que expõe REST com Swagger, múltiplas sessões, webhooks, autenticação por token e docker-compose. Quem compara "WPPConnect vs uma plataforma" normalmente está pensando no server, não na biblioteca.
Os pontos fortes são reais e vale nomeá-los: documentação em português (o site oficial tem tradução pt-BR completa), uma comunidade brasileira grande com anos de tutoriais em vídeo e threads de fórum, e controle fino — por rodar o WhatsApp Web de verdade, ele alcança comportamentos da interface que um cliente de protocolo precisa reimplementar. Quando algo dá errado, você pode abrir o navegador e olhar.
Onde o WPPConnect é a escolha certa
Você quer enviar mensagens a partir de um script. Um npm install wppconnect e vinte linhas resolvem. Subir a stack da WaSphere — Postgres, Redis, API, painel — para isso é desproporcional. Use a biblioteca.
Você já tem um produto e só falta o canal. Se o seu CRM, help desk ou ERP já tem interface, usuários e permissões, um painel a mais é peso morto. O wppconnect-server entrega a API sem opinar sobre o resto.
Você precisa de material em português e de gente para perguntar. Isso tem valor prático enorme e não se compra. A comunidade do WPPConnect é maior que a nossa, e fingir o contrário seria desonesto.
Você quer depurar vendo a tela. Com Puppeteer você abre o navegador em modo visível e observa o que o WhatsApp está fazendo. Numa conexão por protocolo, isso não existe.
Lado a lado
Verificado nos repositórios oficiais em julho de 2026. Onde a coluna do WPPConnect se refere ao servidor e não à biblioteca, está dito.
| WPPConnect | WaSphere | |
|---|---|---|
| O que é | Biblioteca Node.js que exporta funções do WhatsApp Web. O wppconnect-server, separado, embrulha isso numa API REST. | Plataforma completa: servidor de mensagens + API + painel web com caixa de entrada em tempo real. |
| Como conecta | Automação do WhatsApp Web num Chromium controlado por Puppeteer. | Cliente de protocolo via Baileys — websocket, sem navegador. |
| Licença | Biblioteca: LGPL-3.0 ou posterior. wppconnect-server: Apache-2.0. | MIT (núcleo). |
| Linguagem | TypeScript. | TypeScript (NestJS + Next.js). |
| Painel / caixa de entrada | Não incluso. O README do wppconnect-server documenta endpoints e Swagger, não uma interface de conversa. | Incluso: caixa de entrada em tempo real, atribuição de conversas, histórico. |
| Equipe e permissões | Fora do escopo — você constrói. | Papéis (OWNER / ADMIN / MEMBER) aplicados no servidor, não escondendo botões no front-end. |
| Webhooks | Sim, no wppconnect-server, configuráveis. | Múltiplos webhooks por workspace, assinados com HMAC-SHA256, com retentativas e desativação automática após falhas consecutivas. |
| Persistência | Você escolhe e implementa. | PostgreSQL, com schema versionado por migrações. |
| Instalação | npm install, ou docker-compose no wppconnect-server. | Um docker compose up. |
Onde a WaSphere é a escolha certa
A diferença não é "mais recursos". É onde a linha do produto é traçada. O WPPConnect entrega a conexão e a API, e assume que você constrói o resto. A WaSphere assume que o resto — painel, equipe, permissões, banco — é justamente a parte que consome os meses.
- Caixa de entrada de equipe pronta. Conversas em tempo real no navegador, com histórico e atribuição. Se várias pessoas vão atender, isso é o produto — não um extra.
- Permissões aplicadas no servidor. Papéis OWNER, ADMIN e MEMBER validados na API. Esconder botão no front-end não é controle de acesso.
- Chaves de API com escopo. Cada chave carrega uma lista de permissões e pode ser presa a uma única sessão. Uma chave vazada não vira acesso total.
- Webhooks assinados, com retentativa. Vários endpoints por workspace, cada um com segredo HMAC-SHA256 próprio, retentativas configuráveis e desativação automática após falhas seguidas. Você consegue provar que o evento veio de nós.
- PostgreSQL com migrações. O estado tem schema e versão. Atualizar não é adivinhar em que formato os dados ficaram.
- Licença MIT no núcleo. Sem cláusula recíproca a analisar antes de embutir em produto fechado.
Perguntas frequentes
WPPConnect e WaSphere fazem a mesma coisa?
Não exatamente. O WPPConnect é uma biblioteca — e, com o wppconnect-server, uma API REST em cima dela. A WaSphere é uma plataforma: além da API, entrega painel web, caixa de entrada de equipe, permissões e banco de dados. Se você só precisa enviar mensagens a partir de código, o WPPConnect resolve com menos peça em pé.
A licença LGPL do WPPConnect é um problema?
Para a maioria dos usos, não. A LGPL-3.0 permite usar a biblioteca em software proprietário desde que ela permaneça substituível pelo usuário — o que é o caso normal ao instalar via npm. Ela vira uma consideração se você distribui um binário fechado com a biblioteca embutida. O wppconnect-server usa Apache-2.0, mais permissiva. A WaSphere é MIT. Se licença é um critério do seu jurídico, leia os textos, não resumos como este.
Puppeteer ou protocolo: qual é melhor?
São compromissos diferentes. O WhatsApp Web via Puppeteer é mais fácil de depurar (você vê a tela) e acompanha a interface real, mas roda um Chromium por sessão, o que pesa em RAM quando são muitas contas. A conexão por protocolo consome bem menos por sessão, mas quebra de formas menos visíveis quando o protocolo muda. Nenhuma das duas é oficial da Meta.
Posso usar os dois?
Pode. Não há nada impedindo você de usar o WPPConnect para um serviço e a WaSphere para outro. Ambos falam HTTP e webhooks.
Isso é a API oficial do WhatsApp Business?
Não. Tanto o WPPConnect quanto a conexão principal da WaSphere são não-oficiais e operam sobre uma conta comum de WhatsApp. Isso significa risco de bloqueio do número em caso de uso abusivo, para qualquer um dos dois. A WaSphere também suporta a Cloud API oficial da Meta como alternativa; o WPPConnect é focado no WhatsApp Web.
Resumindo
Precisa de uma biblioteca para falar com o WhatsApp a partir do seu código? Use o WPPConnect — é bom nisso, tem comunidade brasileira e documentação em português. Precisa de uma plataforma de atendimento que várias pessoas usam, com permissões e webhooks confiáveis, sem construir tudo isso? Aí vale olhar a WaSphere.