Telegram in ein selbst ge­hos­te­tes n8n in­te­grie­ren: So funk­tio­niert’s!

Die In­te­gra­ti­on von Telegram in ein selbst ge­hos­te­tes n8n er­mög­licht es Ihnen, Nach­rich­ten oder Be­nach­rich­ti­gun­gen direkt in Ihre eigenen Au­to­ma­ti­sie­rungs-Workflows ein­zu­bin­den. In dieser Anleitung erfahren Sie Schritt für Schritt, wie Sie Telegram mit n8n verbinden und erste einfache Workflows für ein­ge­hen­de und aus­ge­hen­de Nach­rich­ten aufbauen.

Vorteile der In­te­gra­ti­on von Telegram in n8n

Telegram eignet sich her­vor­ra­gend für die In­te­gra­ti­on in n8n, weil es eine schnelle, zu­ver­läs­si­ge und direkte Kom­mu­ni­ka­ti­ons­schnitt­stel­le bietet. Nach­rich­ten werden in der Regel in Echtzeit zu­ge­stellt, sodass Sie sofort über Er­eig­nis­se in Ihren Workflows in­for­miert sind. Im Vergleich zu E-Mails oder anderen Be­nach­rich­ti­gungs­sys­te­men wie Discord, das sich auch mit n8n verbinden lässt, sind Telegram-Nach­rich­ten deutlich präsenter und werden auf mobilen Geräten oft schneller wahr­ge­nom­men. Dadurch eignet sich Telegram ideal für zeit­kri­ti­sche Alerts, Sta­tus­mel­dun­gen oder Be­stä­ti­gun­gen.

Ein weiterer Vorteil ist die einfache Struktur der Kom­mu­ni­ka­ti­on. Nach­rich­ten, Dateien, Bilder oder Links lassen sich un­kom­pli­ziert über­tra­gen und in Workflows wei­ter­ver­ar­bei­ten. Sie können bei­spiels­wei­se Inhalte aus APIs, Da­ten­ban­ken oder anderen Tools wie Jira mit n8n au­to­ma­tisch in Telegram ausgeben, ohne zu­sätz­li­che Schnitt­stel­len ent­wi­ckeln zu müssen. Gleich­zei­tig können ein­ge­hen­de Nach­rich­ten als Auslöser für weitere Au­to­ma­ti­sie­run­gen dienen, wodurch sich in­ter­ak­ti­ve Abläufe umsetzen lassen.

Für selbst gehostete n8n-Instanzen ist Telegram praktisch, da Sie keine zu­sätz­li­che In­fra­struk­tur für Be­nach­rich­ti­gun­gen benötigen. Sie können Ihre be­stehen­den Workflows direkt mit einem Messenger verbinden, den Sie ohnehin täglich nutzen. Auch die Team-Kom­mu­ni­ka­ti­on lässt sich einfach abbilden, indem Nach­rich­ten an Gruppen oder Kanäle gesendet werden. So behalten mehrere Personen gleich­zei­tig den Überblick über wichtige Er­eig­nis­se.

Schritt 1: Vor­aus­set­zun­gen erfüllen

Bevor Sie mit der ei­gent­li­chen Ein­rich­tung beginnen, sollten Sie kurz prüfen, ob alle Grund­la­gen vorhanden sind. Das spart später viel Zeit, weil die häu­figs­ten Fehler bei Telegram-Triggern nicht am Workflow selbst, sondern an fehlenden Vor­aus­set­zun­gen wie einer nicht öf­fent­lich er­reich­ba­ren n8n-URL oder einem noch nicht an­ge­leg­ten Bot liegen. Folgende Vor­aus­set­zun­gen sollten erfüllt sein:

• Eine selbst gehostete n8n-Instanz: Ihre n8n-Umgebung muss bereits laufen und über den Browser er­reich­bar sein.
• Eine öf­fent­li­che URL für n8n: Für ein­ge­hen­de Telegram-Events benötigt n8n bei Triggern eine von außen er­reich­ba­re HTTPS-Adresse.
• Ein Telegram-Zugang mit vor­han­de­nen Zu­gangs­da­ten: Sie benötigen gültige Zu­gangs­da­ten, die Sie in n8n hin­ter­le­gen können, und ein per BotFather erzeugtes Access-Token.
• Zugriff auf Ihre n8n-Kon­fi­gu­ra­ti­on: Falls Ihre Instanz hinter einem Reverse Proxy läuft, sollten Sie Um­ge­bungs­va­ria­blen wie WEBHOOK_URL, N8N_HOST und N8N_PROTOCOL anpassen können.
• Optional ein Chat oder eine Gruppe zum Testen: So können Sie die In­te­gra­ti­on direkt aus­pro­bie­ren, ohne pro­duk­ti­ve Abläufe zu be­ein­flus­sen.

Schritt 2: Telegram-Zu­gangs­da­ten vor­be­rei­ten

Für die In­te­gra­ti­on von Telegram in n8n benötigen Sie gültige Zu­gangs­da­ten, mit denen sich n8n gegenüber Telegram au­then­ti­fi­zie­ren kann. Diese Zu­gangs­da­ten er­mög­li­chen es n8n, Nach­rich­ten zu senden und, bei Ver­wen­dung eines Triggers, auch ein­ge­hen­de Nach­rich­ten zu empfangen.

Wenn Sie bereits einen Telegram-Account besitzen, haben Sie die wich­tigs­te Grundlage bereits ge­schaf­fen. Telegram selbst stellt jedoch keine direkte Ver­bin­dung zu n8n her, sondern arbeitet über eine tech­ni­sche Schnitt­stel­le (Bot API), für die ein so­ge­nann­tes Zu­griffsto­ken benötigt wird. Dieses Token fungiert als ein­deu­ti­ger Schlüssel, über den n8n mit Telegram kom­mu­ni­zie­ren kann. In vielen Fällen liegt ein solcher Zugriff bereits vor, bei­spiels­wei­se wenn Telegram schon in anderen Tools oder Au­to­ma­ti­sie­run­gen verwendet wird. Dann können Sie das vor­han­de­ne Token einfach über­neh­men und direkt in n8n hin­ter­le­gen.

Falls noch kein Zu­griffsto­ken existiert, muss dieses zunächst im Rahmen eines n8n-Telegram-Bots erstellt werden. Dieser Schritt ist jedoch schnell erledigt. Behandeln Sie das Zu­griffsto­ken wie ein Passwort. Jede Person, die Zugriff darauf hat, kann im Namen Ihrer In­te­gra­ti­on Nach­rich­ten senden oder ver­ar­bei­ten. Speichern Sie es daher sicher und geben Sie es nicht öf­fent­lich weiter.

Schritt 3: n8n für Webhooks korrekt er­reich­bar machen

Wenn Sie Telegram in n8n aus­schließ­lich zum Senden von Nach­rich­ten nutzen, reicht es aus, die Zu­gangs­da­ten in n8n zu hin­ter­le­gen. In diesem Fall baut das Au­to­ma­ti­sie­rungs­tool selbst aktiv die Ver­bin­dung zu Telegram auf, sodass keine zu­sätz­li­che Kon­fi­gu­ra­ti­on notwendig ist.

Sobald Sie jedoch ein­ge­hen­de Nach­rich­ten ver­ar­bei­ten möchten, also Telegram als Trigger verwenden, muss Ihre n8n-Instanz von außen er­reich­bar sein. Der Grund dafür ist, dass Telegram neue Nach­rich­ten aktiv an n8n sendet. Dafür nutzt n8n so­ge­nann­te Webhooks, also öf­fent­li­che URLs, die von externen Diensten auf­ge­ru­fen werden können. n8n erstellt diese Webhook-URLs au­to­ma­tisch auf Basis Ihrer Kon­fi­gu­ra­ti­on. Wenn Ihre Instanz jedoch hinter einem Reverse Proxy läuft, kennt n8n ohne zu­sätz­li­che Ein­stel­lun­gen oft nur interne Adressen. Das führt dazu, dass Webhooks zwar erstellt werden, aber von außen nicht funk­tio­nie­ren.

Ein einfaches Beispiel für Docker Compose zeigt, wie Sie Ihre n8n-Instanz so kon­fi­gu­rie­ren, dass korrekte öf­fent­li­che Webhook-URLs erzeugt werden und externe Dienste wie Telegram diese zu­ver­läs­sig erreichen können:

services:
    n8n:
        image: n8nio/n8n:latest
        ports:
            - "5678:5678"
        environment:
            - N8N_HOST=n8n.example.com
            - N8N_PROTOCOL=https
            - WEBHOOK_URL=https://n8n.example.com/
            - N8N_PROXY_HOPS=1
        volumes:
            - ./n8n_data:/home/node/.n8n

Schritt 4: Telegram-Zu­gangs­da­ten in n8n hin­ter­le­gen

Im nächsten Schritt verbinden Sie Telegram mit Ihrer n8n-Instanz. Dafür müssen Sie die zuvor vor­be­rei­te­ten Zu­gangs­da­ten einmalig in n8n hin­ter­le­gen. n8n speichert diese als so­ge­nann­te Cre­den­ti­als, sodass Sie sie an­schlie­ßend in be­lie­bi­gen Workflows wie­der­ver­wen­den können, ohne das Token jedes Mal erneut eingeben zu müssen.

Gehen Sie dazu Schritt für Schritt vor:

1. Öffnen Sie Ihre n8n-Ober­flä­che im Browser.
2. Erstellen Sie einen neuen Workflow, um die In­te­gra­ti­on ein­zu­rich­ten oder zu testen.
3. Fügen Sie einen Telegram-Node hinzu.
4. Klicken Sie im Bereich „Cre­den­ti­als“ auf „Create new cre­den­ti­al“.
5. Tragen Sie Ihr vor­han­de­nes Zu­griffsto­ken in das Feld „Access Token“ ein.

Speichern Sie die Eingabe. Nach dem Speichern steht Ihnen die Ver­bin­dung zu Telegram sofort zur Verfügung. Sie können die an­ge­leg­ten Cre­den­ti­als nun in jedem weiteren Workflow auswählen und verwenden. Dieser Schritt muss nur einmal durch­ge­führt werden. Danach können Sie Telegram beliebig oft in neuen oder be­stehen­den Workflows einsetzen.

Close

An­schlie­ßend wird die Ver­bin­dung direkt getestet. Der Erfolg wird dann bei n8n angezeigt:

Close

Schritt 5: Erste Telegram-Nachricht aus n8n senden

Zum Testen der In­te­gra­ti­on empfiehlt es sich, zunächst einen sehr einfachen Workflow zu erstellen, der eine Nachricht an Telegram sendet. Auf diese Weise können Sie schnell über­prü­fen, ob die Ver­bin­dung zwischen n8n und Telegram korrekt funk­tio­niert, ohne direkt mit kom­ple­xe­ren Triggern oder Logiken zu arbeiten.

Der grund­le­gen­de Aufbau des Workflows sieht dabei so aus:

Manual Trigger -> Telegram

Das bedeutet, dass der Workflow manuell gestartet wird und an­schlie­ßend eine Nachricht über den Telegram-Node versendet. Fügen Sie hierzu zunächst einen Manual Trigger-Node hinzu. Dieser dient dazu, den Workflow per Klick aus­zu­füh­ren. An­schlie­ßend fügen Sie einen Telegram-Node hinzu und verbinden beide Nodes mit­ein­an­der, indem Sie eine Ver­bin­dungs­li­nie zwischen ihnen ziehen.

Im Telegram-Node wählen Sie nun die zuvor an­ge­leg­ten Telegram-Cre­den­ti­als aus, damit n8n weiß, über welche Zu­gangs­da­ten die Nachricht gesendet werden soll. Danach kon­fi­gu­rie­ren Sie den Node, indem Sie als Resource die Option „Message“ und als Operation die Option „Send Message“ auswählen. Geben Sie außerdem die Ziel­adres­se an. Dafür tragen Sie entweder eine Chat-ID oder einen Ka­nal­na­men (zum Beispiel „@chan­nel­na­me“) ein. Diese Angabe bestimmt, wohin die Nachricht gesendet wird. Als Test können Sie einen be­lie­bi­gen Nach­rich­ten­text verwenden, wir nutzen als Beispiel: Hello World! From n8n.

Close

Ob der Versand im fertigen Workflow funk­tio­niert, können Sie testen, indem Sie den Schritt durch einen Klick auf „Execute Step“ ausführen:

Close

Starten Sie den Workflow an­schlie­ßend manuell. Wenn alles korrekt ein­ge­rich­tet ist, wird die Nachricht sofort in Telegram angezeigt.

Close

Schritt 6: Ein­ge­hen­de Telegram-Nach­rich­ten ver­ar­bei­ten

Wenn Sie Telegram nicht nur zum Senden, sondern auch als Ein­gangs­ka­nal nutzen möchten, verwenden Sie den Telegram Trigger. Dieser Node startet Ihren Workflow au­to­ma­tisch, sobald eine neue Nachricht in Telegram eingeht. So können Sie ein­ge­hen­de Nach­rich­ten direkt ver­ar­bei­ten und darauf reagieren.

Ein einfacher Aufbau sieht fol­gen­der­ma­ßen aus: Telegram Trigger -> Telegram

In unserem Beispiel wird eine emp­fan­ge­ne Nachricht direkt be­ant­wor­tet. Fügen Sie hierzu zunächst einen Telegram Trigger-Node in Ihren Workflow ein. Wählen Sie an­schlie­ßend die zuvor an­ge­leg­ten Cre­den­ti­als aus, damit n8n auf Telegram zugreifen kann. Danach de­fi­nie­ren Sie das ge­wünsch­te Ereignis, zum Beispiel das Empfangen neuer Nach­rich­ten.

Im nächsten Schritt fügen Sie einen Telegram-Node hinzu und verbinden ihn mit dem Trigger. In diesem Node wählen Sie wieder eine passende Sende-Operation aus, bei­spiels­wei­se „Send Message“, um eine Antwort zu ver­schi­cken.

Damit die Antwort im richtigen Chat ankommt, können Sie die Chat-ID direkt aus den Daten des Triggers über­neh­men. Das bedeutet, dass der Workflow au­to­ma­tisch an genau den Chat zu­rück­schreibt, aus dem die ur­sprüng­li­che Nachricht kam. Sie müssen die Chat-ID also nicht manuell eintragen.

Nach einem Testlauf zeigt Ihnen n8n im Output-Bereich des Telegram Trigger-Nodes alle emp­fan­ge­nen Daten an. Dort sehen Sie genau, welche In­for­ma­tio­nen verfügbar sind, zum Beispiel den Nach­rich­ten­text, die Chat-ID oder weitere Metadaten.

Schritt 7: Workflow produktiv nutzen

Sobald Ihr Workflow funk­tio­niert, können Sie ihn ak­ti­vie­ren. Damit ver­ar­bei­tet n8n ein­ge­hen­de Nach­rich­ten dauerhaft und sendet au­to­ma­tisch Antworten oder Be­nach­rich­ti­gun­gen. Da n8n Ihren Workflow bisher nur au­to­ma­tisch als Entwurf ge­spei­chert hat, müssen Sie ihn erst ver­öf­fent­li­chen. Klicken Sie hierzu auf die Schalt­flä­che „Publish“ (in älteren Versionen nutzen Sie hierfür statt­des­sen den Ak­ti­vie­rungs-Toggle).

Auf diese Weise wird Telegram zu einem festen Be­stand­teil Ihrer Au­to­ma­ti­sie­rung und fungiert als Kom­mu­ni­ka­ti­ons­schnitt­stel­le innerhalb Ihrer gesamten n8n-Workflows.

Drei prak­ti­sche Ideen für Telegram-Workflows mit n8n

Telegram eignet sich her­vor­ra­gend als Schnitt­stel­le für Be­nach­rich­ti­gun­gen und In­ter­ak­tio­nen innerhalb von n8n. Besonders sinnvoll ist der Einsatz überall dort, wo In­for­ma­tio­nen schnell verfügbar sein sollen oder direkt auf Er­eig­nis­se reagiert werden muss.

Beispiel 1: Server- oder Website-Ausfälle melden

Sie können mit n8n re­gel­mä­ßig eine Website oder einen Server prüfen und sich bei Problemen au­to­ma­tisch über Telegram be­nach­rich­ti­gen lassen. Dazu wird ein Workflow ein­ge­rich­tet, der in festen Zeit­ab­stän­den aus­ge­führt wird, bei­spiels­wei­se alle fünf Minuten. Ein HTTP-Request-Node ruft dabei die ge­wünsch­te Website auf und prüft, ob sie er­reich­bar ist. An­schlie­ßend wird mit einem IF-Node aus­ge­wer­tet, ob der Sta­tus­code auf ein Problem hindeutet, etwa bei einem Fehler oder Timeout. Im Feh­ler­fall sendet n8n au­to­ma­tisch eine Nachricht an Telegram, sodass Sie sofort in­for­miert sind. Auf diese Weise erkennen Sie Ausfälle früh­zei­tig, ohne die Systeme manuell über­wa­chen zu müssen.

Close

Beispiel 2: Telegram als Ein­ga­be­ka­nal für Abfragen nutzen

Telegram kann auch als einfache und direkte Ein­ga­be­schnitt­stel­le für Ihre Workflows dienen. In diesem Szenario startet eine ein­ge­hen­de Nachricht au­to­ma­tisch einen Workflow in n8n. Der Inhalt der Nachricht wird an­schlie­ßend aus­ge­wer­tet, bei­spiels­wei­se mit einem IF- oder Switch-Node. Abhängig vom Inhalt können dann un­ter­schied­li­che Aktionen aus­ge­führt werden, etwa das Abrufen von Daten aus einer API oder einer Datenbank. Die Er­geb­nis­se werden an­schlie­ßend wieder als Nachricht an Telegram zu­rück­ge­sen­det. So entsteht ein einfacher, in­ter­ak­ti­ver Ablauf, bei dem Sie In­for­ma­tio­nen direkt per Chat abfragen können. So können Sie schnell auf Daten zugreifen, ohne sich in andere Systeme einloggen zu müssen.

Close

Beispiel 3: Neue Anfragen oder Er­eig­nis­se au­to­ma­tisch wei­ter­lei­ten

Ein weiterer häufiger An­wen­dungs­fall ist die au­to­ma­ti­sche Wei­ter­lei­tung von Er­eig­nis­sen aus anderen Systemen an Telegram. Sobald bei­spiels­wei­se eine neue Anfrage über ein Formular eingeht oder eine Be­stel­lung im Shop erstellt wird, kann n8n diese In­for­ma­ti­on ver­ar­bei­ten. Der Workflow wird dabei entweder über einen Webhook oder einen spe­zi­fi­schen App-Trigger gestartet. An­schlie­ßend werden die re­le­van­ten Daten auf­be­rei­tet und in eine ver­ständ­li­che Nachricht um­ge­wan­delt. Diese Nachricht wird dann au­to­ma­tisch an einen Telegram-Chat oder eine Gruppe gesendet. Auf diese Weise bleiben Sie oder Ihr Team jederzeit auf dem aktuellen Stand, ohne ständig ver­schie­de­ne Systeme prüfen zu müssen. Vor allem in kleinen Teams sorgt das für schnelle Re­ak­ti­ons­zei­ten und eine bessere Übersicht.

Close