WACrew

Blog

Como hospedar um bot de WhatsApp 24 horas (VPS, Docker ou Railway)

Onde rodar um bot de WhatsApp sem parar. Por que serverless não serve para WhatsApp Web, como subir com Docker numa VPS ou num template da Railway, e o que não pode faltar.

Por Rodrigo Sumioshi 5 min de leitura
Neste artigo
  1. Primeiro, descubra que tipo de bot você tem
  2. O que não serve para bot de WhatsApp Web
  3. Opção 1: VPS com Docker
  4. Opção 2: Railway (ou outra plataforma de contêiner)
  5. Opção 3: um computador seu ligado
  6. Comparando as opções
  7. O que não pode faltar em produção
  8. Exemplo completo com o WACrew
  9. Resumo

O bot funciona no seu computador, você fecha o notebook e ele para. Mensagem que chega com ele desligado não entra na fila, não é respondida e, dependendo de como foi escrito, nem fica no histórico. Por isso a pergunta "onde hospedar" aparece logo depois do primeiro bot que dá certo.

A resposta depende de um detalhe técnico: como o seu bot se conecta ao WhatsApp.

Primeiro, descubra que tipo de bot você tem

Bot na API oficial (Cloud API da Meta). O WhatsApp chama o seu servidor por webhook quando chega mensagem. Seu código só precisa responder a requisições HTTP. Isso roda em quase qualquer lugar, inclusive em funções serverless.

Bot no WhatsApp Web (Baileys, whatsapp-web.js e similares). O bot mantém uma conexão aberta o tempo todo, como um aparelho vinculado. Ele precisa de um processo que nunca para e de um disco que não some, porque a sessão fica salva em arquivos. Se você usa o Baileys, está neste grupo.

Essa diferença elimina algumas opções logo de cara.

O que não serve para bot de WhatsApp Web

Serverless (Vercel Functions, AWS Lambda e afins). Essas plataformas executam código por requisição e encerram o processo depois. Não existe conexão aberta permanente nem disco persistente. O bot até conecta, mas a conexão morre quando a execução da função termina.

Hospedagem compartilhada de site. Feita para PHP e páginas, não para um processo Node rodando o dia inteiro.

Plano gratuito que hiberna. Algumas plataformas desligam a aplicação depois de um tempo sem acesso. Para WhatsApp Web, hibernar é o mesmo que estar desligado.

Opção 1: VPS com Docker

Uma VPS é um servidor virtual só seu, com Linux, ligado sempre. É a opção com mais controle e, em geral, a mais barata para rodar o dia inteiro.

O jeito mais simples de rodar o bot nela é com Docker e um volume para os dados. Um docker-compose.yml mínimo:

services:
  bot:
    image: seu-usuario/seu-bot:latest
    restart: unless-stopped        # volta sozinho se cair ou se a VPS reiniciar
    env_file: .env
    volumes:
      - dados-bot:/data            # sessão do WhatsApp e histórico
    ports:
      - "3000:3000"

volumes:
  dados-bot:

Os dois detalhes que mais importam estão comentados. O restart: unless-stopped faz o contêiner voltar depois de uma queda ou de um reinício da máquina. O volume garante que a sessão sobreviva a uma atualização da imagem, para você não precisar escanear o QR de novo a cada deploy.

Para subir:

docker compose up -d
docker compose logs -f bot   # acompanha a conexão e o QR

Se o bot tem painel web, coloque um proxy com HTTPS na frente, como o Caddy, e nunca deixe o painel aberto sem login.

Opção 2: Railway (ou outra plataforma de contêiner)

Se você não quer administrar servidor, uma plataforma de contêiner faz o trabalho pesado. Na Railway, por exemplo, você aponta uma imagem Docker ou um repositório, adiciona um volume e define as variáveis. Ela cuida de reinício, domínio com HTTPS e logs.

Dois cuidados específicos:

  1. Crie o volume. Sem ele, cada deploy começa com o disco vazio e a sessão do WhatsApp se perde.
  2. Configure um health check. Uma rota que responde quando o app está de pé permite que a plataforma só troque a versão quando a nova estiver funcionando.

Muitas aplicações já oferecem um template pronto. O WACrew, por exemplo, tem um template na Railway que cria o serviço com a imagem pronta, o volume em /data, o login do painel e uma senha gerada.

Opção 3: um computador seu ligado

Um Mac mini, um Raspberry Pi ou um PC antigo em casa também funcionam, desde que fiquem ligados e com internet estável. É uma boa opção para testar ou para uso pessoal. Os pontos fracos são queda de energia, troca de IP e o trabalho de expor o painel para fora com segurança (um túnel como o do Cloudflare ajuda).

Comparando as opções

VPS + DockerPlataforma (Railway e afins)Computador em casa
ControleTotalMédioTotal
Trabalho de manutençãoMédioBaixoMédio
Disco persistenteSimSim, com volumeSim
HTTPS e domínioVocê configuraProntoVocê configura
Bom paraProdução com várias contasQuem quer subir rápidoTestes e uso pessoal

O que não pode faltar em produção

  1. Reinício automático. Docker com restart, systemd ou o que a plataforma oferecer.
  2. Reconexão no código. Quando a conexão do WhatsApp cai sem ser logout, o bot precisa reconectar sozinho. O exemplo oficial do Baileys faz isso olhando o código de desconexão.
  3. Sessão em disco persistente, com backup. Perder a pasta de autenticação obriga a vincular de novo.
  4. Logs que você consegue ler. Quando algo der errado de madrugada, é por eles que você vai entender.
  5. Login no painel. Qualquer interface web exposta na internet precisa de senha.
  6. Um aviso quando cair. Um monitor simples que chama a rota de saúde a cada poucos minutos e avisa você.

Exemplo completo com o WACrew

O WACrew é um agente de IA para WhatsApp de código aberto que segue exatamente esse desenho. O repositório traz um docker-compose.yml que usa a imagem pronta ghcr.io/sumioshi/wacrew (para servidores x86 e ARM), com volume persistente e verificação de saúde. Numa VPS com Docker, o caminho é:

git clone https://github.com/sumioshi/wacrew && cd wacrew
cp .env.example .env   # defina PANEL_USER e PANEL_PASS
docker compose up -d

Depois, abra o painel na porta 3000, escaneie o QR em /config e escolha os grupos. Com o painel no ar, o seu agente de código pode ler e responder pelo servidor MCP, de qualquer máquina.

Resumo

Bot de API oficial roda até em serverless. Bot de WhatsApp Web precisa de processo contínuo e disco persistente, então o caminho é VPS com Docker, uma plataforma de contêiner com volume, ou um computador seu sempre ligado. Em qualquer um, garanta reinício automático, reconexão, backup da sessão e login no painel.