VeoSeeBot — нейросети прямо в Telegram Создавайте изображения, видео и тексты с помощью ИИ. Популярные нейросети в одном Telegram-боте.
Открыть бот

Telegram Bot API 10.5 - управление настройками, новые callback-запросы и приглашения пользователей

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

Telegram Bot API 10.5
Telegram Bot API 10.5

Настройки бота теперь можно менять напрямую через 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.

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

Вам также может понравиться