Telegram-Guest-Mode: Antworten in Gruppen, die den Bot nie hinzugefügt haben

Der Guest-Mode (Bot API 10.0, Mai 2026) entfernt die älteste Mauer im Telegram-Bot-Design: die Pflicht, Mitglied eines Chats zu sein, um darin zu sprechen. Mit dem Flag supports_guest_queries kann jede Gruppe den Bot per @mention rufen und bekommt eine Antwort im Inline-Stil über answerGuestQuery, ohne dass der Bot je hinzugefügt wurde oder die Gruppenkonversation liest.

Ich betreibe das in Produktion auf @roestwerk_bot: Eine Kundin oder ein Kunde kann den Shop in einen Klassenchat, einen Nachbarschafts- oder Liefergruppenchat ziehen, indem sie @roestwerk_bot coffee tippen, und eine Produktkarte erscheint. Niemand musste den Bot einladen; der Bot sah nichts außer der Erwähnung.

Was ändert der Guest-Mode tatsächlich?#

Standardmäßig nimmt ein Bot nur an Chats teil, in denen er Mitglied ist: der Gruppe hinzugefügt oder direkt angeschrieben. Der Guest-Mode fügt eine schmale Ausnahme hinzu:

• Jede Gruppe kann den Bot per @mention auslösen, optional mit Text dahinter, etwa @roestwerk_bot filterkaffee.
• Der Bot erhält ein guest_message-Update mit der Erwähnung und dem Abfragetext. Die übrigen Nachrichten der Gruppe bekommt er nicht, weder jetzt noch später.
• Der Bot antwortet über answerGuestQuery, das Inline-Stil-Payloads nimmt: eine Artikelkarte mit Thumbnail, einen Ort, einen Deep-Link-Knopf in die Mini-App.

Das Modell aus Nutzersicht: ein Schalterfenster. Anklopfen, Antwort bekommen, der Kurier tritt nie ins Haus.

Aktivieren: ein Flag, ein Handler#

Das Setup ist bewusst klein:

1. @BotFather → /mybots → den Bot wählen → Bot Settings → supports_guest_queries einschalten. Das ist die Besitzer-Erlaubnis, dass der Bot Guest-Updates überhaupt empfängt.
2. Das guest_message-Update behandeln und jede Query über answerGuestQuery beantworten.

Ein Implementierungshinweis vorab: Bis grammY 1.46 kennt der Type-Definitionen-Stand den guest_message-Typ nicht, man narrows das Update von Hand und registriert den Handler als nachgeschaltete Middleware. Die Logik selbst ist zwanzig Zeilen: Erwähnungstext gegen den Katalog matchen, Top-Produkt wählen, Karte bauen.

Was der Bot sehen kann und was nicht#

Die Privatsphären-Form ist das Verkaufsargument, und sie lohnt sich präzise zu sagen:

• Gesehen: die Erwähnung, der Abfragetext, die Gruppen- und Nutzer-IDs am Guest-Update.
• Nie gesehen: der Rest der Gruppenkonversation, davor und danach. Der Bot kann nicht lauschen, und die Historie der Gruppe bleibt in beide Richtungen unerreichbar.

Für ein Café oder einen Laden liest sich das als kostenlose Reichweite ohne Spam: Kundschaft verbreitet den Bot in die eigenen Gruppenchats, und das Datenschutzargument, das die meisten „fügt unseren Bot hinzu“-Vorschläge erledigt, greift nicht, weil es nichts zu lesen gibt.

Das Limit, das die Doku nicht bestätigt#

Community-Quellen nennen eine Obergrenze von rund drei Guest-Antworten pro auslösender Nachricht. Die Bot-API-Seiten dokumentieren die Zahl nicht. Ich behandle sie als unbestätigt und verifiziere das Verhalten live in einer Testgruppe: Gruppe anlegen, Bot nicht hinzufügen, aus einem zweiten Konto eine @mention schicken und zusehen, was zurückkommt. Eine Generalprobe schlägt es, eine undokumentierte Zahl vor dem Kunden zu zitieren.

Für wen sich Guest-Mode lohnt#

Jeder Bot, dessen Wert eine Karte überlebt: Shops mit kleinem Katalog, Termin- und Abholorientiertes Gewerbe, FAQ-artige Assistenten. Braucht die Antwort auf eine Erwähnung ein Gespräch statt einer Karte, ist Guest-Mode die falsche Form, und ein Deep Link in den Chat mit dem Bot bleibt der Ablauf. Und weil die Antwort über dieselbe Bot-API läuft wie alles andere, funktionieren Benachrichtigungen und der Rest des Bots genau wie bisher: Guest-Mode baut eine Tür, er baut das Haus nicht um.