Telegram Bot API

setMySettings

Категория: Информация · Bot API 10.5 · Официальная документация

История версий: Добавлен в Bot API 10.5

Изменяет настройки бота: inline-режим, приватность, группы, темы, режим callback query (Bot API 10.5).

Возвращает: При успехе возвращает True.

Параметры

ПараметрТипОбязательныйОписание
supports_inline_queriesBooleanНетВключить (true) или выключить (false) inline-режим
inline_query_placeholderStringНетПодсказка в поле ввода inline-режима (пустая строка = по умолчанию)
needs_inline_query_locationBooleanНетЗапрашивать геопозицию пользователя при каждом inline-запросе
inline_feedback_share_denominatorIntegerНетДоля получаемых chosen_inline_result: 1 из N (1, 10, 100, 1000; 0 = не получать)
can_join_groupsBooleanНетРазрешить добавлять бота в группы
can_read_all_group_messagesBooleanНетtrue = выключить режим приватности (видеть все сообщения групп)
can_connect_to_businessBooleanНетРазрешить подключать бота к бизнес-аккаунтам
can_manage_botsBooleanНетРазрешить боту создавать управляемых ботов
supports_guest_queriesBooleanНетРазрешить гостевые запросы из чатов, где бота нет
supports_join_request_queriesBooleanНетРазрешить назначать бота для обработки заявок на вступление
has_topics_enabledBooleanНетВключить темы (форум) в личных чатах с ботом
allows_users_to_create_topicsBooleanНетРазрешить пользователям создавать и удалять темы в личном чате
has_topic_sidebarBooleanНетПоказывать темы личного чата в боковой панели (Bot API 10.5)
can_communicate_with_botsBooleanНетРазрешить общение с другими ботами
callback_query_modeStringНетРежим 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-сообщения, эфемерные сообщения и гостевой режим