Telegram обновил Bot API до версии 10.3

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

Общие изменения

Появилось размещение кнопок в Rich Messages. Для этого разработчики добавили классы: RichMessageButton, RichTextButton, RichBlockButtons и InputRichBlockButtons. Rich Messages — это сообщения со сложной структурой и форматированием. В них также появился компактный режим для таблиц, раскрывающиеся цитаты и возможность прикреплять документы. Для уже загруженных файлов появились ссылки формата tg://document? id=.

Обычные инлайн-кнопки теперь можно делать неактивными. Такая кнопка остаётся видимой, но не реагирует на нажатие. Например, её можно использовать, чтобы показать пользователю уже выбранный вариант. Также в клавиатуры добавили параметр force_reply.

Исчезающие сообщения теперь можно показывать вместо исходного сообщения, связанного с callback-запросом. Речь идёт об Ephemeral Messages — сообщениях, которые в групповых чатах видит только определённый пользователь и бот. При редактировании такого сообщения бот теперь может загружать новые медиафайлы. Поддержка исчезающих сообщений появилась и у Rich Messages.

Изменения в работе ИИ-ботов

Одна из новых функций может пригодиться разработчикам ИИ-ботов. Методы sendMessageDraft и sendRichMessageDraft, которые позволяют постепенно выводить генерируемый ответ, получили параметры can_stop и keep_on_stop. Первый позволяет показать пользователю кнопку остановки генерации, а второй — определить, нужно ли сохранить уже сгенерированную часть сообщения после её остановки. Когда пользователь нажимает кнопку, бот получает соответствующее событие через stopped_message_generation.

Это должно сделать взаимодействие с ИИ-ботами удобнее: пользователю не придётся ждать окончания длинного или ошибочного ответа — генерацию можно будет остановить в любой момент и при необходимости сохранить уже полученную часть текста.

Предыдущая версия Bot API 10.2 вышла 14 июля. В ней Telegram расширил Rich Messages, добавил редактирование и удаление исчезающих сообщений и представил начальную поддержку Communities — объединений нескольких групп, каналов и ботов вокруг общей темы или аудитории.

Полный список изменений доступен в официальной документации Telegram Bot API.