Como alojar um bot do Telegram

Passo 1: crie o bot com o BotFather

1. No Telegram, abra o @BotFather e envie /newbot.
2. Dê ao bot um nome de apresentação e depois um nome de utilizador: 5 a 32 caracteres, letras latinas, algarismos e underscores, a terminar em bot — por exemplo, my_shop_helper_bot.
3. O BotFather responde com o token, que tem este aspeto: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. Quem o tiver controla o seu bot, por isso mantenha-o fora do código e nunca o partilhe. Se for divulgado, envie /token ao BotFather para obter um novo.

Mais dois comandos do BotFather que vale a pena conhecer: /setcommands adiciona a lista de comandos que os utilizadores veem ao escrever /, e /setprivacy controla o que o bot vê nos grupos. O modo de privacidade está ativo por predefinição, por isso num grupo o bot só recebe os comandos dirigidos a ele e as respostas às suas próprias mensagens — a não ser que o torne administrador.

Polling ou webhooks?

Um bot recebe as mensagens do Telegram de uma de duas formas — nunca das duas ao mesmo tempo:

Comece com polling. Não precisa de domínio, de certificado nem de porta aberta, e todas as bibliotecas o suportam. Se alguma vez foi definido um webhook no token, chame primeiro deleteWebhook — o polling não funciona enquanto houver um webhook ativo.

Passo 2a: um bot em Python (python-telegram-bot)

O python-telegram-bot 22 precisa do Python 3.10 ou mais recente. Instale-o com pip install python-telegram-bot e crie bot.py:

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

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    await update.message.reply_text("Hi! Send me a message and I will echo it.")

async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
    await update.message.reply_text(update.message.text)

def main() -> None:
    application = Application.builder().token(os.environ["TELEGRAM_TOKEN"]).build()
    application.add_handler(CommandHandler("start", start))
    application.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))
    application.run_polling(allowed_updates=Update.ALL_TYPES)

if __name__ == "__main__":
    main()

O aiogram 3 é a outra escolha popular em Python, também com Python 3.10 ou mais recente.

Passo 2b: um bot em JavaScript (grammY)

O grammY é o framework de Telegram para Node.js com manutenção ativa. Execute npm install grammy e crie bot.js:

const { Bot } = require("grammy");

const bot = new Bot(process.env.TELEGRAM_TOKEN);
bot.command("start", (ctx) => ctx.reply("Welcome! Up and running."));
bot.on("message:text", (ctx) => ctx.reply(ctx.message.text));

process.once("SIGINT", () => bot.stop());
process.once("SIGTERM", () => bot.stop());
bot.start();

Os tutoriais mais antigos usam o Telegraf, que não tem nenhuma versão nova desde fevereiro de 2024; para um bot novo, o grammY é a escolha mais segura.

Limites e regras do Telegram para bots

Limites segundo as FAQ do Telegram sobre bots:

• Cerca de uma mensagem por segundo numa única conversa, 20 mensagens por minuto num grupo e cerca de 30 mensagens por segundo no total.
• Ficheiros: o bot pode enviar até 50 MB e transferir até 20 MB.
• Só uma cópia do bot pode fazer polling de cada vez. Uma segunda recebe Conflict: terminated by other getUpdates request — use um token separado para testes.

Regras: os termos do Telegram para programadores de bots proíbem spam, mensagens não solicitadas e contornar os limites de envio. Um bot precisa de uma política de privacidade (aplica-se a política padrão do Telegram se não escrever a sua) e tem de apagar os dados de um utilizador quando este o pedir. Automatizar uma conta pessoal em vez de um bot — o chamado userbot — é algo totalmente diferente, e o Telegram bane as contas usadas para flood ou spam.

Alojamento de bots do Telegram na HytHost

Os nossos planos de alojamento de bots executam bots do Telegram tal como bots do Discord:

1. Escolha um plano e o runtime — Python para python-telegram-bot ou aiogram, Node.js para grammY. Selecione Python 3.10 ou mais recente, ou um Node.js atual, no separador Startup.
2. Carregue o seu código com o gestor de ficheiros ou por SFTP, juntamente com requirements.txt ou package.json.
3. Coloque o token num ficheiro .env ou numa variável de ambiente, não no código.
4. Inicie-o. Com polling, o bot não precisa de domínio nem de porta aberta; o painel reinicia-o se falhar.

O que as nossas regras permitem: bots criados com a Bot API oficial e um token do BotFather. Não é permitido: userbots que automatizam uma conta pessoal, mensagens em massa não solicitadas, recolha de dados (scraping) de utilizadores ou grupos, e bots que transferem e redistribuem conteúdos multimédia sem terem os direitos sobre eles. Um bot que viole estas regras é suspenso.

Os planos incluem uma base de dados MySQL e cópias de segurança. Também está a criar um bot do Discord? Veja como criar um bot do Discord.