Como hospedar um bot de WhatsApp

Com Baileys (Node), pareado por código e com a sessão numa pasta que não se perde no deploy. O código abaixo é o mesmo que testamos na plataforma.

1. O projeto

package.json

{
  "name": "meu-bot-whatsapp",
  "type": "module",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "baileys": "7.0.0-rc14",
    "qrcode-terminal": "0.12.0"
  },
  "engines": {
    "node": ">=20"
  }
}

index.js

import makeWASocket, { DisconnectReason, useMultiFileAuthState } from 'baileys'
import qrcode from 'qrcode-terminal'

// A sessão fica na pasta persistente: um deploy novo não pede o QR de novo.
const PASTA_SESSAO = '/data/sessao'

async function iniciar() {
  const { state, saveCreds } = await useMultiFileAuthState(PASTA_SESSAO)
  const sock = makeWASocket({ auth: state })
  sock.ev.on('creds.update', saveCreds)

  // Pareamento por código (mais fácil que ler o QR no log): defina WHATSAPP_NUMERO, ex.: 5511999998888.
  if (!state.creds.registered && process.env.WHATSAPP_NUMERO) {
    setTimeout(async () => {
      const codigo = await sock.requestPairingCode(process.env.WHATSAPP_NUMERO)
      console.log(`Código de pareamento: ${codigo}`)
    }, 3000)
  }

  sock.ev.on('connection.update', ({ connection, lastDisconnect, qr }) => {
    if (qr && !process.env.WHATSAPP_NUMERO) qrcode.generate(qr, { small: true })
    if (connection === 'open') console.log('WhatsApp conectado')
    if (connection === 'close') {
      const motivo = lastDisconnect?.error?.output?.statusCode
      if (motivo === DisconnectReason.loggedOut) {
        console.log('Sessão encerrada no celular. Apague a pasta sessao e conecte de novo.')
      } else {
        iniciar()
      }
    }
  })

  sock.ev.on('messages.upsert', async ({ messages }) => {
    for (const m of messages) {
      if (m.key.fromMe || !m.message) continue
      const texto = m.message.conversation || m.message.extendedTextMessage?.text
      if (texto === '!ping') await sock.sendMessage(m.key.remoteJid, { text: 'pong' })
    }
  })
}

iniciar()

lumahost.json

{
  "tipo": "worker",
  "volume": "/data"
}

O "volume": "/data" do lumahost.json liga a pasta persistente: a sessão do WhatsApp fica em /data/sessao e continua lá depois de um deploy. Sem isso, cada deploy pede para conectar de novo.

2. Parear o número

  1. Crie a variável WHATSAPP_NUMERO com o número do bot, só dígitos e com o código do país (ex.: 5511999998888).
  2. Depois do deploy, abra a aba Logs e copie o Código de pareamento.
  3. No celular do bot: WhatsApp, Dispositivos conectados, Conectar dispositivo, Conectar com número de telefone. Digite o código.

Sem a variável, o bot imprime um QR code nos logs para ler com o celular.

Subir o bot

  1. No painel, Novo app, tipo Robô ou automação, 256 MB de RAM. Escolha o .zip da pasta (sem node_modules nem .venv) ou o repositório do GitHub.
  2. Na aba Variáveis, crie as variáveis do passo anterior e reinicie o app.
  3. Na aba Logs, confira a mensagem de que o bot está no ar.

Pelo Claude Code ou pelo Cursor, com o MCP da LumaHost, basta pedir:

Sobe essa pasta na LumaHost como worker com pasta persistente em /data, nome meu-bot-whatsapp, e cria a variável WHATSAPP_NUMERO com 5511999998888. Depois me mostra o código de pareamento que aparecer no log.

Se der errado

  • "Sessão encerrada no celular": o aparelho foi desconectado no WhatsApp. Na aba Arquivos, em Pasta persistente, apague a pasta sessao e reinicie para parear de novo.
  • Pede pareamento depois de todo deploy: confira se a pasta persistente está ligada (aba Visão geral) e se o código grava em /data.
Faça um snapshot antes de mexer na sessão: ele guarda a pasta e permite voltar.

Perguntas frequentes

Por que meu bot de WhatsApp pede o QR code a cada deploy?

Porque a sessão estava no disco do app, que é refeito a cada deploy. Grave a sessão na pasta persistente (/data, como no exemplo): ela sobrevive a deploy e reinício.

Dá para usar o WhatsApp pessoal?

Dá, mas use um número só para o bot. Bibliotecas como o Baileys não são oficiais, e o WhatsApp pode banir números que mandam mensagem em massa ou recebem denúncia. Para envio em volume, prefira a API oficial (WhatsApp Business Platform).

Quanto de RAM um bot de WhatsApp precisa?

Com Baileys, 256 MB costumam bastar. Bibliotecas que abrem um navegador (whatsapp-web.js, venom) pedem 1 GB ou mais.

Veja também como hospedar um bot de Discord ou um bot de Telegram, e os erros comuns.