TELEGRAM BOT API 10.2: ЧТО НОВОГО

Telegram обновил Bot API до версии 10.2. В этом релизе четыре крупных блока изменений: доработка формата Rich Messages для более гибкой отправки, новый механизм приватных сообщений в группах Ephemeral Messages, первый шаг к объединению чатов в Communities, а также ужесточение правил безопасности для Mini Apps и новые уведомления о статусе подписок. Разбираем каждое изменение подробно.

Формат Rich Messages, появившийся в одном из предыдущих релизов, в версии 10.2 получил более удобный способ формирования сообщений на стороне бота.

Явное указание медиафайлов. У класса InputRichMessage появилось поле media, а вместе с ним - новый класс InputRichMessageMedia. Теперь бот может явно перечислить медиафайлы, которые используются внутри HTML- или Markdown-разметки сообщения, а не полагаться только на встроенные ссылки в тексте.

Голосовые сообщения как медиа. Добавлен класс InputMediaVoiceNote - он описывает голосовое сообщение, которое можно отправить в составе Rich Message.

Блочное описание сообщения. Главное дополнение - у InputRichMessage появилось поле blocks. Оно позволяет собирать исходящее сообщение не строкой разметки, а массивом типизированных блоков, что удобнее для программной генерации сложного контента. Список новых классов блоков получился внушительным:

• InputRichBlockParagraph - абзац текста;
• InputRichBlockSectionHeading - заголовок раздела;
• InputRichBlockPreformatted - предварительно отформатированный текст или код;
• InputRichBlockFooter - подвал сообщения;
• InputRichBlockDivider - разделитель;
• InputRichBlockMathematicalExpression - математическая формула;
• InputRichBlockAnchor - якорь для навигации по сообщению;
• InputRichBlockList и InputRichBlockListItem - список и его элементы;
• InputRichBlockBlockQuotation и InputRichBlockPullQuotation - блочная и выносная цитаты;
• InputRichBlockCollage и InputRichBlockSlideshow - коллаж и слайд-шоу из медиафайлов;
• InputRichBlockTable - таблица;
• InputRichBlockDetails - сворачиваемый блок с заголовком;
• InputRichBlockMap - карта с координатами;
• InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote - соответствующие типы медиавложений;
• InputRichBlockThinking - блок «размышления», предназначенный для ИИ-агентов.

По сути, теперь у разработчика есть три равноправных способа собрать Rich Message: через HTML, через Markdown или через массив блоков - в зависимости от того, что удобнее для конкретной архитектуры бота.

Bot API 10.2 официально вводит Ephemeral Messages - сообщения в группе, которые видит только конкретный пользователь и отправивший их бот, а не вся группа целиком.

Отправка. Приватность добавлена как параметр к уже существующим методам, а не как отдельный метод. Параметры receiver_user_id и callback_query_id появились сразу у большого числа методов отправки: sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation, sendVenue. Таким образом приватным можно сделать практически любой тип контента - от текста до геолокации.

Идентификация. У класса Message появились два новых поля: receiver_user (кому адресовано приватное сообщение) и ephemeral_message_id (отдельный идентификатор ephemeral-сообщения).

Команды. У класса BotCommand добавлено поле is_ephemeral - команда с этим флагом остаётся видимой только пользователю, который её ввёл.

Ответы на приватные сообщения. В классе ReplyParameters появилось поле ephemeral_message_id, позволяющее боту отвечать именно на ephemeral-сообщение. При этом поле message_id в этом классе стало опциональным, если указан ephemeral_message_id.

Редактирование и удаление. Для управления уже отправленным приватным сообщением добавлены отдельные методы:

• editEphemeralMessageText - изменить текст;
• editEphemeralMessageMedia - заменить медиафайл;
• editEphemeralMessageCaption - отредактировать подпись;
• editEphemeralMessageReplyMarkup - обновить клавиатуру;
• deleteEphemeralMessage - удалить сообщение.

Bot API 10.2 добавляет начальную поддержку Communities - объединений из нескольких супергрупп, каналов и ботов, сгруппированных вокруг общей темы или аудитории.

Ключевые изменения:

• новый класс Community, описывающий такое объединение;
• новый класс CommunityChatAdded и поле community_chat_added в классе Message - сообщают о добавлении чата в объединение;
• новый класс CommunityChatRemoved и поле community_chat_removed в классе Message - сообщают об удалении чата из объединения;
• новое поле community в классе ChatFullInfo - позволяет определить, к какому объединению относится чат.

Пока это только базовый набор объектов для чтения структуры и отслеживания событий - методов создания или административного управления объединениями в этом релизе нет.

Уведомления об изменении подписки. Добавлен класс BotSubscriptionUpdated и поле subscription в классе Update. Через это обновление бот узнаёт об изменениях в платной подписке пользователя - оплате, отмене или сбое платежа - не дожидаясь следующего обращения к боту.

Ограничение Mini Apps по домену. Telegram усилил защиту Mini Apps: теперь вызов методов Mini App с origin, отличного от исходного домена приложения, будет заблокирован. Автоматически эта защита включится для всех Mini Apps 20 июля 2026 года. Отключить её можно через настройки Mini App в @BotFather, но в этом случае ответственность за отсутствие ссылок на недоверенные сайты внутри Mini App полностью ложится на разработчика бота.

Bot API 10.2 развивает сразу несколько направлений: Rich Messages стали удобнее собирать программно за счёт блоков и явного указания медиа, Ephemeral Messages дают ботам официальный способ писать пользователю приватно прямо в группе, Communities закладывают основу для более крупных объединённых пространств чатов, а обновления по подпискам и безопасности Mini Apps касаются уже действующей монетизации и защиты пользовательских данных. Из всего перечисленного единственный пункт с жёстким дедлайном - автоматическое включение доменной защиты Mini Apps 20 июля 2026 года, это стоит учесть заранее, если бот использует несколько доменов в сценарии Mini App.

👉 СОЗДАТЬ ЧАТ-БОТ:

Watbot — визуальный конструктор чат-ботов Визуальный конструктор чат-ботов для Вашего бизнеса. Подойдёт для любой ниши. Соберите готовое решение чат-бота за 10 минут! 300 видеоуроков внутри платформы. Больше 100 шаблонов чат-ботов. Легко научиться собирать. Усиливает продажи и автоматизацию. watbot.ru

НАШЕ СООБЩЕСТВО В МАХ:

MAX – быстрое и легкое приложение для общения и решения пов… MAX позволяет отправлять любые виды сообщений и звонить даже на слабых устройствах и при низкой скорости интернета. max.ru

НАШЕ СООБЩЕСТВО В TELEGRAM:

WATBOT Community Это сообщество предпринимателей и разработчиков чат-ботов на платформе Watbot. @watbotru - наш канал @watbotcase_bot - заказать под ключ @watbotassistant_bot - полезные материалы @helpwatbot - тех. поддержка https://t.me/+8HqKHriFyAk1OWVi - ссылка t.me