Telegram Bot API 10.4 Turns Chat Messages Into Mini-Apps
Telegram Bot API 10.4 turns chat messages into interactive mini-apps with HTML widgets and TON wallet payments. Widgets work in private bot chats for now, with groups still on the test server.

Telegram shipped Bot API 10.4 on November 9, and it quietly turns chat messages into small apps. Telegram Bot API 10.4 lets bots send interactive HTML widgets that run inside a message bubble, so a vote, a game, or a payment can happen right in the chat instead of opening a browser. The widgets are tiny, natively rendered, and wired into Telegram's own wallet, which makes this the most ambitious change to Telegram bots in years.
The idea is not new. Telegram has had Mini Apps for a while, but those open a separate web view. Widgets stay inside the message itself. A bot can send a live price ticker, an interactive poll, or a simple game, and the user interacts with it without leaving the conversation. When the bot updates the shared data in one place, every message showing that widget refreshes too.
What Telegram Bot API 10.4 widgets can do
The technical limits are tight on purpose. Widget code is limited to 4KB compressed, or 32KB before compression, and it renders natively instead of opening a browser-like view. That keeps widgets fast and light, and it stops developers from stuffing a whole website into a chat bubble. Bots send them with a new sendWidget method, and the widgets can show custom layouts, buttons, and live data.
There is one big caveat at launch: widgets only work in one-on-one private chats between a user and a bot. Groups and forwarded messages are still on Telegram's test server, and Telegram has not given a production date for them. That is a sensible limit for a first release, but it also means most users will not see widgets until a bot they already talk to starts using them.
TON wallet payments inside the chat
The more significant addition is payment support. Widgets can interact with Telegram's built-in TON wallet, so a bot can request a payment or ask the wallet to sign data, and the user approves it inside the chat. The integration runs through Gram Wallet, Telegram's own non-custodial wallet, and uses TON Connect transaction formats, so developers can build payment requests with code they already have.
That turns a chat message into a storefront. A bot can show a product, take a payment, and confirm the order without the user ever leaving Telegram. For legitimate businesses, that is convenient. For scammers, it is also convenient, which is why the approval step matters: every payment still needs the user to confirm it in the wallet. Never approve a payment from a bot you do not trust, no matter how polished the widget looks, and check your phone for spyware if anything about an app feels off.
The rest of Bot API 10.4
Widgets are the headline, but the update has more. Bots can now send private replies when a user taps a button in a group chat, so only that user sees the response. Formatted quotes let bots quote messages while keeping the original formatting. And Telegram Premium subscribers can give their bots custom usernames ending in agent, ai, app, game, or gay, which is a small thing that makes bot identities clearer.
Telegram founder Pavel Durov announced the change on X on November 10, saying any Telegram message can now be made into an app. That is a big claim, and the private-chat limit means it is not quite true yet. But the direction is clear: Telegram wants the chat itself to be the app, not a doorway to one.
Why it matters, and what to watch
Messaging apps have been drifting toward this for years. WhatsApp now lets people without the app RSVP to events, and every major chat platform is adding commerce and payments. Telegram's version is the most developer-friendly so far, because it gives bots a real interface inside the message instead of a link out.
The risk is the same as the opportunity. Widgets make bots more useful, and they also make scams look more legitimate. A fake support bot with a polished widget and a wallet prompt is a convincing trap. The defense is simple: only interact with bots you sought out, and never approve a wallet transaction you did not expect. The technology is impressive. The judgment still has to come from you.


