Telegram Bot API 10.0–10.5: Pengaturan Bot, Widget, Rich Message, Ephemeral Message, Guest Mode, dan Lainnya
Telegram Bot API 10.5, dirilis 22 November 2026, adalah versi Bot API terbaru dengan 194 metode. Seri 10.x yang dimulai dengan Bot API 10.0 pada 8 Mei 2026 membawa guest mode, live photo, rich message dengan draft streaming, ephemeral message, community, join request query, widget HTML interaktif di dalam pesan (10.4), serta di 10.5 metode setMySettings dan objek baru BotFullInfo yang dikembalikan getMe. Berikut fitur baru di setiap rilis, dengan contoh JSON singkat dan perubahan yang bisa merusak bot yang sudah berjalan.
Ringkasan Telegram Bot API 10
| Versi | Tanggal | Sorotan |
|---|---|---|
| 10.0 | 8 Mei 2026 | Guest mode, live photo, media di polling, penghapusan reaksi |
| 10.1 | 11 Juni 2026 | Rich message dan rich draft, join request query |
| 10.2 | 14 Juli 2026 | Ephemeral message, community, update subscription, proteksi origin Mini App |
| 10.3 | 24 Agustus 2026 | EphemeralMessageParameters, draft yang bisa dihentikan, DisabledButton, tombol di rich message |
| 10.4 | 9 November 2026 | Widget HTML, balasan ephemeral untuk callback query di chat mana pun, kutipan dari rich message, kartu wallet TON, tema share chat |
| 10.5 | 22 November 2026 | setMySettings, BotFullInfo di getMe, callback_query_mode, link undangan bot, blok di expandable quotation |
Bot API 10.0: guest mode, live photo, dan polling
Guest mode. Setelah Guest Mode diaktifkan di Mini App @BotFather, pengguna bisa me-mention bot di chat yang tidak diikuti bot. Bot menerima update guest_message dan bisa mengirim satu balasan dengan answerGuestQuery, berisi guest_query_id dari pesan dan sebuah InlineQueryResult:
{
"guest_query_id": "<message.guest_query_id>",
"result": {
"type": "article",
"id": "1",
"title": "Terjemahan",
"input_message_content": {"message_text": "Bonjour tout le monde"}
}
}
Bot tamu tidak punya akses ke riwayat chat atau daftar anggota, dan tidak melihat pesan berikutnya kecuali di-mention atau dibalas lagi.
- Reaksi dan admin:
deleteMessageReactionmenghapus reaksi di grup;deleteAllMessageReactionsmenghapus hingga 10000 reaksi terbaru dari pengguna atau chat tertentu.getChatAdministratorsmendapat parameterreturn_bots. - Polling: media di polling, opsi, dan penjelasan kuis (
media,explanation_media), plusmembers_onlydancountry_codes. Jumlah opsi minimum turun dari 2 menjadi 1. - Live photo:
sendLivePhotomengirim foto dengan video pendek; live photo juga berfungsi disendMediaGroup,editMessageMedia, dan paid media. - Lainnya:
getManagedBotAccessSettingsdansetManagedBotAccessSettings,getUserPersonalChatMessages, pesan antarbot lewat username jika kedua bot mengizinkan, sertatextkosong disendMessageDraftuntuk menampilkan placeholder "Thinking...".
Bot API 10.1: rich message Telegram dan join request query
Rich message ditujukan untuk output terstruktur seperti laporan, dokumentasi, dan jawaban AI. sendRichMessage menerima objek rich_message dengan konten di html atau markdown (10.2 menambahkan blocks eksplisit dan daftar media). Yang didukung: heading, list dan task list, tabel, kutipan, detail yang bisa dilipat, catatan kaki, rumus LaTeX, peta, kolase, slideshow, dan blok media. Batasnya: 32768 karakter UTF-8, 500 blok, 16 level nesting, 50 media, dan 20 kolom tabel.
curl -X POST "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/sendRichMessage" \
-H "Content-Type: application/json" \
-d '{
"chat_id": 123456789,
"rich_message": {
"markdown": "# Laporan mingguan\n\n| Metrik | Nilai |\n|:-------|------:|\n| Pengguna | **1204** |\n| Error | 3 |\n\n- [x] Deploy v2.1\n- [ ] Perbarui dokumentasi\n\n$$E = mc^2$$"
}
}'
sendRichMessageDraft men-streaming rich message parsial ke chat pribadi selama masih dibuat. Draft hanya pratinjau sementara selama 30 detik, jadi akhiri dengan sendRichMessage. editMessageText kini juga menerima rich_message.
Join request query. Jika bot dipasang sebagai guard bot sebuah chat, update chat_join_request membawa query_id. Putuskan langsung dengan answerChatJoinRequestQuery (approve, decline, atau queue untuk menyerahkan keputusan ke admin lain), atau tampilkan dulu Mini App dengan sendChatJoinRequestWebApp; Mini App menerima chat_join_request_query_id di init data.
{"chat_join_request_query_id": "<chat_join_request.query_id>", "result": "approve"}
Polling juga mendapat media berupa link di 10.1.
Bot API 10.2: ephemeral message Telegram, community, dan keamanan Mini App
Ephemeral message adalah pesan grup yang hanya terlihat oleh satu pengguna dan bot, sehingga petunjuk, teks sambutan, dan hasil pribadi tidak memenuhi timeline bersama. Pengguna juga bisa mengirim perintah ephemeral (BotCommand.is_ephemeral) yang tidak dilihat orang lain. Aturan pengirimannya:
- Bot apa pun boleh membalas secara ephemeral dalam 15 detik setelah aksi yang memenuhi syarat: callback query (lewat id-nya) atau pesan ephemeral masuk (lewat
reply_parameters.ephemeral_message_id). - Bot yang menjadi administrator chat bisa mengirim ephemeral message ke anggota non-bot kapan saja.
- Pengiriman tidak dijamin, terutama jika pengguna offline.
Ephemeral message punya metode sendiri: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, dan deleteEphemeralMessage:
{"chat_id": -1001234567890, "receiver_user_id": 123456789, "ephemeral_message_id": 15}
- Community: supergrup, channel, dan bot yang terhubung seputar satu topik, dengan tipe
Community, pesan layanancommunity_chat_addeddancommunity_chat_removed, sertaChatFullInfo.community. - Langganan: update baru
subscriptionmelaporkan perubahan langganan berbayar pengguna. - Proteksi origin Mini App: metode Mini App diblokir jika dipanggil dari origin yang berbeda dengan domain Mini App. Proteksi ini aktif untuk semua Mini App sejak 20 Juli 2026 dan bisa dimatikan di @BotFather. Lihat cara tes Telegram Mini App untuk dampaknya dalam praktik.
Bot API 10.3: EphemeralMessageParameters, draft yang bisa dihentikan, dan DisabledButton
Breaking change untuk ephemeral message. Parameter receiver_user_id dan callback_query_id dari 10.2 diganti di 13 metode kirim (sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendSticker, sendVideoNote, sendVoice, sendContact, sendLocation, sendVenue) dengan satu objek, ephemeral_message_parameters. sendRichMessage juga menerimanya, dan field baru replace_callback_query_message menampilkan pesan ephemeral menggantikan pesan yang tombolnya ditekan:
{
"chat_id": -1001234567890,
"text": "Hanya kamu yang bisa melihat ini.",
"ephemeral_message_parameters": {
"receiver_user_id": 123456789,
"callback_query_id": "<callback_query.id>",
"replace_callback_query_message": true
}
}
Draft yang bisa dihentikan. Kirim can_stop ke sendMessageDraft atau sendRichMessageDraft untuk menampilkan tombol Stop. Saat pengguna menekannya, bot menerima update stopped_message_generation berisi chat dan draft_id, sehingga kamu bisa menghentikan model. keep_on_stop membiarkan draft parsial tetap terlihat sebentar; kirim sebagai pesan biasa jika harus tetap ada.
import time
import requests
API = "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours"
text, last = "", 0.0
for chunk in generate_reply(): # stream token dari LLM kamu
text += chunk
if time.monotonic() - last > 0.5: # jangan kirim draft per token
requests.post(f"{API}/sendMessageDraft", json={"chat_id": 123456789,
"draft_id": 1, "text": text, "can_stop": True}, timeout=10)
last = time.monotonic()
requests.post(f"{API}/sendMessage", json={"chat_id": 123456789, "text": text}, timeout=10)const API = "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours";
const post = (method, body) => fetch(`${API}/${method}`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(body),
signal: AbortSignal.timeout(10_000),
});
let text = "", last = 0;
for await (const chunk of generateReply()) { // stream token dari LLM kamu
text += chunk;
if (Date.now() - last > 500) { // jangan kirim draft per token
await post("sendMessageDraft", { chat_id: 123456789,
draft_id: 1, text, can_stop: true });
last = Date.now();
}
}
await post("sendMessage", { chat_id: 123456789, text });- Tombol nonaktif: field baru
disabledpadaInlineKeyboardButtonmenerima objekDisabledButton, misalnya{"text": "Habis", "disabled": {}}; tombol ini tidak melakukan apa-apa.InlineKeyboardMarkupdanReplyKeyboardMarkupjuga mendapatforce_reply. - Rich message: tombol di dalam pesan (
<tg-button>,<tg-button-row>), tabel ringkas, expandable block quotation, dan blok dokumen. - Admin: hak
can_send_welcome_messagesdiChatAdministratorRightsdanpromoteChatMember. - Edit ephemeral: unggah file baru di
editEphemeralMessageMedia,show_caption_above_mediadieditEphemeralMessageCaption, danrich_messagedieditEphemeralMessageText.
Bot API 10.4: widget Telegram, balasan ephemeral di chat mana pun, dan wallet TON
Widget. Bot kini bisa mengirim blok HTML interaktif kecil di dalam pesan. Widget adalah satu dokumen HTML (hingga 32768 byte, 4096 byte setelah kompresi zlib) yang dijalankan aplikasi di sandbox tanpa akses jaringan, plus state yang hanya bisa diubah bot: chat_data untuk satu pesan dan public_data yang dibagikan di mana pun widget ditampilkan. Metode baru: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, dan editSharedWidgetData; update baru: widget_query dan shared_widget_query; inline mode mendapat InputWidgetMessageContent dan InputSharedWidgetMessageContent (untuk sementara hanya di server tes).
{
"chat_id": 123456789,
"html": "<h3>Pesanan #1042</h3><p>2 × Margherita, 1 × Lemonade</p><p><strong>Total: $23.50</strong></p>",
"caption": "Pesanan #1042: $23.50"
}
Di produksi, widget saat ini hanya berfungsi di chat pribadi dan dikirim dengan protected content, sehingga tidak bisa diteruskan; grup, inline mode, dan forward hanya berfungsi di server tes. Pesan widget tidak bisa disalin dengan copyMessage / copyMessages, dan izin can_send_other_messages kini juga mencakup widget. Detailnya: penjelasan widget Telegram.
Balasan ephemeral untuk callback query di chat mana pun (kecuali chat direct messages channel). Kirim callback_query_id tanpa receiver_user_id di ephemeral_message_parameters, dan pesan hanya ditampilkan ke pengguna yang menekan tombol. receiver_user_id dan parameter chat_id di metode kirim kini opsional. Kamu tetap harus memanggil answerCallbackQuery.
{
"text": "Hanya kamu yang bisa melihat jawaban ini.",
"ephemeral_message_parameters": {"callback_query_id": "<callback_query.id>"}
}
- Kutipan dari rich message:
TextQuote.rich_textsdanReplyParameters.quote_rich_texts. - Wallet TON:
TonWalletCarddanChatFullInfo.ton_wallet_card, pesan layananton_wallet_transfer;StoryAreaPositiondiganti namanya menjadiAreaPosition. - Tema share chat:
ChatFullInfo.share_themedan metode barugetChatShareThemeBackdrops. - Hadiah:
getUniqueGiftmengembalikan unique gift berdasarkan namanya;deleteBusinessAccountGiftmenghapus hadiah biasa milik akun bisnis yang dikelola tanpa menerima Stars. - Entity dan verifikasi: tipe
MessageEntitybaruton_addressdanbank_card_number;custom_description_parse_modedancustom_description_entitiesdiverifyUserdanverifyChat. - Lainnya: pesan layanan
paid_messages_waived; pengguna Premium bisa memberi hingga 2 bot miliknya username sekunder berakhiran agent, ai, app, game, atau gay; link ke topik di chat pribadi dengan bot,https://t.me/<bot_username>/<message_thread_id>.
Bot API 10.5: setMySettings, BotFullInfo, dan link undangan bot
Pengaturan bot dari kode. Metode baru setMySettings mengubah pengaturan yang sebelumnya hanya ada di @BotFather. Semua parameter opsional, jadi kirim hanya yang ingin diubah; metode ini mengembalikan True:
- Inline mode:
supports_inline_queries,inline_query_placeholder,needs_inline_query_location, daninline_feedback_share_denominator(terima 1 dari setiap 1, 10, 100, atau 1000 hasil inline yang dipilih; 0 mematikannya). - Grup dan privasi:
can_join_groupsdancan_read_all_group_messages(truemematikan privacy mode). - Fitur:
can_connect_to_business,can_manage_bots,supports_guest_queries,supports_join_request_queries, dancan_communicate_with_botsuntuk komunikasi antarbot. - Topik di chat pribadi:
has_topics_enabled,allows_users_to_create_topics, danhas_topic_sidebar. - Callback query:
callback_query_modemenentukan cara bot menerima callback query dari tombol di pesan yang dikirimnya."default"selalu memakai fieldmessage;"auto"memakaiinline_message_idjika pesan tidak bisa diakses bot;"inline"selalu memakaiinline_message_id, bukanmessage.
{
"supports_inline_queries": true,
"inline_query_placeholder": "Cari resep...",
"can_join_groups": false,
"has_topics_enabled": true,
"callback_query_mode": "auto"
}
Kirim ke https://api.telegram.org/bot<token>/setMySettings atau coba dengan token kamu di Bot API Tester, lalu panggil getMe untuk mengecek hasilnya.
BotFullInfo (breaking change). getMe kini mengembalikan objek baru BotFullInfo, bukan User, dan field yang dulu hanya dikembalikan getMe dihapus dari User. BotFullInfo juga menambahkan active_usernames, inline_query_placeholder, needs_inline_query_location, dan has_topic_sidebar. Kode yang membaca field seperti can_join_groups, can_read_all_group_messages, atau supports_inline_queries dari hasil getMe tetap berfungsi, karena field tersebut ada di BotFullInfo. Yang rusak adalah kode yang mengharapkan field itu di objek User lain, serta kode bertipe yang mendeklarasikan hasil getMe sebagai User.
- Link undangan bot: pemilik bot bisa mengundang hingga 10 pengguna sekaligus ke chat pribadi dengan bot lewat
https://t.me/botinvite/<bot_username>; bot lalu bisa mengirim pesan ke pengguna yang diundang.WriteAccessAllowedmendapat fieldinviter. - Expandable quotation (breaking change): di
RichBlockExpandableBlockQuotationdanInputRichBlockExpandableBlockQuotation, fieldtextdigantiblocks, sehingga expandable quotation kini bisa berisi rich block apa pun.
Cara upgrade bot ke Bot API 10.5
- Perbarui library kamu (python-telegram-bot, aiogram, grammY, Telegraf, dan lainnya) ke rilis yang mencantumkan dukungan Bot API 10.5 di changelog-nya.
- Pindahkan
receiver_user_iddancallback_query_idgaya 10.2 ke dalamephemeral_message_parameters. - Jika kamu mengirim daftar
allowed_updateseksplisit, tambahkan tipe baru yang kamu tangani:guest_message,subscription,stopped_message_generation,widget_query,shared_widget_query. - Longgarkan validasi polling: satu opsi kini diperbolehkan.
- Untuk Mini App, pastikan setiap panggilan
Telegram.WebAppberjalan di domain yang terdaftar. - Ganti
StoryAreaPositionmenjadiAreaPositionjika kode kamu merujuk tipe itu berdasarkan nama. - Perlakukan hasil
getMesebagaiBotFullInfo, dan berhenti membaca field khusus getMe sepertican_join_groupsdari objekUserlain. - Di rich message, susun expandable quotation dengan
blocks, bukantext. - Jika kamu mengganti
callback_query_modeke"auto"atau"inline", pastikan handler callback menerimainline_message_idsaatmessagetidak ada. - Coba metode baru dengan token kamu di Bot API Tester: setMySettings, sendWidget, sendRichMessage, deleteEphemeralMessage, dan answerChatJoinRequestQuery.
Ephemeral message dan pesan biasa punya dasar yang sama, jadi panduan kirim pesan lewat Bot API bagus untuk penyegaran, dan limit Telegram Bot API mencantumkan limit rich message di samping limit klasik. Riwayat lengkapnya ada di changelog Bot API resmi.
Pertanyaan umum
Apa versi Telegram Bot API terbaru?
Bot API 10.5, dirilis 22 November 2026, dengan 194 metode. Ini rilis keenam seri 10.x yang dimulai dengan Bot API 10.0 pada 8 Mei 2026. Versi ini menambahkan setMySettings, yang memungkinkan bot mengubah pengaturannya sendiri, dan getMe kini mengembalikan BotFullInfo. Versi sebelumnya, 10.4 (9 November 2026), menambahkan widget HTML di pesan.
Apa itu rich message di Telegram?
Rich message (Bot API 10.1) adalah pesan terstruktur yang dikirim dengan sendRichMessage: heading, list, tabel, rumus LaTeX, blok media, peta, dan sejak 10.3 juga tombol. Kontennya dikirim sebagai HTML, Markdown, atau blok di rich_message, hingga 32768 karakter UTF-8.
Apa itu ephemeral message di bot Telegram?
Ephemeral message (Bot API 10.2) adalah pesan di grup atau supergrup yang hanya bisa dilihat satu pengguna dan bot. Sejak 10.3 pesan ini dikirim dengan ephemeral_message_parameters di sendMessage dan metode kirim lainnya; sejak 10.4 bot juga bisa membalas callback query secara ephemeral di chat mana pun kecuali chat direct messages channel. Pengiriman tidak dijamin, terutama jika pengguna sedang offline.
Bagaimana cara streaming jawaban AI di bot Telegram?
Di chat pribadi, panggil sendMessageDraft atau sendRichMessageDraft berulang kali dengan draft_id yang sama, lalu kirim teks final dengan sendMessage atau sendRichMessage, karena draft hanya pratinjau sementara selama 30 detik. Dengan can_stop, pengguna mendapat tombol Stop dan bot menerima stopped_message_generation.
Apa itu setMySettings di Telegram Bot API 10.5?
setMySettings memungkinkan bot mengubah pengaturannya sendiri tanpa @BotFather: inline mode, privacy mode, bergabung ke grup, koneksi bisnis, guest query dan join request query, topik di chat pribadi, komunikasi antarbot, serta callback_query_mode. Kirim hanya field yang ingin diubah; hasilnya True. Nilai saat ini bisa dibaca dari getMe, yang kini mengembalikan BotFullInfo.
Apa itu guest mode di Telegram Bot API 10.0?
Guest mode memungkinkan bot membalas saat di-mention di chat yang tidak ia ikuti. Bot menerima update guest_message dan menjawab sekali dengan answerGuestQuery, tanpa akses ke riwayat chat. Fitur ini diaktifkan di Mini App @BotFather.
Panduan terkait
Cara Membuat Bot Telegram: dari BotFather sampai Pesan Pertama
Cara membuat bot telegram langkah demi langkah: daftar di @BotFather, simpan token, cek dengan getMe, lalu kirim pesan pertama lewat curl dan Python.
Cara Deploy Bot Telegram: Hosting di VPS, Docker, dan Serverless
Cara deploy bot Telegram: polling vs webhook, service systemd di VPS, Docker, Cloudflare Workers dengan secret_token, plus checklist sebelum bot online.
Error Telegram Bot API: Arti Setiap Error dan Cara Mengatasinya
Daftar error Telegram Bot API: 400 chat not found, 403 bot was blocked by the user, 409 Conflict, 429 retry_after. Penyebab, solusi, dan kode penanganan.
Limit Telegram Bot API: Rate Limit, Error 429, Ukuran File, dan Panjang Pesan
Limit Telegram Bot API: 30 pesan/detik, 1 pesan/detik per chat, 20/menit di grup, cara menangani 429 retry_after, batas ukuran file dan panjang pesan.
Perintah Bot Telegram: setMyCommands, Scope Perintah, dan Deep Link /start
Cara membuat perintah bot Telegram: /setcommands di @BotFather, setMyCommands dengan scope dan bahasa, parameter deep link /start, dan /cmd@bot di grup.
Keyboard Bot Telegram: Inline Keyboard, Tombol Callback, dan Reply Keyboard
Cara membuat tombol bot Telegram: inline keyboard dengan callback_data, answerCallbackQuery, edit pesan setelah tombol ditekan, reply keyboard, ForceReply.
Integrasi n8n Telegram: Hubungkan Bot, Jalankan Workflow, dan Kirim Pesan
Cara menghubungkan n8n ke Telegram: token bot sebagai Access Token, webhook Telegram Trigger via HTTPS publik, kirim pesan via chat id, dan solusi error.
Kirim Pesan Bot Telegram dengan Telegram Bot API (sendMessage)
Kirim pesan bot telegram lewat Bot API: contoh sendMessage dengan curl, Python, dan JavaScript, format HTML/MarkdownV2, tombol inline, dan solusi error.
Telegram Bot Token: Cara Mendapatkan, Mengecek, dan Mencabut Token
Cara mendapatkan token bot telegram dari @BotFather, melihat token bot lama, mengecek dengan getMe, dan me-revoke token yang bocor. Lengkap dengan contoh.
Webhook Telegram Bot: Cara Setting setWebhook, Secret Token, dan Mengatasi Error
Panduan webhook telegram bot: syarat HTTPS dan port, setWebhook dengan secret_token, cek getWebhookInfo, deleteWebhook, serta solusi error 409 dan n8n.
Chat ID Telegram Dimana? Cara Mendapatkan Chat ID User, Grup, dan Channel
Chat id telegram dimana? Cara mendapatkan chat id user, grup, supergroup, dan channel lewat getUpdates, plus solusi saat result kosong atau error 409.
Bot Inline Telegram: Cara Mengaktifkan Mode Inline dan Menjawab Inline Query
Cara membuat bot inline Telegram: aktifkan mode inline lewat @BotFather atau setMySettings, tangani update inline_query, lalu balas via answerInlineQuery.
Pembayaran Telegram Stars untuk Bot: Invoice, Pre-Checkout, Refund, dan Langganan
Cara menerima pembayaran Telegram Stars di bot: sendInvoice dengan XTR, pre_checkout_query, successful_payment, refund, langganan, plus kode Python/JS.
Server Test Telegram: Cara Test Bot di Lingkungan Test Telegram
Cara memakai server test Telegram untuk bot: login ke lingkungan test, buat bot test, panggil Bot API lewat /test/, lalu aktifkan TEST di tester kami.
Widget Telegram untuk Website: Login dengan Telegram, Embed Post, Komentar, dan Tombol Share
Pasang widget telegram untuk website: login dengan Telegram (OIDC), Login Widget lama dengan cek hash, embed post, komentar channel, dan tombol share.
API JavaScript TelegramWidget: Referensi, Event, Kode Error, dan Batasan
Referensi API JavaScript TelegramWidget: properti, request(), event, kode error, variabel CSS, widget_query dan answerWidgetQuery, plus semua batasannya.
Contoh Widget Telegram: Kode HTML dan Bot Python Lengkap
Contoh widget telegram lengkap dengan kode: kartu pesanan statis, counter dengan request widget_query, polling live sebagai widget shared, preview lokal.
Widget Telegram: HTML Interaktif di Dalam Pesan Bot
Widget telegram (Bot API 10.4): apa itu, cara kerja sendWidget, chat_data dan public_data, di mana bisa dipakai saat ini, dan bedanya dengan Mini App.
Cara Tes Telegram Mini App: Dari Mock di Browser sampai Telegram Asli
Cara tes Telegram Mini App: mode mock di browser, localhost lewat tunnel HTTPS, test environment, DevTools per platform, dan validasi initData di server.