Node.js é onde mora a maior parte das ferramentas de WhatsApp de código aberto, então um chatbot de WhatsApp em Node.js é o caminho mais curto entre a ideia e um bot respondendo. A decisão de verdade é a biblioteca, porque ela define se você roda um navegador escondido ou um socket, e com que frequência uma atualização te quebra.
As bibliotecas lado a lado
Números do GitHub em 17/11/2026.
| biblioteca | como conecta | licença | estrelas |
|---|---|---|---|
| Baileys | WebSocket, fala o protocolo do WhatsApp Web direto, sem navegador | MIT | ~11,6 mil |
| whatsapp-web.js | controla o WhatsApp Web dentro do Chromium (Puppeteer) | Apache 2.0 | ~22,9 mil |
| venom | baseada em navegador, Puppeteer | Apache 2.0 | ~6,6 mil |
| wppconnect | baseada em navegador, Puppeteer | ver o repositório | ~3,5 mil |
As de navegador são mais fáceis de entender (é o próprio WhatsApp Web), mas custam um Chromium por sessão, centenas de MB de RAM. O Baileys é leve e rápido, e é o que a maioria dos gateways auto-hospedados usa, inclusive o WACrew e a Evolution API.
Um bot que funciona, com Baileys
import makeWASocket, { useMultiFileAuthState, DisconnectReason } from "baileys";
import qrcode from "qrcode-terminal";
async function start() {
const { state, saveCreds } = await useMultiFileAuthState("auth");
const sock = makeWASocket({ auth: state });
sock.ev.on("creds.update", saveCreds);
sock.ev.on("connection.update", ({ connection, lastDisconnect, qr }) => {
if (qr) qrcode.generate(qr, { small: true });
if (connection === "close") {
const code = lastDisconnect?.error?.output?.statusCode;
if (code !== DisconnectReason.loggedOut) start();
}
});
sock.ev.on("messages.upsert", async ({ messages, type }) => {
if (type !== "notify") return;
for (const m of messages) {
if (m.key.fromMe) continue;
const text = m.message?.conversation ?? m.message?.extendedTextMessage?.text;
if (text?.trim().toLowerCase() === "ping") {
await sock.sendMessage(m.key.remoteJid, { text: "pong" });
}
}
});
}
start();
npm install baileys qrcode-terminal, rode, escaneie o QR em Aparelhos conectados e mande "ping" de outro celular.
O que vem depois da demo
As 30 linhas funcionam. O que leva semanas é tudo em volta delas:
- Sessão e reconexão. A sessão cai, o aparelho é removido, a pasta de autenticação precisa sobreviver a reinício.
- Histórico. O
messages.upsertsó mostra o que chega enquanto você está conectado. Buscar a semana passada exige guardar cada mensagem. - Mídia. Áudio precisa ser baixado e transcrito; imagem e documento precisam de armazenamento.
- Identificadores. Grupo, JID de telefone e o LID novo da mesma pessoa precisam ser reconciliados.
- Não parecer robô. Resposta instantânea, pontuação perfeita e a mesma abertura toda vez são o que o cliente percebe.
Ou pule a parte de escrever o bot
Se o objetivo é uma IA que responda cliente no seu número, o WACrew já faz as partes acima: é um coletor de código aberto em cima do Baileys, com painel, histórico, transcrição e um servidor MCP de WhatsApp, para o Claude Code, o Codex ou o Cursor lerem e responderem sem você escrever bot. A resposta passa por uma revisão que barra texto com cara de robô e sai no ritmo de uma pessoa. Se ainda quiser código próprio, o WACrew tem uma API REST com token Bearer (documentação), e o guia de Python mostra o lado do cliente.
Perguntas frequentes
Qual é melhor, Baileys ou whatsapp-web.js? Baileys se você quer um servidor leve com várias sessões; whatsapp-web.js se prefere o comportamento do app web de verdade e aceita pagar um navegador por sessão.
Dá para rodar um bot de WhatsApp em Node.js em hospedagem grátis? Plano grátis dorme, e bot dormindo perde mensagem. Use uma VPS pequena ou uma plataforma que mantenha o processo de pé.
Isso é a API oficial do WhatsApp? Não. Essas bibliotecas conectam como aparelho a mais. Use com quem já fala com você; disparo em massa é o que derruba número.
O WACrew substitui o Baileys? Ele usa o Baileys por baixo e soma armazenamento, painel, servidor MCP e API por cima.


