GetMyBot-Wissensdatenbank

Nachrichten und Schaltflächen

Bot-Antworten aus Text, Fotos und Schaltflächen aufbauen und Fragen stellen, deren Antworten gespeichert werden.

Auf dieser Seite

Soll der Bot Text, ein Foto und eine Schaltfläche „Auswählen“ senden, fügen Sie die Aktion Nachricht senden hinzu. Eine Antwort besteht aus einzelnen Blöcken, zum Beispiel zuerst einem Produktfoto und danach einer Beschreibung mit Schaltflächen. Schaltflächen unter einer Nachricht heißen auch Inline-Schaltflächen.

In derselben Aktion können Sie eine Frage stellen und auf eine Antwort warten, etwa nach einer Telefonnummer fragen und sie im Kundenprofil speichern. Im Folgenden sehen Sie Blöcke, Schaltflächen und Dialogfragen.

Nachrichtenblöcke

Klicken Sie auf Block hinzufügen und wählen Sie den Inhalt. Blöcke lassen sich kombinieren, etwa ein Begrüßungstext, ein Foto und eine Datei mit dem Kursprogramm.

  • Text: formatierter Text bis 4096 Zeichen, mit Ersetzungen und Schaltflächen.
  • Foto: Bild mit Bildunterschrift.
  • Datei: Dokument mit Beschriftung.
  • Voice (Sprachnachricht): OGG/OPUS, MP3 oder M4A bis 50 MB; Telegram zeigt sie mit sendVoice als Sprachnachricht an.
  • GIF: Animation oder MP4 ohne Ton bis 50 MB (sendAnimation).
  • Video note (Videonotiz): quadratisches MP4 bis 60 Sekunden (sendVideoNote), ohne Beschriftung. Bei jedem Versand wird die Datei aus der Medienbibliothek neu hochgeladen: Telegram akzeptiert bei sendVoice, sendAnimation und sendVideoNote keine auf andere Weise erhaltene file_id.
  • Carousel (Karussell): 2 bis 10 Karten mit Foto, Beschriftung und eigenen Schaltflächen. In Telegram lassen sie sich mit „‹ ›“ innerhalb einer Nachricht über editMessageMedia durchblättern, wenn für jedes Foto eine nutzbare file_id vorliegt, direkt auf der Karte oder aus der Medienbibliothek aufgelöst. Fehlt sie auch nur bei einem Foto, werden alle Karten als einzelne Fotonachrichten gesendet. In anderen Kanälen wie VK werden sie ebenfalls einzeln gesendet. Beschriftung und Schaltflächen jeder Karte bleiben erhalten.
  • Verzögerung: Pause in Sekunden vor dem nächsten Block.
  • KI: eine durch ein Modell anhand eines Prompts erzeugte Antwort.
  • Reaktion: startet eine andere Reaktion, optional mit Warten auf ihr Ergebnis.

Sprachnachrichten, GIFs, Videonotizen und Karussells können wie andere Blöcke in Reaktionen und in der schnellen Rundsendung einer Reaktion verwendet werden; siehe Rundsendungen.

Sie können Blöcke verschieben. Die Anzeigereihenfolge ist Der Reihe nach oder Zufällig für wechselnde Antworten. Das Hauptmenü des Bots lässt sich unverändert lassen, neu festlegen oder ausblenden.

Blockoptionen

Text- und Medienblöcke können folgende Optionen haben: anheften, stumm senden, Weiterleiten verhindern, Spoiler, keine Linkvorschau, nach N Sekunden automatisch löschen.

Inline-Schaltflächen

Für einen Block stellen Sie Schaltflächen mit Schaltflächentext und Typ ein:

  • Text: sendet die Beschriftung als Nutzerantwort. In Telegram und VK erscheint sie auf einer Antworttastatur und kann eine Dialogfrage beantworten oder eine Textreaktion starten. WhatsApp, Instagram, Messenger und das Web-Widget verwenden eine Antwortschaltfläche ohne dauerhafte Tastatur.
  • Link: öffnet eine URL.
  • Web-App: öffnet eine Telegram Mini App. Siehe Mini App.
  • Reaktion: startet beim Drücken eine andere Reaktion.
  • Inline query: fügt „@bot Anfrage“ in das Eingabefeld des aktuellen Chats ein oder bietet die Auswahl eines anderen Chats an (switch_inline_query/switch_inline_query_current_chat). Nur in Telegram und erst, nachdem Sie bei @BotFather mit /setinline den Inline-Modus aktiviert haben. GetMyBot beantwortet solche Anfragen nicht (answerInlineQuery ist nicht implementiert): Die Schaltfläche bereitet den Anfragetext vor, führt aber keine Suche aus.
  • Prefilled text: Link https://t.me/<bot>?text=…, der den Bot-Chat öffnet und Text in das Eingabefeld legt, ohne ihn abzusenden (prefill).
  • Payment link: öffnet eine erforderliche Zahlungs-URL. Die Zahlung erstellen Sie zuvor mit der Aktion „Zahlung erstellen“. Der Link führt auf eine externe Zahlungsseite und ist keine native Telegram-Rechnung.
  • Benachrichtigung: zeigt beim Drücken Text, startet keine Reaktion und übergibt keine gespeicherten Schaltflächendaten (Carry). In Telegram ist es ein kurzer Hinweis oder ein Fenster mit bis zu 200 Zeichen, in VK ein kurzer Hinweis mit bis zu 90 Zeichen ohne Fenster.

Textantwort oder vorbereiteter Text?

AufgabeTyp und EinstellungWas passiert beim Drücken?
In einem Formular „Ja“ wählenText, Beschriftung „Ja“; die Nachricht wartet auf eine Antwort„Ja“ wird als Antwort an den Dialogschritt übergeben
Eine Anfrage vorbereitenVorbereiteter Text, Beschriftung „Schreiben“, Entwurf „Ich möchte bestellen“Der Entwurf erscheint im Eingabefeld des Bot-Chats; die Person kann ihn bearbeiten und selbst senden

Die Beschriftung der Schaltfläche und der vorbereitete Text sind getrennte Felder. Der Entwurf sendet keine Nachricht und startet selbst keine Reaktion.

Bei einer Schaltfläche vom Typ Reaktion wird der Tastendruck als eigenes Ereignis an den Bot gesendet. Technisch heißt es Callback. Inline-Anfrage und Vorbereiteter Text lösen dagegen eine Funktion der Telegram-App aus. Deshalb unterstützen sie weder answerCallbackQuery noch Carry-Daten.

Symbol und Farbe der Schaltfläche

Vor dem Text kann ein Premium-Emoji erscheinen. Tragen Sie dafür seine ID (icon_custom_emoji_id) als positive 64-Bit-Ganzzahl ein. 007 wird beispielsweise als 7 gelesen. Buchstaben, null, negative und zu große Zahlen werden verworfen; die Schaltfläche bleibt ohne Symbol gespeichert.

Telegram zeigt das Symbol nur bei Bots mit den erforderlichen Rechten: einem zusätzlichen Nutzernamen über Fragment oder Telegram Premium des Besitzers beim direkten Versand in einen privaten Chat oder eine Gruppe. Ohne diese Voraussetzung ignoriert Telegram das Symbol und ersetzt es nicht durch ein gewöhnliches Emoji.

Der Stil (style) bestimmt die Farbe: „Standard“ ohne Farbe, „Primär“ blau, „Erfolg“ grün, „Gefahr“ rot.

Einmalig (nach Tippen deaktivieren) (single_use) erlaubt die Nutzung gespeicherter Schaltflächendaten nur ein einziges Mal, etwa für die Bestätigung einer Auswahl. Eine andere Beschriftung oder das Löschen der Nachricht stellen Sie separat beim Verhalten nach dem Drücken ein.

Schaltflächenoptionen

Diese Optionen werden im Editor per Kontrollkästchen eingeschaltet:

  • In neuer Zeile: setzt die Schaltfläche in die nächste Reihe.
  • Auf volle Breite strecken: stellt sie allein in eine Reihe; die nächste Schaltfläche beginnt ebenfalls eine neue Reihe.

So ist die Anordnung gemeint (eckige Klammern stehen für Schaltflächen):

Eine Reihe:       [Katalog] [Hilfe]

Neue Zeile:       [Katalog]
                  [Hilfe]

Volle Breite:     [         Hilfe         ]

Reihen und Farben gibt es in Telegram und VK. Die Anordnung bleibt beim erneuten Öffnen und Bearbeiten erhalten. Telegram-Premium-Emojis funktionieren nur bei einer passenden Verbindung. Einen Schalter „Innerhalb von Telegram öffnen“ gibt es nicht: Die Bot API lässt diese Einstellung nicht über eine solche Option steuern.

Grenzen der Kanäle

Wählen Sie eine Verbindung für den Block oder die einzelne Schaltfläche. Bei „Alle Kanäle“ verwendet der Editor nur Funktionen, die alle ausgewählten Kanäle gemeinsam unterstützen. Ein nicht unterstützter Typ lässt sich nicht speichern.

  • Telegram: URL, Mini App, Reaktion, Benachrichtigung oder Alert, Reihen, Farben und Custom Emoji mit den nötigen Bot-Rechten.
  • VK: URL, Reaktion, kurzer Hinweis (Snackbar), Reihen und Farben. VK Mini App und VK Pay nur mit einer passenden VK-Verbindung.
  • WhatsApp: genau eine URL-CTA-Schaltfläche ohne weitere Schaltflächen in derselben Nachricht. Bis zu 3 gewöhnliche Antwortschaltflächen; 4 bis 10 erscheinen als Liste. Beschriftung bis 20 Zeichen. Keine Reihen, Farben, Mini Apps oder Benachrichtigungen.
  • Instagram / Messenger: Der aktuelle Adapter überträgt nur Antwortschaltflächen (Quick Replies) mit höchstens 20 Zeichen. URL, Mini App, Benachrichtigung, Reihen und Farben werden nicht unterstützt.
  • Web-Widget: URL und Antwortschaltflächen, ohne Reihen, Farben oder Benachrichtigungen.
  • Email: Links einschließlich Zahlungslinks, keine Antwortschaltflächen oder Benachrichtigungen.

Bei Schaltflächen aus einer Liste kann die Spaltenzahl nur für Kanäle mit Reihen eingestellt werden. Sonst bestimmt der Kanal die Anordnung. Anzahl der Schaltflächen und Länge der Beschriftungen werden beim Versand geprüft.

Verhalten beim Drücken

Bei Schaltflächen, die den Tastendruck an den Bot senden, können Sie die Nachricht ersetzen (durch Text oder Inhalt einer anderen Reaktion), sie löschen, ein Label setzen oder einen Parameter speichern, sofern der Kanal diese Aktion unterstützt. Den Text der gedrückten Schaltfläche selbst ändern können Sie nur in Telegram, etwa „Anmelden“ zu „Ausgewählt“. VK kann zwar Nachrichten bearbeiten, aber nicht die Schaltflächenbeschriftung ändern.

Telegram wartet beim Drücken auf eine Bestätigung des Bots (answerCallbackQuery). GetMyBot sendet sie normalerweise selbst und entfernt den Ladeindikator. answerCallbackQuery überspringen deaktiviert diese Bestätigung.

Unter Text on press (notification) können Sie für den Typ „Reaktion“ eine kurze Rückmeldung wie „Kurs ausgewählt“ eintragen (Telegram: höchstens 200 Zeichen; VK: höchstens 90; Ersetzungen funktionieren). Telegram zeigt sie normalerweise kurz über dem Chat. Show as a popup (alert) ist nur in Telegram verfügbar und öffnet ein Fenster über answerCallbackQuery mit show_alert. Bei leerem Text wird lediglich der Ladeindikator entfernt. Wenn Sie answerCallbackQuery überspringen, werden weder Text noch Fenster gesendet.

Schaltflächendaten (Carry)

Mit Carry merkt sich die Schaltfläche, wozu sie gehört. Ein Mantel und ein Kleid können beide „Kaufen“ heißen. Speichern Sie beim Mantel product_id=101, beim Kleid product_id=102. Beim Drücken der Kleid-Schaltfläche enthält {{ctx.product_id}} in der nächsten Reaktion den Wert 102.

Im Editor heißt die Einstellung Daten beim Klicken. Der Schlüssel benennt den Wert; der Wert kann eine Zahl, Text oder eine Ersetzung sein. Der Bot speichert ihn beim Versand der Nachricht und legt ihn beim Tastendruck in den vorübergehenden Reaktionskontext (ctx). Jede Schaltfläche hat eigene Werte.

Die Gültigkeitsdauer (ttl_seconds, TTL) wird in Sekunden angegeben: 3600 ist eine Stunde. 0 wählt den Standard von 30 Tagen. Danach sind die Daten nicht mehr verfügbar. Einmalig (nach Tippen deaktivieren) (single_use) entfernt sie schon nach dem ersten Drücken. Ein gespeicherter Preis ändert sich nicht automatisch, wenn der Katalog aktualisiert wird: Prüfen Sie vor der Zahlung den aktuellen Preis anhand der Produkt-ID.

Einrichtung und Unterschied zu dauerhaften Parametern: Dynamische Schaltflächen und Parameter.

Dynamische Schaltflächen

Wenn Produkte oder Kurse bereits in einer Liste stehen, müssen Sie die Schaltflächen nicht einzeln hinzufügen. Der Block Dynamische Schaltflächen aus einer Liste erzeugt eine pro Eintrag. Geben Sie den Ort der Liste in ctx, einen Alias für das einzelne Element, die Schaltflächenzahl pro Reihe und eine Textvorlage an. {{item.name}} fügt beispielsweise den nächsten Produktnamen ein. Mehr dazu unter Dynamische Schaltflächen und Parameter.

Premium-Emoji im Text

Im Textblock fügt Premium-Emoji über die Formatierungsleiste <tg-emoji emoji-id="…">🙂</tg-emoji> ein. Bei Telegram Premium erscheint das Custom Emoji; andere Empfänger sehen das gewöhnliche Emoji innerhalb des Tags. Das funktioniert sowohl im HTML- als auch im Markdown-Modus des Blocks. Die Emoji-ID hat höchstens 32 Ziffern. Sie können sie über getCustomEmojiStickers erfahren oder eine Nachricht mit dem Emoji an einen Bot wie @idstickerbot weiterleiten.

Ein Link t.me/<bot>?start=<parameter> startet in Telegram den Befehl /start <parameter>. Den Chat mit einem Parameter ohne /start zu öffnen, ist über diesen Link nicht möglich. Wählen Sie passend zum Ziel:

  • Stiller /start: In einer Reaktion auf Befehl /start mit dem gewünschten Startparameter im Link kann die Aktion „Nachricht senden“ ohne Blöcke bleiben. Auf /start folgt dann keine sichtbare Antwort; der Parameter ist trotzdem im Ereigniskontext verfügbar und kann in Bedingungen und anderen Aktionen derselben Reaktion verwendet werden.
  • Prefilled text: https://t.me/<bot>?text=<text> (als Schaltfläche vom Typ „Vorbereiteter Text“ oder gewöhnlicher Link) öffnet den Chat und legt Text ins Eingabefeld, ohne ihn zu senden. /start wird dabei nicht ausgelöst; die Person muss die Nachricht selbst abschicken.
  • Eine automatische Nachricht im Namen des Nutzers beim Öffnen des Links ist mit der Bot API grundsätzlich unmöglich. Der Bot kann nicht als Nutzer schreiben. Als Alternative eignet sich ein Deep Link mit ?start= und eine Reaktion, die den gewünschten Text als Bot-Antwort sendet.

Erwartete Antwort (Dialogschritte)

Ein Textblock kann auf eine Nutzerantwort warten. Dann wird die Nachricht zum Dialogschritt, und der Ablauf pausiert bis zur Antwort. Mehrere solche Schritte ergeben einen Fragebogen oder Assistenten im Chat.

Erwarteter Inhaltstyp

Der Bot kann einen bestimmten Antworttyp erwarten: Text, Auswahl aus Optionen (Antwortschaltflächen), Foto, Video, Videonotiz, Audio, Dokument, Sprachnachricht, Standort, Kontakt, Kalender oder Würfel. Ein anderer Typ gilt als unpassende Antwort.

Text prüfen

Für Text können Sie eine Prüfung auf Telefonnummer, E-Mail, Link, Datum, Uhrzeit oder eine Formelbedingung einschalten. Wird eine Telefonnummer erwartet, akzeptiert der Bot keinen beliebigen Text und zeigt eine Fehlermeldung. Die Formelprüfung nutzt die erweiterte Formel: Bei Erfolg gibt sie leeren Text zurück, bei Ablehnung einen Fehlertext.

Antwort speichern

Sie können die Antwort in einem Parameter speichern. Danach steht sie als {{param.schlüssel}} in Ersetzungen und Bedingungen bereit. So entsteht Schritt für Schritt ein kleines Kundenprofil.

Fehler, Erinnerung und Zeitlimit

  • Nachricht bei ungültiger Antwort: Was der Bot zeigt, wenn die Eingabe die Prüfung nicht besteht.
  • Erinnerung: Was er sendet, wenn die Person nicht antwortet.
  • Warten nach Zeitlimit beenden: Nach welcher Zeit der Bot nicht mehr wartet. Beim Ablauf kann er eine Reaktion starten, etwa um den Fragebogen freundlich zu beenden. Unter Reaktionsverbindungen erscheint sie als „Wartezeit abgelaufen“, die Reaktion auf die eigentliche Antwort als „Erwartete Antwort“.

Dialogschritt mit einem Befehl verlassen

/cancel oder das russische Wort „отмена“ beenden das Warten und antworten mit „Отменено.“; ist eine Abbruchreaktion eingerichtet, startet diese stattdessen. Andere Befehle werden standardmäßig wie gewöhnlicher Text als Antwort geprüft. So kann der Schritt die Person im Dialog halten, bis sie antwortet. Mit Bot-Befehle (z. B. /start) beenden das Warten (escape_on_command) beendet jeder Befehl, etwa /start mitten in einem Fragebogen, das Warten still und wird anschließend normal ausgeführt.

Ersetzungen

Über Ersetzungen fügen Sie Absenderdaten ({{first_name}}, {{username}}, {{user_id}}), Ereignisdaten ({{text}}, {{chat_id}}, {{datetime}}) und Parameter ({{param.schlüssel}}) ein. Vollständige Liste und Formeln: Ersetzungen und Formeln.

Menüschaltfläche des Bots

Die Aktion Menu button wählt das Standardmenü des Bots, Befehle oder eine Mini-App-Schaltfläche mit Text und URL. Sie können sie nur für den aktuellen Chat oder als allgemeine Bot-Einstellung festlegen. So kann etwa nur ein bestimmter Kunde eine persönliche Mini App erhalten. Welche Varianten möglich sind, hängt vom Kanal ab.

Nächste Schritte