GetMyBot-Wissensdatenbank

Reaktionen: Grundlagen

Wie Ihr Bot auf Befehle, Schaltflächen und andere Ereignisse reagiert. Reaktionen erstellen, ihre Reihenfolge festlegen und zwischen ihnen wechseln.

Auf dieser Seite

Eine Reaktion legt eine Verhaltensregel für den Bot fest. Zum Beispiel: „Wenn jemand /price schreibt, sende die Preisliste.“ Oder: „Wenn eine Bestellung bezahlt wird, füge das Label ‚Bezahlt‘ hinzu und gewähre Zugang.“

Legen Sie unter Reaktionen das Ereignis, zusätzliche Bedingungen und Aktionen fest. Der Bot prüft die Regeln von oben nach unten und führt die erste passende aus. Deshalb stehen spezielle Regeln meist über einer allgemeinen Antwort auf jede Nachricht.

Bestandteile einer Reaktion

Für die Preisliste reicht der Befehl /price und eine Nachricht mit Preisen. Weitere Einstellungen benötigen Sie nur, wenn die Regel auf bestimmte Personen oder Chats beschränkt sein soll. Der Editor hat vier Bereiche:

BereichWofür ist er da?Beispiel
TriggerWann starten: bei Text, Befehl, Medien, Tastendruck, Ereignis oder ZeitplanJemand schreibt /price
In ChatsWo die Reaktion gilt: privater Chat, Ansprache in einer Gruppe oder bestimmte Chats; auch der Nutzerstatus zähltNur im privaten Chat
BedingungenWas zusätzlich geprüft wird: Labels, Parameter, Zeit oder NachrichtenanzahlDie Person hat das Label „Bezahlt“
AktionenWas der Bot tut: Nachricht senden, Labels ändern, Daten speichern oder KI aufrufenPreisliste senden

Erstellen und Bearbeiten

Klicken Sie auf Reaktion erstellen oder öffnen Sie eine vorhandene. Oben legen Sie den erforderlichen Namen, die Nummer #N, eine Beschreibung und den Schalter Aktiv fest. Links wechseln Sie zwischen Trigger / In Chats / Bedingungen / Aktionen, in der Mitte füllen Sie die Felder aus. Rechts sehen Sie eine Telegram-Vorschau der Nachricht mit Blöcken, Schaltflächen und Menü. Klicken Sie auf Speichern.

Bei gespeicherten Reaktionen zeigt der Editor Statistiken: Auslösungen, eine Grafik und die jüngsten Ereignisse.

Änderungsverlauf und Wiederherstellung

Öffnen Sie bei einer gespeicherten Reaktion Change history. Dort sehen Sie die letzten 20 Änderungen mit Uhrzeit, Bearbeiter, Änderungsquelle und den Unterschieden zwischen „Vorher“ und „Nachher“. Sie können den Zustand vor einer ausgewählten Änderung wiederherstellen. Prüfen Sie erst die Unterschiede und bestätigen Sie dann.

Die Wiederherstellung ersetzt ungespeicherte Bearbeitungen und wird selbst im Verlauf erfasst. Sie stellt die Einstellungen wieder her, macht aber bereits gesendete Nachrichten oder Datenänderungen nicht rückgängig. Hat jemand die Reaktion nach dem Öffnen der Vergleichsansicht geändert, laden Sie den Vergleich neu.

Schritt-für-Schritt-Anleitung mit Übung.

Reihenfolge und Priorität

In der manuellen Reihenfolge können Sie Reaktionen per Drag-and-drop verschieben, solange keine Suche, Filter oder Ordnerauswahl aktiv ist. Die Reihenfolge bestimmt die Priorität: Beim ersten Treffer stoppt der Bot die Suche. Soll er weitere passende Reaktionen prüfen, fügen Sie die Aktion Nächste Reaktion (goto_next) hinzu.

Suche, Filter und Gruppierung

Über der Liste können Sie nach Namen und Nummer suchen und diese Filter nutzen:

  • Status: alle, nur aktive oder nur inaktive Reaktionen.
  • Erstellt von / bis: Kalendertage in Ihrer Zeitzone, beide Grenzen eingeschlossen.
  • Reihenfolge: manuell, neueste zuerst oder älteste zuerst.
  • Gruppierung: nach Tagen oder Monaten der Erstellung. Sie funktioniert nur bei einer Sortierung nach Datum. Wenn Sie sie bei manueller Reihenfolge einschalten, wechselt die Liste zu „Neueste zuerst“. Eine bereits gewählte Datumssortierung bleibt erhalten. Die manuelle Reihenfolge schaltet die Gruppierung aus.

Filter gelten für alle Reaktionen, nicht nur für die sichtbare Seite. Sie lassen sich mit Suche und Ordnern kombinieren. Der Zähler zeigt die Anzahl der Treffer. Der Filterzustand steht in der Seitenadresse: Sie können die Seite neu laden, den Link teilen oder mit „Zurück“ zur Ansicht zurückkehren. Filter zurücksetzen löscht Suche, Filter, Sortierung und Gruppierung, behält aber den gewählten Ordner bei.

Filter und Sortierung ändern nur die Listenansicht. Die Reihenfolge, in der der Bot Reaktionen prüft, bleibt gleich.

Ein- und Ausschalten

Mit dem Schalter in der Listenzeile oder Aktiv im Editor können Sie eine Reaktion einschalten oder deaktivieren, ohne sie zu löschen. Deaktivierte Reaktionen werden bei der Suche nach einer passenden Regel übersprungen.

Duplizieren und Löschen

Die Listenzeile hat die Schaltflächen Duplizieren und Löschen. Beim Duplizieren entsteht eine Kopie, die Sie für eine ähnliche Regel anpassen können.

Import und Export

Mit Export im Editor können Sie eine Reaktion als JSON-Datei speichern und mit Reaktion importieren in der Liste wieder laden. So übertragen Sie sie zwischen Bots oder bewahren Versionen außerhalb der Plattform auf.

Eine Reaktion als Rundsendung verschicken

Mit Senden… in der Reaktionszeile (Senden-Symbol) senden Sie diese Reaktion an alle aktiven Abonnenten des Bots. Das eignet sich für Ankündigungen und Benachrichtigungen. Mit Labels können Sie die Zielgruppe eingrenzen. Mehr dazu unter Rundsendungen.

Reaktionen verketten und Dialoge führen

Eine Reaktion zeigt zum Beispiel einen Katalog, ihre Schaltfläche startet eine zweite mit einem Produkt, und diese fragt nach der Lieferadresse. Für den Wechsel zwischen Reaktionen gibt es mehrere Wege:

  • Kettenreaktion (chain): startet während der Ausführung eine andere Reaktion.
  • Nächste Reaktion (goto_next): übergibt an die nächste passende Reaktion in der Liste.
  • Dialogschritte: Ein Nachrichtenblock kann auf eine Antwort warten und deren Format prüfen. Der Ablauf pausiert bis dahin. Siehe Nachrichten und Schaltflächen.
  • Sonst-Zweig: Wenn die Bedingungen nicht erfüllt sind, kann eine andere Reaktion starten. Diese wählen Sie unter „Bedingungen“ aus.
  • Nächsten Schritt wählen (branch_result): behandelt ein leeres, einzelnes, mehrfaches oder unvollständiges Suchergebnis.
  • Schritt nach Wert wählen (branch_value): Bestätigt beispielsweise bei updated einen Antrag und bittet bei conflict darum, den aktuellen Stand erneut zu laden.
  • Aktionsergebnis: Wenn die Aktion solche Übergänge unterstützt, kann sie bei Erfolg, Konflikt, fehlendem Datensatz oder Fehler zu unterschiedlichen Reaktionen wechseln. Siehe Ergebniszweige auswählen.
  • Block aufrufen (call_block): übergibt Eingaben an eine gemeinsame Berechnung und empfängt ihre festgelegten Ausgaben in der aktuellen Reaktion. Siehe Blockbibliothek und Versionen.

Eine Datenkette kann so aussehen: Sammlung durchsuchen → Nächsten Schritt wählen → Schaltflächen → Verknüpfte Datensätze finden. Stammt die Liste von einem externen Dienst, nutzen Sie Liste verarbeiten → Gruppen und Summen. Benennen Sie das Ergebnis jeder Aktion, damit Sie es in der nächsten auswählen können.

Praktische Übungen zu den neuen Aktionen zeigen beide Ketten anhand von Kursen und Anträgen.

Wählen Sie bei der Einrichtung Daten vorheriger Schritte aus, statt Pfade auswendig zu lernen. Prüfen Sie den aktuellen Entwurf vor dem Speichern mit Beispieldaten: Vergleichen Sie Zweige und erwartete Nachrichten. Testen Sie nach dem Speichern den tatsächlichen Weg über den verbundenen Bot und Kanal, wo reale Aktionen ausgeführt werden.

Nächste Schritte