9 ноября 2026 года в официальном changelog вышла версия Bot API 10.4. Для владельцев ботов в ней три главных изменения. Первое: HTML-виджеты в сообщениях Telegram-ботов, которые отправляются методом sendWidget, пока только в личные чаты. Второе: подписчики Telegram Premium могут назначить не более чем двум своим ботам дополнительные юзернеймы с окончаниями agent, ai, app, game или gay. Третье: появилось служебное сообщение о том, что собеседник написал по ссылке, которая позволяет писать без оплаты Stars. Ниже отделяем то, что подтверждено, от того, что пока неизвестно.
Что вошло в Bot API 10.4
- HTML-виджеты: класс Widget, поле widget в Message и ExternalReplyInfo, метод sendWidget.
- Запросы от виджетов к боту: WidgetQuery и SharedWidgetQuery.
- Дополнительные юзернеймы для ботов у пользователей с Premium.
- Служебное сообщение PaidMessagesWaived о переписке по ссылке без оплаты Stars.
- Метод deleteBusinessAccountGift для бизнес-аккаунтов.
HTML-виджеты в сообщениях ботов и метод sendWidget
В API добавлен класс Widget. В классах Message и ExternalReplyInfo появилось поле widget, по которому видно, что сообщение содержит HTML-виджет. Отправляет такие сообщения новый метод sendWidget. Параметры метода описаны в документации Bot API.
Ограничения виджетов сейчас
- В рабочей среде (production) виджеты пока можно отправлять только в личные чаты.
- Отправленные виджеты автоматически получают защищённый контент, поэтому их нельзя переслать.
Об ограничении по чатам в changelog сказано «currently», то есть «пока». Это намекает, что ограничение временное, но ни обещания открыть виджеты для групп и каналов, ни сроков там нет.
Как виджет общается с ботом: WidgetQuery и SharedWidgetQuery
В Update добавлено поле widget_query с классом WidgetQuery. Через него бот получает запросы от виджетов в сообщениях, отправленных самим ботом или через него. Для запросов из пересланных сообщений с виджетами, которыми поделились (shared widgets), есть отдельное поле shared_widget_query с классом SharedWidgetQuery. Отправленные ботом виджеты сейчас переслать нельзя, поэтому из описания изменений не ясно, в каких сценариях бот получит такие запросы на практике.
Где виджеты уже видны
По данным агрегатора релизов Releasebot, HTML-виджеты в ботах появились в Telegram Desktop 7.4. Версия 7.4.1, по тем же данным, исправила вылет при запуске на некоторых системах Windows. Официального поста Telegram о клиентском обновлении с виджетами мы не нашли.
С мобильными клиентами ясности нет. Telegram для Android 13.2.0 вышел 5 ноября, 13.2.1 — 7 ноября. В changelog обеих версий указано только «Bug fixes and minor improvements». Данных по iOS у нас нет. Как виджет отображается в клиентах без поддержки, неизвестно, поэтому проверьте это до запуска.
Дополнительные юзернеймы для ботов: ai, app, agent, game
Пользователь с подпиской Telegram Premium может назначить своим ботам дополнительные юзернеймы с окончаниями «agent», «ai», «app», «game» или «gay». Ограничение — не больше двух ботов. Для ИИ-ассистента, мини-аппа или игры такое окончание сразу подсказывает, что это за продукт.
Пока неизвестно, стоят ли такие юзернеймы что-то сверх подписки и что с ними будет, если Premium закончится. Подписку можно оформить за рубли на Starnbuy.
Сообщения по ссылкам без оплаты Stars
В Message добавлены поле paid_messages_waived и класс PaidMessagesWaived. Это служебное сообщение: отправитель воспользовался ссылкой, которая позволяет писать без оплаты Telegram Stars. Тем, кто берёт звёзды за входящие сообщения, важно знать, что такой способ существует и фиксируется в API.
Кто создаёт такие ссылки, где они находятся в интерфейсе и можно ли их отозвать, в changelog не описано. Если ваш бот ведёт учёт платных входящих, добавьте обработку PaidMessagesWaived. Тогда переписка без оплаты не попадёт в статистику как платная.
Бизнес-аккаунты: удаление обычных подарков
Метод deleteBusinessAccountGift позволяет боту удалять обычные подарки управляемого бизнес-аккаунта без получения Telegram Stars за них.
Сопутствующее: камера и микрофон в мини-аппах
По данным Releasebot, Telegram Desktop 7.3.5 добавил запросы доступа к камере и микрофону для мини-аппов. Это изменение клиента, а не Bot API 10.4. Если ваш мини-апп работает с видео или голосом, проверьте его и в десктопной версии.
Что пока неизвестно
- Можно ли принимать Stars внутри виджетов. О платежах в виджетах в changelog ничего нет.
- Когда виджеты появятся в клиентах для iOS и Android.
- Разрешат ли отправлять виджеты в группы и каналы и когда.
- Кто и как создаёт ссылки, освобождающие от оплаты Stars, и можно ли их отозвать.
- Есть ли у дополнительных юзернеймов отдельная цена и что с ними будет после окончания Premium.
Чек-лист для владельца бота
- Установите Telegram Desktop 7.4.1 или новее (поддержка виджетов в 7.4 известна по данным Releasebot). Отправьте виджет из тестового бота себе в личные сообщения и посмотрите, как он отображается.
- Обновите библиотеку бота, когда в ней появится поддержка Bot API 10.4. Добавьте обработку widget_query и shared_widget_query.
- Стройте сценарии с виджетами только для личных чатов. Для пользователей мобильных клиентов оставьте запасной вариант: текст и кнопки.
- Если вам нужен юзернейм на ai, app, agent или game, оформите Telegram Premium и найдите в документации Bot API и в BotFather, как назначить дополнительное имя.
- Если вы берёте Stars за входящие, добавьте учёт сообщений PaidMessagesWaived.
Частые вопросы
Стоит ли переносить оплату в боте на виджеты?
Пока нет: подтверждённых данных о платежах внутри виджетов нет. Принимайте оплату привычными способами. Другие материалы о Stars и платных функциях Telegram — в нашем блоге.
Можно ли взять окончание ai или app для личного аккаунта?
Изменение в Bot API касается только ботов. Про личные аккаунты в нём ничего не сказано.
Где посмотреть полный список изменений?
В официальном Bot API changelog на core.telegram.org, в записи о версии 10.4 от 9 ноября 2026 года.
Комментарии
Войдите через Telegram, чтобы оставлять комментарии
Войти через Telegram