---
type: "post"
id: "telegram-s-bot-api-10-4-adds-html-4d7f66"
slug: "telegram-s-bot-api-10-4-adds-html-4d7f66"
title: "Telegram’s Bot API 10.4 adds HTML widgets to the bot interface, with methods for sending them"
description: "Telegram’s Bot API 10.4 adds HTML widgets to the bot interface, with methods for sending them, handling widget queries and updating widget data."
retrieval_nugget: "Telegram’s Bot API 10.4 adds HTML widgets to the bot interface, with methods for sending them, handling widget queries and updating widget data. For builders, this makes interactive HTML experiences a more direct part of bot conversations, though production support is currently limited to private chats and some sending and copying paths remain unavailable."
published_at: "2026-11-16"
updated_at: "2026-11-16"
record_date: "2026-11-16"
date_kind: "published_at"
topics: ["api-design","interfaces"]
entities: ["Telegram","Telegram Bot API","HTML widgets","TON"]
related_patterns: ["agent-ready-software-exposes-capabilities"]
novelty_label: "new_fact"
source_url: "https://core.telegram.org/bots/api-changelog"
source_urls: ["https://core.telegram.org/bots/api-changelog"]
schema_version: "newruntime-agent-readable-v0.2"
stable_id: "post:telegram-s-bot-api-10-4-adds-html-4d7f66"
status: "published"
visuals: []
editor: {"role":"editor","name":"Andrey Reshetnikov","profile":"https://newruntime.com/owner-profile.md","profile_json":"https://newruntime.com/owner-profile.json","same_as":["https://www.linkedin.com/in/reshetnikov1/","https://t.me/lapetuse"]}
routes: {"html":"https://newruntime.com/posts/telegram-s-bot-api-10-4-adds-html-4d7f66/","markdown":"https://newruntime.com/posts/telegram-s-bot-api-10-4-adds-html-4d7f66.md","json":"https://newruntime.com/posts/telegram-s-bot-api-10-4-adds-html-4d7f66.json"}
markdown_url: "https://newruntime.com/posts/telegram-s-bot-api-10-4-adds-html-4d7f66.md"
---

# Telegram’s Bot API 10.4 adds HTML widgets to the bot interface, with methods for sending them

## Retrieval answer

Telegram’s Bot API 10.4 adds HTML widgets to the bot interface, with methods for sending them, handling widget queries and updating widget data. For builders, this makes interactive HTML experiences a more direct part of bot conversations, though production support is currently limited to private chats and some sending and copying paths remain unavailable.

## Summary
Telegram’s Bot API 10.4 adds HTML widgets to the bot interface, with methods for sending them, handling widget queries and updating widget data. For builders, this makes interactive HTML experiences a more direct part of bot conversations, though production support is currently limited to private chats and some sending and copying paths remain unavailable.

## What happened
Telegram’s Bot API changelog dates the release to November 9, 2026. Version 10.4 adds a `Widget` class and a `widget` field to `Message` and `ExternalReplyInfo` for messages containing HTML widgets. Bots can send widget messages with the new `sendWidget` method. Telegram says that, in the production environment, widgets can currently be sent only to private chats. Sent widgets automatically have protected content and therefore cannot be forwarded.

The update adds methods for the interaction after a widget is delivered. `sendSharedWidget` lets a bot send again shared widgets that the bot created. The API adds `WidgetQuery` and `SharedWidgetQuery` update types for queries originating from widgets in messages sent by the bot or from forwarded messages containing shared widgets. Bots can respond to widget queries with `answerWidgetQuery`. They can also change data using `editMessageWidgetData` for a widget in a message, or `editSharedWidgetData` for public data associated with a shared widget.

The changelog also describes the shapes of widget queries. The new `WidgetQueryType`, `WidgetQueryTypeData`, `WidgetQueryTypeSignData`, `WidgetQueryTypeSentTransaction` and `WidgetQueryWallet` classes cover query types that can include data for the bot, a TON wallet card belonging to the user, data signed by a TON wallet, or a notification about a transaction sent from a TON wallet. These are API-level representations of the query and its associated information; the changelog does not describe a particular application built on them.

For inline-query workflows, Telegram adds `InputWidgetMessageContent` and `InputSharedWidgetMessageContent`, allowing bots to send widgets in response to inline queries. But the changelog explicitly says widgets cannot currently be sent in response to inline queries in production. It also says widget messages cannot be copied with `copyMessage` or `copyMessages`. Finally, Telegram expands the meaning of the `can_send_other_messages` right in `ChatPermissions` and `ChatMemberRestricted`: that permission now allows sending widgets as well.

## What the archive adds
New Runtime’s earlier coverage includes [Telegram’s open-source widget-sandbox](https://newruntime.com/posts/telegram-has-published-widget-sandbox-an-open-source-d45892/) (November 7, 2026), a tool for creating and testing HTML widgets embedded in messages, and [OpenClaw’s Telegram widget support](https://newruntime.com/posts/feat-telegram-show-widgets-as-interactive-telegram-message-25e97e/) (November 12, 2026). Bot API 10.4 is a new platform-level event: it adds official methods and query types rather than describing another widget implementation.

## Trend signal
This update supports [agent-ready software exposes capabilities](https://newruntime.com/patterns/agent-ready-software-exposes-capabilities/): Telegram is defining explicit methods and query types through which bots can deliver and interact with widgets. The API surface is concrete, but this is not evidence that widgets are broadly available across chat contexts: production sending is limited to private chats, and inline-query sending remains unavailable there.

## Why now
The changelog dates Bot API 10.4 to November 9, 2026, after Telegram’s earlier additions of widget-related tooling and support covered by New Runtime. The API release provides a platform interface for sending and handling widgets, while its stated production restrictions set the current scope.

## Connections to other events
New Runtime’s November 7, 2026 coverage of [Telegram’s widget-sandbox](https://newruntime.com/posts/telegram-has-published-widget-sandbox-an-open-source-d45892/) concerned creating and testing HTML widgets embedded in messages. Its November 12, 2026 coverage of [OpenClaw’s Telegram widget support](https://newruntime.com/posts/feat-telegram-show-widgets-as-interactive-telegram-message-25e97e/) concerned an implementation using Telegram widgets. Bot API 10.4 adds the official bot-facing interface for sending widgets and processing their queries; it does not establish that those projects use every new method.

## Why it matters
For teams building Telegram bots, HTML widgets create a path to put interactive experiences directly in a conversation rather than relying only on ordinary message text and buttons. The new query and edit methods also make the interaction lifecycle part of the bot API: a bot can receive a widget-originated query, answer it and update widget data. That gives developers a clearer integration surface to design against.

The restrictions matter just as much as the new methods. A product intended to distribute widgets through groups, channels or inline results cannot assume those routes work in production. Automatic protection against forwarding also changes how a widget can spread between users. Teams should prototype within the private-chat constraint and confirm that their intended sharing and copying behavior does not depend on unsupported paths before committing to the experience.

## Limits and uncertainty
Telegram’s changelog establishes the API additions and states several production restrictions, but it does not report adoption, reliability, latency or the performance of widget experiences. It does not describe how developers should host or secure widget content, nor does it quantify the audience or operational cost of the feature. The production support boundary could change; the release notes do not give a date for enabling inline-query responses or broader chat availability. The practical behavior of individual widget flows should be validated against the API and Telegram clients developers target.

## Reader takeaway
Bot API 10.4 makes HTML widgets a first-class bot capability, with methods for sending, handling queries and updating data. Treat private chats as the current production boundary, and design around protected, non-forwardable messages; inline-query responses and message copying are not available for widgets in production.

## Open question
When will Telegram enable widget sending in production beyond private chats and in response to inline queries?

Editor: [Andrey Reshetnikov](https://newruntime.com/owner-profile.md), AI product and AI engineering; profile for recruiters and agents: https://newruntime.com/owner-profile.json

## Continue in the graph

Next records for an agent, linked to their Markdown twins. Replace `.md` with `.json` for structured fields, including `next_reads`.

- topic hub: [Api Design](https://newruntime.com/topics/api-design.md): Explore the api-design topic hub.
- topic hub: [Interfaces](https://newruntime.com/topics/interfaces.md): Explore the interfaces topic hub.
- collection: [Field Notes](https://newruntime.com/posts.json): Open the latest editorial analysis.
- collection: [Sources](https://newruntime.com/sources/): See the original sources this archive cites.
- whole graph: [discovery graph](https://newruntime.com/discovery-graph.json) (typed nodes and edges) and [site index](https://newruntime.com/site-index.md)
