Créer un bot Telegram en JavaScript : guide pour débutants

Bot Telegram en JavaScript : par où commencer et comment ne pas se perdre

Avez-vous déjà réfléchi au fonctionnement de ces bots intelligents dans Telegram qui envoient la météo, rappellent les délais ou simplement font des blagues amusantes ? Et si je vous disais que vous pouvez écrire votre propre bot Telegram en JavaScript en une seule soirée ? Oui, oui, même si vous êtes débutant. Dans ce guide, nous allons décomposer le processus de création d'un bot étape par étape, avec des exemples de code réels et sans blabla inutile.

Pourquoi JavaScript ? Parce que c'est un langage universel qui fonctionne partout : sur les serveurs, dans le navigateur et même sur un Raspberry Pi. Et avec la bibliothèque Telegraf, la création d'un bot Telegram devient un véritable plaisir. Prêt ? C'est parti !

De quoi avons-nous besoin pour créer un bot Telegram en JS

Avant d'écrire du code, préparons les outils. Vous aurez besoin de :

\n
• Node.js (version 14 ou plus récente) — l'environnement d'exécution JavaScript sur le serveur.
\n
• Un éditeur de texte — Visual Studio Code, Sublime Text ou tout autre.
\n
• Un compte Telegram — impossible sans cela.
\n
• Un terminal — la ligne de commande pour installer les paquets.
\n

Si Node.js n'est pas encore installé — téléchargez-le depuis le site officiel. Le processus d'installation est trivial : il suffit de cliquer sur "Suivant".

Enregistrement du bot et obtention du token

La première étape pour créer un bot Telegram en JavaScript est d'obtenir un token API. C'est une clé secrète qui relie votre code à Telegram.

\n
1. Ouvrez Telegram et trouvez le bot @BotFather.
\n
2. Envoyez la commande /newbot.
\n
3. Choisissez un nom pour le bot (par exemple, MonPremierBotTest).
\n
4. Choisissez un nom d'utilisateur unique se terminant par bot (par exemple, mon_premier_test_2025_bot).
\n
5. Conservez le token obtenu — il ressemblera à ceci : 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz.
\n

Important : le token est votre mot de passe. Ne le montrez à personne et ne le téléchargez pas sur GitHub en clair.

Installation des bibliothèques et configuration du projet

Passons maintenant au code. Créez un dossier pour le projet, ouvrez-le dans le terminal et exécutez :

npm init -y

Cette commande créera le fichier package.json. Installons maintenant la bibliothèque principale — Telegraf :

npm install telegraf

Telegraf est une bibliothèque puissante et simple pour travailler avec l'API Telegram Bot en JavaScript. Elle prend en charge les commandes, les claviers, le mode inline et bien plus encore.

Pour plus de commodité, installez également dotenv — il vous aidera à stocker le token dans un fichier séparé :

npm install dotenv

Créez un fichier .env à la racine du projet et écrivez-y votre token :

BOT_TOKEN=votre_token_ici

N'oubliez pas d'ajouter .env dans .gitignore si vous prévoyez de publier le code.

Écrire votre premier bot Telegram en JavaScript

Créez un fichier bot.js et ouvrez-le dans l'éditeur. Commençons par le plus simple — un bot qui répond à la commande /start.

require('dotenv').config();\nconst { Telegraf } = require('telegraf');\n\nconst bot = new Telegraf(process.env.BOT_TOKEN);\n\nbot.start((ctx) => {\n    ctx.reply('Bonjour ! Je suis ton premier bot en JavaScript !');\n});\n\nbot.launch();\nconsole.log('Bot démarré !');

Lancez le bot avec la commande :

node bot.js

Ouvrez votre bot dans Telegram et appuyez sur Start. Si tout est fait correctement, le bot vous répondra par un message de bienvenue. Félicitations — vous venez de créer un bot Telegram en JavaScript fonctionnel !