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
- Crie a variável
WHATSAPP_NUMEROcom o número do bot, só dígitos e com o código do país (ex.:5511999998888). - Depois do deploy, abra a aba Logs e copie o Código de pareamento.
- 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
- No painel, Novo app, tipo Robô ou automação, 256 MB de RAM. Escolha o .zip da pasta (sem
node_modulesnem.venv) ou o repositório do GitHub. - Na aba Variáveis, crie as variáveis do passo anterior e reinicie o app.
- 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
sessaoe 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.
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.