Créer un bot Telegram en 2026 : BotFather, sans code et avec Python

Un bot Telegram peut répondre aux questions, exécuter des commandes et connecter une conversation à d’autres services. Pour le créer, commencez par BotFather. Pour lui faire envoyer des réponses, il vous faudra ensuite un workflow no-code ou un programme qui traite les messages.

Ce guide vous explique comment créer un bot Telegram en 2026 : enregistrer un compte, obtenir un token, configurer des réponses sans coder ou avec Python, et résoudre les problèmes de configuration les plus courants. Nous commencerons par BotFather, puis verrons les deux méthodes pour créer un bot fonctionnel.

En bref

via le compte officiel @BotFather et gardez son token d’accès confidentiel.

Un workflow no-code suffit pour les réponses simples ; Python vous donne le contrôle sur une logique personnalisée.

BotFather crée le compte, mais pour répondre, le bot a besoin d’un workflow ou d’un programme en cours d’exécution.

Testez /start et /help, puis envoyez un message texte dans une conversation privée avant de déployer le bot.

Qu’est-ce qu’un bot Telegram ?

Un bot Telegram est une application automatisée avec laquelle les utilisateurs échangent sur Telegram. Il peut répondre aux questions, exécuter des commandes ou connecter une conversation à un autre service, comme l’explique la présentation des bots de Telegram.

Commencez par une seule tâche. Un bot d’assistance peut afficher des instructions pour /start et /help. Un bot écho répète les messages : envoyez Hello, recevez Hello. Cela suffit pour vérifier que la connexion fonctionne avant d’ajouter d’autres règles.

Un bot n’est pas automatiquement un chatbot IA. Une réponse prédéfinie ne nécessite qu’une règle ; pour générer des réponses avec l’IA, il faut intégrer un modèle séparément. Une Mini App est une interface web qui s’ouvre dans Telegram : sa création est différente de celle du bot textuel présenté ici.

Les bots font aussi partie de l’écosystème publicitaire de Telegram : une plateforme publicitaire Telegram comme AdsGram diffuse des campagnes dans les chaînes, les bots et les Mini Apps.

Comment créer un bot Telegram

Créez le compte avec BotFather, puis choisissez un workflow no-code ou Python pour définir le comportement du bot. BotFather sert à l’enregistrer, quelle que soit la méthode choisie : ce n’est pas une troisième option pour créer la logique conversationnelle.

Avant de choisir un outil de création de bots Telegram, schématisez une conversation : message reçu → condition → réponse. Vérifiez que l’outil prend en charge les types de messages, les embranchements et le stockage des données dont vous avez besoin. Si la conversation comporte de nombreuses exceptions, comparez le temps nécessaire pour modifier les règles dans un éditeur visuel et dans le code.

Inscrivez-vous avec BotFather

Ouvrez le compte officiel @BotFather, envoyez /newbot et suivez les instructions pour choisir un nom affiché et un nom d’utilisateur. Telegram décrit cette procédure dans son tutoriel pour créer son premier bot.

1. Ouvrez BotFather avec le lien direct ci-dessus, puis appuyez sur Démarrer.
2. Envoyez /newbot.
3. Saisissez un nom affiché, par exemple Workshop Help.
4. Choisissez un nom d’utilisateur disponible qui se termine par bot, par exemple workshop_help_demo_bot.
5. Enregistrez le token d’accès dans un gestionnaire de mots de passe ou un coffre-fort de secrets.
6. Ouvrez le lien du bot pour vérifier que vous pouvez accéder à son chat.

Le nom d’utilisateur donné en exemple est fictif ; sa disponibilité n’est pas garantie. Utilisez des lettres latines, des chiffres et des traits de soulignement, et respectez les exigences de nom d’utilisateur indiquées par BotFather.

Un jeton d’accès permet au bot de s’authentifier auprès de la Bot API. Toute personne qui le récupère peut prendre le contrôle du bot : ne le publiez donc pas dans des captures d’écran, des dépôts de code ou des documents partagés. Pour un bot existant, ouvrez les options de gestion dans BotFather afin d’obtenir ou de remplacer son jeton. S’il a été divulgué, révoquez-le et mettez à jour l’application connectée avec le nouveau jeton.

Commandes BotFather utiles

Voici les commandes de configuration les plus courantes, mais la liste n’est pas exhaustive. Consultez le guide BotFather de Telegram et le menu BotFather actuel pour découvrir les paramètres disponibles.

N’ajoutez que les commandes prises en charge par votre application. Une entrée dans le menu ne génère pas de réponse à elle seule : /help nécessite toujours une règle de workflow ou un gestionnaire de code.

Créer un bot sans coder

Pour créer un bot Telegram sans coder, connectez son jeton à un workflow visuel et définissez la façon dont les messages entrants déclenchent des réponses. Voici un exemple minimal avec n8n, un outil d’automatisation tiers qui n’appartient pas à Telegram.

Commencez par configurer une instance n8n capable de recevoir les événements Telegram. L’auto-hébergement nécessite aussi de configurer un serveur : « sans code » ne veut donc pas dire « sans configuration ». Ne partez pas du principe qu’une offre hébergée ou un fonctionnement continu est gratuit.

1. Créez un nouveau workflow et ajoutez le nœud Telegram Trigger.
2. Créez des identifiants Telegram, puis saisissez le jeton BotFather dans le champ Access Token, en suivant la documentation sur les identifiants.
3. Sélectionnez l’événement Message dans le nœud Telegram Trigger.
4. Ajoutez une action Telegram avec la ressource Message et l’opération Send Message.
5. Définissez Chat ID sur l’ID du chat du message entrant. Si l’action suit directement le déclencheur, utilisez l’expression {{ $json.message.chat.id }}.
6. Définissez Text sur Bonjour ! Votre bot est connecté. La documentation des actions Telegramprésente les opérations prises en charge.
7. Lancez l’écouteur de test, puis envoyez un nouveau message privé à votre bot.
8. Vérifiez que le bot répond, puis publiez ou activez le workflow pour qu’il reste opérationnel.

Dans cet exemple, le bot répond par la même phrase à chaque message. Vous pouvez ensuite ajouter une condition pour rediriger /start vers un message de bienvenue et /help vers des instructions. Prévoyez aussi une réponse aux saisies non reconnues, afin de ne pas laisser l’utilisateur sans réponse.

Pour une instance n8n auto-hébergée, Telegram a besoin d’une adresse de webhook publique en HTTPS. Les tests et la production peuvent remplacer l’enregistrement du webhook : utilisez donc un bot de test distinct lorsque vous modifiez un workflow en production. Consultez le guide de dépannage Telegram de n8n.

Créer un bot Telegram avec Python

Choisissez Python si vous avez besoin de contrôler précisément les réponses, la validation et les intégrations. L’exemple ci-dessous implémente /start, /help et la répétition des messages texte, en utilisant le modèle de gestion asynchrone présenté dans l’exemple python-telegram-bot.

Préparer le projet

Installez une version de Python prise en charge. Python 3.12 est une bonne base pour cet exemple. La documentation de la bibliothèque fournit les détails de compatibilité. Créez un dossier et un environnement virtuel pour isoler les dépendances de ce projet.

Sur macOS ou Linux :

mkdir telegram-bot-demo cd telegram-bot-demo
python3 -m venv .venv source .venv/bin/activate
python -m pip install "python-telegram-bot==22.8"

Sous Windows PowerShell, utilisez py -m venv .venv,
puis .\.venv\Scripts\Activate.ps1, avant de lancer la même commande d’installation.
Si une règle locale empêche l’activation, lancez directement .\.venv\Scripts\python.exe au lieu de modifier la stratégie de sécurité du système juste pour suivre ce tutoriel.

Ajouter le code du bot

Enregistrez ce code sous le nom bot.py. Le token est récupéré depuis une variable d’environnement, et non enregistré dans le code source.

import os

from telegram import Update

from telegram.ext import (

Application, CommandHandler, ContextTypes,

MessageHandler, filters,

)

async def start(update: Update, context: ContextTypes.DEFAULT_TYPE):

if update.message:

await update.message.reply_text("Bonjour ! Envoyez un message ou utilisez /help.")

async def help_command(update: Update, context: ContextTypes.DEFAULT_TYPE):

if update.message:

await update.message.reply_text("Je répète les messages texte. Envoyez « Bonjour » pour essayer.")

async def echo(update: Update, context: ContextTypes.DEFAULT_TYPE):

if update.message and update.message.text:

await update.message.reply_text(update.message.text)

def main():

token = os.environ.get("TELEGRAM_BOT_TOKEN")

if not token:

raise SystemExit("Définissez TELEGRAM_BOT_TOKEN avant de démarrer le bot.")

app = Application.builder().token(token).build()

app.add_handler(CommandHandler("start", start))

app.add_handler(CommandHandler("help", help_command))

app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, echo))

app.run_polling(allowed_updates=["message"])

if __name__ == "__main__":

main()

​

Lancer le bot

Définissez le secret dans la même session de terminal, puis lancez python bot.py. Sous macOS ou Linux avec bash ou zsh, cette méthode évite de saisir le token dans une commande qui serait enregistrée dans l’historique du shell :

read -s "TELEGRAM_BOT_TOKEN?Collez le token du bot : "
zsh export TELEGRAM_BOT_TOKEN python bot.py

Avec bash, remplacez la première ligne par read -s -p "Collez le token du bot : " TELEGRAM_BOT_TOKEN.

Avec PowerShell 7, utilisez $env:TELEGRAM_BOT_TOKEN = Read-Host -MaskInput 'Collez le token du bot', puis python bot.py.

Ouvrez la conversation privée et testez /start, /help ainsi qu’un court message texte. Arrêtez le processus avec Ctrl+C. Ce code constitue une base d’apprentissage : il ne comprend ni base de données, ni état de conversation persistant, ni surveillance en production.

Faire tourner le bot en continu

Hébergez l’application sur un serveur toujours allumé, ou laissez le workflow no-code actif dans son environnement d’hébergement. Si vous fermez le processus Python local, le bot cessera de répondre.

Le long polling consiste à demander à Telegram les nouveaux événements. Avec un webhook, c’est Telegram qui envoie les événements à votre serveur. La documentation de l’API Bot décrit ces deux modes de réception des mises à jour, qui s’excluent mutuellement. L’exemple en Python utilise le polling, tandis que le déclencheur n8n s’appuie sur un webhook.

Avant de passer d’une expérimentation à un service partagé :

- Stockez le token dans les paramètres secrets de votre hébergeur et excluez .venv ainsi que les fichiers contenant des secrets de Git.
- Lancez une seule instance en polling par token de bot et évitez qu’une autre application récupère les événements du même bot.
- Configurez le redémarrage automatique et examinez les erreurs sans enregistrer de secrets ni de contenu de message superflu.
- Stockez les données de conversation nécessaires en dehors de la mémoire du processus.
- Testez un redémarrage et vérifiez que le bot reprend bien son activité.

Si votre projet a besoin d’une interface web par la suite, prévoyez-la séparément. Le guide d’AdsGram sur le développement de Telegram Mini Apps : les erreurs à évitervous donnera des pistes pour cette étape.

Résoudre les erreurs de configuration courantes

Si votre bot ne répond pas, vérifiez que l’application est bien lancée et que les mises à jour lui parviennent avant de modifier son profil. Procédez dans cet ordre pour déterminer si le problème vient du compte, du workflow ou du code.

1. Aucune réponse après l’inscription : connectez le workflow ou le programme, puis lancez-le. BotFather ne l’exécute pas à votre place.
2. Variable d’environnement manquante : définissez TELEGRAM_BOT_TOKEN dans le même terminal ou service d’hébergement que celui qui lance Python.
3. Erreur d’authentification : vérifiez qu’il n’y a pas d’espace en trop, que le token est à jour et que vous utilisez les identifiants du bon bot.
4. Conflit de polling : arrêtez les processus en double. Si vous passez d’un service avec webhook au polling, supprimez volontairement le webhook avec deleteWebhook avant de lancer le polling. Consultez la FAQ sur les mises à jour Telegram.
5. Le chat privé fonctionne, mais pas le groupe : vérifiez le mode de confidentialité et testez une commande adressée au bot, par exemple /help@your_bot_username.
6. La commande du menu ne fait rien : créez un gestionnaire pour cette commande. L’ajouter dans BotFather la rend simplement visible.

FAQ

Vous pouvez commencer en local, sans compte d’hébergement. Voici ce qu’il faut savoir sur l’inscription et le fonctionnement continu de votre bot.

Peut-on créer un bot Telegram gratuitement ?

La plateforme de bots de Telegram est gratuite, et vous pouvez développer un petit bot Python sur votre ordinateur. L’hébergement, un service no-code ou des API externes peuvent toutefois entraîner des frais. Pour commencer, lancez un bot local qui répond par texte, puis vérifiez le coût des services ou de l’hébergement avant de le faire fonctionner en continu.

BotFather est-il sûr ?

Utilisez le compte officiel, accessible depuis la documentation de Telegram ou le lien direct @BotFather dans ce guide. BotFather est l’outil de Telegram pour gérer les bots. Les principaux risques sont les faux comptes et la divulgation de votre token d’accès. Gardez-le privé et ne le confiez qu’à l’application ou au service que vous choisissez en connaissance de cause pour faire fonctionner le bot.

Comment obtenir un token de bot Telegram avec BotFather ?

Envoyez /newbot au compte officiel BotFather, puis répondez aux questions sur le nom et le nom d’utilisateur. BotFather vous fournira le token du bot. Pour un bot existant, utilisez les options de gestion pour générer un token. Conservez-le en lieu sûr et mettez à jour les identifiants de votre application chaque fois que vous révoquez ou remplacez l’ancien token.

Faut-il connaître Python pour créer un bot Telegram ?

Non. Un éditeur visuel permet de configurer une réponse simple sans Python, et d’autres langages peuvent aussi utiliser l’API Bot. Choisissez la solution en fonction du comportement souhaité et de ce que vous êtes en mesure de maintenir. Un outil visuel convient à un arbre de décision simple ; pour des validations ou des intégrations plus complexes, mieux vaut parfois développer votre propre application.

Pourquoi mon bot s’arrête-t-il quand je ferme le terminal ?

Dans cet exemple, c’est le terminal qui exécute le processus chargé de recevoir les messages et d’y répondre. Quand ce processus s’arrête, la logique du bot cesse de fonctionner, même si le compte du bot existe toujours. Pour qu’il reste actif, déployez le programme dans un environnement disponible en permanence avec gestion des redémarrages, ou laissez un workflow hébergé tourner et consultez ses journaux d’exécution en cas de problème.