Telegram Bot API 10.3: Rich Messages для AI-ботов и бизнеса

24 августа 2026 года Telegram выпустил Bot API 10.3. Главная линия обновления — дальнейшее развитие Rich Messages: появились отдельные классы кнопок, компактный режим таблиц, сворачиваемые цитаты и блоки документов.

Для разработчика это не просто новые названия в API. Rich Messages позволяют собирать ответ из структурированных блоков и делать интерфейс бота ближе к небольшой интерактивной странице прямо внутри диалога. Особенно интересно это для AI-ассистентов, поддержки, каталогов, инструкций и внутренних бизнес-ботов.

Разберём только подтверждённые возможности из официальной документации Telegram Bot API и посмотрим, где они действительно полезны.

Что нового в Telegram Bot API 10.3

В changelog Telegram эти изменения перечислены именно для версии 10.3. Обновление продолжает Rich Messages, которые расширялись и в предыдущих версиях Bot API.

RichMessageButton: действие внутри структурированного ответа

Класс RichMessageButton представляет кнопку в Rich Message. Для бизнес-сценария это важно тем, что действие можно логически привязать к блоку контента, а не выводить всё управление отдельной клавиатурой после длинного сообщения.

Например, AI-бот подобрал три услуги. Каждая секция может содержать описание, цену или условия и связанное действие: открыть подробности, оставить заявку, передать диалог сотруднику. Интерфейс становится понятнее, если клиенту не приходится сопоставлять «вариант №2» с кнопкой в другом месте сообщения.

RichTextButton и группы кнопок

Bot API 10.3 добавил RichTextButton, а также RichBlockButtons и входной вариант InputRichBlockButtons. Это даёт разработчику отдельные элементы для формирования блока действий внутри rich-сообщения.

Но обычные inline keyboard никуда не исчезают. Если бот уже стабильно работает на InlineKeyboardMarkup, переписывать весь интерфейс ради новой версии API не требуется. Rich Messages стоит применять там, где структурированный ответ реально улучшает сценарий.

Компактные таблицы

В RichBlockTable и InputRichBlockTable появился флаг is_compact. Таблица — один из самых полезных форматов для бизнес-бота, потому что многие ответы по природе табличные: остатки, цены, тарифы, статусы заказов, расписание, сравнение вариантов.

AI-модель может вернуть данные в JSON, а приложение уже само валидирует структуру и формирует rich-таблицу. Лучше не позволять модели напрямую собирать произвольный payload Bot API: промежуточный слой должен проверять типы, длину и допустимые действия.

Сворачиваемые цитаты

RichBlockExpandableBlockQuotation и InputRichBlockExpandableBlockQuotation позволяют показывать блок цитаты, который пользователь может раскрыть и снова свернуть. Это полезно, когда основной ответ должен оставаться коротким, но у пользователя есть возможность открыть подробности.

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

Документы внутри Rich Messages

Версия 10.3 добавила RichBlockDocument и InputRichBlockDocument. Для бизнеса это открывает аккуратные сценарии, где файл является частью ответа: бот объясняет действие, прикладывает документ и сразу предлагает следующий шаг.

Примеры: инструкция после оплаты, PDF с условиями, сформированный отчёт, техническое задание, памятка сотруднику. Перед отправкой документов нужно проверять права доступа: бот не должен выдавать приватный файл только потому, что пользователь угадал идентификатор.

Что это меняет для AI-ботов

Главное изменение — можно разделить генерацию смысла и представление. Модель решает, какие данные нужны пользователю, а код приложения превращает проверенный результат в Rich Message.

1. Пользователь задаёт вопрос.
2. Бэкенд получает контекст из CRM, базы знаний или каталога.
3. AI возвращает структурированный результат по заданной схеме.
4. Код валидирует данные и выбирает допустимые кнопки.
5. Telegram получает Rich Message с текстом, таблицей, документом или действиями.

Такой подход безопаснее, чем разрешать модели самостоятельно выбирать произвольные URL, callback_data и документы. Все действия с последствиями должны проходить через серверные правила.

Пример для поддержки

Клиент спрашивает статус заказа. Бот находит заказ в CRM, формирует короткое резюме, выводит компактную таблицу с номером, статусом и датой, а ниже предлагает допустимые действия. Если есть инструкция по получению, её можно показать отдельным разворачиваемым блоком или документом.

Если вопрос выходит за рамки автоматического сценария, кнопка переводит диалог оператору. AI в такой архитектуре не заменяет бизнес-логику, а помогает интерпретировать запрос и формировать понятный ответ.

Пример для каталога

Вместо пяти отдельных сообщений бот может сформировать структурированный ответ: заголовок подборки, несколько вариантов, таблицу ключевых характеристик и действия. При этом остаток и цена должны приходить из рабочей базы или API, а не придумыватьcя моделью.

Для подобных проектов полезно заранее разделять контент, состояние диалога и данные каталога. Это упрощает переход между Telegram, VK, сайтом и CRM, если бизнес использует несколько каналов.

Нужно ли срочно обновлять существующего бота

Нет, если текущий интерфейс решает задачу. Bot API сохраняет привычные методы, а Rich Messages — дополнительный инструмент. Обновление имеет смысл, когда длинные ответы стали неудобными, требуется показать структурированные данные или хочется сделать действия более контекстными.

Что проверить перед внедрением

• Поддерживает ли используемая библиотека нужные классы Bot API 10.3.
• Есть ли fallback для клиентов или сценариев, где rich-представление не подходит.
• Валидируется ли результат AI перед отправкой.
• Не попадают ли токены и персональные данные в логи.
• Проверяются ли права доступа к документам.
• Идемпотентны ли callback-действия, создающие заявки или заказы.
• Есть ли перевод на оператора при неопределённости.

Когда Rich Messages подходят

Используйте их для структурированных инструкций, сравнений, статусов, AI-ответов с дополнительными деталями, документов и интерфейсов, где действие должно находиться рядом с соответствующим контентом.

Когда лучше оставить обычные сообщения

Если бот отвечает одной-двумя строками, принимает простую команду или использует устойчивую inline-клавиатуру, Rich Messages могут только усложнить код. Формат должен решать пользовательскую проблему, а не демонстрировать новую возможность API.

Итог

Telegram Bot API 10.3 развивает Rich Messages в сторону полноценного структурированного интерфейса: новые кнопки, группы действий, компактные таблицы, сворачиваемые цитаты и документы. Для AI-ботов это особенно полезно, потому что ответ можно собирать из проверенных блоков вместо одного большого текста.

Если нужен Telegram-бот, который работает с CRM, каталогом, AI или внутренней базой, архитектуру лучше проектировать вокруг данных и бизнес-правил, а интерфейс Bot API выбирать уже поверх них. Посмотреть направление можно на странице автоматизации бизнес-процессов, а задачу обсудить через контакты A.S Groups.

FAQ

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

Официальный changelog Telegram датирует Bot API 10.3 24 августа 2026 года.

Что главное в версии 10.3?

Продолжение Rich Messages: новые классы кнопок, блок кнопок, компактный режим таблиц, сворачиваемые цитаты и блоки документов.

Нужно ли переделывать inline keyboard?

Нет. Новые rich-элементы дополняют существующие механизмы. Переписывать рабочий интерфейс без пользовательской причины не нужно.

Можно ли использовать Rich Messages с AI?

Да. Надёжнее всего получать от модели структурированный результат, валидировать его на сервере и только затем формировать допустимые Rich Messages и действия.