setMySettings
Змінює налаштування бота: inline-режим, приватність, групи, теми, режим callback-запитів (Bot API 10.5).
Повертає: У разі успіху повертає True.
Параметри
| Параметр | Тип | Обов’язковий | Опис |
|---|---|---|---|
supports_inline_queries | Boolean | Ні | Увімкнути (true) або вимкнути (false) inline-режим |
inline_query_placeholder | String | Ні | Підказка для inline-запиту в полі введення (порожній рядок = default) |
needs_inline_query_location | Boolean | Ні | Запитувати геопозицію користувача з кожним inline-запитом |
inline_feedback_share_denominator | Integer | Ні | Частка отримуваних вибраних inline-результатів: 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-запитів: 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Видаляє фото профілю бота.