Рекомендуем
VeoSeeBot — нейросети прямо в Telegram Создавайте изображения, видео и тексты с помощью ИИ. Популярные нейросети в одном Telegram-боте.
Открыть бот

Telegram Bot API 10.4 — HTML-виджеты в личных чатах и скрытые ответы на кнопки

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

Telegram Bot API 10.4
Telegram Bot API 10.4

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-ответах остаются недоступными в рабочей среде. Наиболее заметное изменение за пределами виджетов уже касается общих чатов: боты могут показывать персональные ответы на нажатия кнопок, не создавая отдельного видимого сообщения для всех участников.

Источники

При использовании материалов сайта необходимо указывать ссылку на TGLand.ru. Если вы копируете фрагменты текста в интернете, прямая гиперссылка, доступная для индексации поисковыми системами, должна быть размещена в начале материала.

Вам также может понравиться