Créer un bot Telegram en Python

Créer un bot Telegram en Python se fait en trois étapes : obtenir un jeton auprès de @BotFather, installer une bibliothèque Python dédiée, puis écrire quelques lignes de code qui répondent aux commandes. En une heure, même un débutant peut avoir un bot qui répond à /start. Ce guide pas à pas explique comment créer le bot, configurer son environnement, écrire le premier script, ajouter des boutons, l'héberger pour qu'il tourne en continu et protéger le jeton.

Le jeton du bot donne un contrôle total : ne le publiez jamais dans un dépôt public ni dans une capture d'écran. En cas de fuite, révoquez-le immédiatement dans @BotFather.

Créer le bot avec BotFather

1. Dans Telegram, cherchez @BotFather et vérifiez le badge officiel.
2. Envoyez /newbot.
3. Choisissez un nom affiché, puis un nom d'utilisateur qui se termine par « bot ».
4. BotFather renvoie un jeton : une suite de chiffres, deux-points et caractères.
5. Avec /setdescription, /setuserpic et /setcommands, complétez la fiche du bot.

Pour comprendre les bots en général : bots Telegram.

Préparer Python

• Installez une version récente de Python 3.
• Créez un environnement virtuel pour le projet.
• Installez une bibliothèque de bot Telegram populaire, par exemple python-telegram-bot.
• Enregistrez le jeton dans une variable d'environnement, pas dans le code.

Premier script

Un bot minimal qui répond à /start ressemble à ceci :

import os
from telegram import Update
from telegram.ext import ApplicationBuilder, CommandHandler, ContextTypes

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Bonjour ! Je suis votre premier bot.")

app = ApplicationBuilder().token(os.environ["BOT_TOKEN"]).build()
app.add_handler(CommandHandler("start", start))
app.run_polling()

Lancez le script, ouvrez votre bot dans Telegram et envoyez /start. Le bot répond tant que le programme tourne sur votre ordinateur.

Commandes et boutons

• Plusieurs commandes : ajoutez un gestionnaire par commande, par exemple /aide ou /prix.
• Boutons intégrés : des boutons sous le message déclenchent des actions sans taper de commande.
• Messages libres : un gestionnaire de texte permet de répondre aux questions fréquentes.
• Mini app : un bouton peut ouvrir une application web dans Telegram. Voir mini app Telegram.

Héberger le bot

Un bot qui tourne sur votre PC s'arrête quand vous l'éteignez. Pour qu'il fonctionne en continu, utilisez un petit serveur loué au mois ou un service d'hébergement d'applications. Deux modes existent : le « polling », où le bot interroge Telegram en boucle, simple à mettre en place, et le « webhook », où Telegram envoie les messages à votre serveur, plus efficace pour les bots très utilisés.

Idées de premiers bots

• FAQ automatique pour un commerce : horaires, adresse, tarifs.
• Rappels : le bot envoie un message à une heure donnée.
• Inscriptions à un cours ou un événement, avec enregistrement dans un tableur.
• Publication automatique dans un canal à partir d'une source d'actualités.

Commencez petit, testez avec quelques amis, puis ajoutez des fonctions une par une. Un bot simple qui fonctionne bien vaut mieux qu'un projet complexe jamais terminé.

Sécurité

• Gardez le jeton hors du code et hors des dépôts publics.
• Révoquez-le avec /revoke en cas de doute.
• Ne demandez jamais à vos utilisateurs leurs codes de connexion ou phrases de récupération.
• Activez la validation en deux étapes sur votre compte Telegram.

Pour aller plus loin avec Telegram : Telegram, comment ça marche. Pour monétiser un bot ou un canal : gagner de l'argent sur Telegram.

Exemple de bot avec mini app

TotalHash montre ce qu'un bot peut faire avec une mini app : un jeu de minage gratuit qui s'ouvre depuis le bot. Les tâches versent de petites sommes en USD₮ et GRAM sur votre portefeuille TON. Aucune promesse de revenu.

Réponses rapides

Faut-il savoir programmer pour créer un bot Telegram ?

Pour un bot sur mesure, des bases de Python suffisent ; sinon, des constructeurs sans code existent.

Comment obtenir le jeton d'un bot ?

En envoyant /newbot à @BotFather, qui renvoie le jeton après le choix du nom.

Pourquoi mon bot ne répond plus ?

Le script doit tourner en permanence ; hébergez-le sur un serveur ou un service d'hébergement.

Que faire si le jeton a fuité ?

Le révoquer immédiatement avec /revoke dans @BotFather et mettre à jour le script.