22 ноября 2026 года Telegram выпустил Bot API 10.5. Разработчики получили возможность менять настройки бота программно, управлять форматом callback-запросов, приглашать пользователей в личные чаты с ботом и использовать более сложные раскрываемые цитаты.

Настройки бота теперь можно менять напрямую через API
Главное нововведение версии 10.5 — метод setMySettings. Он позволяет изменять параметры бота из программы, в том числе настройки, которые раньше обычно задавали через BotFather. Это удобно для сервисов, запускающих ботов автоматически, и для проектов, где конфигурация меняется в зависимости от задач.
Метод поддерживает несколько групп параметров:
| Возможность | Параметры | Для чего применяется |
| Inline-режим | supports_inline_queries, inline_query_placeholder, needs_inline_query_location, inline_feedback_share_denominator | Поиск через упоминание бота в других чатах, подсказка в строке ввода, запрос геопозиции и сбор статистики выбранных результатов |
| Работа в группах | can_join_groups, can_read_all_group_messages | Разрешение на добавление в группы и управление режимом приватности |
| Бизнес-функции и управление ботами | can_connect_to_business, can_manage_bots | Подключение к бизнес-аккаунтам и создание управляемых ботов |
| Взаимодействие и доступ | supports_guest_queries, supports_join_request_queries, can_communicate_with_bots | Гостевые запросы, обработка заявок на вступление и взаимодействие между ботами |
| Темы в личной переписке | has_topics_enabled, allows_users_to_create_topics, has_topic_sidebar | Управление тематическими ветками и их отображением |
| Кнопки | callback_query_mode | Выбор формата ответа на нажатие callback-кнопки |
Например, включение тематических веток и боковой панели выглядит так:
curl -X POST "https://api.telegram.org/bot<TOKEN>/setMySettings" \
-H "Content-Type: application/json" \
-d '{"has_topics_enabled":true,"has_topic_sidebar":true}'<TOKEN> здесь обозначает токен конкретного бота. Метод возвращает true при успешном изменении настроек; параметры, которые отсутствуют в запросе, сохраняют прежние значения. При управлении приватностью нужно учитывать смысл can_read_all_group_messages: значение true отключает privacy mode и разрешает боту читать все групповые сообщения, доступные в рамках правил Telegram.
Callback-кнопки получили три режима обработки нажатий
До обновления обработчики обычно опирались на поле message в объекте CallbackQuery для кнопок сообщений, отправленных самим ботом. Теперь через callback_query_mode можно управлять тем, какое поле приходит вместе с событием нажатия.
| Режим | Что получает бот |
default | Поле message; если сообщение недоступно, в нём может находиться объект InaccessibleMessage |
auto | Поле inline_message_id, когда исходное сообщение недоступно; сразу после удаления сообщения всё ещё возможен InaccessibleMessage |
inline | Поле inline_message_id для callback-кнопок в сообщениях, отправленных самим ботом |
Название режима inline здесь относится к формату идентификатора сообщения. Для обработчика это существенная разница: при таком режиме информация callback_query.message.chat.id может отсутствовать. Код, который всегда обращается к message, потребуется адаптировать к работе с inline_message_id.
Режимы особенно полезны для интерфейсов с кнопками, где сообщения могут удаляться или становиться недоступными. В документации отдельно описано, какие данные возвращаются в каждом случае.
Темы в личных чатах получили боковую панель
Telegram ранее добавил тематические ветки в переписку пользователя с ботом. Версия 10.5 расширяет их отображение: параметр has_topic_sidebar включает список тем в боковой панели личного чата.
Например, бот поддержки может использовать отдельные темы для обращений по оплате, доставке и техническим вопросам. Пользователь получает дополнительный способ переходить между такими обсуждениями, если клиент Telegram поддерживает соответствующий интерфейс.
За включение самого режима тем отвечает has_topics_enabled. Отдельный параметр allows_users_to_create_topics управляет возможностью пользователя самостоятельно создавать и удалять темы.
Владелец бота может пригласить до десяти пользователей за раз
Для личных чатов появилась специальная ссылка формата https://t.me/botinvite/<bot_username>. Владелец бота может открыть её и пригласить до десяти пользователей за один раз. После приглашения бот получает право отправлять сообщения выбранным людям.
Приглашение сопровождается служебным сообщением. В объекте WriteAccessAllowed добавлено поле inviter, содержащее сведения о владельце бота, который отправил приглашение. Благодаря этому разработчик может отличить такое подключение от других способов предоставления доступа на запись.
Функция подходит для подключения небольшой команды к рабочему боту, приглашения тестировщиков или запуска пилотного проекта. Ограничение «до десяти» относится к одному действию приглашения; официальный журнал изменений не описывает его как общий лимит аудитории бота.
Метод getMe возвращает отдельный объект BotFullInfo
В Bot API 10.5 изменилась модель данных метода getMe. Теперь он возвращает объект BotFullInfo, выделенный из ранее использовавшегося User. Поля, описывающие настройки самого бота, отделены от универсального объекта пользователя.
В BotFullInfo добавлены дополнительные сведения: active_usernames со списком действующих имён бота, inline_query_placeholder с подсказкой для inline-поиска, needs_inline_query_location с настройкой запроса геопозиции и has_topic_sidebar с состоянием боковой панели тем.
Для библиотек со строгими типами изменение возвращаемого объекта означает обновление моделей и схем. В обработчиках, использующих результат getMe, может понадобиться проверка полей, особенно если приложение ожидает прежний тип User.
Раскрываемые цитаты поддерживают таблицы и медиаблоки
Обновление затронуло Rich Messages — формат сложных сообщений, поддерживающий структурированный текст, таблицы и медиа. Раскрываемая цитата RichBlockExpandableBlockQuotation теперь содержит массив blocks. Аналогичное изменение получил объект для отправки InputRichBlockExpandableBlockQuotation.
Ранее содержимое раскрываемой цитаты передавалось через поле text. Теперь внутри могут находиться различные Rich Blocks, включая таблицы, фотографии и другие поддерживаемые элементы. Например, бот с отчётами способен скрыть подробную таблицу показателей внутри раскрываемого фрагмента большого сообщения.
Это изменение имеет значение для сериализации и чтения сообщений: интеграции, работающие с прежним полем text, должны учитывать структуру blocks.
Обновление затрагивает настройки и структуры данных существующих ботов
Bot API 10.5 расширил возможности автоматизации настройки ботов и управления интерфейсом личных чатов. Самые заметные для уже работающих проектов изменения касаются getMe, формата CallbackQuery при использовании новых режимов и внутренней структуры раскрываемых цитат. Для пользователей новые возможности проявляются прежде всего в навигации по темам и приглашениях в личные чаты.
Официальные подробности опубликованы в журнале изменений Telegram Bot API и документации метода setMySettings. Анонс релиза доступен в канале BotNews.