Comment Connecter un Assistant IA à Telegram

Vous voulez que le même assistant que vous utilisez déjà dans un onglet de navigateur vive à l'intérieur de Telegram, pour lui écrire depuis le téléphone que vous avez en poche plutôt que d'ouvrir un ordinateur portable. La bonne nouvelle : la plomberie est simple, un token de bot, une boucle de messages, un LLM. Le point moins évident, c'est ce qu'il faut pour garder cette tuyauterie en ligne après la première réponse "hello world".

Pourquoi mettre un assistant IA sur Telegram

La plupart des outils d'IA vivent derrière une URL. Vous y accédez, vous tapez, vous lisez la réponse et vous fermez l'onglet. Le contexte disparaît dès que vous fermez.

Telegram change ça en traitant votre assistant comme n'importe quelle autre conversation de votre liste de contacts. Vous pouvez lui envoyer une note vocale depuis la voiture, lui transférer un lien depuis un groupe ou coller un message d'erreur pendant que vous êtes sur l'ordinateur. En face, le même assistant garde la mémoire de chacun de ces échanges, parce que c'est un processus persistant qui répond, pas une page qui se recharge.

Une fois ce cadre en tête, la vraie question n'est plus "puis-je faire répondre un bot Telegram ?", presque tous les tutoriels y répondent en cinq minutes. La vraie question est "qui prend le relais quand le bot devient muet à 23 h un mardi soir ?".

Étape 1 : Créez le bot dans BotFather

Ouvrez Telegram et cherchez @BotFather. C'est le compte officiel avec la coche bleue de vérification. Appuyez sur Démarrer et envoyez :

/newbot

BotFather pose deux questions :

Nom affiché : celui qui apparaît sur la fiche de contact du bot. Modifiable plus tard.
Nom d'utilisateur : le @handle utilisé dans les liens et les mentions. Il doit contenir 5 à 32 caractères, uniquement l'alphabet latin, et se terminer par bot (par exemple monia_assistant_bot).

Une fois un nom d'utilisateur valide accepté, BotFather vous renvoie un token. Il ressemble à ceci :

7123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw

Traitez cette chaîne comme un mot de passe. Ne la collez pas dans des captures d'écran, des groupes ou des dépôts publics. En cas de fuite, écrivez /revoke à BotFather, choisissez le bot et il vous en donne un nouveau ; l'ancien cesse de fonctionner immédiatement.

Étape 2 : Décidez qui réfléchit

Le token du bot ne sert qu'à envoyer et recevoir des messages. Il ne décide pas quoi dire. C'est le rôle du LLM. Vous avez trois grandes options :

Une seule API de LLM : pointer directement vers OpenAI, Anthropic ou Google. Simple, mais chaque fournisseur a son SDK, son modèle d'authentification et ses limites.
Un routeur type OpenRouter : une seule clé d'API qui donne accès à des dizaines de modèles. Vous changez de modèle selon la tâche (rapide et bon marché pour le chat, gros modèle pour le raisonnement) sans jongler avec plusieurs comptes.
Un modèle local : Ollama ou llama.cpp sur votre propre matériel. Aucun coût par token, mais vous êtes responsable de la disponibilité.

Pour un assistant personnel qui doit paraître réactif, la plupart des gens finissent sur une API hébergée. La latence d'un modèle local sur du matériel grand public est souvent moins bonne qu'une API commerciale bien connectée, et la qualité reste en retrait sur le raisonnement général.

Quel que soit le fournisseur choisi, générez la clé dans son tableau de bord maintenant et stockez-la avec le token du bot. Vous aurez besoin des deux à l'étape suivante.

Étape 3 : Construisez (ou empruntez) la boucle de messages

Entre Telegram et le LLM, il faut un petit logiciel qui :

Fait du long polling (ou utilise des webhooks) contre l'API des bots Telegram pour lire les nouveaux messages.
Passe le texte du message (et éventuellement l'historique de conversation) au LLM.
Renvoie la réponse du LLM dans le même chat Telegram.
Gère les erreurs pour qu'un incident isolé ne tue pas la boucle en silence.

Si vous êtes à l'aise en Python, la bibliothèque python-telegram-bot plus le SDK du fournisseur permettent d'avoir un prototype qui tourne en environ 40 lignes. Node a des paquets équivalents. Pour une voie strictement no-code, des outils comme Make.com ou n8n permettent de poser un déclencheur Telegram et une action OpenAI sur un canvas et de les relier avec une ligne.

Deux détails que vous voudrez presque certainement ajouter avant de considérer que c'est utilisable :

Une liste d'utilisateurs autorisés, pour éviter que des inconnus qui devinent le handle du bot ne brûlent votre budget d'API. Les bots sont trouvables via la recherche Telegram ; sans allowlist, votre bot répond à tout le monde.
Une mémoire de conversation, pour que l'assistant se souvienne des tours précédents du même chat au lieu de traiter chaque message comme le premier. Persistez l'historique dans une base indexée par chat_id, ou utilisez un framework d'agents avec mémoire intégrée.

Étape 4 : Gardez le processus en vie

C'est ici que la plupart des projets de week-end meurent en silence.

Votre bot Telegram ne répond que tant que la boucle de messages tourne. Si elle est dans un terminal sur votre portable, elle s'arrête dès que le portable se met en veille. Si c'est un python bot.py sur un VPS bon marché, elle s'arrête à la prochaine chute du processus, au prochain redémarrage du VPS pour mise à jour du noyau ou à la prochaine exception non gérée à 3 h du matin.

La réponse habituelle est peu glamour :

Emballez le processus dans systemd (ou Docker avec restart: unless-stopped) pour que l'OS le relance après un crash ou un redémarrage.
Envoyez les logs quelque part où vous allez vraiment les regarder (un fichier tourné par logrotate ou un service de logs hébergé).
Ajoutez un health check qui vous prévient si le bot n'a reçu aucune update Telegram depuis N minutes.
Stockez le token du bot et les clés d'API dans un gestionnaire de secrets, pas dans un config.yaml sur le même disque que le code.

Rien de tout ça n'est difficile isolément. C'est simplement une responsabilité continue, et c'est cette part-là qui décide si "assistant IA sur Telegram" devient un outil quotidien agréable ou un projet à redéployer toutes les quelques semaines.

Le raccourci : utiliser un Hermes Agent géré

Si vous aimez l'idée d'un assistant IA sur Telegram, mais pas celle d'administrer un serveur Linux, le raccourci consiste à déléguer les deux étapes du milieu et à garder celles qui comptent vraiment pour vous.

Hermify fait tourner un Hermes Agent géré comme un contact Telegram pour vous. Vous apportez :

Votre token de bot (de l'étape 1)
Une clé de fournisseur de modèle (de l'étape 2), ou un forfait qui inclut l'accès au modèle

Hermify s'occupe de la boucle de messages, du superviseur de processus, des fichiers de mémoire qui persistent d'une conversation à l'autre et du stockage sécurisé des identifiants. Le bot est en ligne dans votre Telegram en environ une minute, et quand le processus doit redémarrer il redémarre tout seul, donc vous l'apprenez par un tableau de bord, pas par un chat silencieux. Commencez avec Hermify pour essayer la voie gérée.

Le Hermes Agent en dessous est open source, vous n'êtes donc pas verrouillé sur l'hébergement : vous pouvez déplacer plus tard la même configuration sur votre propre VPS si vous décidez que la charge opérationnelle en vaut la peine. La plupart des gens s'aperçoivent qu'ils ne le font jamais.

Choisir entre DIY et géré

Les deux voies fonctionnent. La décision porte surtout sur là où vous voulez dépenser votre attention :

DIY si vous exploitez déjà ce type d'infrastructure, voulez un contrôle total sur le modèle, les fichiers de mémoire et les prompts, et considérez la partie opérationnelle comme faisant partie du plaisir.
Géré si vous voulez que l'assistant ne soit qu'un contact Telegram à qui écrire depuis n'importe où, sans maintenance le week-end.

Dans les deux cas, le gain d'expérience est le même : votre assistant cesse d'être une URL et devient quelqu'un à qui l'on envoie un message. Une fois qu'il vit dans Telegram, vous vous en servez vraiment.

Pour comparer les étapes de configuration avec un déploiement concret, le guide de déploiement sur Telegram parcourt une installation complète de bout en bout. Pour le raccourci, commencez avec Hermify et votre assistant est en ligne sur Telegram en environ une minute.