Telegram Bot API 10.3 — Расширение Rich Messages, новые эфемерные сообщения и права администраторов

24 августа 2026 года состоялся релиз Telegram Bot API 10.3, который привносит значительные изменения в работу с Rich Messages и эфемерным контентом. Ключевые обновления включают новые блоки для интеграции кнопок и файлов прямо в текст, а также рефакторинг параметров отправки исчезающих сообщений. Релиз требует внимания разработчиков из-за обратно несовместимых изменений в методах отправки медиа и текста.

Развитие Rich Messages: интерактивные элементы и новые блоки

Telegram продолжает развивать формат структурированных сообщений (Rich Messages), добавляя в версию 10.3 элементы для построения полноценных интерфейсов напрямую в теле сообщения.

• Кнопки в тексте: Введены классы RichMessageButton и RichTextButton. Для группировки кнопок в блочную структуру добавлены классы RichBlockButtons и InputRichBlockButtons.
• Поддержка файлов и документов: Появились классы RichBlockDocument и InputRichBlockDocument, позволяющие встраивать документы в Rich-сообщения. Также реализована поддержка ссылок формата tg://document?id= для прямых загрузок файлов.
• Сворачиваемые цитаты: Разработчики добавили классы RichBlockExpandableBlockQuotation и InputRichBlockExpandableBlockQuotation, которые позволяют создавать блоки цитирования с возможностью скрытия и раскрытия текста пользователем.
• Компактные таблицы: В классы RichBlockTable и InputRichBlockTable добавлено булево поле is_compact для более плотного отображения данных.

Рефакторинг работы с эфемерными сообщениями

Логика маршрутизации эфемерных сообщений (видимых только конкретному пользователю или имеющих таймер самоуничтожения) подверглась существенной переработке. Это изменение напрямую затрагивает кодовую базу существующих ботов.

• Унификация параметров отправки: Введен новый объект EphemeralMessageParameters. Он полностью заменяет разрозненные параметры receiver_user_id и callback_query_id во всех базовых методах отправки контента, включая sendMessage, sendPhoto, sendVideo и другие. Этот же параметр добавлен в метод sendRichMessage.
• Подмена исходного контента: Новое поле replace_callback_query_message в объекте EphemeralMessageParameters позволяет боту отобразить эфемерное сообщение прямо на месте исходного (например, при нажатии на inline-кнопку).
• Расширение возможностей редактирования: Метод editEphemeralMessageMedia получил поддержку загрузки новых файлов. В editEphemeralMessageCaption интегрирован параметр show_caption_above_media, а метод editEphemeralMessageText теперь умеет работать со структурированным текстом через параметр rich_message.

Управление группами, клавиатуры и черновики

Помимо структурных изменений, версия 10.3 включает несколько точечных улучшений для управления чатами и пользовательским вводом:

• Приветственные сообщения: В права администраторов (ChatAdministratorRights и ChatMemberAdministrator), а также в метод promoteChatMember, добавлен флаг can_send_welcome_messages.
• Визуальная деактивация кнопок: Класс InlineKeyboardButton получил свойство disabled, а также введен отдельный класс DisabledButton. Это позволяет отображать неактивные кнопки (например, при достижении лимитов или окончании страниц) без их физического удаления из разметки.
• Принудительные ответы: В разметки клавиатур InlineKeyboardMarkup и ReplyKeyboardMarkup добавлено поле force_reply.
• Управление черновиками: Методы sendMessageDraft и sendRichMessageDraft расширены параметрами can_stop и keep_on_stop.

Итоги и рекомендации по обновлению

Релиз Bot API 10.3 требует обязательного аудита кода перед обновлением используемых библиотек и SDK. Замена параметров receiver_user_id и callback_query_id на объект ephemeral_message_parameters является обратно несовместимым изменением, из-за которого старые методы отправки будут возвращать ошибки при работе с эфемерным контентом.

В то же время, нововведения значительно упрощают проектирование интерфейсов. Использование флага disabled для inline-кнопок избавляет разработчиков от необходимости перестраивать клавиатуры обходными путями, а интеграция кнопок и документов в структуру Rich Messages делает ботов более интерактивными без усложнения клиентского рендеринга. Обновление следует разворачивать поэтапно, предварительно убедившись, что выбранный API-клиент полностью поддерживает спецификацию 10.3.