Como hospedar um bot de Telegram

Do BotFather ao bot online 24 horas, com Telegraf (Node) ou python-telegram-bot. O código abaixo é o mesmo que testamos na plataforma.

1. Crie o bot no BotFather

No Telegram, fale com @BotFather, mande /newbot, escolha o nome e guarde o token que ele devolve.

2. O projeto com Telegraf (Node)

package.json

{
  "name": "meu-bot-telegram",
  "type": "module",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "telegraf": "4.16.3"
  },
  "engines": {
    "node": ">=20"
  }
}

index.js

import { Telegraf } from 'telegraf'

const bot = new Telegraf(process.env.TELEGRAM_TOKEN)

bot.start((ctx) => ctx.reply('Olá! Mande /ping.'))
bot.command('ping', (ctx) => ctx.reply('pong'))

bot.launch(() => console.log('Bot no ar'))

// A plataforma para o container com SIGTERM num deploy novo: encerra limpo.
process.once('SIGINT', () => bot.stop('SIGINT'))
process.once('SIGTERM', () => bot.stop('SIGTERM'))

lumahost.json

{
  "tipo": "worker"
}

Ou com python-telegram-bot

requirements.txt

python-telegram-bot==22.8

main.py

import os
from telegram import Update
from telegram.ext import Application, CommandHandler, ContextTypes


async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Olá! Mande /ping.")


async def ping(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("pong")


app = Application.builder().token(os.environ["TELEGRAM_TOKEN"]).build()
app.add_handler(CommandHandler("start", start))
app.add_handler(CommandHandler("ping", ping))
print("Bot no ar", flush=True)
app.run_polling()

lumahost.json

{
  "tipo": "worker",
  "start": "python main.py"
}

3. O token

Crie a variável TELEGRAM_TOKEN com o token do BotFather. Ele não vai no código.

Subir o bot

  1. No painel, Novo app, tipo Robô ou automação, 256 MB de RAM. Escolha o .zip da pasta (sem node_modules nem .venv) ou o repositório do GitHub.
  2. Na aba Variáveis, crie as variáveis do passo anterior e reinicie o app.
  3. 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, nome meu-bot-telegram, e cria a variável TELEGRAM_TOKEN com o valor que eu vou te passar.

Se der errado

  • 401: Unauthorized ou InvalidToken: o token está errado ou foi revogado no BotFather. Atualize a variável e reinicie.
  • 409: Conflict: terminated by other getUpdates request: o mesmo bot está rodando em outro lugar. Deixe só um.

Perguntas frequentes

Polling ou webhook?

Polling, como no exemplo, é o mais simples: o bot roda como worker e pergunta ao Telegram por mensagens novas. Webhook exige um app web com endereço público; dá para fazer, mas só vale a pena com muito volume.

Quanto de RAM um bot de Telegram precisa?

256 MB costumam sobrar para um bot comum.

O bot responde em dobro depois de um deploy. Por quê?

Dois processos com o mesmo token disputam as mensagens. Na LumaHost o container antigo é parado no deploy; se o mesmo token também roda no seu computador, desligue lá.

Veja também como hospedar um bot de Discord ou um bot de WhatsApp, e os erros comuns.