setMySettings
Mengubah pengaturan bot: mode inline, privasi, grup, topik, mode callback query (Bot API 10.5).
Nilai kembalian: Jika berhasil, mengembalikan True.
Parameter
| Parameter | Tipe | Wajib | Deskripsi |
|---|---|---|---|
supports_inline_queries | Boolean | Opsional | Mengaktifkan (true) atau menonaktifkan (false) mode inline |
inline_query_placeholder | String | Opsional | Placeholder inline query di kolom input (string kosong = default) |
needs_inline_query_location | Boolean | Opsional | Meminta lokasi pengguna pada setiap inline query |
inline_feedback_share_denominator | Integer | Opsional | Porsi hasil inline terpilih yang diterima: 1 dari N (1, 10, 100, 1000; 0 = tidak ada) |
can_join_groups | Boolean | Opsional | Izinkan menambahkan bot ke grup |
can_read_all_group_messages | Boolean | Opsional | true = nonaktifkan mode privasi (membaca semua pesan grup) |
can_connect_to_business | Boolean | Opsional | Izinkan menghubungkan bot ke akun bisnis |
can_manage_bots | Boolean | Opsional | Izinkan bot membuat bot terkelola |
supports_guest_queries | Boolean | Opsional | Izinkan guest query dari chat yang tidak diikuti bot |
supports_join_request_queries | Boolean | Opsional | Izinkan bot ditugaskan memproses permintaan bergabung |
has_topics_enabled | Boolean | Opsional | Aktifkan mode topik forum di chat pribadi dengan bot |
allows_users_to_create_topics | Boolean | Opsional | Izinkan pengguna membuat dan menghapus topik di chat pribadi |
has_topic_sidebar | Boolean | Opsional | Tampilkan topik chat pribadi di sidebar (Bot API 10.5) |
can_communicate_with_bots | Boolean | Opsional | Izinkan bot berkomunikasi dengan bot lain |
callback_query_mode | String | Opsional | Mode callback query: default, auto, atau inline (inline_message_id alih-alih message) |
Contoh permintaan
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());
Panduan langkah demi langkah: Cara Membuat Bot Telegram: dari BotFather sampai Pesan Pertama
Metode terkait
getMeMengembalikan informasi bot (BotFullInfo sejak Bot API 10.5).getMyCommandsMengembalikan daftar perintah bot saat ini.setMyCommandsMengatur daftar perintah bot.deleteMyCommandsMenghapus perintah bot.getMyNameMengembalikan nama bot.setMyNameMengatur nama bot.getMyDescriptionMengembalikan deskripsi bot.setMyDescriptionMengatur deskripsi bot.getMyShortDescriptionMengembalikan deskripsi singkat bot.setMyShortDescriptionMengatur deskripsi singkat bot.setMyProfilePhotoMengatur foto profil bot.removeMyProfilePhotoMenghapus foto profil bot.