Telegram выпустил Bot API 10.2 14 июля 2026 года. Релиз позволяет ботам показывать отдельные команды и ответы внутри группы только выбранному пользователю, вводит базовую поддержку Communities, расширяет Rich Messages и готовит обязательную доменную защиту Mini Apps с 20 июля.
Ephemeral Messages скрывают команды и ответы от остальных участников группы
Ключевым изменением Bot API 10.2 стали Ephemeral Messages — сообщения внутри группового чата, которые видят выбранный пользователь и отправивший их бот. Telegram описывает новый механизм в официальном changelog и в отдельном разделе документации о возможностях ботов.
Бот может отправить приватный ответ прямо в группе через привычные методы: sendMessage, sendPhoto, sendVideo, sendDocument, sendVoice, sendLocation и другие. Для адресации появились параметры receiver_user_id и callback_query_id. Полученное сообщение содержит отдельный ephemeral_message_id, а обычный message_id для такого объекта равен нулю.
Telegram добавил отдельные методы для дальнейшей работы с приватным сообщением:
editEphemeralMessageTextменяет текст;editEphemeralMessageMediaзаменяет медиафайл;editEphemeralMessageCaptionредактирует подпись;editEphemeralMessageReplyMarkupобновляет кнопки;deleteEphemeralMessageудаляет сообщение до истечения срока его показа.
Приватными могут быть фотографии, видео, документы, аудио, голосовые сообщения, стикеры, контакты, геопозиции и места. Команды тоже получили флаг is_ephemeral: сообщение пользователя с такой командой остаётся скрытым от других участников и сторонних ботов.
| Сценарий | Практический результат |
| Настройка уведомлений в группе | Бот показывает переключатели одному пользователю, не засоряя общий чат |
| Модерация | Участник получает персональное предупреждение рядом с обсуждением |
| Заказ или заявка | Статус и служебные данные остаются видимыми адресату |
| Помощник на базе ИИ | Бот выдаёт персональную сводку внутри текущего разговора |
| Приветствие нового участника | Подсказки появляются в группе без серии публичных сообщений |
У редактирования есть ограничение: Telegram предупреждает, что офлайн-пользователь может не получить событие об изменении ephemeral-сообщения. Для критичных данных лучше отправлять завершённый ответ сразу либо предусматривать повторное получение состояния через кнопку.
Communities связывают супергруппы, каналы и ботов общей структурой
Bot API 10.2 получил начальную поддержку Communities — объединений из нескольких супергрупп, каналов и ботов, связанных общей темой или аудиторией. Объект Community пока содержит два поля: числовой идентификатор id и название name.
В ChatFullInfo появилось поле community, по которому бот может определить принадлежность чата к такому объединению. Сервисные события community_chat_added и community_chat_removed сообщают о добавлении или удалении чата. Разработчик может обновлять локальную структуру доступа, навигацию, статистику или правила автоматизации сразу после изменения состава Community.
В опубликованной документации Community пока представлена как объект для чтения и отслеживания событий. Методы создания, редактирования и административного управления объединениями в changelog Bot API 10.2 не перечислены. Возможность выглядит как фундамент для более крупных пространств Telegram, где каналы, обсуждения и сервисные боты работают в одной логической системе.
Rich Messages получили вложенные медиа и блочное описание исходящих сообщений
В Bot API 10.1 Telegram представил Rich Messages с таблицами, формулами, цитатами, коллажами и потоковой выдачей текста. Версия 10.2 расширила именно отправку такого контента: класс InputRichMessage теперь принимает поле blocks и список media.
Разработчик выбирает один из трёх способов описания сообщения:
- HTML-разметка в поле
html; - Markdown-разметка в поле
markdown; - массив типизированных блоков в поле
blocks.
Для блочного варианта добавлены входные классы параграфов, заголовков, списков, цитат, таблиц, раскрывающихся секций, карт, коллажей, слайд-шоу, фотографий, видео, аудио и блока InputRichBlockThinking. Появился InputMediaVoiceNote, поэтому в состав сложного сообщения можно включать голосовые заметки.
Медиа, используемые внутри HTML или Markdown, передаются через InputRichMessageMedia. В тексте они связываются с вложениями адресами вида tg://photo?id=..., tg://video?id=... и tg://audio?id=.... Такой механизм подходит для отчётов, обучающих материалов, карточек товаров и ответов ИИ, где текст, таблица, формула и иллюстрация должны находиться в одном структурированном сообщении.
Mini Apps ограничат вызовы Telegram исходным доменом с 20 июля
Bot API 10.2 усиливает защиту Mini Apps от вызовов с посторонних сайтов. С 20 июля 2026 года Telegram автоматически запретит использование методов Mini App со страниц, чей origin отличается от исходного домена приложения. Под origin понимается сочетание протокола, домена и порта страницы.
Изменение затронет проекты, которые открывают интерфейс на нескольких доменах, передают управление внешней странице или выполняют часть сценария во встроенном окне с другого origin. Такие цепочки стоит проверить до 20 июля: вызов Telegram WebApp API после перехода на сторонний домен может перестать работать.
Защиту разрешено отключить через Mini App в @BotFather. Telegram отдельно указывает, что при отключении разработчик принимает на себя ответственность за ссылки на недоверенные сайты. Для большинства проектов сохранение автоматической проверки снижает риск, что внешняя страница получит доступ к функциям Mini App в чужом контексте.
События подписок сообщают об отмене, восстановлении и сбое платежа
В объекте Update появилось поле subscription с данными BotSubscriptionUpdated. Бот получает пользователя, собственный invoice_payload и новое состояние подписки:
| Состояние | Событие |
canceled | Пользователь отменил подписку |
active | Пользователь повторно активировал ранее отменённую подписку |
failed | Очередной платёж завершился ошибкой |
Сервис может синхронизировать доступ к платным функциям сразу после изменения состояния подписки. Проектам с явно заданным списком allowed_updates потребуется добавить тип subscription, чтобы Telegram присылал такие обновления через webhook или getUpdates.
Bot API 10.2 меняет групповые сервисы и правила работы Mini Apps
Ephemeral Messages дают ботам отдельный приватный слой прямо внутри группового разговора. Communities добавляют идентификатор общей структуры для связанных чатов, а Rich Messages теперь можно собирать из типизированных исходящих блоков и встроенных медиа.
Самая близкая обязательная дата связана с Mini Apps: доменная защита включится 20 июля 2026 года. У Communities пока доступен начальный набор объектов и событий, поэтому дальнейшие возможности управления будут зависеть от следующих обновлений Telegram.
