Retour au blog
AI AgentsTelegramTutorialAutomation

Comment créer un agent IA sur Telegram (guide 2026)

Guide pratique pour créer un agent IA sur Telegram en 2026 : configuration de BotFather, les quatre vrais chemins (Python, n8n, SaaS, runtime d'agent) et comment choisir.

Par Hermify Team||11 min de lecture
Fond sombre avec l'icône avion en papier de Telegram et le texte en gras 'Build an AI Agent on Telegram' à côté d'une petite ligne verte en accent

Vous voulez un agent IA qui vit dans Telegram. Pas un onglet de plus dans le navigateur, pas une énième app mobile, mais un contact dans votre barre latérale qui répond quand vous lui écrivez, se souvient de ce que vous lui avez raconté la semaine dernière et peut, pour de vrai, faire des choses au lieu de seulement discuter.

La bonne nouvelle : Telegram est la plateforme de messagerie la plus accueillante pour ça. La Bot API est gratuite, s'ouvre en deux minutes via BotFather et ne facture pas au message, contrairement à WhatsApp Business qui facture à la conversation et exige une vérification Meta. La moins bonne : « comment créer un agent IA sur Telegram » se décline en au moins quatre chemins différents en 2026, et le bon dépend de votre profil - développeur qui aime câbler des stacks ou non-dev qui veut l'agent en place ce soir.

Ce guide passe en revue ce dont vous avez vraiment besoin, les quatre vrais chemins, et un arbre de décision honnête à la fin.

Ce que veut vraiment dire « un agent IA sur Telegram »

Avant de choisir un stack, il faut être précis sur ce que vous construisez. L'expression couvre un spectre large :

  • Une simple surcouche de chat. Le bot transmet vos messages à un LLM et renvoie la réponse. Utile, mais il oublie tout dès que le chat défile.
  • Un chatbot avec mémoire. Même flux, mais avec une mémoire de session ou un vector store pour rappeler les messages précédents.
  • Un agent. Un processus de longue durée doté d'une personnalité, d'outils qu'il peut appeler (recherche web, calendrier, e-mail, vos propres APIs), d'une mémoire persistante entre sessions et de la capacité à exécuter un travail en plusieurs étapes de lui-même.

La plupart des tutoriels « monter un bot Telegram » s'arrêtent à la surcouche de chat. C'est bien si vous voulez seulement chatter. Si vous voulez que l'agent se souvienne du projet décrit mercredi dernier ou qu'il exécute un point matinal automatiquement, il faut une mémoire persistante et un planificateur - exactement ce qui transforme un bot en agent.

Les dimensions qui pèsent au moment de choisir :

  • Mémoire entre sessions : l'agent se souvient-il de vous la semaine prochaine, ou chaque nouvelle conversation repart-elle de zéro ?
  • Outils et skills : peut-il vraiment faire des choses (envoyer des e-mails, chercher sur le web, résumer un PDF, appeler votre API), ou seulement discuter ?
  • BYOK : pouvez-vous pointer vers votre propre clé OpenAI, Anthropic ou OpenRouter, ou êtes-vous enfermé dans les crédits inclus du fournisseur ?
  • Hébergement : SaaS hébergé, no-code cloud, auto-hébergé ou runtime managé ?
  • Allowlist : pouvez-vous restreindre le bot à votre propre user ID Telegram, ou n'importe qui qui le trouve peut brûler vos crédits ?

La mémoire est le critère qui compte le plus. Un chatbot répond à des questions ; un agent personnel s'en souvient.

Schéma comparant un message Telegram isolé à un long fil de mémoire persistante s'étalant sur plusieurs semaines

Étape zéro : créer le bot dans BotFather

Tous les chemins ci-dessous commencent par la même étape de cinq minutes, alors faites-la d'abord.

Ouvrez Telegram, cherchez @BotFather et envoyez /newbot. BotFather va demander deux choses dans cet ordre :

  1. Un nom affiché (peut contenir des espaces, modifiable plus tard).
  2. Un nom d'utilisateur, qui doit finir par bot et est définitif.

Une fois les deux acceptés, BotFather répond avec un token d'API du type 123456789:ABCdef.... Traitez-le comme un mot de passe : toute personne disposant de ce token peut poster des messages au nom de votre bot. Stockez-le dans un gestionnaire de mots de passe ou dans un .env que vous ne commitez pas.

Quelques commandes BotFather utiles dès le premier jour :

  • /setdescription : le court texte d'intro que les utilisateurs voient en ouvrant le chat.
  • /setcommands : le menu d'autocomplétion des commandes slash.
  • /setprivacy : dans les groupes, mettez « Disable » si vous voulez que le bot voie tous les messages, pas seulement ceux qui le mentionnent.

Deux détails qui surprennent les débutants. D'abord, la Bot API de Telegram est vraiment gratuite, sans frais par message, même à l'échelle. Ensuite, par défaut, un bot n'initie une conversation qu'après que l'utilisateur a envoyé le premier message - donc en développement, écrivez-lui une fois vous-même avant d'attendre une réponse.

Chemin 1 : Python from scratch (BotFather + python-telegram-bot + OpenAI)

Le chemin classique du développeur. Vous écrivez un petit service Python qui relie la Bot API de Telegram à l'API d'un LLM et décide ce qui se passe entre les deux.

Le stack vers lequel tout le monde converge :

# requirements.txt
python-telegram-bot==22.1
openai==1.40.0
python-dotenv==1.0.1

La boucle minimale :

from telegram.ext import Application, MessageHandler, filters
from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["OPENAI_API_KEY"])

async def reply(update, context):
    msg = update.message.text
    answer = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": msg}],
    ).choices[0].message.content
    await update.message.reply_text(answer)

app = Application.builder().token(os.environ["TELEGRAM_BOT_TOKEN"]).build()
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, reply))
app.run_polling()

Ce code est un chatbot, pas encore un agent. Pour en faire un agent, vous ajoutez quatre choses par-dessus :

  • Mémoire. Une table SQLite ou Postgres indexée sur chat_id pour l'historique court. Pour le souvenir plus long, un vector store comme ChromaDB, Qdrant ou pgvector.
  • Outils. Du function-calling sur le LLM pour qu'il puisse interroger vos APIs, le web ou le système de fichiers.
  • Allowlist. Vérifiez update.effective_user.id contre une variable d'environnement ALLOWED_USERS pour qu'un utilisateur aléatoire ne vide pas votre clé.
  • Un hôte. Quelque chose qui garde le processus vivant quand votre laptop se met en veille. Un VPS à 5 €/mois comme Hetzner CX22 ou une Raspberry Pi suffit largement - le modèle tourne sur les serveurs d'OpenAI, pas chez vous.

Délai jusqu'à « agent qui se souvient et utilise des outils » : un week-end si vous maîtrisez Python, plus sinon. Coût : tokens du fournisseur (quelques euros par mois en usage personnel) plus l'hôte.

Idéal pour : développeurs qui veulent le contrôle total, aucune dépendance fournisseur, et qui acceptent de maintenir un service Python.

Chemin 2 : No-code avec n8n (ou Make)

Si vous ne voulez pas écrire de code mais souhaitez un vrai contrôle sur le flux, n8n est l'option open source la plus solide en 2026. C'est un constructeur visuel de workflows que vous pouvez auto-héberger sur un VPS à 5 €/mois ou utiliser sur n8n.cloud.

Le montage tient en gros en quatre nœuds :

  1. Telegram Trigger : écoute les nouveaux messages de votre bot.
  2. Nœud AI Agent : le nœud d'agent intégré de n8n, configuré avec un LLM (OpenAI, Anthropic, Groq, etc.) et un buffer mémoire.
  3. Nœuds outils (optionnels) : HTTP Request, Google Sheets, Postgres, vos propres APIs.
  4. Telegram Send Message : répond dans le même chat.

Le nœud AI Agent dispose d'une option Memory intégrée. Choisissez Window Buffer Memory pour les N derniers tours, ou branchez un nœud mémoire Postgres ou Redis pour la persistance entre redémarrages de n8n.

Le compromis honnête : n8n est d'abord un outil de workflow et seulement ensuite une plateforme d'agents. Il brille quand le bot est surtout une couche de tri au-dessus d'un workflow que vous avez déjà - gestion de leads, suivi de notes de frais, mises à jour CRM, pré-tri support. Il commence à fatiguer quand l'agent doit réfléchir plutôt que router. Si vous vous retrouvez à ajouter un cinquième nœud IF pour gérer des subtilités du langage humain, vous simulez du raisonnement avec des branches et l'agent va perdre. Nous avons creusé le contraste dans Hermes Agent vs n8n.

Idéal pour : non-développeurs, ou développeurs qui utilisent déjà n8n pour d'autres workflows et veulent une surface Telegram pour eux.

Chemin 3 : Constructeurs SaaS hébergés

Des plateformes qui emballent tout le stack derrière une interface web. Vous vous inscrivez, collez le token BotFather, glissez quelques blocs, cliquez publier et le bot est en ligne. Voiceflow, Botpress, Mosaia, Lobster Father et une longue traîne de niches vivent ici.

Les compromis sont prévisibles :

  • Le setup le plus facile du marché - souvent moins d'une heure, parfois moins de cinq minutes.
  • BYOK est rare. Vous consommez en général les crédits du fournisseur avec marge, ou vous épuisez le plan gratuit dans l'après-midi.
  • La « mémoire » affichée sur la page marketing est souvent limitée à la session, pas entre sessions. Testez-le le huitième jour avant de vous engager.
  • Vos messages et ceux de vos utilisateurs passent par l'infrastructure du fournisseur. Lisez la politique de confidentialité.

Ce chemin convient quand le bot est un FAQ orienté client ou une couche de captation de leads et que vous n'avez pas besoin de mémoire personnelle persistante.

Idéal pour : petites entreprises qui veulent un bot Telegram orienté client, avec un coût opérationnel minimal et sans besoin de mémoire personnelle entre sessions.

Chemin 4 : Un runtime d'agent auto-hébergé

C'est la catégorie la plus récente et celle qui correspond le mieux au cas d'usage « agent personnel sur Telegram ». Un runtime d'agent auto-hébergé est un processus de longue durée pensé spécifiquement pour être un agent : il livre, dès le départ, mémoire structurée, couche de skills, planificateur et intégration de premier ordre sur Telegram (et d'autres plateformes).

Les deux vraies options open source :

  • OpenClaw stocke tout sous forme de fichiers Markdown et YAML dans votre workspace. Local-first, transparent, les skills sont portables d'une machine à l'autre puisque ce sont juste des fichiers.
  • Hermes Agent est celui que nous connaissons le mieux, car Hermify en est la version managée. Il maintient un profil persistant et une mémoire entre sessions, crée et améliore des skills automatiquement au fil du travail, tourne sur un VPS à 5 € ou une Raspberry Pi, et a un support Telegram de premier ordre incluant allowlist, mode vocal et planification en langage naturel. Pour un pas à pas, voir Comment déployer Hermes Agent sur Telegram.

Le profil de coût ressemble à celui du Chemin 1 (c'est vous qui hébergez) avec l'avantage que le runtime prend en charge le gros du travail sur la mémoire, les skills et la fiabilité. Vous le pointez vers votre propre clé OpenAI ou Anthropic, vous mettez le token BotFather dans la configuration, et vous avez un agent qui se souvient et agit - sans service Python à maintenir.

Idéal pour : ceux qui veulent un vrai agent personnel (qui se souvient, apprend, fait des choses), tiennent à posséder leur stack et sont à l'aise avec un VPS à 5 € ou une Pi.

Bureau à domicile sombre et photoréaliste, avec un téléphone affichant une notification Telegram en vert et la LED d'un petit serveur qui clignote faiblement à l'arrière-plan

Comment choisir

Un court arbre de décision, ordonné par ce que la plupart des gens cherchent vraiment :

| Votre situation | Chemin | |---|---| | Vous voulez un chatbot, peu importe la mémoire ou les outils | SaaS hébergé (Chemin 3). Gratuit ou presque, instantané. | | Vous utilisez déjà n8n / Make pour d'autres workflows | n8n (Chemin 2). Telegram Trigger + AI Agent. | | Vous êtes développeur Python et voulez le contrôle total | Python from scratch (Chemin 1). Prévoyez un week-end. | | Vous voulez un vrai agent personnel qui se souvient et apprend | Runtime d'agent auto-hébergé (Chemin 4). | | Vous voulez le Chemin 4 sans serveur à gérer | Runtime managé - c'est ce qu'est Hermify. |

Un test de bon sens avant de vous engager : montez le bot, écrivez-lui pendant une semaine, puis le huitième jour, regardez ce dont il se souvient quand vous revenez. S'il rappelle le projet que vous lui avez décrit mercredi dernier, vous avez un agent. Sinon, vous avez un chatbot. Il n'y a rien de mal à avoir un chatbot, mais autant savoir lequel vous avez fini par construire.

Pourquoi Telegram et pas WhatsApp ou Discord

C'est la deuxième question la plus posée et elle mérite un paragraphe. Telegram s'est imposé pour les agents personnels parce que trois choses s'alignent : la Bot API est gratuite et immédiate (pas de frais par message, pas de vérification d'entreprise, pas de templates pré-approuvés), la plateforme autorise les bots tiers sans friction et l'UX du chat (réponses, pièces jointes, messages vocaux, claviers inline) est assez riche pour soutenir des interactions de type agent. WhatsApp Business facture à la conversation et exige une vérification Meta avec templates pré-approuvés - viable pour du service client transactionnel, douloureux pour un agent personnel à 19 €/mois. Discord est un bon choix quand votre communauté y vit déjà ; nous le couvrons dans un guide séparé.

Nous avons aussi écrit une comparaison plus longue dans Le meilleur assistant IA pour Telegram si vous voulez voir côte à côte les options existantes au lieu d'en construire une.

Conclusion

Le plus petit chemin - SaaS hébergé - convient très bien pour un chatbot. Python from scratch est la bonne réponse si vous aimez câbler des stacks et voulez que chaque ligne soit la vôtre. n8n est la bonne réponse si le bot est avant tout de la plomberie de workflow. Un runtime d'agent auto-hébergé est la bonne réponse si vous voulez que l'assistant soit un outil de long terme qui s'améliore plus vous l'utilisez.

Si vous voulez la version « agent personnel » sans gérer de serveur, démarrez avec Hermify. C'est la version managée de Hermes Agent : mémoire persistante, BYOK, livraison Telegram, allowlist, et aucun Docker à surveiller.

Quel que soit le chemin, le prix est le même : un assistant qui vit dans l'app que vous ouvrez déjà cinquante fois par jour.

Sources

Lancez votre propre agent Hermes

Apportez votre clé API, connectez Telegram et obtenez un agent IA auto-améliorant opérationnel en 60 secondes.

Commencer