Visão geral
A Vertra Cloud é ideal para hospedar bots do WhatsApp usando owhatsapp-web.js, uma biblioteca Node.js que emula a interface web do WhatsApp.
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
- Dashboard
- CLI
- VS Code
- Compacte o projeto em um
.zip(pastas comonode_modules,venvetargetsão removidas automaticamente) ou envie-o ao GitHub. - No dashboard, clique em Novo Projeto e envie o
.zipou cole a URL do repositório. - 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. - Adicione suas variáveis de ambiente em Variáveis de Ambiente.
- 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.
- Revise e faça o deploy. Acompanhe a saída na aba Logs.
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