Ressources · Intégration n8n

Intégration Telegram n8nAutomatiser Telegram avec n8n.

Jusqu'où un bot peut-il pousser une intégration Telegram n8n ? Le nœud expose 24 opérations sur 4 ressources, du message texte à l'annonce épinglée ou au fichier récupéré dans un chat. Le trigger écoute 9 types de mises à jour. Alertes, validations et bot de support tiennent là-dessus.

Tester l'intégration Telegram sur n8nVoir les 24 opérations

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

Que couvre vraiment l'intégration Telegram n8n ?

L'intégration Telegram n8n repose sur deux nœuds livrés avec n8n. Le nœud Telegram joue le rôle du bot : il poste du texte, des photos, des vidéos, de l'audio, des documents, des stickers et des positions dans une conversation, modifie ou supprime ce qu'il a déjà envoyé, épingle et désépingle, et relit les données d'un chat. Le Telegram Trigger, le nœud qui démarre un workflow, se déclenche dès qu'une mise à jour arrive sur ce même bot.

Première forme, la plus courte : l'alerte. Un workflow qui surveille une exécution en échec se termine sur message.sendMessage, et le groupe concerné voit la ligne en quelques secondes. Face à une notification via Pushover, l'intérêt tient au fil : la discussion continue sous l'alerte, avec les personnes qui doivent réagir. Règle Parse Mode sur HTML si les chiffres doivent ressortir, et coupe Append n8n Attribution dans les Additional Fields pour que le message ne se termine pas par la signature n8n.

Deuxième forme, la validation, celle qui distingue Telegram d'un canal de notification à sens unique. message.sendAndWait pose la question et suspend l'exécution jusqu'à ce qu'on réponde, d'où le Response Type qui propose Approval, Free Text et Custom Form. Une remise inhabituelle, un congé, un virement à autoriser : la décision se prend dans le fil, et le workflow repart tout seul derrière.

Troisième forme, le bot à double sens. Le trigger se déclenche sur un message entrant, le workflow répond avec message.sendMessage, et une réponse via clavier inline revient sous forme de callback_query auquel callback.answerQuery répond. Les photos envoyées par les équipes terrain passent par file.get avant d'être archivées dans Google Sheets. Le schéma se transpose sur Slack, à une différence près : un groupe Telegram s'adresse par un Chat ID numérique, et @channelusername ne fonctionne que sur les canaux publics.

Le nœud HTTP Request prend le relais dès que la méthode de la Bot API visée sort des 24 opérations. Il appelle n'importe quel endpoint Telegram en réutilisant le même credential, l'identifiant de connexion enregistré une fois dans n8n, donc rien n'est à refaire. Deux limites méritent un plan : la Bot API accepte 30 messages par seconde, seuil qu'un nœud Loop Over Items alimentant au plus 30 Chat ID et une pause posée par un nœud Code permettent de tenir, et Telegram ne retient qu'un seul webhook par bot, si bien qu'un workflow en test prive la version publiée de ses événements.

Si la question porte sur la plateforme plutôt que sur le nœud, l'Avis n8n traite l'hébergement et le coût, et la Formation n8n montre comment construire ce type de workflow.

Connexion

Comment connecter Telegram à n8n ?

  1. 01

    Créer le bot avec BotFather

    Un compte Telegram suffit. Ouvre une discussion avec @BotFather, envoie /newbot et réponds à ses deux questions. Le name s'affiche dans la fiche de contact et reste modifiable. Le username sert à la recherche, aux mentions et aux liens t.me : de 5 à 32 caractères, lettres latines, chiffres et tirets bas, insensible à la casse, terminé par bot, figé une fois créé.

  2. 02

    Enregistrer le token dans un credential

    BotFather répond avec un token. Dans n8n, ouvre le menu Credentials, crée un credential Telegram et colle cette valeur dans Access Token. C'est la seule méthode d'authentification acceptée par ces nœuds. Un credential se crée une fois puis se retrouve dans la liste déroulante de chaque workflow, et le Telegram Trigger prend exactement le même : un bot se configure une seule fois.

  3. 03

    Donner au bot l'accès au canal

    Un bot ne publie pas là où il n'est pas membre. Dans l'application Telegram, ouvre le canal visé et touche son nom, marque-le comme canal public, puis passe par Administrators, Add Admin, cherche le username du bot et valide avec la coche en haut à droite. Sans cette étape, la première exécution renvoie Error: Forbidden: bot is not a participant of the channel.

Déclencheurs

Qu'est-ce qui déclenche un workflow depuis Telegram ?

Telegram Trigger est le nœud qui démarre un workflow quand quelque chose se passe dans Telegram. Il écoute 9 événements, listés ci-dessous par famille. Tu en choisis un ou plusieurs, tu actives le workflow : n8n enregistre le webhook (l'URL que Telegram appelle) sur ton compte.

Ce que tu vois dans n8n

Tous les événements, par famille

Une ligne par objet, une puce par action. L'événement à cocher dans le nœud s'écrit objet.action ; survole une puce pour lire quand il se déclenche.

callback_query.*1
  • callback_query.
    • callback_query
channel_post.*1
  • channel_post.
    • channel_post
edited_channel_post.*1
  • edited_channel_post.
    • edited_channel_post
edited_message.*1
  • edited_message.
    • edited_message
inline_query.*1
  • inline_query.
    • inline_query
message.*1
  • message.
    • message
poll.*1
  • poll.
    • poll
pre_checkout_query.*1
  • pre_checkout_query.
    • pre_checkout_query
shipping_query.*1
  • shipping_query.
    • shipping_query

Le trigger accepte aussi * (tout événement). Pratique pour du log, dangereux en production.

Notes de configuration

01Telegram Trigger setupLe Telegram Trigger enregistre un webhook à l'activation du workflow. Un webhook, c'est une URL que Telegram appelle : chaque mise à jour arrive dans n8n en quelques secondes, sans interrogation régulière de l'API.

Le Telegram Trigger enregistre un webhook à l'activation du workflow. Un webhook, c'est une URL que Telegram appelle : chaque mise à jour arrive dans n8n en quelques secondes, sans interrogation régulière de l'API.

Paramètres clés

  • Trigger On : les mises à jour auxquelles le bot s'abonne. Le catalogue en expose 9, et * prend tout sauf Chat Member, Message Reaction et Message Reaction Count.
  • Restrict to Chat IDs : ne déclenche que pour les Chat ID listés ici, séparés par des virgules.
  • Restrict to User IDs : le même filtre appliqué aux identifiants d'utilisateur.
  • Download Images/Files : rapatrie l'image ou le fichier joint dans l'item, Image Size décidant de la taille récupérée, la grande par défaut.
Quand l'utiliser
abonne-toi à l'événement le plus étroit qui fasse le travail, puis ajoute les restrictions. Le workflow cesse de se réveiller pour des conversations qui ne le concernent pas, et la liste des exécutions redevient lisible.
02Message and Edited MessageCes deux-là portent le trafic ordinaire d'une conversation. La plupart des bots se construisent sur ce duo, et rien d'autre.

Ces deux-là portent le trafic ordinaire d'une conversation. La plupart des bots se construisent sur ce duo, et rien d'autre.

Paramètres clés

  • Message (message) : un nouveau message entrant de n'importe quel type, texte, photo ou sticker.
  • Edited Message (edited_message) : une nouvelle version d'un message déjà connu du bot qui a été modifié.
Cas d'usage
un bot de support répond au moment où la question est tapée. S'abonner aussi à l'événement de modification rattrape la correction postée dix secondes plus tard, plutôt que de traiter la première version comme définitive et le correctif comme une seconde demande.
Quand l'utiliser
garde les deux quand la réponse dépend du libellé exact, et laisse tomber le second quand gérer les doublons coûte plus cher que ça ne rapporte.
03Channel Post and Edited Channel PostUn canal diffuse dans un seul sens, et Telegram rapporte son activité séparément des messages de conversation.

Un canal diffuse dans un seul sens, et Telegram rapporte son activité séparément des messages de conversation.

Paramètres clés

  • Channel Post (channel_post) : un nouveau post entrant sur un canal, de n'importe quel type, texte, photo ou sticker compris.
  • Edited Channel Post (edited_channel_post) : une nouvelle version d'un post de canal connu du bot qui a été modifié.
Cas d'usage
recopier chaque annonce dans une archive au fil de l'eau, ou surveiller un canal et réagir quand un post est discrètement réécrit après publication, ce que l'événement de publication seul ne voit jamais.
Quand l'utiliser
le bot doit siéger dans le canal pour que l'un ou l'autre se déclenche, exactement la même étape d'administration que pour y publier.
04Callback Query and Inline QueryCes deux événements naissent d'une interaction avec le bot, pas d'un message écrit. Tous deux attendent une réponse.

Ces deux événements naissent d'une interaction avec le bot, pas d'un message écrit. Tous deux attendent une réponse.

Paramètres clés

  • Callback Query (callback_query) : une nouvelle callback query entrante, du type que renvoie un clavier inline au bot.
  • Inline Query (inline_query) : une nouvelle inline query entrante, levée quand un utilisateur tape le nom du bot dans une conversation.
Cas d'usage
la voie des boutons se complète avec callback.answerQuery, qui renvoie la réponse à ce clavier. Côté frappe, c'est callback.answerInlineQuery qui renvoie la liste de résultats à insérer dans le fil.
Quand l'utiliser
abonne-toi au callback dès qu'un workflow envoie des boutons : chaque réponse arrive comme un événement, et il faut bien que quelque chose y réponde. L'inline ne sert qu'à un bot pensé pour être appelé depuis les conversations des autres.
05Poll, Pre-Checkout Query and Shipping QueryLes trois derniers événements sont étroits volontairement, et chacun traîne une condition à connaître avant de bâtir dessus.

Les trois derniers événements sont étroits volontairement, et chacun traîne une condition à connaître avant de bâtir dessus.

Paramètres clés

  • Poll (poll) : un nouvel état de sondage. Les bots ne reçoivent que les mises à jour des sondages arrêtés et de ceux qu'ils ont envoyés eux-mêmes.
  • Pre-Checkout Query (pre_checkout_query) : une nouvelle pre-checkout query entrante, qui porte l'information complète de la commande.
  • Shipping Query (shipping_query) : une nouvelle shipping query entrante, levée pour les factures à prix flexible uniquement.
Cas d'usage
enregistrer le résultat d'un sondage d'équipe dès que Telegram le signale arrêté. Les deux événements de paiement appartiennent à un bot qui vend dans Telegram et restent muets partout ailleurs, ce qui les rend faciles à laisser branchés.
Actions

Que sait faire le nœud Telegram ?

Le nœud Telegram expose 24 opérations sur 4 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

Matrice ressources × opérations
RessourceGetGet AdministratorsAnswer Inline QueryAnswer QueryDelete Chat MessageEdit Message TextLeaveGet MemberPin Chat MessageSend and Wait for ResponseSend AnimationSend AudioSend Chat ActionSend DocumentSend LocationSend Media GroupSend MessageSend PhotoSend StickerSend VideoSet DescriptionSet TitleUnpin Chat Message
Chat✓✓✓✓✓✓
Callback✓✓
File✓
Message✓✓✓✓✓✓✓✓✓✓✓✓✓✓✓

Chat

6 opérations
01

Get a chat

chat.get

Ce que tu vois dans n8n

Notes & cas d'usage

Rapatrie l'état courant d'un chat dans le workflow, pour que les nœuds suivants s'appuient sur ce que Telegram renvoie plutôt que sur une supposition.

Paramètres clés

  • Chat ID : l'identifiant unique du chat visé, ou son nom d'utilisateur. Si tu ne l'as pas sous la main, demande-le à @get_id_bot.
Cas d'usage
lire le chat une fois en début d'exécution, puis laisser un nœud IF trancher entre un rapport complet et une ligne de résumé.
02

Get all administrators in a chat

chat.administrators

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie en un appel la liste des administrateurs d'un chat, via la méthode getChatAdministrators de la Bot API.

Paramètres clés

  • Chat ID : le Chat ID ou le nom du canal au format @channelusername. Un Telegram Trigger placé plus haut dans le workflow te fournit directement cette valeur.
Cas d'usage
reconstruire chaque matin la liste des modérateurs, ou vérifier que la personne qui a envoyé une commande a le droit de la lancer avant que la suite ne s'exécute.
03

Get a member in a chat

chat.member

Ce que tu vois dans n8n

Notes & cas d'usage

Interroge une personne précise dans un chat précis et renvoie sa fiche de membre.

Paramètres clés

  • Chat ID : le chat dans lequel l'appartenance est vérifiée.
  • User ID : l'identifiant unique de l'utilisateur visé.
Cas d'usage
réserver une commande interne aux membres d'un groupe privé. Le bot cherche la personne, et la branche qui suit décide quoi faire de la réponse obtenue.
04

Leave a chat

chat.leave

Ce que tu vois dans n8n

Notes & cas d'usage

Fait sortir le bot d'un groupe, d'un supergroupe ou d'un canal.

Paramètres clés

  • Chat ID : le groupe, le supergroupe ou le canal que le bot quitte.
Cas d'usage
refermer un groupe projet temporaire à la fin d'une campagne. Le dernier nœud du workflow de clôture retire le bot, et personne n'a besoin de se rappeler six semaines plus tard dans quelles conversations il traînait encore.
05

Set description on a chat

chat.setDescription

Ce que tu vois dans n8n

Notes & cas d'usage

Remplace le texte affiché sous le nom du chat par un autre.

Paramètres clés

  • Chat ID : le chat dont la description change, sous forme d'identifiant ou de @channelusername.
  • Description : la nouvelle description du chat, de 0 à 255 caractères, plafond à garder en tête au moment de construire la chaîne.
Cas d'usage
garder la description d'un canal de support alignée sur l'astreinte du moment, rafraîchie chaque lundi par un workflow programmé.
06

Set a title on a chat

chat.setTitle

Ce que tu vois dans n8n

Notes & cas d'usage

Renomme un chat depuis le workflow, ce qui devient utile dès que le nom porte une information.

Paramètres clés

  • Chat ID : le chat qui est renommé.
  • Title : le nouveau titre du chat, de 1 à 255 caractères.
Cas d'usage
une cellule de crise nommée d'après l'incident qu'elle suit, retitrée quand le statut passe d'investigation à résolu. La liste des conversations affiche l'état sans qu'on ouvre le fil.

Callback

2 opérations
07

Answer Query a callback

callback.answerQuery

Ce que tu vois dans n8n

Notes & cas d'usage

Répond à un callback query envoyé depuis un clavier inline, pour que chaque bouton de ce clavier reçoive une réponse du workflow.

Paramètres clés

  • Query ID : l'identifiant unique de la requête à laquelle on répond. Un Telegram Trigger réglé sur Callback Query le transmet.
  • Text : une notification facultative de 0 à 200 caractères. Laissé vide, rien ne s'affiche.
  • Show Alert : transforme cette notification en fenêtre d'alerte au lieu d'un bandeau en haut de l'écran de discussion.
Cas d'usage
confirmer la clôture d'un ticket sur le bouton lui-même, dans le fil où la demande est partie.
08

Answer an inline query callback

callback.answerInlineQuery

Ce que tu vois dans n8n

Notes & cas d'usage

Alimente la liste de résultats proposée à quelqu'un qui tape le nom du bot dans une conversation, sans qu'il en sorte.

Paramètres clés

  • Query ID : l'identifiant unique de la requête traitée, récupéré depuis un Telegram Trigger réglé sur Inline Query.
  • Results : un tableau de résultats sérialisé en JSON. Telegram en accepte 50 au maximum par requête.
  • Cache Time : la durée, en secondes, pendant laquelle le client peut garder cette réponse en cache.
Cas d'usage
un bot de recherche interne : un commercial tape le nom du bot et une référence produit, puis insère la bonne ligne de tarif.

File

1 opération
09

Get a file

file.get

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère à partir de son identifiant un fichier auquel le bot a accès, et rapatrie au besoin son contenu dans le workflow.

Paramètres clés

  • File ID : l'identifiant du fichier à récupérer.
  • Download : activé, le nœud télécharge le fichier ; désactivé, il ne renvoie que sa fiche.
  • MIME Type : à renseigner quand l'extension seule ne suffit pas à identifier le fichier, par exemple image/jpeg.
Cas d'usage
un technicien envoie une photo de compteur au bot, et le workflow la télécharge avant que quoi que ce soit tente de la lire.

Message

15 opérations
10

Delete a chat message

message.deleteMessage

Ce que tu vois dans n8n

Notes & cas d'usage

Efface un message d'une conversation, via la méthode deleteMessage de la Bot API.

Paramètres clés

  • Chat ID : la conversation qui contient le message.
  • Message ID : l'identifiant unique du message à supprimer.
Cas d'usage
nettoyer le message d'attente qu'un long workflow a posté pendant qu'il travaillait, une fois le résultat final envoyé et le repère devenu inutile.
11

Edit a text message

message.editMessageText

Ce que tu vois dans n8n

Notes & cas d'usage

Réécrit sur place le texte d'un message déjà publié, au lieu d'empiler un correctif juste en dessous.

Paramètres clés

  • Chat ID : la conversation qui héberge le message à réécrire.
  • Message ID : l'identifiant unique du message à modifier.
  • Inline Message ID : utilisé à la place quand Message Type vaut Inline Message.
  • Text : le texte que devient le message.
  • Reply Markup : None, ou Inline Keyboard pour conserver des boutons sous le texte modifié.
Cas d'usage
une ligne de statut qui passe de « en file » à « en cours » puis à « terminé », sans noyer le canal sous trois messages presque identiques.
12

Pin a chat message

message.pinChatMessage

Ce que tu vois dans n8n

Notes & cas d'usage

Épingle un message pour qu'il reste en haut de la conversation pour tout le monde.

Paramètres clés

  • Chat ID : la conversation où l'épingle apparaît.
  • Message ID : l'identifiant unique du message à épingler.
  • Disable Notification : champ des Additional Fields qui décide si tous les membres reçoivent une notification du nouveau message épinglé.
Cas d'usage
épingler le résumé d'incident dès sa publication, pour que les arrivants tardifs le lisent avant de remonter le fil.
13

Send an animated file

message.sendAnimation

Ce que tu vois dans n8n

Notes & cas d'usage

Publie un GIF, ou une vidéo H.264/MPEG-4 AVC sans son, jusqu'à 50 Mo.

Paramètres clés

  • Chat ID : la conversation où atterrit l'animation.
  • Binary File : activé quand le fichier vient du workflow lui-même.
  • Input Binary Field : le nom de la propriété binaire qui contient ce fichier.
  • Animation : utilisé quand Binary File est désactivé. Passe un file_id déjà présent sur les serveurs Telegram, la voie recommandée, ou une URL HTTP.
Cas d'usage
une courte capture d'écran qui montre ce qui a changé, envoyée au canal qui suit les mises en production.
14

Send an audio file

message.sendAudio

Ce que tu vois dans n8n

Notes & cas d'usage

Envoie un fichier audio, que Telegram affiche dans son lecteur musical.

Paramètres clés

  • Chat ID : la conversation de destination.
  • Binary File et Input Binary Field : l'interrupteur et le nom de la propriété quand l'audio arrive d'un nœud précédent.
  • Audio : un file_id ou une URL HTTP, en remplacement de la voie binaire.
  • Performer et Title : des Additional Fields qui remplissent les deux lignes affichées par le lecteur.
Cas d'usage
un résumé vocal produit plus haut dans le workflow et déposé chaque soir dans une conversation privée.
15

Send a chat action

message.sendChatAction

Ce que tu vois dans n8n

Notes & cas d'usage

Signale à la conversation qu'il se passe quelque chose du côté du bot. Telegram maintient ce statut 5 secondes au plus.

Paramètres clés

  • Chat ID : la conversation qui voit le statut.
  • Action : ce qu'il faut diffuser, choisi selon ce que la personne s'apprête à recevoir. Typing, Upload Photo, Upload Document, Record Audio, Find Location et le reste de la liste.
Cas d'usage
le placer avant une branche lente, pour que celui qui attend une réponse voie Typing au lieu du silence.
16

Send a document

message.sendDocument

Ce que tu vois dans n8n

Notes & cas d'usage

Transmet un fichier en tant que document, le bon format pour un PDF, un export ou une archive.

Paramètres clés

  • Chat ID : la conversation qui reçoit le fichier.
  • Binary File et Input Binary Field : active l'interrupteur, puis nomme la propriété binaire qui porte le document.
  • Document : un file_id ou une URL HTTP quand la voie binaire est désactivée.
  • File Name : un Additional Field qui fixe le nom vu par le destinataire.
Cas d'usage
l'export mensuel quitte le workflow comptable et arrive déjà nommé dans le groupe finance.
17

Send a location

message.sendLocation

Ce que tu vois dans n8n

Notes & cas d'usage

Pose un point sur la carte dans la conversation, construit à partir de deux coordonnées.

Paramètres clés

  • Chat ID : la conversation où le point est publié.
  • Latitude : la latitude du lieu.
  • Longitude : la longitude du lieu.
Cas d'usage
une équipe terrain reçoit sa prochaine intervention sous forme de coordonnées précises, au lieu d'une adresse à recopier.
18

Send a media group message

message.sendMediaGroup

Ce que tu vois dans n8n

Notes & cas d'usage

Regroupe plusieurs photos et vidéos dans un seul album au lieu d'une rafale de messages séparés.

Paramètres clés

  • Chat ID : la conversation qui reçoit l'album.
  • Media : utilise Add Media une fois par fichier. Chaque entrée prend un Type, Photo ou Video, et un Media File donné sous forme de file_id ou d'URL HTTP.
Cas d'usage
quatre visuels produit publiés en un seul album, pour qu'un canal catalogue reste parcourable au lieu de devenir un mur d'images.
19

Send a text message

message.sendMessage

Ce que tu vois dans n8n

Notes & cas d'usage

C'est l'opération sur laquelle finit la majorité des workflows : le bot poste du texte dans une conversation.

Paramètres clés

  • Chat ID : la conversation visée, sous forme d'identifiant numérique ou de @channelusername.
  • Text : le corps du message, jusqu'à 4096 caractères après analyse des entités.
  • Parse Mode : Markdown, MarkdownV2 ou HTML, pour des valeurs en gras et des liens.
  • Append n8n Attribution : actif par défaut, c'est pourquoi les messages envoyés se terminent par la ligne n8n. Ajoute le champ et bascule l'interrupteur pour l'enlever.
Cas d'usage
l'alerte qui annonce un paiement en échec, dans le groupe capable d'agir.
20

Send message and wait for response

message.sendAndWait

Ce que tu vois dans n8n

Notes & cas d'usage

Poste un message puis maintient l'exécution en attente jusqu'à ce qu'une personne réponde dans Telegram, ce qui transforme une conversation en étape de validation.

Paramètres clés

  • Chat ID : la conversation où la question apparaît.
  • Message : le texte que la personne lit avant de trancher.
  • Response Type : Approval pour un bouton, Free Text pour une réponse écrite via un formulaire, Custom Form pour plusieurs champs.
  • Type of Approval : Approve Only, ou Approve and Disapprove pour les deux boutons.
  • Limit Wait Time : borne le temps d'attente du nœud avant que l'exécution reprenne.
Cas d'usage
une remise au-dessus du plafond habituel attend qu'un responsable valide avec Approve avant l'envoi du devis.
21

Send a photo message

message.sendPhoto

Ce que tu vois dans n8n

Notes & cas d'usage

Publie une image directement dans la conversation, l'opération à choisir quand le visuel porte le message.

Paramètres clés

  • Chat ID : la conversation où part l'image.
  • Binary File et Input Binary Field : le duo à utiliser quand un nœud précédent a produit l'image.
  • Photo : un file_id déjà présent sur les serveurs Telegram, ou une URL HTTP, quand la voie binaire est coupée.
  • Caption : de 0 à 1024 caractères sous l'image.
Cas d'usage
le graphique qui clôt le rapport hebdomadaire, avec les chiffres marquants écrits dans la légende.
22

Send a sticker

message.sendSticker

Ce que tu vois dans n8n

Notes & cas d'usage

Répond avec un sticker : .WEBP statique, .TGS animé ou .WEBM vidéo.

Paramètres clés

  • Chat ID : la conversation qui reçoit le sticker.
  • Binary File et Input Binary Field : utilisés quand le fichier du sticker circule dans le workflow.
  • Sticker : un file_id déjà présent sur les serveurs Telegram, ou une URL HTTP vers un fichier .webp.
Cas d'usage
un déploiement qui passe déclenche toujours le même sticker, et une équipe lit ça plus vite qu'une phrase.
23

Send a video

message.sendVideo

Ce que tu vois dans n8n

Notes & cas d'usage

Charge une vidéo dans la conversation, avec les champs qui décrivent le clip.

Paramètres clés

  • Chat ID : la conversation où la vidéo est publiée.
  • Binary File et Input Binary Field : l'interrupteur et la propriété binaire qui porte la vidéo.
  • Video : un file_id ou une URL HTTP quand la voie binaire est coupée.
  • Width, Height et Duration : des Additional Fields qui décrivent le clip.
  • Thumbnail : une image JPEG de moins de 200 ko, dont la largeur et la hauteur ne dépassent pas 320.
Cas d'usage
une démonstration enregistrée jointe au ticket qui l'a demandée.
24

Unpin a chat message

message.unpinChatMessage

Ce que tu vois dans n8n

Notes & cas d'usage

Retire l'épingle d'un message quand il n'a plus de raison de rester en haut.

Paramètres clés

  • Chat ID : la conversation qui contient le message épinglé.
  • Message ID : l'identifiant unique du message à désépingler.
Cas d'usage
la branche de clôture d'un workflow d'incident désépingle le résumé qu'elle avait épinglé au début, et la conversation revient à la normale sans geste manuel.
Besoin d'aide

Besoin d'aide pour automatiser Telegram avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

Telegram et n8n, les questions qui suivent

01L'intégration Telegram n8n est-elle gratuite ?
Oui côté n8n. Le nœud Telegram et le Telegram Trigger sont livrés avec n8n : rien à installer, rien de plus à payer, aussi bien sur n8n Cloud que sur une instance auto-hébergée en Community Edition sous licence Sustainable Use. Un workflow se comporte de la même façon dans les deux cas, donc un bot monté sur un poste part sur un serveur sans retouche. La création du bot se fait dans Telegram avec BotFather, et le credential obtenu se réutilise dans tous les workflows qui en ont besoin.
02Quels identifiants faut-il pour connecter Telegram à n8n ?
Une seule méthode : un API bot access token. Ouvre une discussion avec BotFather, envoie la commande /newbot, réponds aux questions de nom et de username, puis copie le token généré dans le champ Access Token d'un credential Telegram. Un compte Telegram est le seul prérequis. Le même credential alimente le nœud Telegram et le Telegram Trigger. Publier dans un canal demande une étape de plus hors de n8n : ajouter le bot à ce canal comme administrateur, sinon la première exécution échoue avec une erreur qui dit que le bot n'est pas participant du canal.
03Quelles sont les limites du nœud Telegram ?
Le nœud couvre 24 opérations réparties sur 4 ressources, et tout ce que la Bot API propose au-delà passe par le nœud HTTP Request avec le même credential. Trois plafonds se rencontrent vite. Le texte d'un message s'arrête à 4096 caractères après analyse des entités. Une description de chat tient dans 0 à 255 caractères, une légende dans 0 à 1024. La Bot API accepte par ailleurs 30 messages par seconde : une diffusion sur une longue liste réclame un nœud Loop Over Items qui passe au plus 30 Chat ID à la fois, et un nœud Code qui attend avant le lot suivant.
04Le Telegram Trigger réagit-il en temps réel ?
Oui. Le trigger fonctionne par webhook : n8n enregistre son URL auprès de Telegram à l'activation du workflow, Telegram appelle cette URL, et chaque mise à jour arrive en quelques secondes, sans interrogation à intervalle régulier. Deux choses coincent. Derrière un reverse proxy, Telegram exige une adresse HTTPS, donc la variable d'environnement WEBHOOK_URL doit porter l'URL publique en HTTPS de l'instance, et le bouton Execute step réclame le proxy des websockets sous peine de voir le canevas rester bloqué en attente. Telegram ne garde par ailleurs qu'un seul webhook par bot : un workflow en test prive la version publiée de ses événements. Deux bots distincts, un pour le test et un pour la production, règlent le conflit.
05n8n ou Make pour Telegram ?
Ça dépend de ce qui pèse le plus. n8n tourne sur ton propre serveur via Docker ou npm, ou sur n8n Cloud, et le workflow est identique dans les deux cas : les conversations restent sur une infrastructure que tu maîtrises. Make est hébergé uniquement, sans option d'auto-hébergement, et se facture à l'opération, ce qui change le calcul pour un bot bavard, où chaque message envoyé, chaque callback traité et chaque fichier récupéré compte. La logique visuelle diffère également. Les deux couvrent les actions Telegram courantes : le test honnête consiste à refaire ton workflow le plus actif dans chacun et à comparer.
Même plateforme

Autres docs utiles sur ce stack.

Voir toutes les intégrations