Telegram Bot API 10.4 Adds Interactive Widgets and TON Wallet Support

• Telegram Bot API 10.4 adds interactive HTML widgets that run directly inside private chat messages.
• Bots can share live widget data, request TON wallet approvals and send private group replies.
• Telegram Premium users can now create custom bot usernames with several new suffix options.

Telegram has released Bot API 10.4 with new tools that let developers build more interactive experiences inside chats. The update introduces HTML widgets that appear directly in message bubbles, along with changes to private bot replies, wallet interactions and custom bot usernames.

The Telegram Bot API 10.4 update is aimed at making bots more useful without sending users to an external browser for every interaction. Developers can use the new widgets for live price tickers, interactive polls and simple games, while Telegram has also expanded how bots communicate in group chats.

Telegram Bot API 10.4 Adds Interactive HTML Widgets

The main addition in Telegram Bot API 10.4 is support for live, interactive HTML widgets inside messages. A bot can send a widget that is rendered natively within the Telegram chat, allowing users to interact with it without opening a separate browser window.

Possible uses include live price tickers, interactive polls and simple games. Telegram says these widgets are designed to download instantly and can be smaller than 4 KB. They support interactive elements, with payments and viral sharing mechanics built into the experience.

A bot can also update shared data from one place. When that data changes, the update can appear across the different messages displaying the same widget as those widgets refresh. This makes it possible to keep shared information consistent without sending a separate replacement message to every chat.

There is an important limitation at launch: HTML widgets currently work only in one-on-one private chats between a user and a bot. They are not yet available in group chats.

Widgets Can Connect With Telegram’s TON Wallet

The new widgets can interact with Telegram’s built-in TON wallet when a bot requests a payment or data signing action. This gives developers a way to add supported wallet-based steps to an interactive experience.

Wallet actions are not approved silently. When a widget requests an operation, Telegram opens a separate wallet window where the user can review the request and approve it. The user remains in control of whether the requested action goes ahead.

Bots Get Private Replies in Group Chats

Telegram Bot API 10.4 also expands ephemeral responses. Bots can now send a private reply when a user taps a bot button in a group chat. The response is visible only to that user and the bot, rather than appearing as a message for everyone in the group.

This can help bots handle personal actions, selections or follow-up information without adding unnecessary messages to a busy group conversation. The feature gives bot developers another way to keep individual interactions separate from the public chat.

Telegram Premium Adds Custom Bot Usernames

Another change in Telegram Bot API 10.4 is support for custom bot usernames with a Telegram Premium subscription. Eligible users can create bot usernames using suffixes such as @yourname_ai, @yourname_agent, @yourname_app or @yourname_game.

These options give developers more flexibility to identify a bot by its purpose. For example, an AI assistant, an app-based bot or a game bot can use a username that makes its function easier to recognise.

How Developers Can Use the New Bot API Features

Developers can refer to the official Telegram Bot API documentation for the updated API methods and implementation details. The new widget experience is intended for bots that need compact interfaces, shared live data or interactive steps within a private chat.

For more Telegram coverage, read our earlier report on the Telegram update with video features, media controls and developer tools.

Conclusion

Telegram Bot API 10.4 brings interactive HTML widgets into private chats, adds user-approved TON wallet actions and expands private bot replies in groups. The update also introduces custom bot username options for Telegram Premium subscribers, giving developers more ways to build and identify bot experiences.

Frequently Asked Questions