Pular para o conteúdo principal

Visão geral

A Vertra Cloud é ideal para hospedar bots do Telegram, com disponibilidade contínua, reinício automático e acompanhamento dos logs em tempo real.
Ao criar a aplicação para um bot, selecione o tipo Bot (não Site). Bots não precisam de porta HTTP exposta.

Node.js com node-telegram-bot-api

Estrutura

package.json

vertracloud.config

Exemplo (Node.js)


Python com python-telegram-bot

Estrutura

requirements.txt

vertracloud.config

Exemplo (Python)

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 ou Python), o arquivo principal (src/index.js ou main.py) 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.

Configuração das variáveis de ambiente

1

Obtenha o token do bot

Converse com o @BotFather no Telegram para criar um novo bot e obter o BOT_TOKEN.
2

Configure no dashboard

Depois de criar a aplicação, adicione a variável de ambiente:
  • Nome: BOT_TOKEN
  • Valor: (seu token do @BotFather)
3

Confira os logs

Acompanhe os logs após o deploy para confirmar que o bot está online e conectado.

Versões disponíveis

Node.js

Python

Observações

  • Tipo bot: sempre selecione Bot ao criar a aplicação (não Site)
  • Variáveis de ambiente: configure BOT_TOKEN nas variáveis da aplicação
  • Reinício automático: ativado por padrão, mantém o bot online em caso de desconexão
  • Memória: 256 MB bastam para bots simples; 512 MB ou mais para os complexos
  • Logs: use console.log() (JS) ou logging (Python) para acompanhar em tempo real
  • Polling: as duas bibliotecas usam polling, que é mais simples, mas consome mais recursos do que webhooks
Última modificação em 26 de outubro de 2026