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
- No painel, Novo app, tipo Robô ou automação, 256 MB de RAM. Escolha o .zip da pasta (sem
node_modulesnem.venv) ou o repositório do GitHub. - Na aba Variáveis, crie as variáveis do passo anterior e reinicie o app.
- 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: UnauthorizedouInvalidToken: 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á.