Een Telegram-bot hosten

Stap 1: maak de bot aan met BotFather

1. Open in Telegram @BotFather en stuur /newbot.
2. Geef de bot een weergavenaam en daarna een gebruikersnaam: 5 tot 32 tekens, Latijnse letters, cijfers en underscores, eindigend op bot — bijvoorbeeld my_shop_helper_bot.
3. BotFather antwoordt met de token, die er zo uitziet: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. Wie hem heeft, bestuurt je bot, dus houd hem uit je code en deel hem nooit. Is hij uitgelekt, stuur dan /token naar BotFather voor een nieuwe.

Nog twee BotFather-commando's die handig zijn om te kennen: /setcommands voegt de lijst met commando's toe die gebruikers zien als ze / typen, en /setprivacy bepaalt wat de bot in groepen ziet. De privacymodus staat standaard aan, dus in een groep ontvangt de bot alleen commando's die voor hem bedoeld zijn en antwoorden op zijn eigen berichten — tenzij je hem beheerder maakt.

Polling of webhooks?

Een bot krijgt zijn berichten van Telegram op een van twee manieren — nooit allebei tegelijk:

Begin met polling. Je hebt geen domein, geen certificaat en geen open poort nodig, en elke library ondersteunt het. Is er ooit een webhook op de token ingesteld, roep dan eerst deleteWebhook aan — polling werkt niet zolang er een webhook actief is.

Stap 2a: een bot in Python (python-telegram-bot)

python-telegram-bot 22 vereist Python 3.10 of nieuwer. Installeer het met pip install python-telegram-bot en maak bot.py aan:

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 is de andere populaire keuze in Python, ook voor Python 3.10 of nieuwer.

Stap 2b: een bot in JavaScript (grammY)

grammY is het actief onderhouden Telegram-framework voor Node.js. Voer npm install grammy uit en maak bot.js aan:

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();

Oudere tutorials gebruiken Telegraf, dat sinds februari 2024 geen nieuwe release meer heeft gehad; voor een nieuwe bot is grammY de veiligere keuze.

Limieten en regels van Telegram voor bots

Limieten volgens de bot-FAQ van Telegram:

• Ongeveer één bericht per seconde in één chat, 20 berichten per minuut in een groep en ongeveer 30 berichten per seconde in totaal.
• Bestanden: de bot kan tot 50 MB versturen en tot 20 MB downloaden.
• Er mag maar één kopie van de bot tegelijk pollen. Een tweede krijgt Conflict: terminated by other getUpdates request — gebruik een aparte token om te testen.

Regels: de voorwaarden van Telegram voor botontwikkelaars verbieden spam, ongevraagde berichten en het omzeilen van rate limits. Een bot heeft een privacybeleid nodig (het standaardbeleid van Telegram geldt als je er zelf geen schrijft) en moet de gegevens van een gebruiker verwijderen als die daarom vraagt. Een persoonlijk account automatiseren in plaats van een bot — een zogeheten userbot — is iets heel anders, en Telegram blokkeert accounts die voor flooding of spam worden gebruikt.

Telegram-bot hosting bij HytHost

Onze bot hosting-pakketten draaien Telegram-bots net zo goed als Discord-bots:

1. Kies een pakket en de runtime — Python voor python-telegram-bot of aiogram, Node.js voor grammY. Kies Python 3.10 of nieuwer, of een actuele Node.js, op het tabblad Startup.
2. Upload je code met de bestandsbeheerder of via SFTP, samen met requirements.txt of package.json.
3. Zet de token in een .env-bestand of een omgevingsvariabele, niet in de code.
4. Start hem. Met polling heeft de bot geen domein of open poort nodig; het panel herstart hem als hij crasht.

Wat onze regels toestaan: bots die gebouwd zijn op de officiële Bot API met een BotFather-token. Niet toegestaan: userbots die een persoonlijk account automatiseren, ongevraagde massaberichten, het scrapen van gebruikers of groepen, en bots die media downloaden en doorgeven zonder de rechten daarop. Een bot die deze regels overtreedt, wordt opgeschort.

Pakketten bevatten een MySQL-database en back-ups. Maak je ook een Discord-bot? Lees hoe je een Discord-bot maakt.