9 ноября 2026 года Telegram выпустил Bot API 10.4 с поддержкой интерактивных HTML-виджетов внутри сообщений. Боты получили способы обновлять содержимое таких карточек и обрабатывать действия пользователя, а нажатие кнопки в общем чате теперь может вызвать персональный ответ, видимый только нажавшему. При этом в рабочем API отправка виджетов пока ограничена личными чатами.

HTML-виджет позволяет разместить в сообщении Telegram небольшой интерактивный интерфейс: например, карточку заказа, счётчик или панель с результатами опроса. До официального релиза механизм уже появился в тестовой документации Bot API 10.4. Теперь Telegram описал публичные методы и отдельно указал, какие из возможностей доступны на действующих серверах.
HTML-виджеты работают внутри сообщения Telegram
Раньше бот мог отправить текст, кнопки или предложить открыть Telegram Mini App. С версией 10.4 он может поместить интерфейс непосредственно в сообщение: пользователь видит кнопки, показатели и другие элементы в привычной ленте переписки. Для этого предназначен метод sendWidget, принимающий HTML-код и настройки размеров карточки.
Виджет представляет собой небольшой документ с HTML, CSS и JavaScript. Для него предусмотрена изолированная среда исполнения: код работает через QuickJS без прямого доступа к интернету. Запросы fetch, WebSocket и другие сетевые обращения из самого виджета недоступны. Если интерфейсу понадобились данные с сервера, он взаимодействует с ботом через предусмотренные Bot API запросы.
Есть ограничения по объёму: HTML-код виджета может занимать до 32 768 байт, а после сжатия zlib с максимальным уровнем — не более 4096 байт. Поэтому формат рассчитан на компактные панели и небольшие интерактивные элементы. Для полноценного веб-приложения с внешними библиотеками и сетевыми запросами сохраняется отдельный механизм Telegram Mini Apps.
В Bot API 10.4 виджеты пока доступны только в личных чатах
Официальная документация прямо ограничивает отправку HTML-виджетов в рабочей среде личными чатами. Сообщения с ними автоматически получают защиту от пересылки. Отправка виджетов через ответы на inline-запросы в рабочей среде также пока недоступна, а методы copyMessage и copyMessages такие сообщения не копируют.
Это влияет на сценарии использования. Бот может показать пользователю интерактивную карточку в личной переписке, но разместить её в группе в рамках текущих производственных ограничений нельзя. Для голосований и командных панелей, которые должны появляться непосредственно в групповых сообщениях, общедоступный режим пока ограничен.
В Bot API предусмотрен и метод sendSharedWidget. Он позволяет повторно отправить созданный ботом общий виджет, используя его идентификатор. Сейчас это применимо с учётом того же ограничения на личные чаты; наличие механизма общих виджетов само по себе не снимает запрет на пересылку.
Как виджет получает ответы и обновляет данные
В Bot API 10.4 появилась отдельная цепочка обмена данными между карточкой и ботом. При разрешённых запросах действие пользователя создаёт событие widget_query, которое приходит боту через обычный механизм обновлений. Бот отвечает методом answerWidgetQuery. На ответ отводится 15 секунд, а данные ответа получает именно тот виджет, который отправил запрос.
Для изменения состояния карточки используются editMessageWidgetData и editSharedWidgetData. Первый метод меняет данные конкретного сообщения, второй — общие данные повторно используемого виджета. Например, бот может передавать обновлённый статус заказа без отправки нового сообщения каждый раз, когда статус меняется.
У общего виджета есть технические пределы: менять его публичные данные можно не чаще одного раза в секунду. Клиент также может кэшировать данные; по умолчанию установлен срок 30 секунд, который настраивается в пределах от 5 до 3600 секунд. Поэтому обновление общей карточки на стороне бота не гарантирует совершенно одновременное изменение изображения на экранах всех пользователей.
Скрытые ответы на кнопки стали доступны в общих чатах
Вторая заметная функция релиза связана с ephemeral messages — временными персональными сообщениями. Telegram поддерживал их и раньше, но в Bot API 10.4 расширил применение к ответам на нажатие кнопки. Теперь бот может указать callback_query_id в ephemeral_message_parameters и отправить ответ, который увидит только человек, нажавший кнопку. Поле receiver_user_id для такого сценария больше не обязательно.
Представим групповой чат с ботом, который показывает общую кнопку «Мой статус». Участник нажимает её и получает персональные сведения, тогда как остальные участники не видят этот ответ в переписке. При этом возможность не распространяется на чаты личных сообщений каналов (channel direct messages chats).
Для разработчиков здесь существенна разница между обычным ответом в чат и персональной реакцией на конкретное нажатие: её можно использовать для индивидуальной информации, сохраняя общую переписку свободной от отдельных ответов каждому участнику.
TON-кошельки, цитирование и дополнительные изменения API
Виджеты получили возможность передавать боту запросы, связанные с нативным TON-кошельком Telegram. В спецификации появились типы для данных кошелька, подписанной информации и уведомлений о проведённых транзакциях. Отдельные структуры позволяют работать с карточкой кошелька, балансами и NFT-элементами, а поле ton_wallet_transfer описывает служебные сообщения о переводах. Доступность конкретных данных зависит от соответствующего сценария взаимодействия с кошельком.
Есть изменения и в работе с текстом. Поля rich_texts и quote_rich_texts позволяют цитировать фрагменты Rich Messages с сохранением расширенного форматирования. Для сообщений появились типы сущностей ton_address и bank_card_number, а для Rich Messages — структура RichTextTonAddress.
В остальных частях обновления Telegram добавил метод getUniqueGift для получения информации об уникальном подарке по имени и deleteBusinessAccountGift для удаления обычного подарка у подключённого бизнес-аккаунта без конвертации в Telegram Stars. Также появились структуры оформления экрана пересылки ссылки на пользователя или чат и метод getChatShareThemeBackdrops.
Подписчики Telegram Premium теперь могут назначать дополнительное имя пользователя двум своим ботам. Для таких имён предусмотрены окончания agent, ai, app, game или gay. Ещё одно изменение — ссылки на темы в личных чатах с ботами по формату https://t.me/<bot_username>/<message_thread_id>: открыть конкретную тему по такой ссылке может только участник соответствующей переписки.
Публичный релиз виджетов пока ограничен личной перепиской
Bot API 10.4 зафиксировал переход HTML-виджетов из тестовой спецификации в официальный API от 9 ноября 2026 года. При этом отправка в группы, пересылка карточек и их использование в inline-ответах остаются недоступными в рабочей среде. Наиболее заметное изменение за пределами виджетов уже касается общих чатов: боты могут показывать персональные ответы на нажатия кнопок, не создавая отдельного видимого сообщения для всех участников.