From 9207664fbd65ecc55f38da9fc33e1e429a6cc157 Mon Sep 17 00:00:00 2001
From: Ilia Denisov <evilcart@gmail.com>
Date: Tue, 23 Jun 2026 22:45:54 +0200
Subject: [PATCH] docs(telegram): note the promo body @username is a deep link

---
 platform/telegram/README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/platform/telegram/README.md b/platform/telegram/README.md
index 53bab55..13ea0b0 100644
--- a/platform/telegram/README.md
+++ b/platform/telegram/README.md
@@ -86,7 +86,9 @@ Telegram identity to an account from a browser. Both map a rejection to gRPC
   self-contained: no bot-link, no gateway, no game. Its `?startapp` payload
   (`TELEGRAM_PROMO_START_PARAM`, default `verudit_ru-scrabble_en`) is a variant-seed deep
   link the backend decodes to seed a brand-new user's variant preferences (English Scrabble
-  alongside the default Erudit).
+  alongside the default Erudit). The message body also renders the bot's `@username` as that
+  same deep link (an HTML `text_link`), so tapping the mention — not just the button — opens
+  the seeded Mini App rather than the bot profile.
 - **Rate limiting.** Outbound sends are throttled (`TELEGRAM_SEND_RATE_PER_SECOND`,
   default 25) to respect the Bot API flood limits.