Comment héberger un bot Telegram

Étape 1 : créer le bot avec BotFather

1. Dans Telegram, ouvrez @BotFather et envoyez /newbot.
2. Donnez au bot un nom d'affichage, puis un nom d'utilisateur : 5 à 32 caractères, lettres latines, chiffres et underscores, se terminant par bot — par exemple my_shop_helper_bot.
3. BotFather répond avec le token, qui ressemble à 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11. Quiconque le possède contrôle votre bot : gardez-le hors de votre code et ne le partagez jamais. S'il a fuité, envoyez /token à BotFather pour en obtenir un nouveau.

Deux autres commandes BotFather utiles : /setcommands ajoute la liste de commandes que les utilisateurs voient en tapant /, et /setprivacy contrôle ce que le bot voit dans les groupes. Par défaut, le mode confidentialité est activé : dans un groupe, le bot ne reçoit que les commandes qui lui sont destinées et les réponses à ses propres messages — sauf si vous en faites un administrateur.

Polling ou webhooks ?

Un bot reçoit ses messages de Telegram de l'une de deux façons — jamais les deux en même temps :

Commencez par le polling. Il ne demande ni domaine, ni certificat, ni port ouvert, et toutes les bibliothèques le prennent en charge. Si un webhook a déjà été défini sur le token, appelez d'abord deleteWebhook — le polling ne fonctionne pas tant qu'un webhook est actif.

Étape 2a : un bot en Python (python-telegram-bot)

python-telegram-bot 22 nécessite Python 3.10 ou plus récent. Installez-le avec pip install python-telegram-bot et créez 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 est l'autre choix populaire en Python, lui aussi sur Python 3.10 ou plus récent.

Étape 2b : un bot en JavaScript (grammY)

grammY est le framework Telegram activement maintenu pour Node.js. Lancez npm install grammy et créez 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();

Les anciens tutoriels utilisent Telegraf, qui n'a plus eu de version depuis février 2024 ; pour un nouveau bot, grammY est le choix le plus sûr.

Limites et règles de Telegram pour les bots

Limites tirées de la FAQ de Telegram sur les bots :

• Environ un message par seconde dans une même discussion, 20 messages par minute dans un groupe, et environ 30 messages par seconde au total.
• Fichiers : le bot peut envoyer jusqu'à 50 MB et télécharger jusqu'à 20 MB.
• Une seule copie du bot peut faire du polling à la fois. Une deuxième reçoit Conflict: terminated by other getUpdates request — utilisez un token distinct pour les tests.

Règles : les conditions de Telegram pour les développeurs de bots interdisent le spam, les messages non sollicités et le contournement des limites de débit. Un bot doit avoir une politique de confidentialité (celle de Telegram s'applique par défaut si vous n'écrivez pas la vôtre) et doit supprimer les données d'un utilisateur sur demande. Automatiser un compte personnel au lieu d'un bot — ce qu'on appelle un userbot — est une tout autre affaire, et Telegram bannit les comptes utilisés pour le flood ou le spam.

Hébergement de bots Telegram chez HytHost

Nos offres d'hébergement de bots font tourner les bots Telegram aussi bien que les bots Discord :

1. Choisissez une offre et le runtime — Python pour python-telegram-bot ou aiogram, Node.js pour grammY. Sélectionnez Python 3.10 ou plus récent, ou une version actuelle de Node.js, dans l'onglet Startup.
2. Envoyez votre code avec le gestionnaire de fichiers ou en SFTP, accompagné de requirements.txt ou package.json.
3. Placez le token dans un fichier .env ou une variable d'environnement, pas dans le code.
4. Démarrez-le. En polling, le bot n'a besoin ni de domaine ni de port ouvert ; le panel le redémarre s'il plante.

Ce que nos règles autorisent : les bots basés sur la Bot API officielle avec un token BotFather. Interdits : les userbots qui automatisent un compte personnel, les messages de masse non sollicités, le scraping d'utilisateurs ou de groupes, et les bots qui téléchargent et redistribuent des médias sans en détenir les droits. Un bot qui enfreint ces règles est suspendu.

Les offres incluent une base de données MySQL et des sauvegardes. Vous créez aussi un bot Discord ? Consultez comment créer un bot Discord.