Connexion Credentials Telegram N8N

Contacter Ocade Fusion

Telegram est devenu un canal de communication incontournable pour automatiser les échanges avec vos utilisateurs, clients ou équipes. En connectant Telegram à N8N, vous pouvez déclencher des workflows dès qu’un message arrive, analyser son contenu avec un LLM, et exécuter des actions automatiques. La clé de cette intégration : créer un bot Telegram et récupérer sa clé API pour l’utiliser dans vos credentials N8N.

Qu’est-ce qu’un bot Telegram ?

Un bot Telegram est un compte automatisé qui peut recevoir et envoyer des messages, des fichiers, des images. Contrairement à un compte utilisateur classique, un bot est conçu pour interagir programmatiquement avec des services externes. Dans le contexte de N8N, le bot sert d’interface entre vos workflows et la messagerie Telegram : chaque message reçu par le bot peut déclencher une automatisation.

Pour créer un bot, Telegram met à disposition BotFather, un bot spécial qui gère la création et la configuration de tous les autres bots. C’est lui qui vous fournira la clé API nécessaire pour connecter votre bot à N8N.

Prérequis : installer Telegram

Avant de créer votre bot, vous devez disposer d’un compte Telegram actif. L’application est disponible sur mobile (iOS et Android) et sur ordinateur (Windows, macOS, Linux). Pour une manipulation plus confortable lors de la configuration, l’installation sur ordinateur est recommandée.

Étapes d’installation

• Sur mobile : téléchargez Telegram depuis l’App Store (iOS) ou le Play Store (Android), puis créez votre compte avec votre numéro de téléphone.
• Sur ordinateur : rendez-vous sur desktop.telegram.org et téléchargez la version correspondant à votre système d’exploitation.
• Appareillage : au premier lancement sur ordinateur, un QR code s’affiche. Sur l’application mobile, allez dans Paramètres > Appareils > Connecter un appareil, puis scannez le QR code pour synchroniser les deux applications.

Une fois connecté sur les deux appareils, vos conversations sont synchronisées. Vous êtes prêt à créer votre premier bot.

Créer un bot avec BotFather

BotFather est le bot officiel de Telegram pour créer et gérer vos bots. Il est disponible par défaut dans tous les comptes Telegram. La procédure est simple et se fait entièrement par conversation.

Étape 1 : Accéder à BotFather

Dans la barre de recherche de Telegram, tapez BotFather. Sélectionnez le contact officiel (identifiable par son badge vérifié) et ouvrez la conversation.

Étape 2 : Créer un nouveau bot

Envoyez la commande /newbot dans le chat. BotFather vous pose alors deux questions successives :

• Nom du bot : c’est le nom affiché dans les conversations. Choisissez un nom sans espace ni tiret (exemple : OcadeFusion).
• Username du bot : c’est l’identifiant unique qui doit obligatoirement se terminer par « bot » (exemple : OcadeFusionBot).

Étape 3 : Récupérer la clé API

Une fois le bot créé, BotFather vous fournit un message contenant votre token d’accès HTTP API. Cette clé ressemble à une longue chaîne de caractères du type 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Copiez-la précieusement : c’est elle que vous utiliserez dans N8N pour authentifier votre bot.

BotFather vous indique également l’URL de votre bot sous la forme t.me/VotreNomBot. Gardez cette information pour activer le bot.

Configurer le credential Telegram dans N8N

Une fois votre clé API en main, vous pouvez créer le credential dans N8N. Cette étape permet à vos workflows d’interagir avec votre bot Telegram.

Étape 1 : Accéder aux credentials

Depuis la page d’accueil de N8N, cliquez sur Credentials dans le menu latéral. Puis cliquez sur Create Credential et recherchez « Telegram ».

Étape 2 : Configurer le credential

Sélectionnez Telegram API. Un seul champ est requis : Access Token. Collez la clé API que vous avez récupérée de BotFather.

Conseil pratique : renommez votre credential avec un nom explicite (exemple : « OcadeFusionBot ») pour le retrouver facilement si vous gérez plusieurs bots Telegram.

Étape 3 : Tester et sauvegarder

Cliquez sur Save. N8N teste automatiquement la connexion. Si tout est correct, un message de validation s’affiche. Votre credential est prêt à être utilisé dans vos workflows.

Créer un workflow déclenché par Telegram

Maintenant que votre credential est configuré, vous pouvez créer un workflow qui réagit aux messages envoyés à votre bot. Avant de tester, une étape cruciale : activer votre bot en lui envoyant un premier message.

Étape 1 : Activer le bot

Rendez-vous sur l’URL de votre bot fournie par BotFather (t.me/VotreNomBot). Cliquez sur Start en bas de la conversation. Cette action est obligatoire une seule fois : elle autorise le bot à recevoir vos messages. Sans cette activation, aucun message ne sera détecté par N8N.

Étape 2 : Ajouter le nœud Telegram Trigger

Créez un nouveau workflow dans N8N. Ajoutez un nœud Telegram Trigger et sélectionnez le credential que vous venez de créer. Dans le champ « Updates », choisissez le type d’événement à détecter : Message pour les messages texte, ou * pour tous les événements (messages, fichiers, images, etc.).

Étape 3 : Configurer la sauvegarde des exécutions

Pour visualiser les exécutions dans l’onglet dédié, allez dans les Settings du workflow. Activez la sauvegarde pour les exécutions en erreur, en succès, manuelles et en cours. Sans cette configuration, vous ne verrez pas les résultats de vos tests.

Étape 4 : Activer le workflow et tester

Point essentiel : votre workflow doit être en mode Actif (toggle en haut à droite). Un workflow inactif ne détectera aucun message entrant. Une fois activé, envoyez un message à votre bot dans Telegram. Retournez dans N8N : une nouvelle exécution doit apparaître dans l’onglet Executions.

Données récupérées et cas d’usage

Lorsqu’un message arrive sur votre bot, le nœud Telegram Trigger récupère un ensemble de données exploitables dans la suite de votre workflow. Comprendre ces données vous permet de construire des automatisations intelligentes et ciblées.

Structure des données reçues

Pour un message texte, vous récupérez notamment :

• chat.id : identifiant unique de la conversation, indispensable pour répondre au bon utilisateur.
• from.first_name / from.last_name : prénom et nom de l’expéditeur.
• text : contenu du message envoyé par l’utilisateur.
• date : timestamp de réception du message.

Pour un fichier ou une image, des données supplémentaires sont disponibles dans l’objet photo ou document : identifiant du fichier, taille, dimensions. Ces informations permettent de télécharger le fichier dans la suite du workflow avec un nœud Telegram dédié.

Cas d’usage concrets

• Chatbot intelligent : récupérez le texte du message, envoyez-le à un LLM pour analyse, puis retournez une réponse automatique via un nœud Telegram Send Message.
• Collecte de leads : stockez les informations de contact (prénom, nom, chat.id) dans une base de données NocoDB ou Airtable.
• Notifications d’équipe : déclenchez des alertes Slack ou email lorsqu’un message spécifique arrive sur le bot.
• Traitement de fichiers : recevez des images ou documents, traitez-les (compression, OCR, analyse IA) et renvoyez le résultat à l’utilisateur.

Comment connecter un bot Telegram à N8N pour déclencher des workflows automatiquement ?

La connexion Telegram-N8N nécessite d'installer un plugin spécifique sur votre serveur N8N, puis de scanner un QR code depuis l'application mobile Telegram pour synchroniser les deux services. Telegram et N8N se connectent via OAuth : vous cliquez sur 'Connecter avec Telegram' dans N8N, vous êtes redirigé vers Telegram pour autoriser l'accès, et les credentials sont créés automatiquement. Vous devez créer un bot via BotFather en envoyant la commande /newbot, récupérer le token API fourni, puis créer un credential Telegram dans N8N en collant ce token. Ensuite, ajoutez un nœud Telegram Trigger dans votre workflow et activez-le pour détecter les messages entrants. Pour connecter Telegram à N8N, il suffit de copier l'URL de votre profil Telegram et de la coller dans les paramètres de N8N. Le système détecte automatiquement vos conversations et crée les credentials nécessaires.

Conclusion

Connecter Telegram à N8N ouvre un champ d’automatisations puissant : chatbots intelligents, collecte de données, notifications en temps réel, traitement de fichiers. La procédure est simple une fois maîtrisée : créer un bot via BotFather, récupérer le token API, configurer le credential dans N8N, et activer votre workflow.

Le point clé à retenir : n’oubliez jamais d’activer votre bot (clic sur Start dans Telegram) et de passer votre workflow en mode actif. Sans ces deux actions, aucun message ne sera détecté.

Pour aller plus loin, explorez nos autres ressources N8N ou contactez notre équipe pour concevoir des automatisations Telegram adaptées à vos besoins métier.