Максим
Телеграм бот

ОБЗОР TELEGRAM BOT API 10.1: RICH MESSAGES, GUARD BOTS И ССЫЛКИ В ОПРОСАХ

Telegram выпустил Bot API 10.1 - и это обновление меняет то, как боты общаются с пользователями на самом базовом уровне. Главное нововведение - Rich Messages, принципиально новый формат сообщений с блочной структурой, нативными таблицами, математическими формулами и поддержкой стриминга ИИ-ответов. Разбираем всё по порядку и смотрим, как это применить в чатботах на платформе Watbot.

Rich Messages: новый формат сообщений

До версии 10.1 у ботов был один формат сообщений - обычный текст с ограниченным форматированием. Максимум 4096 символов, базовые теги вроде жирного и курсива, подписи к медиафайлам ещё короче. Этого хватало для большинства задач, но не для полноценных лонгридов, технических статей, гайдов и структурированных отчётов.
Rich Messages меняют это кардинально. Теперь боты могут отправлять полноценные блочные документы - по структуре это ближе к Notion или Telegraph, но прямо внутри чата Telegram.

Лимиты Rich Messages

Сравнение с обычными сообщениями говорит само за себя:
Обычное сообщение - до 4096 символов. Rich Message - до 32 768 символов UTF-8, то есть в 8 раз больше. Помимо этого: до 500 вложенных блоков, до 16 уровней вложенности, до 50 медиавложений внутри одного сообщения, таблицы шириной до 20 колонок.

Форматирование текста: новые типы

Добавлен целый набор классов для форматирования текста внутри Rich Messages. Помимо привычных жирного (RichTextBold), курсива (RichTextItalic), подчёркивания (RichTextUnderline) и зачёркивания (RichTextStrikethrough), теперь доступны:
  • RichTextSpoiler - скрытый текст под спойлером
  • RichTextSubscript и RichTextSuperscript - нижний и верхний индекс
  • RichTextMarked - выделение текста маркером
  • RichTextCode - инлайн-код
  • RichTextMathematicalExpression - математическое выражение в строке
  • RichTextCustomEmoji - кастомные эмодзи внутри текста
  • RichTextDateTime - дата и время с автоматической локализацией
  • RichTextTextMention - упоминание пользователя с текстом
  • RichTextUrl, RichTextEmailAddress, RichTextPhoneNumber, RichTextBankCardNumber - кликабельные ссылки, email, телефоны и номера карт
  • RichTextMention, RichTextHashtag, RichTextCashtag, RichTextBotCommand - упоминания, хештеги, кештеги, команды
  • RichTextAnchor и RichTextAnchorLink - якоря и ссылки на них для навигации по длинному документу
  • RichTextReference и RichTextReferenceLink - сноски и ссылки на них

Блоки Rich Messages

Структурная единица Rich Message - блок (RichBlock). Добавлены следующие типы блоков:
Текстовые и структурные:
  • RichBlockParagraph - абзац
  • RichBlockSectionHeading - заголовок раздела
  • RichBlockPreformatted - блок кода или форматированного текста
  • RichBlockFooter - подвал документа
  • RichBlockDivider - разделитель
  • RichBlockAnchor - якорь для навигации
  • RichBlockCaption - подпись к блоку
Списки и таблицы:
  • RichBlockList и RichBlockListItem - списки, в том числе с чек-боксами
  • RichBlockTable и RichBlockTableCell - нативные таблицы с выравниванием, границами, чередованием строк и объединением ячеек
Цитаты:
  • RichBlockBlockQuotation - блочная цитата
  • RichBlockPullQuotation - выносная цитата
Медиа:
  • RichBlockPhoto - фото
  • RichBlockVideo - видео
  • RichBlockAnimation - анимация
  • RichBlockAudio - аудио
  • RichBlockVoiceNote - голосовое сообщение
  • RichBlockCollage - коллаж из нескольких медиафайлов
  • RichBlockSlideshow - слайдшоу
Специальные:
  • RichBlockMathematicalExpression - блочная математическая формула по центру
  • RichBlockMap - интерактивная карта с координатами прямо в теле сообщения
  • RichBlockDetails - сворачиваемый блок с заголовком (как
    в HTML)
  • RichBlockThinking - блок «размышления» для ИИ-агентов

Новые методы

  • sendRichMessage - отправить Rich Message
  • sendRichMessageDraft - отправить частичное Rich Message с возможностью дописывать блоки в реальном времени (для стриминга ИИ-ответов)
  • Параметр rich_message в методе editMessageText - редактировать Rich Message
Rich Messages также можно использовать как InputRichMessageContent в результатах inline-запросов, гостевых запросов и Web App запросов.

Что это значит на практике

Лонгриды и гайды прямо в боте

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

Нативные таблицы вместо текстовых костылей

Таблицы из моноширинного шрифта на смартфонах всегда превращались в нечитаемую мешанину. Нативные таблицы RichBlockTable отображаются корректно, поддерживают выравнивание, границы, чередование строк и объединение ячеек по горизонтали и вертикали.

Математика без картинок

RichBlockMathematicalExpression и RichTextMathematicalExpression позволяют вставлять LaTeX-формулы напрямую в тело сообщения. Для образовательных ботов, научных каналов и технических отчётов это принципиальное изменение.

Стриминг ИИ-ответов

sendRichMessageDraft создан специально для интеграции с языковыми моделями. Бот отправляет черновик, затем дописывает в него новые блоки по мере генерации ответа. Пользователь видит, как текст появляется плавно - без перерисовки всего сообщения целиком. RichBlockThinking позволяет нативно показывать статус «ИИ думает» прямо в структуре сообщения.

Интерактивная карта в сообщении

RichBlockMap вставляет интерактивную карту с заданными координатами и масштабом прямо в тело Rich Message - без отдельного вложения и без перехода в стороннее приложение.

Сворачиваемые блоки

RichBlockDetails работает как аккордеон: заголовок видно всегда, содержимое скрыто до клика. Идеально для FAQ, дополнительных деталей, длинных логов и любого контента, который нужен не всем.

Guard Bots: капча и модерация вступления через Mini Apps

Проблема, которую решает обновление

Для закрытых групп и каналов всегда стояла задача: как проверить нового участника перед вступлением. Раньше решения были громоздкими - бот-модератор мьютил новичка и ждал нажатия инлайн-кнопки. Выглядело непрезентабельно и обходилось автоматически.

Как работает теперь

Введено официальное понятие Guard Bot. Добавлены новые поля и методы:
  • Поле supports_join_request_queries в объекте User - показывает, поддерживает ли бот обработку запросов на вступление.
  • Поле guard_bot в объекте ChatFullInfo - показывает, какой бот назначен гвардом в этом чате.
  • Поле query_id в объекте ChatJoinRequest - идентификатор запроса на вступление.
  • Метод answerChatJoinRequestQuery - одобрить, отклонить запрос или поместить в очередь.
  • Метод sendChatJoinRequestWebApp - открыть Mini App прямо в процессе обработки заявки.

Что можно реализовать

Вместо примитивной кнопки «Я не робот» теперь можно развернуть перед пользователем полноценное веб-приложение. Варианты применения:
Анимированная капча - визуально корректная проверка, что перед вами человек, а не скрипт.
Анкета премодерации - для закрытых бизнес-клубов, профессиональных сообществ, приватных групп поддержки. Пользователь заполняет форму, бот получает ответы и принимает решение автоматически или передаёт на ручную проверку.
Мини-тест на соответствие - перед входом в тематическое сообщество участник отвечает на несколько вопросов. Прошёл - заявка одобрена. Не прошёл - отклонена или отправлена на пересмотр.
Как только пользователь завершает проверку внутри Mini App, бот одобряет заявку через answerChatJoinRequestQuery.

Обновления опросов

К возможностям опросов из версии 10.0 добавилось ещё одно: медиавложения теперь поддерживают ссылки.
Добавлен класс Link и поле link в объект PollMedia. Добавлен класс InputMediaLink, который можно использовать как InputPollOptionMedia.
Это значит, что в качестве медиа к варианту ответа в опросе теперь можно прикреплять ссылку - не только фото, стикер или геолокацию. Полезно для опросов с внешними источниками, ссылками на товары, статьи или страницы.

Как использовать в Watbot

1. Контентные боты и образование. Rich Messages открывают возможность отправлять структурированные учебные материалы прямо в диалоге: с заголовками, таблицами, формулами и встроенными медиафайлами. Больше не нужно дробить гайд на 10 отдельных сообщений или отправлять PDF.
2. Авторассылки с богатым форматированием. Авторассылки в сочетании с Rich Messages позволят делать информационные письма внутри Telegram с полноценной версткой - заголовки, разделители, коллажи из фото, карты и сворачиваемые блоки с деталями.
3. Закрытые сообщества. Guard Bots - это готовая база для автоматизированной модерации вступления. В сочетании с встроенной CRM Watbot данные из анкеты при вступлении можно автоматически сохранять в карточку контакта и сегментировать аудиторию.
4. ИИ-боты. sendRichMessageDraft и RichBlockThinking - это нативная инфраструктура для ботов с языковыми моделями. Ответ генерируется и появляется у пользователя блок за блоком, без задержки и без перерисовки.

Практические сценарии

- Онлайн-школа. Урок в формате Rich Message: заголовок темы, текст с примерами, блок кода, таблица с данными, математические формулы, встроенное видео-объяснение и сворачиваемый блок с дополнительными материалами. Всё в одном сообщении.
- Закрытый бизнес-клуб. Пользователь подаёт заявку на вступление - Guard Bot открывает Mini App с анкетой. Ответил на 5 вопросов о роде деятельности и опыте - бот автоматически одобряет подходящих и отправляет остальных на ручную проверку.
- ИИ-ассистент для бизнеса. Пользователь задаёт вопрос боту с подключённой языковой моделью. Бот сначала показывает RichBlockThinking, затем поблочно дописывает ответ в реальном времени - с заголовками, списками и кодом, если нужно.
- Каталог товаров. Карточка товара как Rich Message: фото в коллаже, описание с заголовками, таблица характеристик, интерактивная карта ближайшего магазина и кнопка заказа - всё в одном структурированном сообщении.

Совместимость

Обычные сообщения (Regular Messages) никуда не исчезают и работают как прежде. Rich Messages - это дополнительный формат, а не замена. Боты, не использующие новые возможности, продолжат работать без изменений.
Пользователи с устаревшими версиями Telegram могут видеть Rich Messages в упрощённом виде - без части блочного форматирования.

Выводы

Bot API 10.1 добавляет в Telegram то, чего давно не хватало для серьёзного контента: полноценный блочный формат сообщений с нативными таблицами, формулами, медиаколлажами, интерактивными картами и навигацией по якорям. Guard Bots дают инструмент для цивилизованной модерации вступления в закрытые сообщества. Поддержка стриминга через sendRichMessageDraft делает Rich Messages готовым форматом для ИИ-агентов прямо из коробки.
Для тех, кто строит информационных ботов, образовательные платформы или закрытые сообщества на базе Telegram - это один из самых значимых релизов за всю историю Bot API.
👉 СОЗДАТЬ ЧАТ-БОТ:
Watbot — визуальный конструктор чат-ботов Визуальный конструктор чат-ботов для Вашего бизнеса. Подойдёт для любой ниши. Соберите готовое решение чат-бота за 10 минут! 300 видеоуроков внутри платформы. Больше 100 шаблонов чат-ботов. Легко научиться собирать. Усиливает продажи и автоматизацию. watbot.ru
НАШЕ СООБЩЕСТВО В МАХ:
MAX – быстрое и легкое приложение для общения и решения пов… MAX позволяет отправлять любые виды сообщений и звонить даже на слабых устройствах и при низкой скорости интернета. max.ru