setMySettings
Изменяет настройки бота: inline-режим, приватность, группы, темы, режим callback query (Bot API 10.5).
Возвращает: При успехе возвращает True.
Параметры
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
supports_inline_queries | Boolean | Нет | Включить (true) или выключить (false) inline-режим |
inline_query_placeholder | String | Нет | Подсказка в поле ввода inline-режима (пустая строка = по умолчанию) |
needs_inline_query_location | Boolean | Нет | Запрашивать геопозицию пользователя при каждом inline-запросе |
inline_feedback_share_denominator | Integer | Нет | Доля получаемых chosen_inline_result: 1 из N (1, 10, 100, 1000; 0 = не получать) |
can_join_groups | Boolean | Нет | Разрешить добавлять бота в группы |
can_read_all_group_messages | Boolean | Нет | true = выключить режим приватности (видеть все сообщения групп) |
can_connect_to_business | Boolean | Нет | Разрешить подключать бота к бизнес-аккаунтам |
can_manage_bots | Boolean | Нет | Разрешить боту создавать управляемых ботов |
supports_guest_queries | Boolean | Нет | Разрешить гостевые запросы из чатов, где бота нет |
supports_join_request_queries | Boolean | Нет | Разрешить назначать бота для обработки заявок на вступление |
has_topics_enabled | Boolean | Нет | Включить темы (форум) в личных чатах с ботом |
allows_users_to_create_topics | Boolean | Нет | Разрешить пользователям создавать и удалять темы в личном чате |
has_topic_sidebar | Boolean | Нет | Показывать темы личного чата в боковой панели (Bot API 10.5) |
can_communicate_with_bots | Boolean | Нет | Разрешить общение с другими ботами |
callback_query_mode | String | Нет | Режим callback query: default, auto или inline (inline_message_id вместо message) |
Пример запроса
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/setMySettings" \
-H "Content-Type: application/json" \
-d '{
"supports_inline_queries": true,
"can_read_all_group_messages": false,
"callback_query_mode": "auto"
}'
Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/setMySettings",
json={
"supports_inline_queries": True,
"can_read_all_group_messages": False,
"callback_query_mode": "auto"
},
timeout=30,
)
print(resp.json())
JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/setMySettings`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"supports_inline_queries": true,
"can_read_all_group_messages": false,
"callback_query_mode": "auto"
}),
});
console.log(await res.json());
Пошаговое руководство: Что нового в Telegram Bot API 10.0–10.5: настройки бота, виджеты, rich-сообщения, эфемерные сообщения и гостевой режим
Похожие методы
getMeВозвращает информацию о боте (BotFullInfo с Bot API 10.5).getMyCommandsВозвращает текущий список команд бота.setMyCommandsУстанавливает список команд бота.deleteMyCommandsУдаляет команды бота.getMyNameВозвращает имя бота.setMyNameУстанавливает имя бота.getMyDescriptionВозвращает описание бота.setMyDescriptionУстанавливает описание бота.getMyShortDescriptionВозвращает краткое описание бота.setMyShortDescriptionУстанавливает краткое описание бота.setMyProfilePhotoУстанавливает фото профиля бота.removeMyProfilePhotoУдаляет фото профиля бота.