Comment créer un bot Telegram de A à Z : Guide pour débutants
Créer un bot Telegram commence par BotFather et un jeton API, pas par un choix de framework. Voici le parcours pour débutants, du premier jeton à un bot qui reste en ligne.
Michael Chen
Un petit commerçant reçoit chaque jour les trois mêmes questions dans ses DMs Telegram : délais de livraison, politique de retour, dates de réapprovisionnement. Y répondre à la main lui prend une heure avant même le déjeuner. Un ami lui suggère de créer un bot pour gérer ça. Le commerçant n’a jamais écrit une ligne de code.
Bonne nouvelle : la première version d’un bot Telegram ne nécessite pas beaucoup de code, et rien ne vous oblige à toucher directement aux serveurs de Telegram. Tout passe par un outil officiel unique, conçu exactement pour ça.
Commencez par BotFather, pas par un framework
Tout bot Telegram commence de la même façon : par une conversation avec @BotFather, le propre bot de Telegram pour créer des bots. Ouvrez une discussion avec lui, envoyez /newbot, choisissez un nom d’affichage, puis un nom d’utilisateur se terminant par « bot ». BotFather vous remet immédiatement un jeton API. Ce jeton est le mot de passe du bot vers les serveurs de Telegram, et quiconque le possède peut contrôler le bot. Traitez-le donc comme les identifiants admin d’un site, pas comme quelque chose à coller dans un groupe public ou à commiter dans un dépôt de code public.
À ce stade, vous avez techniquement un bot fonctionnel. Il ne fait encore rien, car aucun code n’écoute les messages qui lui sont envoyés.
Choisissez un langage avant de choisir un tutoriel
La plupart des guides pour débutants choisissent Python par défaut, car les bibliothèques communautaires sont matures et la syntaxe se lit presque comme de l’anglais courant. Node.js convient à ceux qui sont déjà à l’aise avec JavaScript, surtout si le bot doit communiquer avec une application web que vous gérez déjà. Les grandes équipes utilisent parfois Java ou Go quand un bot doit gérer un trafic important, mais ce n’est généralement pas le point de départ pour un premier projet.
| Langage | Temps d’installation typique (indicatif) | Meilleur pour |
|---|---|---|
| Python | 30 à 60 minutes pour un bot de réponse basique | Premier bot, prototypes rapides |
| Node.js / JavaScript | 30 à 60 minutes | Équipes ayant déjà un backend JS |
| Java ou Go | Une demi-journée ou plus pour une configuration minimale | Bots à fort trafic ou pour entreprises |
Remarque : les temps d’installation varient considérablement selon l’expérience du développeur ; les chiffres ci-dessus sont des estimations indicatives, pas des benchmarks mesurés.
Ce que doit faire une première version
Résistez à l’envie de construire toutes les fonctionnalités avant de tester quoi que ce soit. Une première version fonctionnelle couvre généralement trois comportements : répondre à une commande /start par un message de bienvenue, réagir à quelques mots-clés fixes, et transférer tout ce qu’elle ne reconnaît pas à un humain. Ce dernier point est plus important qu’il n’y paraît. Les bots qui restent silencieux face à une entrée inattendue frustrent bien plus les utilisateurs que les bots avec un ensemble de fonctionnalités plus restreint.
- Répondre à
/startet/helpavec un court menu de ce que le bot peut faire. - Reconnaître un petit ensemble de mots-clés liés à vos vraies questions récurrentes, pas à une liste devinée.
- Proposer un message de repli du type « un humain vous répondra » plutôt que le silence quand rien ne correspond.
Une fois que cette boucle fonctionne de manière fiable, ajouter des messages programmés, des commandes de gestion de groupe ou une recherche en base de données devient une petite étape, pas une reconstruction complète.
Où le bot doit-il vivre
Le code sur votre ordinateur portable cesse de répondre dès que vous fermez le couvercle. Un bot destiné à fonctionner en continu a besoin d’un hébergement qui reste allumé : un petit VPS, une plateforme de conteneurs, ou une fonction serverless qui se réveille à la réception de messages. Aucune de ces options n’a besoin d’être coûteuse pour un bot à faible trafic.
| Option d’hébergement | Coût mensuel (référence) | Meilleur pour |
|---|---|---|
| Fonction serverless gratuite | 0 $ pour un trafic léger | Bots de réponse simples, tests |
| Petit VPS | 4 $ à 10 $ | Bots qui doivent aussi exécuter d’autres tâches en arrière-plan |
| Plateforme de conteneurs gérée | 5 $ à 20 $ | Équipes qui veulent moins de maintenance serveur |
Remarque : les prix sont des fourchettes approximatives et indicatives qui varient selon le fournisseur et la région, pas des devis fixes.
Si votre bot doit apparaître cohérent depuis un pays spécifique, que ce soit pour des tests régionaux ou parce que votre public est géographiquement concentré, une connexion résidentielle via le marché des proxys est une option que certaines personnes utilisent en complément de leur hébergement, indépendamment du code du bot. Quel que soit l’hébergeur choisi, la documentation officielle de l’API Telegram Bot est la référence à mettre en favori une fois que vous dépassez les commandes pour débutants.
Une courte liste de vérification avant de lancer
Parcourir ces étapes avant d’annoncer un bot publiquement évite la plupart des maux de tête liés au support précoce.
- Stockez le jeton API dans une variable d’environnement, jamais directement dans du code que vous pourriez partager ou commiter.
- Testez
/start, vos trois réponses aux mots-clés principaux, et le message de repli depuis un deuxième compte. - Confirmez que le bot reste en ligne après avoir fermé votre ordinateur portable, en le vérifiant depuis un autre appareil une heure plus tard.
- Définissez une description et une photo de profil du bot via BotFather pour qu’il ait l’air intentionnel, pas abandonné en cours de construction.
- Notez qui est prévenu lorsque le message de repli se déclenche, pour que les questions sans correspondance ne disparaissent pas dans le vide.
De nombreux fournisseurs du marché vendent également des comptes administrateurs vérifiés ou des numéros vérifiés par SMS pour les tests de bots, sous les rubriques comptes Telegram ou vérification SMS, utiles si vous préférez ne pas lier un numéro personnel à un bot que vous testez encore. Comparez quelques offres sur le prix et la rapidité de livraison avant de vous engager, de la même manière que vous compareriez des fournisseurs d’hébergement.
