Pular para o conteúdo principal

Visão geral

A Vertra Cloud é ideal para hospedar bots do WhatsApp usando o whatsapp-web.js, uma biblioteca Node.js que emula a interface web do WhatsApp.
Importante: a biblioteca whatsapp-web.js usa Puppeteer e Chromium, que exigem 512 MB de memória ou mais. 1 GB recomendado para operação estável já vem configurado na aplicação.

Requisitos

  • Node.js 18+ instalado localmente
  • Conta na Vertra Cloud
  • Número de telefone válido para a conta do WhatsApp

Estrutura do projeto

Configuração

package.json

A plataforma instala as dependências do whatsapp-web.js, e o Puppeteer usa o Chromium já disponível na imagem do runtime, então nenhum navegador é baixado durante a instalação. Não inclua node_modules no upload.

vertracloud.config

Exemplo completo de bot

Deploy

  1. Compacte o projeto em um .zip (pastas como node_modules, venv e target são removidas automaticamente) ou envie-o ao GitHub.
  2. No dashboard, clique em Novo Projeto e envie o .zip ou cole a URL do repositório.
  3. Em Build, confira o runtime (JavaScript), o arquivo principal (index.js) e a memória. Os comandos de start e build ficam em Configurações avançadas.
  4. Adicione suas variáveis de ambiente em Variáveis de Ambiente.
  5. Em Rede, deixe a publicação na web desativada: um bot não recebe tráfego de entrada e roda em segundo plano em qualquer plano.
  6. Revise e faça o deploy. Acompanhe a saída na aba Logs.
O passo a passo completo está em Primeiro deploy.

Primeira execução: autenticação

1

Faça o deploy e aguarde o QR code

Depois do deploy, acompanhe os logs. Você verá um QR code exibido no terminal.
2

Leia com o celular

Abra o WhatsApp no celular, vá em Configurações → Aparelhos conectados e leia o QR code.
3

Persistência da sessão

A pasta sessions/ guarda os dados de autenticação. Não a limpe, ou o bot precisará ser autenticado de novo.
4

Confirmação

Quando você vir “Authentication successful!” nos logs, o bot estará pronto para receber mensagens.

Observações importantes

  • Memória crítica: whatsapp-web.js + Puppeteer/Chromium exigem pelo menos 512 MB, mas 1 GB recomendado para operação estável
  • Sessões persistentes: a pasta sessions/ guarda os dados de autenticação. Configure um volume persistente, se necessário
  • QR code: exibido só na primeira execução. Leia-o rapidamente antes que expire (geralmente em 30 segundos)
  • Reinício automático: ativado por padrão, mantém o bot online
  • Logs: acompanhe regularmente para detectar problemas de conexão
  • Limite de envio: o WhatsApp tem limites de mensagens. Implemente pausas entre os envios
  • Tipo bot: sempre selecione Bot ao criar a aplicação
Última modificação em 26 de outubro de 2026