Zur App

DokumentationWorkflowsApps und Services

Telegram · Nachricht senden Node

Sendet Textnachrichten über deinen Telegram-Bot und beantwortet Klicks auf Inline-Buttons, in privaten Chats, Gruppen, Channels und Forum-Themen. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.

9 Min LesezeitAktualisiert am

Was Telegram · Nachricht senden macht

Sendet Textnachrichten über deinen Telegram-Bot und beantwortet Klicks auf Inline-Buttons, in privaten Chats, Gruppen, Channels und Forum-Themen.

  • Verarbeitet einen Eingang.
  • Stellt einen Ausgang für weitere Schritte bereit.
  • Wird als normaler Schritt in den Ablauf eingebunden.

Node einrichten

  1. 01Öffne einen Workflow und füge „Telegram · Nachricht senden“ über Bausteine hinzu.
  2. 02Fülle die erforderlichen Felder aus. Werte aus vorherigen Schritten kannst du als Variable einsetzen.
  3. 03Nutze Testdaten oder starte einen Testlauf und prüfe die Ausgabe des Nodes.
  4. 04Verbinde den erfolgreichen Ausgang mit dem nächsten Schritt und aktiviere den Workflow erst nach einem vollständigen Probelauf.

Aktionen und Betriebsarten

Wähle im Feld „Was soll Telegram tun?“ die gewünschte Funktion. Danach zeigt das Node-Panel nur die dafür relevanten Einstellungen.

  • Nachricht senden
  • Button-Klick beantworten

Einstellungen

FeldBedeutungBereich
Telegram-BotWähle den Telegram-Bot, der diese Nachricht sendet. Der Token bleibt verschlüsselt und wird nie im Workflow gespeichert.Standard
Was soll Telegram tun?Sende eine Nachricht oder bestätige einen Klick auf einen Inline-Button.Standard
Chat-ID oder @ChannelZiel-Chat. Für Channels kannst du @channelname verwenden; private Chats und Gruppen verwenden ihre numerische ID. In einem vom Telegram-Trigger gestarteten Reply wird die eingehende Chat-ID automatisch übernommen, wenn dieses Feld leer auflöst.Standard
NachrichtText der Nachricht. Telegram erlaubt 4096 Zeichen pro Nachricht, längerer Text ohne Formatierung wird automatisch an Absatz- oder Zeilenumbrüchen in mehrere Nachrichten aufgeteilt (max. 64000 Zeichen). Mit HTML/MarkdownV2 prüft Telegram die Länge selbst. Leerzeichen allein werden nicht gesendet; die eingehende Nachricht wird nie automatisch zurückgespiegelt.Standard
FormatierungOptionales Telegram-Format. Bei MarkdownV2 müssen Sonderzeichen nach Telegram-Regeln escaped werden.Standard
Forum-Themen-IDOptional. Sendet die Nachricht in ein bestimmtes Forum-Thema der Supergruppe.Erweitert
Auf Nachrichten-ID antwortenOptionales Komfortfeld. Wird Telegram-konform in reply_parameters.message_id übernommen.Erweitert
Stumm sendenSendet ohne Benachrichtigungston. Die Nachricht bleibt im Chat sichtbar.Erweitert
Weiterleiten und Speichern verhindernSchützt den Nachrichteninhalt vor Weiterleitung und lokalem Speichern, soweit Telegram dies unterstützt.Erweitert
Link-VorschauOptionales Telegram-LinkPreviewOptions-Objekt. Unterstützt JSON-Autocomplete für Werte aus vorherigen Nodes.Erweitert
Antwort-ParameterOptionales ReplyParameters-Objekt. Das Komfortfeld „Auf Nachrichten-ID antworten“ wird damit sicher zusammengeführt.Erweitert
Buttons oder eigene TastaturOptionales InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove oder ForceReply als JSON.Erweitert
Callback-Query-IDPflichtfeld. Nutze callback_query.id aus dem Telegram-Trigger. Telegram zeigt bis zur Bestätigung einen Ladeindikator am Button.Standard
HinweistextOptionaler Hinweis mit 0 bis 200 Zeichen. Ohne Text wird nur der Ladeindikator beendet.Standard
Als Alert anzeigenZeigt den Hinweis als Dialog statt als kurze Benachrichtigung am oberen Bildschirmrand.Erweitert
Callback-URLOptional. Öffnet eine HTTPS-URL im Telegram-Client; Game-URLs funktionieren nur mit callback_game-Buttons.Erweitert
Cache-Dauer (Sekunden)Optional. Wie lange Telegram-Clients das Ergebnis zwischenspeichern dürfen. Standard ist 0.Erweitert
Für jedes Item einzeln ausführenAus (Standard): der Node läuft einmal für den gesamten Input. An: bekommt er mehrere Items (z. B. aus „Liste aufteilen“), läuft er einmal PRO Item, und {{ $json }} ist dabei jeweils genau dieses Item. So arbeitest du eine Dateiliste Eintrag für Eintrag ab.Erweitert
Wenn ein Item fehlschlägt„Überspringen“ schreibt für das fehlgeschlagene Item ein `error`-Feld und verarbeitet die übrigen weiter, statt den ganzen Lauf an einer einzigen unlesbaren Datei scheitern zu lassen.Erweitert
Pause zwischen Items (Millisekunden)Wartezeit vor jedem Durchlauf außer dem ersten. 1000 = 1 Sekunde pro Item. Nützlich, wenn die Gegenstelle sonst dichtmacht. Maximal 300000 (5 Minuten).Erweitert

Eingaben und Ausgaben

EingabeBedeutungTyp
Chat-IDFeld aus dem verbundenen Schritt.text
NachrichtFeld aus dem verbundenen Schritt.text
Themen-IDFeld aus dem verbundenen Schritt.number
Antwort aufFeld aus dem verbundenen Schritt.number
ButtonsFeld aus dem verbundenen Schritt.json
Callback-Query-IDFeld aus dem verbundenen Schritt.text
Callback-HinweisFeld aus dem verbundenen Schritt.text
Als Alert anzeigenFeld aus dem verbundenen Schritt.boolean
Callback-URLFeld aus dem verbundenen Schritt.text
Cache-DauerFeld aus dem verbundenen Schritt.number
AusgabeBedeutungTyp
ErfolgreichFeld aus dem verbundenen Schritt.boolean
Nachrichten-IDFeld aus dem verbundenen Schritt.number
Chat-IDFeld aus dem verbundenen Schritt.text
Gesendet amFeld aus dem verbundenen Schritt.number
Telegram-NachrichtDie vollständige Message-Antwort der Telegram Bot API.json
Callback beantwortetTrue, wenn Telegram die Antwort auf den Button-Klick angenommen hat.boolean
Beantwortete Callback-Query-IDFeld aus dem verbundenen Schritt.text

Dieser Node kann Listen Item für Item verarbeiten. Fehlerbehandlung und Pause zwischen Items findest du in den erweiterten Einstellungen.

Beispiel und Testlauf

Statusmeldung mit Inline-Button senden: Starte den Node zunächst mit einem kleinen, eindeutig erkennbaren Datensatz. Öffne danach die Ausgabe und verwende nur Felder, die dort tatsächlich vorhanden sind.

Beispiel für einen Testlauf

{
  "chat_id": "-1001234567890",
  "text": "<b>Deployment abgeschlossen</b>\nVersion 2.4.0 ist live.",
  "parse_mode": "HTML",
  "reply_markup": {
    "inline_keyboard": [
      [
        {
          "text": "Dashboard öffnen",
          "url": "https://example.com/status"
        }
      ]
    ]
  }
}

Zugriff und Sicherheit

Prüfe vor der Aktivierung, welche Daten in diesen Schritt gelangen und welche Daten seine Ausgabe enthält.

Schlüssel und Zugangsdaten gehören in die geschützte Verbindungsverwaltung. Trage sie nicht als normalen Text in Workflow-Felder, Testdaten oder Beschreibungen ein.

Häufige Fehler beheben

  • Keine Ausgabe: Prüfe den letzten Testlauf und ob der vorherige Node die erwarteten Felder geliefert hat.
  • Variable bleibt leer: Öffne die Ausgabe des vorherigen Schritts und übernimm den Feldnamen aus den echten Testdaten.
  • Liste wird nur einmal verarbeitet: Aktiviere die Ausführung pro Item in den erweiterten Einstellungen.

Verwandte Artikel