setMySettings
Thay đổi cài đặt bot: chế độ inline, quyền riêng tư, nhóm, chủ đề, chế độ truy vấn callback (Bot API 10.5).
Giá trị trả về: Nếu thành công, trả về True.
Tham số
| Tham số | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
supports_inline_queries | Boolean | Tùy chọn | Bật (true) hoặc tắt (false) chế độ inline |
inline_query_placeholder | String | Tùy chọn | Văn bản gợi ý của truy vấn inline trong ô nhập (chuỗi rỗng = default) |
needs_inline_query_location | Boolean | Tùy chọn | Yêu cầu vị trí người dùng với mỗi truy vấn inline |
inline_feedback_share_denominator | Integer | Tùy chọn | Tỷ lệ kết quả inline được chọn nhận về: 1 trên N (1, 10, 100, 1000; 0 = không nhận) |
can_join_groups | Boolean | Tùy chọn | Cho phép thêm bot vào nhóm |
can_read_all_group_messages | Boolean | Tùy chọn | true = tắt chế độ riêng tư (đọc mọi tin nhắn trong nhóm) |
can_connect_to_business | Boolean | Tùy chọn | Cho phép kết nối bot với tài khoản doanh nghiệp |
can_manage_bots | Boolean | Tùy chọn | Cho phép bot tạo bot được quản lý |
supports_guest_queries | Boolean | Tùy chọn | Cho phép truy vấn khách từ các chat mà bot không phải thành viên |
supports_join_request_queries | Boolean | Tùy chọn | Cho phép chỉ định bot xử lý yêu cầu tham gia |
has_topics_enabled | Boolean | Tùy chọn | Bật chế độ chủ đề diễn đàn trong chat riêng với bot |
allows_users_to_create_topics | Boolean | Tùy chọn | Cho phép người dùng tạo và xóa chủ đề trong chat riêng |
has_topic_sidebar | Boolean | Tùy chọn | Hiển thị chủ đề chat riêng ở thanh bên (Bot API 10.5) |
can_communicate_with_bots | Boolean | Tùy chọn | Cho phép bot giao tiếp với các bot khác |
callback_query_mode | String | Tùy chọn | Chế độ truy vấn callback: default, auto hoặc inline (inline_message_id thay cho message) |
Ví dụ request
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());
Hướng dẫn từng bước: Cách tạo bot Telegram từ A đến Z: BotFather, token và tin nhắn đầu tiên
Phương thức liên quan
getMeTrả về thông tin bot (BotFullInfo từ Bot API 10.5).getMyCommandsTrả về danh sách lệnh hiện tại của bot.setMyCommandsĐặt danh sách lệnh của bot.deleteMyCommandsXóa các lệnh của bot.getMyNameTrả về tên của bot.setMyNameĐặt tên cho bot.getMyDescriptionTrả về mô tả của bot.setMyDescriptionĐặt mô tả cho bot.getMyShortDescriptionTrả về mô tả ngắn của bot.setMyShortDescriptionĐặt mô tả ngắn cho bot.setMyProfilePhotoĐặt ảnh đại diện cho bot.removeMyProfilePhotoXóa ảnh đại diện của bot.