Гайд July 30, 2026

Чек-лист обновления Telegram Bot API 10.2: медиа в Rich Messages, редактирование Ephemeral и Communities

Telegram выпустил Bot API 10.2 14 июля 2026 года, и объём изменений здесь больше, чем предполагает номер версии. Rich Messages получили медиа и блочные конструкторы, ephemeral-сообщения обрели полный набор методов редактирования и удаления, а Communities добавили новую топологию, которую нужно хранить. Для команды, работающей с несколькими платформами, безопасный путь — пройти чек-лист до деплоя: зафиксировать версию, мигрировать затронутые методы и оставить нормализацию входящих на едином webhook, прежде чем трогать production-бота.

Ключевые выводы

10.2 выпущен 14 июля 2026 года: добавлены media в rich message, полный набор конструкторов InputRichBlock*, методы редактирования/удаления ephemeral и сообщения жизненного цикла Communities — всё это задокументировано на core.telegram.org.
Три почти breaking-изменения требуют ревью кода: новые поля media/blocks в InputRichMessage, параметры receiver_user_id/ephemeral_message_id во многих методах send*, а также типы сообщений community_chat_added/community_chat_removed.
Rich Messages в официальном Bot API — только для исходящих. Входящие от пользователей по-прежнему приходят как обычный текст/markdown — ваш inbound-конвейер не обязан разбирать rich-блоки, если только вы сами не строите богатый UI.
Communities добавляют состояние маршрутизации, а не слияние сообщений. Community связывает несколько supergroup, channel и bot; сообщения по-прежнему принадлежат исходному chat ID и маршрутизируются по чатам.
Делайте апгрейд за фича-флагом и убедитесь, что ваша Bot API-библиотека выпустила совместимый с 10.2 релиз, прежде чем направлять на него production-трафик.

Что реально меняет Bot API 10.2

Ниже — дословные дополнения из официального changelog Bot API, сгруппированные по областям, которые команде реально предстоит трогать.

Rich Messages: медиа и блочные конструкторы

В 10.1 появились Rich Messages — структурированный, пригодный для стриминга AI форматированный текст. 10.2 делает их пригодными для реального контента:

Добавлены класс InputRichMessageMedia и поле media в InputRichMessage, чтобы бот мог «явно указать медиа, используемое в форматировании markdown или html при отправке rich message».
Добавлен класс InputMediaVoiceNote.
Добавлены InputRichBlockListItem и полный набор входных блочных классов: InputRichBlockParagraph, InputRichBlockSectionHeading, InputRichBlockPreformatted, InputRichBlockFooter, InputRichBlockDivider, InputRichBlockMathematicalExpression, InputRichBlockAnchor, InputRichBlockList, InputRichBlockBlockQuotation, InputRichBlockPullQuotation, InputRichBlockCollage, InputRichBlockSlideshow, InputRichBlockTable, InputRichBlockDetails, InputRichBlockMap, InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote, InputRichBlockThinking.
Добавлено поле blocks в InputRichMessage, позволяющее «задать форматирование rich message через блочные сущности».

Практический итог: если 10.1 позволял rich message отправлять, то 10.2 позволяет собирать его из типизированных блоков и прикреплять медиа. Любой код, где InputRichMessage строится литералом, стоит перепроверить — после обновления библиотеки она может ожидать blocks, а не инлайн-строку.

Ephemeral-сообщения: полный цикл редактирования/удаления

Ephemeral-сообщения (групповые сообщения, видимые только одному пользователю и боту) тоже появились раньше, но 10.2 завершает набор методов:

Добавлено is_ephemeral в BotCommand.
Добавлены receiver_user и ephemeral_message_id в класс Message.
Добавлены параметры receiver_user_id и callback_query_id в sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation, sendVenue.
Добавлен ephemeral_message_id в ReplyParameters (а message_id стал опциональным при его наличии).
Добавлены editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup и deleteEphemeralMessage.

Если ваш бот поддержки сейчас может отправить приватный ответ в группе, но не может его отредактировать, 10.2 — то обновление, которое закрывает этот пробел. По-прежнему требуются права администратора группы — см. руководство по ephemeral-сообщениям.

Communities: новые типы сообщений

Communities — это «несколько supergroup, channel и bot, связанных общей темой или аудиторией». Для потребителей webhook ключевые добавления:

Класс Community.
Классы сообщений CommunityChatAdded и CommunityChatRemoved, а также их поля в Message.
Поле community в ChatFullInfo.

Эти сообщения жизненного цикла — тот же интерфейс, что описан в руководстве по обработке событий Communities. Для чек-листа правило проще: если ваш switch ориентируется на message.text и проваливается в default на неизвестных типах, то community_chat_added/community_chat_removed тихо попадут в default-ветку. Обрабатывайте их явно, чтобы фиксировать изменения топологии Community.

Прочее

Добавлен BotSubscriptionUpdated (и поле subscription в Update) для изменений платёжной подписки пользователя.
Усилена безопасность Mini App: вызовы методов из разных origin запрещены, автоматическое включение — с 20 июля 2026 года (opt-out в BotFather).

Чек-лист обновления

Пройдите эти пункты до того, как направите трафик на бота 10.2.

№	Действие	Почему это важно
1	Зафиксируйте Bot API-библиотеку на совместимой с 10.2 версии (например, `Telegram.BotAPI 10.2.0` для .NET)	Нетипизированные или старые клиенты игнорируют новые поля и молча отправляют ухудшенные сообщения
2	Аудит всех конструкций `sendRichMessage` / `InputRichMessage`	Новые поля `media` и `blocks` меняют способ сборки rich message
3	Добавьте `community_chat_added` / `community_chat_removed` в обработчик сообщений	Неизвестные типы попадают в default-ветку и теряются
4	Решите, принимать ли новые методы редактирования/удаления ephemeral	Позволяет боту поддержки править приватный ответ без повторной отправки
5	Сохраняйте `community` из `ChatFullInfo` в метаданных чата	Нужно для рассуждений о топологии Community в будущем
6	Протестируйте обработку origin в Mini App до 20 июля 2026 года	С этой даты кросс-origin вызовы начинают блокироваться
7	Держите нормализацию входящих на едином webhook	Rich-блоки только исходящие; inbound по-прежнему приходит как текст

Что 10.2 не меняет для inbound-команд

Самое важное «неизменное»: входящие сообщения от пользователей по-прежнему приходят как обычный текст. Когда пользователь печатает в чате Telegram, на вашей стороне объект RichMessage не возникает — Rich Messages это исходящая возможность бота. Это тот же вывод, что и в анализе Bot API 10.1: задача inbound — кросс-платформенная нормализация формата, а не разбор rich-блоков.

Иными словами, команде, чья цель — приём и маршрутизация сообщений, не нужно переписывать inbound-парсер ради 10.2. Обновление касается того, что ваш бот отправляет обратно.

Как вписывается UnifyPort

UnifyPort доставляет входящие сообщения Telegram (наряду с WhatsApp, LINE, X, Zalo и TikTok) как единый нормализованный поток событий message.received, поэтому inbound-часть апгрейда 10.2 — приём сообщения пользователя, проверка подписи HMAC-SHA256, маршрутизация по разговору — остаётся неизменной вне зависимости от версии Bot API.

Каталог событий webhook стабилен: message.received, message.updated, message.deleted, message.read, message.reaction, плюс события жизненного цикла разговоров и аккаунтов. Каждая доставка несёт X-Device-Event-Id, X-Device-Delivery-Id, X-Device-Timestamp и hex-кодированную X-Device-Signature (HMAC-SHA256 от "<таймстемп>" + "." + "<сырое тело>"), когда у endpoint задан signing_secret. Вы проверяете подпись по сыросту телу, парсите JSON и ветвитесь по event.type — точная процедура описана в руководстве по доставке и подписям webhook.

Если цель апгрейда — чисто кросс-платформенная надёжность inbound, трогать официальный Bot API вообще не нужно. Если вы заодно хотите отправлять rich- или ephemeral-ответы из собственного кода Telegram-бота, там и применяются изменения 10.2. Авторизация Telegram в UnifyPort — Telegram authorization — описывает поток api_id / api_hash / номера телефона, необходимый для подключения аккаунта.

Ограничения и компромиссы

Rich Messages требуют совместимого клиента. На очень старых клиентах Telegram rich-блоки могут не отображаться; предусмотрите запасной вариант в виде обычного текста.
Ephemeral-сообщения требуют прав администратора группы и доходят только до одного пользователя — это не инструмент для рассылки.
Communities — новая и развивающаяся функция. Не предполагайте, что агрегация сообщений на уровне Community существует уже сегодня; маршрутизируйте по chat ID и сохраняйте топологию по мере поступления.
Официальный Bot API по-прежнему одна платформа. Если команда также обрабатывает inbound для WhatsApp, LINE или X, переход на 10.2 решает только сторону Telegram — кросс-платформенную задачу inbound нужно решать отдельно.

Часто задаваемые вопросы

Когда вышел Bot API 10.2?

Telegram выпустил Bot API 10.2 14 июля 2026 года согласно официальному changelog на core.telegram.org/bots/api-changelog. Ключевые добавления — медиа и блочные конструкторы Rich Message, полный набор методов редактирования/удаления ephemeral и Communities.

Нужно ли обновляться немедленно?

Нет дедлайна, обязывающего обновлять функцию приёма. Единственный ограниченный сроком пункт — принудительная проверка origin в Mini App с 20 июля 2026 года; если вы используете Mini App, проверьте кросс-origin поведение до этой даты.

Изменится ли формат входящих сообщений после 10.2?

Нет. Rich Messages — исходящая возможность бота. Входящие от пользователей по-прежнему приходят как обычный текст или markdown, поэтому вашему inbound-парсеру не нужна поддержка rich-блоков.

Communities — это то же самое, что групповые чаты?

Нет. Community — это набор связанных supergroup, channel и bot. Сообщения по-прежнему принадлежат исходному чату, и вы маршрутизируете и храните их по chat ID. Новые типы сообщений community_chat_added и community_chat_removed служат для отслеживания изменений топологии.

Может ли UnifyPort принимать события жизненного цикла Telegram Community?

UnifyPort доставляет inbound Telegram как нормализованные события message.* и события жизненного цикла через единый webhook. Для событий топологии, специфичных для Community, действуйте так же, как описано в руководстве по событиям Communities — сохраняйте поля service-message и сверяйтесь с getChat.

Следующий шаг

Просмотрите каталог событий webhook, чтобы убедиться, что ваш inbound-обработчик покрывает стандартные события message.*: см. справочник provider message support.
Если вы подключаете аккаунт Telegram впервые, Quickstart проведёт вас через отправку и приём первого сообщения.

Источники

Changelog Telegram Bot API (официальный): https://core.telegram.org/bots/api-changelog — Bot API 10.2, 14.07.2026. Проверено 30.07.2026.
Справочник Telegram Bot API (официальный): https://core.telegram.org/bots/api. Проверено 30.07.2026.