GuestQueryBot

Demonstrates guest queries through long polling in chats where the bot is not a member.

Behavior

At startup, the bot calls getMe and prints its bot information and the value of supportsGuestQueries.

For each guest request, it prints the query ID, caller, chat, and content, then answers with an inline article whose message contains:

Guest mode reply
Query ID: <guest-query-id>

For ordinary content messages carrying guest-call metadata, the bot also replies with the initiating user's name and/or the public chat's title. Every received update is printed to standard output. The bot defines no commands.

Setup and permissions

Create a bot and obtain its token; keep the token private.
Enable guest queries in BotFather so that supports_guest_queries is enabled.
For ordinary messages outside guest mode, add the bot to the relevant chat and allow it to send messages there.

The guest-query flow does not require the bot to be a chat member. This example uses no admin-only methods and does not configure a webhook.

Run

From the repository root:

./gradlew :GuestQueryBot:run --args="BOT_TOKEN"

The first argument is the required bot token. Optional, case-sensitive flags may follow it in either order:

debug enables formatted library logging on standard output;
testServer connects to Telegram's Bot API test environment.

For example:

./gradlew :GuestQueryBot:run --args="BOT_TOKEN debug testServer"