Telegram Bot API 10.3: кнопки в сообщениях и кнопка «Стоп»

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

Разбираем, что нового, кому это важно и что сделать владельцу бота.

Что произошло

Bot API 10.3 вышел 24 августа 2026 года и описан в официальном changelog на core.telegram.org. Это продолжение линейки обновлений лета 2026 года: в версиях 10.1 и 10.2 Telegram представил «богатые» сообщения (Rich Messages) и эфемерные сообщения, а в 10.3 их развил.

Ключевые изменения по официальному changelog:

Rich Messages (оформленные сообщения) - Кнопки теперь можно ставить прямо внутри rich-сообщения (классы RichMessageButton, RichTextButton, RichBlockButtons). По описанию в официальном канале BotNews, они поддерживают колбэки, Mini Apps, Login URL, копирование текста и другое, с несколькими стилями и выравниванием. - Компактные таблицы (поле is_compact). - Раскрывающиеся цитаты (RichBlockExpandableBlockQuotation). - Вложение документов в rich-сообщение (RichBlockDocument) и ссылки вида tg://document?id= для загрузки файлов.

Эфемерные сообщения (видны только одному пользователю в группе) - Параметры receiver_user_id и callback_query_id в методах sendMessage, sendPhoto, sendDocument и других заменены одним параметром ephemeral_message_parameters (класс EphemeralMessageParameters). - Новое поле replace_callback_query_message позволяет показать эфемерное сообщение вместо исходного. - Можно загружать новые файлы при редактировании медиа эфемерного сообщения. - Новое право администратора can_send_welcome_messages.

Клавиатуры - Неактивные кнопки: класс DisabledButton и поле disabled у InlineKeyboardButton. - Поле force_reply в InlineKeyboardMarkup и ReplyKeyboardMarkup.

Для ИИ-ботов - Параметры can_stop и keep_on_stop в методах sendMessageDraft и sendRichMessageDraft — нативная кнопка «Стоп» для потоковых ответов с возможностью сохранить уже сгенерированную часть. - Новое обновление о том, что пользователь остановил генерацию (MessageGenerationStopped, поле stopped_message_generation).

Прочее - Служебные сообщения о вступлении чата из сообщества (CommunityChatJoined) и новые поля у UniqueGiftInfo.

Кого это касается

• Владельцев ботов, которые уже используют эфемерные сообщения с параметрами receiver_user_id и callback_query_id. В changelog прямо сказано, что эти параметры заменены новым объектом. Если бот написан напрямую под HTTP API или на библиотеке, обновлённой под 10.3, код нужно проверить.
• Бизнесов, у которых бот работает как каталог, запись или FAQ. Кнопки внутри оформленных сообщений, таблицы и документы позволяют сделать красивое меню услуг, прайс-таблицу или выдать договор PDF в одном сообщении.
• Ботов с ИИ-ассистентом. Кнопка «Стоп» решает частую жалобу пользователей на длинные ответы, которые нельзя прервать.

Если ваш бот — простой «приём заявок» на классических кнопках, он продолжит работать: эти изменения добавляют возможности, а не ломают базовые сценарии.

Как проверить своего бота

• Узнайте, на чём он написан и какой версии библиотека (aiogram, python-telegram-bot, Telegraf, grammY, GramIO и т. д.). Поддержка 10.3 зависит от выхода обновления библиотеки.
• Поищите в коде receiver_user_id и callback_query_id в вызовах отправки сообщений. Если они есть — это кандидат на доработку под ephemeral_message_parameters.
• Проверьте логи бота на ошибки 400 от Telegram после конца августа.
• Пройдите основные сценарии в группе и в личке: меню, запись, оплата, ответ оператора.

Что делать: пошаговый план

• Обновите библиотеку до версии с поддержкой Bot API 10.3, сначала на тестовом боте.
• Перепишите вызовы эфемерных сообщений на объект ephemeral_message_parameters, если вы их используете.
• Пересмотрите меню. Где у вас «простыня» текста и длинная клавиатура снизу — попробуйте rich-сообщение с кнопками внутри, раскрывающимися блоками для подробностей и компактной таблицей цен.
• Используйте неактивные кнопки для недоступных вариантов: например, занятые слоты записи можно показывать серыми, а не прятать — так понятнее.
• Для ИИ-бота включите can_stop и решите, сохранять ли частичный ответ (keep_on_stop).
• Отправляйте документы прямо в сообщении: прайс, памятку, договор.
• Проверьте права администраторов в группах, если бот присылает приветствия новым участникам: появилось отдельное право can_send_welcome_messages.
• Задокументируйте изменения и обновите инструкцию для сотрудников, которые работают с ботом.

Идеи для малого бизнеса на основе 10.3

Новые возможности — это не только про разработчиков. Вот несколько сценариев, которые стали проще реализовать:

• Салон красоты или клиника. Бот присылает одно оформленное сообщение: список услуг с раскрывающимися описаниями, компактная таблица цен и кнопки «Записаться» прямо под нужной услугой. Занятое время показывается неактивными кнопками, и клиенту сразу видно, что свободно.
• Доставка и кафе. Меню разделами, кнопки добавления в корзину внутри сообщения, а оформление заказа — в Mini App, которую можно открыть прямо из rich-сообщения.
• Образовательные проекты. Бот выдаёт материалы урока документом в том же сообщении, где есть описание и кнопка «Сдать задание».
• Рабочий чат команды. Бот в группе отвечает сотруднику на команду эфемерным сообщением — личная информация (график, задачи) не засоряет общий чат.
• ИИ-консультант на сайте и в Telegram. Пользователь может остановить длинный ответ кнопкой «Стоп», а бот получает об этом событие и может, например, предложить связаться с менеджером.

Важно не перегружать бота функциями: чем проще сценарий для клиента, тем выше конверсия. Мы обычно начинаем с одного-двух улучшений и смотрим на статистику обращений.

На что обратить внимание при обновлении

Bot API обновляется часто — летом 2026 года вышли версии 10.1, 10.2 и 10.3 с интервалом в несколько недель. Новые возможности становятся доступны в популярных библиотеках не сразу, а после их обновления, поэтому иногда разумно подождать стабильного релиза библиотеки, а не переписывать всё вручную. Отдельно продумайте обратную совместимость. Пользователям старых версий приложения Telegram новые элементы могут отображаться иначе, поэтому ключевые действия (запись, оплата, связь с менеджером) лучше дублировать понятным текстом или командой. И обязательно тестируйте изменения на отдельном тестовом боте, а не на рабочем, через который идут заявки.

Ещё один практический совет: заведите в боте команду или кнопку «Связаться с человеком». Какими бы красивыми ни были новые сообщения, часть клиентов всё равно захочет поговорить с менеджером, и бот не должен становиться для них стеной.

Как это решаем мы в WeCre8

Мы делаем Telegram-ботов для малого бизнеса — запись, заявки, каталоги, уведомления, связка с сайтом. Для ботов, которые мы ведём на поддержке и размещаем на своём хостинге, мы сами отслеживаем changelog Bot API, обновляем библиотеки, проверяем, что ничего не сломалось, и предлагаем клиентам новые возможности, когда они действительно полезны, а не ради моды.

Если у вас бот, сделанный другим разработчиком, который больше не на связи, мы можем взять его на сопровождение: разберёмся в коде, обновим, перенесём на наш хостинг и настроим мониторинг. Если бот устроен так, что поддерживать его дороже, чем переписать, — честно скажем об этом.

FAQ

Мой бот перестанет работать после Bot API 10.3?

Базовые функции — нет. Риск есть у ботов, которые отправляют эфемерные сообщения с параметрами receiver_user_id и callback_query_id: в 10.3 они заменены на ephemeral_message_parameters.

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

Сообщения бота в группе, которые видит только один пользователь. Удобно для личных ответов на команды без засорения общего чата.

Можно ли теперь сделать в боте красивый прайс?

Да, в rich-сообщениях появились компактные таблицы, раскрывающиеся цитаты и кнопки внутри сообщения — это хорошо подходит для прайса и меню услуг.

Нужно ли что-то менять в Mini App?

В 10.3 изменения касаются в основном сообщений и кнопок; кнопки в rich-сообщениях умеют открывать Mini Apps. Отдельных обязательных изменений для Mini Apps в этом выпуске changelog не указывает.

Сколько стоит обновить бота?

Зависит от кода и объёма доработок. Для ботов на нашей поддержке обновления под новые версии API входят в сопровождение.

Нужна помощь?

Хотите обновить бота или сделать новый с оформленными сообщениями и записью? Напишите нам. Подробнее о поддержке — на странице /services/support.