Com allotjar un bot de Telegram

Pas 1: Crea el bot amb BotFather

1. A Telegram, obre @BotFather i envia /newbot.
2. Dona al bot un nom visible i després un nom d'usuari: de 5 a 32 caràcters, lletres llatines, dígits i guions baixos, acabat en bot — per exemple my_shop_helper_bot.
3. BotFather respon amb el token, que té aquest aspecte: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. Qui el tingui controla el teu bot, així que mantén-lo fora del codi i no el comparteixis mai. Si es filtra, envia /token a BotFather per obtenir-ne un de nou.

Dues ordres més de BotFather que val la pena conèixer: /setcommands afegeix la llista d'ordres que els usuaris veuen quan escriuen /, i /setprivacy controla què veu el bot als grups. Per defecte el mode de privadesa està activat, de manera que en un grup el bot només rep les ordres adreçades a ell i les respostes als seus propis missatges — tret que el facis administrador.

Polling o webhooks?

Un bot rep els missatges de Telegram d'una de dues maneres — mai totes dues alhora:

Comença amb polling. No necessita domini, certificat ni port obert, i totes les biblioteques el suporten. Si algun cop s'ha configurat un webhook al token, crida primer deleteWebhook — el polling no funciona mentre hi hagi un webhook actiu.

Pas 2a: Un bot en Python (python-telegram-bot)

python-telegram-bot 22 necessita Python 3.10 o posterior. Instal·la'l amb pip install python-telegram-bot i crea 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()

aiogram 3 és l'altra opció popular en Python, també amb Python 3.10 o posterior.

Pas 2b: Un bot en JavaScript (grammY)

grammY és el framework de Telegram per a Node.js que es manté activament. Executa npm install grammy i crea 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();

Els tutorials més antics fan servir Telegraf, que no ha tingut cap versió nova des del febrer del 2024; per a un bot nou, grammY és l'opció més segura.

Límits i normes de Telegram per als bots

Límits segons les preguntes freqüents sobre bots de Telegram:

• Aproximadament un missatge per segon en un mateix xat, 20 missatges per minut en un grup i aproximadament 30 missatges per segon en total.
• Fitxers: el bot pot enviar fins a 50 MB i descarregar-ne fins a 20 MB.
• Només una còpia del bot pot fer polling alhora. Una segona rep Conflict: terminated by other getUpdates request — fes servir un token separat per a les proves.

Normes: les condicions de Telegram per a desenvolupadors de bots prohibeixen l'spam, els missatges no sol·licitats i eludir els límits de freqüència. Un bot necessita una política de privadesa (s'aplica l'estàndard de Telegram si no n'escrius una de pròpia) i ha d'esborrar les dades d'un usuari quan ho demani. Automatitzar un compte personal en lloc d'un bot — l'anomenat userbot — és una cosa completament diferent, i Telegram bloqueja els comptes que s'utilitzen per a flooding o spam.

Allotjament de bots de Telegram a HytHost

Els nostres plans d'allotjament de bots executen bots de Telegram a més de bots de Discord:

1. Tria un pla i l'entorn d'execució — Python per a python-telegram-bot o aiogram, Node.js per a grammY. Tria Python 3.10 o posterior, o una versió actual de Node.js, a la pestanya Startup.
2. Puja el teu codi amb el gestor de fitxers o per SFTP, juntament amb requirements.txt o package.json.
3. Posa el token en un fitxer .env o en una variable d'entorn, no al codi.
4. Engega'l. Amb polling el bot no necessita domini ni port obert; el panell el reinicia si es penja.

Què permeten les nostres normes: bots creats sobre la Bot API oficial amb un token de BotFather. No es permeten: userbots que automatitzin un compte personal, missatges massius no sol·licitats, extreure dades (scraping) d'usuaris o grups, ni bots que descarreguin i redistribueixin contingut multimèdia sense tenir-ne els drets. Un bot que incompleixi aquestes normes queda suspès.

Els plans inclouen una base de dades MySQL i còpies de seguretat. També estàs fent un bot de Discord? Consulta com crear un bot de Discord.