Nachrichten und Schaltflächen

Die Aktion „Nachricht senden" setzt die Bot-Antwort aus Blöcken zusammen und versieht sie mit Inline-Schaltflächen, dem Hauptmenü und Dialogschritten. Dies ist die umfangreichste Aktion des Builders — hier werden auch Ersetzungen und Referenzparameter der Schaltflächen eingebunden.

Nachrichtenblöcke

Eine Nachricht ist eine Abfolge von Blöcken (Schaltfläche Block hinzufügen):

  • Text — formatierter Text (bis zu 4096 Zeichen) mit Ersetzungen und Schaltflächen.
  • Foto — Bild mit Bildunterschrift.
  • Datei — Dokument mit Bildunterschrift.
  • Verzögerung — Pause in Sekunden vor dem nächsten Block.
  • KI — Antwort, die ein Modell anhand eines Prompts generiert.
  • Reaktion — Aufruf einer anderen Reaktion (optional mit Warten auf deren Verarbeitung).

Blöcke können per Drag & Drop verschoben werden. Anzeigemodus der Blöcke — „In Reihenfolge" oder „Zufällig" (für variierende Antworten). Das Hauptmenü des Bots kann unverändert bleiben, neu festgelegt oder ausgeblendet werden.

Block-Optionen

Text- und Medienblöcke haben Flags: anheften, ohne Ton, Weiterleitung schützen, Spoiler, ohne Link-Vorschau, automatisch löschen nach N Sekunden.

Inline-Schaltflächen

Im Block werden Schaltflächen konfiguriert (Schaltflächentext + Typ):

  • Text (Callback) — Schaltfläche mit Verarbeitung des Drucks auf Bot-Seite.
  • Link — öffnet eine URL.
  • Web-App — öffnet eine Telegram Mini App. Siehe Mini App.
  • Reaktion aufrufen — Druck startet eine andere Reaktion.
  • Zahlung empfangen und Benachrichtigung — als „demnächst" gekennzeichnet.

Stil der Schaltfläche — normal, blau (Primary), grün (Success) oder rot (Danger). Das Flag „Einmalig" verbraucht die Schaltfläche nach dem ersten Druck.

Verhalten beim Drücken

Für Callback-Schaltflächen wird konfiguriert, was beim Drücken passiert: Schaltflächentext ersetzen, Nachricht ersetzen (durch Text oder den Inhalt einer verknüpften Reaktion), Nachricht löschen, answerCallbackQuery überspringen. Das Drücken kann auch Labels setzen und Parameter festlegen.

Parameter in der Schaltfläche (Carry)

Der Block „Carry — Datensnapshot beim Schaltflächendruck" hängt an die Schaltfläche einen Satz von Werten an, die zum Sendezeitpunkt fixiert wurden. Beim Drücken gelangen diese Werte in den Kontext — so trägt jede Schaltfläche ihre eigenen Parameter (per-invocation), auch wenn es viele Schaltflächen gibt. Die Lebensdauer des Payloads in Sekunden wird festgelegt. Dies ist die Grundlage für Szenarien „Produkt auswählen → genau dieses bestellen".

Dynamische Schaltflächen

Der Block „Dynamische Schaltflächen aus Liste" entfaltet ein Array aus ctx in Schaltflächen — eine pro Element. Konfigurierbar sind: Schlüssel der Liste in ctx, Alias des Elements, Anzahl der Schaltflächen pro Reihe und Schaltflächenvorlage (unterstützt {{alias.feld}}). So werden Kataloge, Datensatzlisten und Menüs aus Sammlungsdaten erstellt. Details — Dynamische Schaltflächen und Parameter.

Erwartete Antwort (Dialogschritte)

Ein Textblock kann auf eine Antwort des Nutzers warten — das macht die Nachricht zu einem Dialogschritt und hält das Szenario bis zur Antwort an. Mehrere aufeinanderfolgende Schritte bilden einen Fragebogen oder Assistenten direkt im Chat.

Typ des erwarteten Inhalts

Der Bot kann auf eine bestimmte Art von Antwort warten: Text, Auswahl aus Varianten (Varianten-Schaltflächen), Foto, Video, Video-Notiz, Audio, Dokument, Sprachnachricht, Standort, Kontakt, Kalender oder Würfel. Schickt der Nutzer den falschen Typ, gilt die Antwort als unpassend.

Textvalidierung

Für Textantworten kann eine Formatprüfung aktiviert werden: Telefon, E-Mail, Link, Datum, Uhrzeit oder Formelübereinstimmung (regulärer Ausdruck). Eine Antwort, die die Prüfung nicht besteht, wird abgelehnt, und der Bot zeigt eine Fehlermeldung an.

Antwort speichern

Die Antwort des Nutzers kann in einem Parameter gespeichert werden — danach ist sie in Ersetzungen als {{param.schlüssel}} und in Bedingungen verfügbar. So befüllen Dialogschritte ein Mini-Profil des Kunden.

Fehler, Erinnerung und Timeout

  • Nachricht bei Validierungsfehler — was angezeigt werden soll, wenn die Antwort die Validierung nicht besteht.
  • Erinnerung — was gesendet werden soll, wenn der Nutzer schweigt.
  • Warten nach Timeout aufheben — nach wie vielen Sekunden das Warten eingestellt wird; bei Timeout kann eine Reaktion gestartet werden (z. B. den Fragebogen sanft abschließen). Diese Reaktion ist in den Verknüpfungen als „Warte-Timeout" sichtbar, und die Reaktion auf die eigentliche Antwort — als „Erwartete Antwort".

Ersetzungen

Die Schaltfläche „Ersetzungen" fügt Variablen ein: Absenderdaten ({{first_name}}, {{username}}, {{user_id}}), Ereignisse ({{text}}, {{chat_id}}, {{datetime}}) und Parameter ({{param.schlüssel}}). Vollständige Liste und Formeln — Ersetzungen und Formeln.

Weiter