setMySettings
تنظیمات ربات را تغییر میدهد: حالت اینلاین، حریم خصوصی، گروهها، تاپیکها، حالت کوئری callback (Bot API 10.5).
مقدار بازگشتی: در صورت موفقیت، True برمیگرداند.
پارامترها
| پارامتر | نوع | الزامی | توضیحات |
|---|---|---|---|
supports_inline_queries | Boolean | اختیاری | فعال (true) یا غیرفعال (false) کردن حالت اینلاین |
inline_query_placeholder | String | اختیاری | متن راهنمای کوئری اینلاین در فیلد ورودی (رشته خالی = default) |
needs_inline_query_location | Boolean | اختیاری | درخواست موقعیت مکانی کاربر همراه با هر کوئری اینلاین |
inline_feedback_share_denominator | Integer | اختیاری | سهم نتایج اینلاین انتخابشده دریافتی: 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());
راهنمای گامبهگام: ساخت ربات تلگرام: آموزش قدمبهقدم از BotFather تا اولین پیام با Python
متدهای مرتبط
getMeاطلاعات ربات را برمیگرداند (BotFullInfo از Bot API 10.5).getMyCommandsفهرست فعلی دستورات ربات را برمیگرداند.setMyCommandsفهرست دستورات ربات را تنظیم میکند.deleteMyCommandsدستورات ربات را حذف میکند.getMyNameنام ربات را برمیگرداند.setMyNameنام ربات را تنظیم میکند.getMyDescriptionتوضیحات ربات را برمیگرداند.setMyDescriptionتوضیحات ربات را تنظیم میکند.getMyShortDescriptionتوضیحات کوتاه ربات را برمیگرداند.setMyShortDescriptionتوضیحات کوتاه ربات را تنظیم میکند.setMyProfilePhotoعکس پروفایل ربات را تنظیم میکند.removeMyProfilePhotoعکس پروفایل ربات را حذف میکند.