Zur App

DokumentationWorkflowsAuslöser

Telegram · Neues Update Node

Startet den Workflow bei neuen Nachrichten, Kommandos, Channel-Posts oder Button-Klicks deines Telegram-Bots. Der sichere Bot-Webhook wird beim Aktivieren in Production automatisch eingerichtet. Hier findest du Einrichtung, Felder, Ein- und Ausgaben, Testablauf und Fehlerbehebung.

7 Min LesezeitAktualisiert am

Was Telegram · Neues Update macht

Startet den Workflow bei neuen Nachrichten, Kommandos, Channel-Posts oder Button-Klicks deines Telegram-Bots. Der sichere Bot-Webhook wird beim Aktivieren in Production automatisch eingerichtet.

  • Startet einen neuen Workflow-Lauf.
  • 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 · Neues Update“ ü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

Telegram · Neues Update hat eine klar abgegrenzte Aufgabe. Die verfügbaren Einstellungen erscheinen direkt im Node-Panel, sobald du den Node auswählst.

Einstellungen

FeldBedeutungBereich
Telegram-BotWähle den Telegram-Bot für diesen Trigger. Tokens bleiben verschlüsselt in Workflow-Zugängen; mehrere Bots lassen sich getrennt verbinden.Standard
Update-TypenJSON-Liste der Telegram-Updates, die diesen Workflow starten dürfen. Leer lassen oder [] verwenden, um Telegrams Standardauswahl zu nutzen.Erweitert
Nur Bot-KommandoOptional. Startet nur, wenn der Nachrichtentext mit diesem Kommando beginnt. Mit führendem / eintragen.Erweitert
Nur Chat-IDOptional. Beschränkt den Trigger auf einen privaten Chat, eine Gruppe oder einen Channel.Erweitert
Nachrichten anderer Bots ignorierenVerhindert Bot-zu-Bot-Schleifen. Updates ohne Absender bleiben davon unberührt.Erweitert

Eingaben und Ausgaben

EingabeBedeutungTyp
StandardDieser Auslöser benötigt keinen Eingang.JSON
AusgabeBedeutungTyp
Event-TypDer erkannte Telegram-Update-Typ, z. B. message oder callback_query.text
Update-IDFeld aus dem verbundenen Schritt.number
Chat-IDFeld aus dem verbundenen Schritt.text
Nachrichten-IDFeld aus dem verbundenen Schritt.number
Themen-IDFeld aus dem verbundenen Schritt.number
TextFeld aus dem verbundenen Schritt.text
Medien-BeschriftungFeld aus dem verbundenen Schritt.text
AbsenderTelegram-User oder Bot, der das Update ausgelöst hat.json
ChatTelegram-Chat, Gruppe oder Channel des Updates.json
Button-KlickVollständige Callback Query bei Klick auf einen Inline-Button.json
Callback-DatenDer data-Wert des geklickten Inline-Buttons.text
Rohes UpdateDas vollständige Telegram-Update ohne Informationsverlust.json

Beispiel und Testlauf

Beispiel für eine eingehende Telegram-Nachricht: 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

{
  "event_type": "message",
  "update_id": 836521004,
  "chat_id": "-1001234567890",
  "message_id": 42,
  "message_thread_id": null,
  "text": "/status Produktion",
  "caption": null,
  "from": {
    "id": 118922110,
    "is_bot": false,
    "first_name": "Mara",
    "username": "mara_ops"
  },
  "chat": {
    "id": -1001234567890,
    "title": "Operations",
    "type": "supergroup"
  },
  "callback_query": null,
  "data": null,
  "update": {
    "update_id": 836521004
  }
}

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.
  • Workflow startet nicht: Aktiviere den Workflow und prüfe im Auslöser, ob Test- und Produktionsmodus richtig gewählt sind.

Verwandte Artikel