WACrew

Guia

Chatbot de WhatsApp em Node.js: Baileys, whatsapp-web.js, venom ou wppconnect

Como fazer um chatbot de WhatsApp em Node.js em 2026. Baileys, whatsapp-web.js, venom e wppconnect comparados, um bot com Baileys em 30 linhas e o que fica para manter depois da demo.

Atualizado em 3 min de leitura
Nesta página
  1. As bibliotecas lado a lado
  2. Um bot que funciona, com Baileys
  3. O que vem depois da demo
  4. Ou pule a parte de escrever o bot
  5. Perguntas frequentes

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.

bibliotecacomo conectalicençaestrelas
BaileysWebSocket, fala o protocolo do WhatsApp Web direto, sem navegadorMIT~11,6 mil
whatsapp-web.jscontrola o WhatsApp Web dentro do Chromium (Puppeteer)Apache 2.0~22,9 mil
venombaseada em navegador, PuppeteerApache 2.0~6,6 mil
wppconnectbaseada em navegador, Puppeteerver 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.upsert só 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.