update readmes

GuestQueryBot/README.md

@@ -0,0 +1,50 @@
+# 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:
+
+```text
+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
+
+1. Create a bot and obtain its token; keep the token private.
+2. Enable guest queries in BotFather so that `supports_guest_queries` is enabled.
+3. 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:
+
+```bash
+./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:
+
+```bash
+./gradlew :GuestQueryBot:run --args="BOT_TOKEN debug testServer"
+```