Telegram Bot API

setMySettings

دسته‌بندی: اطلاعات ربات · Bot API 10.5 · مستندات رسمی

تاریخچه نسخه‌ها: اضافه‌شده در Bot API 10.5

تنظیمات ربات را تغییر می‌دهد: حالت اینلاین، حریم خصوصی، گروه‌ها، تاپیک‌ها، حالت کوئری callback (Bot API 10.5).

مقدار بازگشتی: در صورت موفقیت، True برمی‌گرداند.

پارامترها

پارامترنوعالزامیتوضیحات
supports_inline_queriesBooleanاختیاریفعال (true) یا غیرفعال (false) کردن حالت اینلاین
inline_query_placeholderStringاختیاریمتن راهنمای کوئری اینلاین در فیلد ورودی (رشته خالی = default)
needs_inline_query_locationBooleanاختیاریدرخواست موقعیت مکانی کاربر همراه با هر کوئری اینلاین
inline_feedback_share_denominatorIntegerاختیاریسهم نتایج اینلاین انتخاب‌شده دریافتی: 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: 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