Comment créer un bot Telegram en Java : guide complet avec code

Formateur Python en ligne pour débutants

Apprenez Python facilement sans surcharge théorique. Résolvez des tâches pratiques avec vérification automatique et écrivez du code directement dans le navigateur.

Start Course

Bot Telegram en Java : par où commencer et comment ne pas abandonner en cours de route

Avez-vous déjà voulu écrire votre propre bot Telegram, mais pensiez que c'était trop compliqué ? Je m'empresse de vous rassurer : créer un bot Telegram en Java est une tâche que même un débutant peut accomplir. Pas de magie, seulement un plan clair et un peu de code.

Dans ce guide, nous parcourrons tout le chemin, de l'enregistrement du bot dans Telegram à la publication de l'application finale. Vous apprendrez à connecter la bibliothèque TelegramBots, à traiter les commandes, à envoyer des messages et à éviter les erreurs typiques. À la fin, un modèle prêt que vous pourrez adapter à vos besoins.

Pourquoi Java ? Ce langage offre stabilité, performance et une immense quantité de solutions prêtes à l'emploi. Pour un bot Telegram en Java, il n'est pas nécessaire d'installer des dizaines de dépendances – tout tient dans un seul projet Maven/Gradle. C'est parti !

Étape 1 : Enregistrement du bot et obtention du token

Avant d'écrire du code, il faut « créer » le bot. Cela se fait via le bot principal de Telegram – BotFather.

Lancez BotFather dans Telegram et envoyez la commande :

/newbot

Ensuite, suivez les instructions : inventez un nom (qui sera visible par les utilisateurs) et un username (doit se terminer par _bot). Après la création réussie, vous recevrez un token – une longue chaîne de caractères comme :

1234567890:ABCdefGHIjklmNOPqrstUVwxyz-1234567

Important : le token est la clé de votre bot. Ne le montrez à personne, ne le téléchargez pas dans des dépôts publics. Il est préférable de le stocker dans des variables d'environnement ou des fichiers de configuration.

Étape 2 : Création du projet et connexion des dépendances

Nous utiliserons Maven – c'est pratique et standard pour les projets Java. Si vous préférez Gradle, le principe est le même, il suffit de réécrire les dépendances dans votre format.

Créez un projet Java standard dans votre IDE (IntelliJ IDEA, Eclipse ou NetBeans) et ouvrez le fichier pom.xml. Ajoutez-y la dépendance suivante :

<dependency>    <groupId>org.telegram</groupId>    <artifactId>telegrambots</artifactId>    <version>6.9.7.1</version></dependency>

Cette bibliothèque – TelegramBots – est la plus populaire pour créer des bots en Java. Elle prend en charge toutes les fonctions principales : envoi de messages, d'images, de boutons, travail avec le mode Inline et Webhooks.

Après avoir ajouté la dépendance, exécutez mvn clean install ou mettez à jour le projet dans l'IDE pour télécharger la bibliothèque.

Étape 3 : Écrire le premier bot – classe de base

Créez une classe qui hérite de TelegramLongPollingBot. Cette classe sera responsable de la réception des mises à jour des serveurs Telegram. Voici la structure minimale :

import org.telegram.telegrambots.bots.TelegramLongPollingBot;import org.telegram.telegrambots.meta.api.objects.Update;import org.telegram.telegrambots.meta.exceptions.TelegramApiException;

public class MySimpleBot extends TelegramLongPollingBot {

    @Override    public String getBotUsername() {        return "YourBotUsername"; // sans @    }

    @Override    public String getBotToken() {        return "YOUR_TOKEN_HERE";    }

    @Override    public void onUpdateReceived(Update update) {        // Ici nous traiterons les messages        if (update.hasMessage() && update.getMessage().hasText()) {            String messageText = update.getMessage().getText();            long chatId = update.getMessage().getChatId();            System.out.println("Message reçu : " + messageText + " du chat : " + chatId);        }    }}

Pour l'instant, le bot se contente de journaliser les messages entrants. Ajoutons une action en réponse.