Telegram Bot API 9.3: Революция в ИИ-чатах

Всем привет!

Прямо в канун Нового года — а именно 31 декабря — Telegram представил крупное обновление Bot API 9.3. И не просто представил, а громко заявил: «Революция ИИ в чатах».

И, если пробежаться по списку изменений, масштаб обновления для ботов действительно ощущается — особенно в проектах, где используется ИИ. Давайте вместе пройдёмся по чейнджлогу и посмотрим, что Telegram приготовил нам в подарок на Новый год.

Если вам интересны подобные материалы, подписывайтесь на Telegram-канал «Код на салфетке». Там я делюсь гайдами для новичков, полезными инструментами и новостями. А прямо сейчас у нас там ещё и проходит новогодний розыгрыш.

Темы в чатах с ботом

Главным нововведением стало добавление функциональности «Тем» в чаты с ботами. Они уже могут быть вам знакомы по супергруппам.

Теперь боты могут создавать и редактировать темы (если администратор заранее не задал фиксированный набор). Предполагается, что это будет активно использоваться в связке с ИИ — для тематического разделения диалогов. Темы поддерживают весь функционал обычных сообщений: отправку, пересылку и различные действия. Единственное отличие — теперь нужно дополнительно передавать идентификатор темы.

Ещё одно важное нововведение — возможность «стримить» сообщения, ровно так же, как это делают ИИ-модели при генерации ответа. Раньше, чтобы добиться подобного эффекта, приходилось городить костыли из последовательных редактирований сообщений с учётом таймаутов Telegram. Теперь же для этого появился отдельный метод — sendMessageDraft.

Обратите внимание: режим «стриминга» работает только при включённых темах.

Изменения:

Добавлено поле has_topics_enabled в класс User, которое позволяет определить, включён ли для бота режим тем в личных чатах.
Добавлен метод sendMessageDraft, позволяющий по мере генерации передавать пользователю частичные сообщения.
Добавлена поддержка полей message_thread_id и is_topic_message в классе Message для сообщений в личных чатах с включённым режимом тем.
Добавлена поддержка параметра message_thread_id в личных чатах с темами в методах sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, sendMediaGroup, copyMessage, copyMessages, forwardMessage и forwardMessages, что позволяет ботам отправлять сообщения в конкретную тему.
Добавлена поддержка параметра message_thread_id в личных чатах в методе sendChatAction, что позволяет ботам отправлять действия чата в конкретную тему в личных чатах.
Добавлена поддержка параметра message_thread_id в личных чатах с темами в методах editForumTopic, deleteForumTopic и unpinAllForumTopicMessages, что позволяет ботам управлять темами в личных чатах.
Добавлено поле is_name_implicit в классы ForumTopic и ForumTopicCreated.

Подарки

Я не особо интересуюсь подарками в Telegram, поэтому не могу объективно оценить важность связанных с ними обновлений. Предлагаю вам самостоятельно сделать выводы — пишите своё мнение в комментариях.

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

Также появилась возможность для ботов получать список всех подарков пользователя с использованием различных фильтров.

Изменения:

Добавлены методы getUserGifts и getChatGifts.
Поле last_resale_star_count в классе UniqueGiftInfo заменено на поля last_resale_currency и last_resale_amount.
Параметр exclude_limited в методе getBusinessAccountGifts заменён на параметры exclude_limited_upgradable и exclude_limited_non_upgradable.
Добавлено значение "gifted_upgrade" как возможное значение UniqueGiftInfo.origin для сообщений об апгрейде подарка, который был куплен после его отправки.
Добавлено значение "offer" как возможное значение UniqueGiftInfo.origin для сообщений о покупке подарка через предложение о покупке.
В класс Message добавлено поле gift_upgrade_sent.
В класс UniqueGift добавлено поле gift_id.
В класс UniqueGift добавлено поле is_from_blockchain.
В метод getBusinessAccountGifts добавлен параметр exclude_from_blockchain, позволяющий отфильтровывать подарки, назначенные из блокчейна TON.
В класс Gift добавлены поля personal_total_count и personal_remaining_count.
В классы Gift и UniqueGift добавлено поле is_premium.
В классы GiftInfo и OwnedGiftRegular добавлено поле is_upgrade_separate.
Добавлен класс UniqueGiftColors, описывающий цветовую схему имени пользователя, ответов на сообщения и превью ссылок на основе уникального подарка.
В класс Gift добавлено поле has_colors.
В класс UniqueGift добавлено поле colors.
Добавлен класс GiftBackground, а в класс Gift — поле background.
В класс Gift добавлено поле unique_gift_variant_count.
В классы GiftInfo и OwnedGiftRegular добавлено поле unique_gift_number.
В класс AcceptedGiftTypes добавлено поле gifts_from_channels.

Другие изменения

Помимо этого, в обновление вошло несколько общих изменений, затрагивающих бизнес-аккаунты, управление правами и рейтинг пользователей.

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

Если у бота, помимо основного username, есть дополнительные (приобретённые на Fragment), теперь можно полностью скрыть основной username.

Расширены возможности управления правами администратора в каналах. Теперь бот может управлять разрешением can_restrict_members. Это особенно полезно в сценариях, когда администраторов назначает бот и требуется выдавать минимально необходимые права.

Также боты теперь могут видеть рейтинг пользователя в Telegram. Рейтинг — это относительно новое понятие, которое отражает активность пользователя, связанную с покупкой и отправкой подарков.

Изменения:

Ботам разрешено отключать свой основной username, если у них есть дополнительные активные username, приобретённые через Fragment.
Ботам разрешено отключать право can_restrict_members в канальных чатах.
Добавлен метод repostStory, позволяющий ботам репостить сторис между разными бизнес-аккаунтами, которыми они управляют.
Добавлен класс UserRating, а в класс ChatFullInfo — поле rating.
Максимальная цена платных медиа увеличена до 25 000 Telegram Stars.
В класс ChatFullInfo добавлено поле paid_message_star_count.
В методы forwardMessage и copyMessage добавлен параметр message_effect_id.
В класс ChatFullInfo добавлено поле unique_gift_colors.
В класс ChecklistTask добавлено поле completed_by_chat.

Заключение

Telegram продолжает радовать интересными и местами неожиданными обновлениями. Поддержка тем в чатах с ботами и «стриминг» сообщений действительно способны заметно расширить пользовательский опыт при работе с ИИ-ботами. В то же время акцент на подарки, на мой взгляд, выглядит скорее как «баловство».

Это было последнее обновление в 2025 году. Интересно, что Telegram приготовит дальше? Возможно, наконец расширят возможности форматирования сообщений. Будем посмотреть.