Changelog Telegram Bot API
Semua perubahan Telegram Bot API dari versi 9.0 (April 2025) hingga Bot API 10.5 saat ini (22 November 2026), diurutkan dari yang terbaru. Nama metode tertaut ke referensi kami beserta parameter dan contoh; nama kelas tertaut ke dokumentasi resmi.
Bot API 10.5 Terbaru
Metode baru: setMySettings
Pengaturan bot
- Ditambahkan metode setMySettings yang memungkinkan bot mengubah pengaturannya, termasuk pengaturan mode inline, mode privasi, izin untuk ditambahkan ke grup, mode topik forum di chat pribadi, dan mode penerimaan callback query.
- Ditambahkan kemampuan menerima callback query dari tombol di pesan yang dikirim bot dengan field inline_message_id alih-alih field message di kelas CallbackQuery, tergantung parameter callback_query_mode pada metode setMySettings.
- Ditambahkan kemampuan bot menampilkan daftar topik di sidebar dalam chat pribadi dengan bot melalui parameter has_topic_sidebar pada metode setMySettings.
- Kelas BotFullInfo dipisahkan dari kelas User, dan tipe kembalian metode getMe diubah menjadi BotFullInfo. Field yang sebelumnya hanya dikembalikan oleh getMe dihapus dari kelas User.
- Ditambahkan field active_usernames ke kelas BotFullInfo sehingga bot dapat memperoleh daftar semua username aktifnya.
- Ditambahkan field inline_query_placeholder ke kelas BotFullInfo sehingga bot dapat memperoleh placeholder untuk inline query miliknya.
- Ditambahkan field needs_inline_query_location ke kelas BotFullInfo sehingga bot dapat memeriksa apakah ia meminta lokasi pengguna di setiap inline query.
- Ditambahkan field has_topic_sidebar ke kelas BotFullInfo sehingga bot dapat memeriksa apakah topik di chat pribadi dengan bot ditampilkan di sidebar.
Umum
- Pemilik bot kini dapat mengundang hingga 10 pengguna sekaligus ke chat pribadi dengan bot melalui tautan
https://t.me/botinvite/<bot_username>. Bot dapat mengirim pesan ke pengguna yang diundang. - Ditambahkan field inviter ke kelas WriteAccessAllowed untuk pesan layanan tentang pengguna yang diundang pemilik bot ke chat pribadi dengan bot.
- Field text diganti dengan field blocks di kelas RichBlockExpandableBlockQuotation dan InputRichBlockExpandableBlockQuotation, sehingga kutipan blok yang dapat diperluas bisa berisi blok apa pun.
Bot API 10.4
Metode baru: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData, getChatShareThemeBackdrops, getUniqueGift, deleteBusinessAccountGift
Widget
- Ditambahkan kelas Widget dan field widget ke kelas Message dan ExternalReplyInfo untuk pesan dengan widget HTML.
- Ditambahkan metode sendWidget yang memungkinkan bot mengirim pesan dengan widget HTML. Saat ini, di lingkungan produksi, widget hanya dapat dikirim ke chat pribadi, dan widget yang terkirim otomatis memiliki konten terlindungi sehingga tidak dapat diteruskan.
- Ditambahkan metode sendSharedWidget yang memungkinkan bot mengirim ulang shared widget yang dibuat oleh bot.
- Ditambahkan kelas WidgetQuery dan field widget_query ke kelas Update untuk query yang dikirim ke bot oleh widget di pesan yang dikirim oleh bot atau melalui bot.
- Ditambahkan kelas SharedWidgetQuery dan field shared_widget_query ke kelas Update untuk query yang dikirim ke bot dari pesan terusan berisi shared widget.
- Ditambahkan kelas WidgetQueryType, WidgetQueryTypeData, WidgetQueryTypeSignData, WidgetQueryTypeSentTransaction dan WidgetQueryWallet yang mendeskripsikan tipe query dari widget. Query dapat berisi data untuk bot beserta kartu dompet TON pengguna, data yang ditandatangani oleh dompet TON pengguna, atau notifikasi tentang transaksi yang dikirim dari dompet TON pengguna.
- Ditambahkan metode answerWidgetQuery yang memungkinkan bot menjawab query dari widget.
- Ditambahkan metode editMessageWidgetData yang memungkinkan bot mengubah data widget di dalam pesan.
- Ditambahkan metode editSharedWidgetData yang memungkinkan bot mengubah data publik shared widget.
- Ditambahkan kelas InputWidgetMessageContent dan InputSharedWidgetMessageContent yang memungkinkan bot mengirim widget sebagai respons inline query. Saat ini, widget belum dapat dikirim sebagai respons inline query di lingkungan produksi.
- Pesan widget tidak dapat disalin menggunakan metode copyMessage dan copyMessages.
- Hak can_send_other_messages di kelas ChatPermissions dan ChatMemberRestricted kini juga mengizinkan pengiriman widget.
Pesan ephemeral
- Bot kini dapat mengirim balasan ephemeral untuk callback query di chat mana pun, kecuali chat direct messages channel, dengan menentukan callback_query_id tanpa receiver_user_id di parameter ephemeral_message_parameters pada metode sendMessage, sendRichMessage, sendAnimation, sendAudio, sendContact, sendDocument, sendLivePhoto, sendLocation, sendPhoto, sendSticker, sendVenue, sendVideo, sendVideoNote dan sendVoice.
- Field receiver_user_id di kelas EphemeralMessageParameters dan parameter chat_id pada metode-metode tersebut kini opsional.
Kutipan dari rich message
- Ditambahkan field rich_texts ke kelas TextQuote untuk kutipan yang dipilih dari RichMessage.
- Ditambahkan field quote_rich_texts ke kelas ReplyParameters sehingga bot dapat mengutip rich message.
Dompet TON
- Ditambahkan kelas TonWalletCard, TonWalletCardSticker, TonNft dan TonNftAttribute, serta field ton_wallet_card ke kelas ChatFullInfo.
- Ditambahkan kelas TonWalletTransfer dan field ton_wallet_transfer ke kelas Message untuk pesan layanan tentang transfer dengan dompet TON.
- Kelas StoryAreaPosition diganti namanya menjadi AreaPosition karena kini juga digunakan untuk mendeskripsikan posisi stiker pada kartu dompet TON.
Tema berbagi chat
- Ditambahkan kelas ChatShareTheme, ChatShareThemeEmoji dan ChatShareThemeUniqueGift, serta field share_theme ke kelas ChatFullInfo, yang mendeskripsikan tema layar untuk membagikan tautan ke pengguna atau chat.
- Ditambahkan kelas EmojiType, EmojiTypeEmoji dan EmojiTypeCustomEmoji.
- Ditambahkan kelas ChatShareThemeBackdrop dan ChatShareThemeBackdrops serta metode getChatShareThemeBackdrops.
Hadiah
- Ditambahkan metode getUniqueGift yang memungkinkan bot mendapatkan informasi tentang hadiah unik berdasarkan namanya.
- Ditambahkan metode deleteBusinessAccountGift yang memungkinkan bot menghapus hadiah biasa milik akun bisnis yang dikelola tanpa menerima Telegram Stars untuknya.
Umum
- Pengguna dengan langganan Telegram Premium kini dapat memberikan username sekunder berakhiran “agent”, “ai”, “app”, “game”, atau “gay” ke maksimal 2 bot miliknya. Username semacam ini dapat disarankan di field suggested_username pada kelas KeyboardButtonRequestManagedBot.
- Ditambahkan kelas RichTextTonAddress yang merepresentasikan alamat di blockchain TON dalam RichMessage.
- Ditambahkan tipe “ton_address” ke kelas MessageEntity untuk alamat di blockchain TON.
- Ditambahkan tipe “bank_card_number” ke kelas MessageEntity untuk nomor kartu bank.
- Ditambahkan parameter custom_description_parse_mode dan custom_description_entities ke metode verifyUser dan verifyChat.
- Ditambahkan kelas PaidMessagesWaived dan field paid_messages_waived ke kelas Message untuk pesan layanan tentang pengirim yang menggunakan tautan untuk mengirim pesan tanpa membayar Telegram Stars.
- Ditambahkan kemampuan membuat tautan ke topik di chat pribadi dengan bot dalam format
https://t.me/<bot_username>/<message_thread_id>. Tautan semacam ini hanya membuka topik bagi pengguna yang chat pribadinya memiliki topik tersebut.
Bot API 10.3
Rich Messages
- Ditambahkan kelas RichMessageButton yang merepresentasikan tombol dalam RichMessage.
- Ditambahkan kelas RichTextButton.
- Ditambahkan kelas RichBlockButtons dan InputRichBlockButtons.
- Ditambahkan field is_compact ke kelas RichBlockTable dan InputRichBlockTable.
- Ditambahkan kelas RichBlockExpandableBlockQuotation dan InputRichBlockExpandableBlockQuotation yang merepresentasikan kutipan blok yang dapat diperluas dan diciutkan kembali.
- Ditambahkan kelas RichBlockDocument dan InputRichBlockDocument yang berisi file.
- Ditambahkan dukungan tautan berformat
tg://document?id=untuk unggahan file umum di rich message.
Pesan ephemeral
- Ditambahkan kelas EphemeralMessageParameters, dan parameter receiver_user_id serta callback_query_id pada metode sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation dan sendVenue diganti dengan parameter ephemeral_message_parameters.
- Ditambahkan parameter ephemeral_message_parameters ke metode sendRichMessage.
- Ditambahkan field replace_callback_query_message ke kelas EphemeralMessageParameters yang memungkinkan bot menampilkan pesan ephemeral sebagai pengganti pesan asli.
- Ditambahkan dukungan unggah file baru di editEphemeralMessageMedia.
- Ditambahkan parameter show_caption_above_media ke metode editEphemeralMessageCaption.
- Ditambahkan parameter rich_message ke metode editEphemeralMessageText.
- Ditambahkan field can_send_welcome_messages ke kelas ChatAdministratorRights dan ChatMemberAdministrator.
- Ditambahkan parameter can_send_welcome_messages ke metode promoteChatMember.
Reply markup
- Ditambahkan kelas DisabledButton dan field disabled ke kelas InlineKeyboardButton.
- Ditambahkan field force_reply ke kelas InlineKeyboardMarkup dan ReplyKeyboardMarkup.
Umum
- Ditambahkan parameter can_stop dan keep_on_stop ke metode sendMessageDraft dan sendRichMessageDraft.
- Ditambahkan update tentang pengguna yang menghentikan pembuatan pesan, direpresentasikan oleh kelas MessageGenerationStopped dan field stopped_message_generation di kelas Update.
- Ditambahkan kelas CommunityChatJoined dan field community_chat_joined ke kelas Message untuk pesan layanan tentang bergabungnya chat dari komunitas.
- Ditambahkan field text, entities, dan is_private ke kelas UniqueGiftInfo.
Bot API 10.2
Metode baru: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage
Rich Messages
- Ditambahkan kelas InputRichMessageMedia dan field media ke kelas InputRichMessage sehingga bot dapat secara eksplisit menentukan media yang digunakan dalam format markdown atau html saat mengirim rich message.
- Ditambahkan kelas InputMediaVoiceNote yang merepresentasikan pesan suara yang akan dikirim.
- Ditambahkan kelas InputRichBlockListItem yang merepresentasikan item daftar yang akan dikirim.
- Ditambahkan kelas InputRichBlockParagraph, InputRichBlockSectionHeading, InputRichBlockPreformatted, InputRichBlockFooter, InputRichBlockDivider, InputRichBlockMathematicalExpression, InputRichBlockAnchor, InputRichBlockList, InputRichBlockBlockQuotation, InputRichBlockPullQuotation, InputRichBlockCollage, InputRichBlockSlideshow, InputRichBlockTable, InputRichBlockDetails, InputRichBlockMap, InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote dan InputRichBlockThinking yang merepresentasikan berbagai tipe blok untuk memformat rich message yang dikirim.
- Ditambahkan field blocks ke kelas InputRichMessage sehingga bot dapat menentukan format rich message melalui entitas blok.
Pesan ephemeral
- Diperkenalkan dukungan Ephemeral Messages yang memungkinkan bot mengirim pesan grup dan menerima perintah yang hanya terlihat oleh pengguna tertentu dan bot.
- Ditambahkan field is_ephemeral ke kelas BotCommand.
- Ditambahkan field receiver_user ke kelas Message.
- Ditambahkan field ephemeral_message_id ke kelas Message.
- Ditambahkan parameter receiver_user_id dan callback_query_id ke metode sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation, sendVenue.
- Ditambahkan field ephemeral_message_id ke kelas ReplyParameters sehingga bot dapat membalas pesan ephemeral.
- Field message_id di kelas ReplyParameters ditandai opsional jika field ephemeral_message_id ada.
- Ditambahkan metode editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption dan editEphemeralMessageReplyMarkup yang memungkinkan bot mengedit pesan ephemeral.
- Ditambahkan metode deleteEphemeralMessage yang memungkinkan bot menghapus pesan ephemeral.
Komunitas
- Diperkenalkan dukungan awal untuk Komunitas — beberapa supergrup, channel, dan bot yang terhubung di sekitar topik atau audiens yang sama.
- Ditambahkan kelas Community yang merepresentasikan komunitas.
- Ditambahkan kelas CommunityChatAdded dan field community_chat_added ke kelas Message.
- Ditambahkan kelas CommunityChatRemoved dan field community_chat_removed ke kelas Message.
- Ditambahkan field community ke kelas ChatFullInfo.
Umum
- Ditambahkan update tentang perubahan langganan berbayar pengguna, direpresentasikan oleh kelas BotSubscriptionUpdated dan field subscription di kelas Update.
- Keamanan Mini App diperketat dengan melarang penggunaan metode Mini App dari origin yang berbeda dengan domain asli Mini App. Perlindungan ini akan otomatis diaktifkan untuk semua Mini App pada 20 Juli 2026. Anda dapat menonaktifkannya melalui Mini App @BotFather. Jika melakukannya, Anda mengakui bahwa bot bertanggung jawab memastikan Mini App tidak memuat tautan ke situs yang tidak tepercaya.
Bot API 10.1
Metode baru: sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp
Rich Messages
- Ditambahkan dukungan Rich Messages yang memungkinkan bot mengirim teks yang sangat terstruktur dan melakukan streaming balasan buatan AI dengan rich formatting yang mulus.
- Ditambahkan kelas RichTextBold, RichTextItalic, RichTextUnderline, RichTextStrikethrough, RichTextSpoiler, RichTextDateTime, RichTextTextMention, RichTextSubscript, RichTextSuperscript, RichTextMarked, RichTextCode, RichTextCustomEmoji, RichTextMathematicalExpression, RichTextUrl, RichTextEmailAddress, RichTextPhoneNumber, RichTextBankCardNumber, RichTextMention, RichTextHashtag, RichTextCashtag, RichTextBotCommand, RichTextAnchor, RichTextAnchorLink, RichTextReference dan RichTextReferenceLink yang merepresentasikan berbagai tipe teks dengan rich formatting.
- Ditambahkan kelas RichText yang merepresentasikan teks dengan rich formatting.
- Ditambahkan kelas RichBlockCaption yang merepresentasikan caption teks dengan rich formatting.
- Ditambahkan kelas RichBlockTableCell yang merepresentasikan sel dalam tabel.
- Ditambahkan kelas RichBlockListItem yang merepresentasikan item dalam daftar.
- Ditambahkan kelas RichBlockParagraph, RichBlockSectionHeading, RichBlockPreformatted, RichBlockFooter, RichBlockDivider, RichBlockMathematicalExpression, RichBlockAnchor, RichBlockList, RichBlockBlockQuotation, RichBlockPullQuotation, RichBlockCollage, RichBlockSlideshow, RichBlockTable, RichBlockDetails, RichBlockMap, RichBlockAnimation, RichBlockAudio, RichBlockPhoto, RichBlockVideo, RichBlockVoiceNote dan RichBlockThinking yang merepresentasikan berbagai tipe blok dalam pesan dengan rich formatting.
- Ditambahkan kelas RichBlock yang merepresentasikan blok dalam pesan dengan rich formatting.
- Ditambahkan kelas RichMessage yang merepresentasikan pesan dengan rich formatting.
- Ditambahkan field rich_message ke kelas Message.
- Ditambahkan kelas InputRichMessage yang mendeskripsikan rich message yang akan dikirim.
- Ditambahkan kelas InputRichMessageContent, dan kelas ini kini dapat digunakan sebagai InputMessageContent dalam hasil inline query, guest query, dan query Web App.
- Ditambahkan metode sendRichMessage yang memungkinkan bot mengirim rich message.
- Ditambahkan metode sendRichMessageDraft yang memungkinkan bot melakukan streaming rich message parsial.
- Ditambahkan parameter rich_message ke metode editMessageText sehingga bot dapat mengedit rich message.
Query permintaan bergabung
- Ditambahkan field supports_join_request_queries ke kelas User.
- Ditambahkan field guard_bot ke kelas ChatFullInfo.
- Ditambahkan field query_id ke kelas ChatJoinRequest.
- Ditambahkan metode answerChatJoinRequestQuery.
- Ditambahkan metode sendChatJoinRequestWebApp.
Polling
- Ditambahkan kelas Link dan field link ke kelas PollMedia.
- Ditambahkan kelas InputMediaLink, dan kelas ini kini dapat digunakan sebagai InputPollOptionMedia.
Bot API 10.0
Metode baru: answerGuestQuery, deleteAllMessageReactions, deleteMessageReaction, sendLivePhoto, getManagedBotAccessSettings, setManagedBotAccessSettings, getUserPersonalChatMessages
Mode tamu
- Diperkenalkan dukungan mode tamu yang memungkinkan bot menerima pesan tertentu dan mengirim balasan di chat yang tidak diikutinya sebagai anggota.
- Ditambahkan field supports_guest_queries ke kelas User.
- Ditambahkan field guest_bot_caller_user dan guest_bot_caller_chat ke kelas Message.
- Ditambahkan field guest_query_id ke kelas Message.
- Ditambahkan field guest_message ke kelas Update.
- Ditambahkan kelas SentGuestMessage dan metode answerGuestQuery.
Manajemen chat
- Ditambahkan field can_react_to_messages ke kelas ChatMemberRestricted dan ChatPermissions.
- Ditambahkan parameter return_bots ke metode getChatAdministrators.
- Ditambahkan metode deleteAllMessageReactions.
- Ditambahkan metode deleteMessageReaction.
- Bot kini dapat melihat pesan tertentu yang dikirim bot lain di grup.
Polling
- Ditambahkan kelas InputMediaSticker, InputMediaLocation dan InputMediaVenue.
- Ditambahkan kelas PollMedia yang merepresentasikan media dalam polling.
- Ditambahkan field media ke kelas Poll sehingga bot dapat melihat media dalam polling.
- Ditambahkan field explanation_media ke kelas Poll sehingga bot dapat melihat media dalam penjelasan kuis.
- Ditambahkan field media ke kelas PollOption sehingga bot dapat melihat media dalam opsi polling.
- Ditambahkan kelas InputPollMedia serta parameter media dan explanation_media ke metode sendPoll sehingga bot dapat menambahkan media ke polling.
- Ditambahkan kelas InputPollOptionMedia dan field media ke kelas InputPollOption sehingga bot dapat menambahkan media ke opsi polling.
- Ditambahkan field members_only ke kelas Poll.
- Ditambahkan parameter members_only ke metode sendPoll.
- Ditambahkan field country_codes ke kelas Poll.
- Ditambahkan parameter country_codes ke metode sendPoll.
- Jumlah minimum opsi polling diturunkan dari 2 menjadi 1.
Live photo
- Ditambahkan kelas LivePhoto yang merepresentasikan foto dengan video pendek.
- Ditambahkan kelas InputMediaLivePhoto.
- Ditambahkan field live_photo ke kelas Message dan ExternalReplyInfo.
- Ditambahkan metode sendLivePhoto yang memungkinkan bot mengirim live photo.
- Ditambahkan kelas PaidMediaLivePhoto yang mendeskripsikan media berbayar berupa live photo.
- Ditambahkan kelas InputPaidMediaLivePhoto yang memungkinkan bot mengirim live photo sebagai media berbayar.
- Live photo kini dapat digunakan di sendMediaGroup dan editMessageMedia,
Umum
- Business bot kini dapat mengelola akun pengguna tanpa langganan Telegram Premium.
- Ditambahkan kemampuan mengirim pesan ke bot lain melalui username jika kedua bot mengaktifkan komunikasi antarbot.
- Ditambahkan kemampuan membalas bot lain dari business bot jika business bot tersebut mengaktifkan komunikasi antarbot.
- Bot kini dapat mengirim teks kosong di metode sendMessageDraft.
- Ditambahkan kelas BotAccessSettings dan metode getManagedBotAccessSettings.
- Ditambahkan metode setManagedBotAccessSettings.
- Ditambahkan metode getUserPersonalChatMessages.
Bot API 9.6
Metode baru: getManagedBotToken, replaceManagedBotToken, savePreparedKeyboardButton
Managed bot
- Ditambahkan field can_manage_bots ke kelas User.
- Ditambahkan kelas KeyboardButtonRequestManagedBot dan field request_managed_bot ke kelas KeyboardButton.
- Ditambahkan kelas ManagedBotCreated dan field managed_bot_created ke kelas Message.
- Ditambahkan update tentang pembuatan managed bot dan perubahan tokennya, direpresentasikan oleh kelas ManagedBotUpdated dan field managed_bot di kelas Update.
- Ditambahkan metode getManagedBotToken dan replaceManagedBotToken.
- Ditambahkan kelas PreparedKeyboardButton dan metode savePreparedKeyboardButton yang memungkinkan bot meminta pengguna, chat, dan managed bot dari Mini App.
- Ditambahkan metode requestChat ke kelas WebApp.
- Ditambahkan dukungan tautan
https://t.me/newbot/{manager_bot_username}/{suggested_bot_username}[?name={suggested_bot_name}]yang memungkinkan bot meminta pembuatan managed bot melalui tautan.
Polling
- Ditambahkan dukungan kuis dengan beberapa jawaban benar.
- Field correct_option_id diganti dengan field correct_option_ids di kelas Poll.
- Parameter correct_option_id diganti dengan parameter correct_option_ids di metode sendPoll.
- Parameter allows_multiple_answers kini dapat digunakan untuk kuis di metode sendPoll.
- Waktu maksimum penutupan polling otomatis dinaikkan menjadi 2628000 detik.
- Ditambahkan field allows_revoting ke kelas Poll.
- Ditambahkan parameter allows_revoting ke metode sendPoll.
- Ditambahkan parameter shuffle_options ke metode sendPoll.
- Ditambahkan parameter allow_adding_options ke metode sendPoll.
- Ditambahkan parameter hide_results_until_closes ke metode sendPoll.
- Ditambahkan field description dan description_entities ke kelas Poll.
- Ditambahkan parameter description, description_parse_mode, dan description_entities ke metode sendPoll.
- Ditambahkan field persistent_id ke kelas PollOption yang merepresentasikan identifier persisten untuk opsi tersebut.
- Ditambahkan field option_persistent_ids ke kelas PollAnswer.
- Ditambahkan field added_by_user dan added_by_chat ke kelas PollOption yang menunjukkan pengguna dan chat yang menambahkan opsi tersebut.
- Ditambahkan field addition_date ke kelas PollOption yang mendeskripsikan tanggal opsi tersebut ditambahkan.
- Ditambahkan kelas PollOptionAdded dan field poll_option_added ke kelas Message.
- Ditambahkan kelas PollOptionDeleted dan field poll_option_deleted ke kelas Message.
- Ditambahkan field poll_option_id ke kelas ReplyParameters sehingga bot dapat membalas opsi polling tertentu.
- Ditambahkan field reply_to_poll_option_id ke kelas Message.
- Entitas “date_time” kini diizinkan di judul checklist, teks tugas checklist, TextQuote, kutipan ReplyParameters, sendGift, dan giftPremiumSubscription.
Bot API 9.5
Metode baru: setChatMemberTag
- Ditambahkan tipe MessageEntity “date_time” yang memungkinkan bot menampilkan tanggal dan waktu terformat kepada pengguna.
- Semua bot kini dapat menggunakan metode sendMessageDraft.
- Ditambahkan field tag ke kelas ChatMemberMember dan ChatMemberRestricted.
- Ditambahkan metode setChatMemberTag.
- Ditambahkan field can_edit_tag ke kelas ChatMemberRestricted dan ChatPermissions.
- Ditambahkan field can_manage_tags ke kelas ChatMemberAdministrator dan ChatAdministratorRights.
- Ditambahkan parameter can_manage_tags ke metode promoteChatMember.
- Ditambahkan field sender_tag ke kelas Message.
- Ditambahkan field iconCustomEmojiId ke kelas BottomButton.
Bot API 9.4
Metode baru: setMyProfilePhoto, removeMyProfilePhoto, getUserProfileAudios
- Bot kini dapat menggunakan custom emoji dalam pesan yang dikirim langsung oleh bot ke chat pribadi, grup, dan supergrup jika pemilik bot berlangganan Telegram Premium.
- Bot kini dapat membuat topik di chat pribadi menggunakan metode createForumTopic.
- Bot kini dapat mencegah pengguna membuat dan menghapus topik di chat pribadi melalui pengaturan baru di Mini App @BotFather.
- Ditambahkan field allows_users_to_create_topics ke kelas User.
- Ditambahkan field icon_custom_emoji_id ke kelas KeyboardButton dan InlineKeyboardButton sehingga bot dapat menampilkan custom emoji pada tombol jika bot dapat menggunakan custom emoji di pesan tersebut.
- Ditambahkan field style ke kelas KeyboardButton dan InlineKeyboardButton sehingga bot dapat mengubah warna tombol.
- Ditambahkan kelas ChatOwnerLeft dan field chat_owner_left ke kelas Message.
- Ditambahkan kelas ChatOwnerChanged dan field chat_owner_changed ke kelas Message.
- Ditambahkan metode setMyProfilePhoto dan removeMyProfilePhoto yang memungkinkan bot mengelola foto profilnya.
- Ditambahkan kelas VideoQuality dan field qualities ke kelas Video sehingga bot dapat memperoleh informasi tentang kualitas lain yang tersedia untuk video.
- Ditambahkan field first_profile_audio ke kelas ChatFullInfo.
- Ditambahkan kelas UserProfileAudios dan metode getUserProfileAudios yang memungkinkan bot mengambil daftar audio yang ditambahkan ke profil pengguna.
- Ditambahkan field rarity ke kelas UniqueGiftModel.
- Ditambahkan field is_burned ke kelas UniqueGift.
Bot API 9.3
Metode baru: sendMessageDraft, getUserGifts, getChatGifts, repostStory
Topik di chat pribadi
- Ditambahkan field has_topics_enabled ke kelas User yang dapat digunakan untuk mengetahui apakah mode topik forum diaktifkan untuk bot di chat pribadi.
- Ditambahkan metode sendMessageDraft yang memungkinkan pesan parsial di-stream ke pengguna selama sedang dibuat.
- Field message_thread_id dan is_topic_message di kelas Message kini didukung untuk pesan di chat pribadi dengan mode topik forum aktif.
- Parameter message_thread_id kini didukung di chat pribadi bertopik pada metode sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, sendMediaGroup, copyMessage, copyMessages, forwardMessage dan forwardMessages, sehingga bot dapat mengirim pesan ke topik tertentu.
- Parameter message_thread_id kini didukung di chat pribadi pada metode sendChatAction, sehingga bot dapat mengirim chat action ke topik tertentu di chat pribadi.
- Parameter message_thread_id kini didukung di chat pribadi bertopik pada metode editForumTopic, deleteForumTopic dan unpinAllForumTopicMessages, sehingga bot dapat mengelola topik di chat pribadi.
- Ditambahkan field is_name_implicit ke kelas ForumTopic dan ForumTopicCreated.
Hadiah
- Ditambahkan metode getUserGifts dan getChatGifts.
- Field last_resale_star_count diganti dengan field last_resale_currency dan last_resale_amount di kelas UniqueGiftInfo.
- Parameter exclude_limited diganti dengan parameter exclude_limited_upgradable dan exclude_limited_non_upgradable di metode getBusinessAccountGifts.
- Ditambahkan nilai “gifted_upgrade” sebagai nilai yang mungkin untuk UniqueGiftInfo.origin pada pesan tentang upgrade hadiah yang dibeli setelah hadiah dikirim.
- Ditambahkan nilai “offer” sebagai nilai yang mungkin untuk UniqueGiftInfo.origin pada pesan tentang pembelian hadiah melalui penawaran pembelian.
- Ditambahkan field gift_upgrade_sent ke kelas Message.
- Ditambahkan field gift_id ke kelas UniqueGift.
- Ditambahkan field is_from_blockchain ke kelas UniqueGift.
- Ditambahkan parameter exclude_from_blockchain di metode getBusinessAccountGifts untuk menyaring hadiah yang diberikan dari blockchain TON.
- Ditambahkan field personal_total_count dan personal_remaining_count ke kelas Gift.
- Ditambahkan field is_premium ke kelas Gift dan UniqueGift.
- Ditambahkan field is_upgrade_separate ke kelas GiftInfo dan OwnedGiftRegular.
- Ditambahkan kelas UniqueGiftColors yang mendeskripsikan skema warna nama pengguna, balasan pesan, dan pratinjau tautan berdasarkan hadiah unik.
- Ditambahkan field has_colors ke kelas Gift.
- Ditambahkan field colors ke kelas UniqueGift.
- Ditambahkan kelas GiftBackground dan field background ke kelas Gift.
- Ditambahkan field unique_gift_variant_count ke kelas Gift.
- Ditambahkan field unique_gift_number ke kelas GiftInfo dan OwnedGiftRegular.
- Ditambahkan field gifts_from_channels ke kelas AcceptedGiftTypes.
Lain-lain
- Bot kini dapat menonaktifkan username utamanya jika memiliki username aktif tambahan yang dibeli di Fragment.
- Bot kini dapat menonaktifkan hak can_restrict_members di chat channel.
- Ditambahkan metode repostStory yang memungkinkan bot memposting ulang story di berbagai akun bisnis yang dikelolanya.
- Ditambahkan kelas UserRating dan field rating ke kelas ChatFullInfo.
- Harga maksimum media berbayar dinaikkan menjadi 25000 Telegram Stars.
- Ditambahkan field paid_message_star_count ke kelas ChatFullInfo.
- Ditambahkan parameter message_effect_id ke metode forwardMessage dan copyMessage.
- Ditambahkan field unique_gift_colors ke kelas ChatFullInfo.
- Ditambahkan field completed_by_chat ke kelas ChecklistTask.
Bot API 9.2
Metode baru: approveSuggestedPost, declineSuggestedPost
Checklist
- Ditambahkan field checklist_task_id ke kelas ReplyParameters sehingga bot dapat membalas tugas checklist tertentu.
- Ditambahkan field reply_to_checklist_task_id ke kelas Message.
Hadiah
- Ditambahkan field publisher_chat ke kelas Gift dan UniqueGift yang dapat digunakan untuk mendapatkan informasi tentang chat yang menerbitkan hadiah.
Direct messages di channel
- Ditambahkan field is_direct_messages ke kelas Chat dan ChatFullInfo yang dapat digunakan untuk mengidentifikasi supergrup yang digunakan sebagai chat direct messages channel.
- Ditambahkan field parent_chat ke kelas ChatFullInfo yang menunjukkan channel induk dari chat direct messages channel.
- Ditambahkan kelas DirectMessagesTopic dan field direct_messages_topic ke kelas Message yang mendeskripsikan topik chat direct messages.
- Ditambahkan parameter direct_messages_topic_id ke metode sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, sendMediaGroup, copyMessage, copyMessages, forwardMessage dan forwardMessages. Parameter ini dapat digunakan untuk mengirim pesan ke topik chat direct messages.
Postingan yang disarankan
- Ditambahkan kelas SuggestedPostParameters dan parameter suggested_post_parameters ke metode sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, copyMessage, forwardMessage. Parameter ini dapat digunakan untuk mengirim postingan yang disarankan ke topik chat direct messages.
- Ditambahkan metode approveSuggestedPost yang memungkinkan bot menyetujui postingan yang disarankan.
- Ditambahkan metode declineSuggestedPost yang memungkinkan bot menolak postingan yang disarankan.
- Ditambahkan field can_manage_direct_messages ke kelas ChatMemberAdministrator dan ChatAdministratorRights.
- Ditambahkan parameter can_manage_direct_messages ke metode promoteChatMember.
- Ditambahkan field is_paid_post ke kelas Message yang dapat digunakan untuk mengidentifikasi postingan berbayar. Postingan seperti ini tidak boleh dihapus selama 24 jam agar pembayaran diterima.
- Ditambahkan kelas SuggestedPostPrice yang mendeskripsikan harga postingan yang disarankan.
- Ditambahkan kelas SuggestedPostInfo dan field suggested_post_info ke kelas Message yang mendeskripsikan postingan yang disarankan.
- Ditambahkan kelas SuggestedPostApproved dan field suggested_post_approved ke kelas Message yang mendeskripsikan pesan layanan tentang persetujuan postingan yang disarankan.
- Ditambahkan kelas SuggestedPostApprovalFailed dan field suggested_post_approval_failed ke kelas Message yang mendeskripsikan pesan layanan tentang kegagalan persetujuan postingan yang disarankan.
- Ditambahkan kelas SuggestedPostDeclined dan field suggested_post_declined ke kelas Message yang mendeskripsikan pesan layanan tentang penolakan postingan yang disarankan.
- Ditambahkan kelas SuggestedPostPaid dan field suggested_post_paid ke kelas Message yang mendeskripsikan pesan layanan tentang pembayaran yang berhasil untuk postingan yang disarankan.
- Ditambahkan kelas SuggestedPostRefunded dan field suggested_post_refunded ke kelas Message yang mendeskripsikan pesan layanan tentang pengembalian dana untuk postingan yang disarankan.
Bot API 9.1
Metode baru: sendChecklist, editMessageChecklist, getMyStarBalance
Checklist
- Ditambahkan kelas ChecklistTask yang merepresentasikan tugas dalam checklist.
- Ditambahkan kelas Checklist yang merepresentasikan checklist.
- Ditambahkan kelas InputChecklistTask yang merepresentasikan tugas yang akan ditambahkan ke checklist.
- Ditambahkan kelas InputChecklist yang merepresentasikan checklist yang akan dibuat.
- Ditambahkan field checklist ke kelas Message dan ExternalReplyInfo yang mendeskripsikan checklist dalam pesan.
- Ditambahkan kelas ChecklistTasksDone dan field checklist_tasks_done ke kelas Message yang mendeskripsikan pesan layanan tentang perubahan status tugas dalam checklist (yaitu ditandai selesai/belum selesai).
- Ditambahkan kelas ChecklistTasksAdded dan field checklist_tasks_added ke kelas Message yang mendeskripsikan pesan layanan tentang penambahan tugas baru ke checklist.
- Ditambahkan metode sendChecklist yang memungkinkan bot mengirim checklist atas nama akun bisnis.
- Ditambahkan metode editMessageChecklist yang memungkinkan bot mengedit checklist atas nama akun bisnis.
Hadiah
- Ditambahkan field next_transfer_date ke kelas OwnedGiftUnique dan UniqueGiftInfo.
- Ditambahkan field last_resale_star_count ke kelas UniqueGiftInfo.
- Ditambahkan “resale” sebagai nilai yang mungkin untuk field origin di kelas UniqueGiftInfo.
Umum
- Jumlah maksimum opsi dalam polling dinaikkan menjadi 12.
- Ditambahkan metode getMyStarBalance yang memungkinkan bot mendapatkan saldo Telegram Stars miliknya saat ini.
- Ditambahkan kelas DirectMessagePriceChanged dan field direct_message_price_changed ke kelas Message yang mendeskripsikan pesan layanan tentang perubahan harga direct messages yang dikirim ke chat channel.
- Ditambahkan metode hideKeyboard ke kelas WebApp.
Bot API 9.0
Metode baru: readBusinessMessage, deleteBusinessMessages, setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto, removeBusinessAccountProfilePhoto, setBusinessAccountGiftSettings, getBusinessAccountStarBalance, transferBusinessAccountStars, getBusinessAccountGifts, convertGiftToStars, upgradeGift, transferGift, postStory, editStory, deleteStory, giftPremiumSubscription
Akun bisnis
- Ditambahkan kelas BusinessBotRights, dan field can_reply diganti dengan field rights bertipe BusinessBotRights di kelas BusinessConnection.
- Ditambahkan metode readBusinessMessage yang memungkinkan bot menandai pesan masuk sebagai telah dibaca atas nama akun bisnis.
- Ditambahkan metode deleteBusinessMessages yang memungkinkan bot menghapus pesan atas nama akun bisnis.
- Ditambahkan metode setBusinessAccountName yang memungkinkan bot mengubah nama depan dan nama belakang akun bisnis yang dikelola.
- Ditambahkan metode setBusinessAccountUsername yang memungkinkan bot mengubah username akun bisnis yang dikelola.
- Ditambahkan metode setBusinessAccountBio yang memungkinkan bot mengubah bio akun bisnis yang dikelola.
- Ditambahkan kelas InputProfilePhoto yang mendeskripsikan foto profil yang akan dipasang.
- Ditambahkan metode setBusinessAccountProfilePhoto dan removeBusinessAccountProfilePhoto yang memungkinkan bot mengubah foto profil akun bisnis yang dikelola.
- Ditambahkan metode setBusinessAccountGiftSettings yang memungkinkan bot mengubah pengaturan privasi terkait hadiah masuk di akun bisnis yang dikelola.
- Ditambahkan kelas StarAmount dan metode getBusinessAccountStarBalance yang memungkinkan bot memeriksa saldo Telegram Stars akun bisnis yang dikelola saat ini.
- Ditambahkan metode transferBusinessAccountStars yang memungkinkan bot mentransfer Telegram Stars dari saldo akun bisnis yang dikelola ke saldonya sendiri untuk ditarik.
- Ditambahkan kelas OwnedGiftRegular, OwnedGiftUnique, OwnedGifts dan metode getBusinessAccountGifts yang memungkinkan bot mengambil daftar hadiah milik akun bisnis yang dikelola.
- Ditambahkan metode convertGiftToStars yang memungkinkan bot mengonversi hadiah yang diterima akun bisnis yang dikelola menjadi Telegram Stars.
- Ditambahkan metode upgradeGift yang memungkinkan bot meng-upgrade hadiah biasa yang diterima akun bisnis yang dikelola menjadi hadiah unik.
- Ditambahkan metode transferGift yang memungkinkan bot mentransfer hadiah unik milik akun bisnis yang dikelola.
- Ditambahkan kelas InputStoryContentPhoto dan InputStoryContentVideo yang merepresentasikan konten story yang akan diposting.
- Ditambahkan kelas StoryArea, StoryAreaPosition, LocationAddress, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeLink, StoryAreaTypeWeather dan StoryAreaTypeUniqueGift yang mendeskripsikan area aktif yang dapat diklik pada story.
- Ditambahkan metode postStory yang memungkinkan bot memposting story atas nama akun bisnis yang dikelola.
- Ditambahkan metode editStory yang memungkinkan bot mengedit story yang sebelumnya diposting atas nama akun bisnis yang dikelola.
- Ditambahkan metode deleteStory yang memungkinkan bot menghapus story yang sebelumnya diposting atas nama akun bisnis yang dikelola.
Mini App
- Ditambahkan field DeviceStorage yang memungkinkan Mini App menggunakan penyimpanan lokal persisten di perangkat pengguna.
- Ditambahkan field SecureStorage yang memungkinkan Mini App menggunakan penyimpanan lokal yang aman di perangkat pengguna untuk data sensitif.
Hadiah
- Ditambahkan kelas UniqueGiftModel, UniqueGiftSymbol, UniqueGiftBackdropColors dan UniqueGiftBackdrop untuk mendeskripsikan properti hadiah unik.
- Ditambahkan kelas UniqueGift yang mendeskripsikan hadiah yang telah di-upgrade menjadi hadiah unik.
- Ditambahkan kelas AcceptedGiftTypes yang mendeskripsikan tipe hadiah yang diterima oleh pengguna atau chat.
- Field can_send_gift diganti dengan field accepted_gift_types bertipe AcceptedGiftTypes di kelas ChatFullInfo.
- Ditambahkan kelas GiftInfo dan field gift ke kelas Message yang mendeskripsikan pesan layanan tentang hadiah biasa yang dikirim atau diterima.
- Ditambahkan kelas UniqueGiftInfo dan field unique_gift ke kelas Message yang mendeskripsikan pesan layanan tentang hadiah unik yang dikirim atau diterima.
Telegram Premium
- Ditambahkan metode giftPremiumSubscription yang memungkinkan bot menghadiahkan langganan Telegram Premium kepada pengguna dengan pembayaran Telegram Stars.
- Ditambahkan field premium_subscription_duration ke kelas TransactionPartnerUser untuk transaksi yang melibatkan langganan Telegram Premium yang dibeli oleh bot.
- Ditambahkan field transaction_type ke kelas TransactionPartnerUser untuk mempermudah pembedaan dan pemrosesan semua tipe transaksi.
Umum
- Harga maksimum media berbayar dinaikkan menjadi 10000 Telegram Stars.
- Harga maksimum untuk satu periode langganan dinaikkan menjadi 10000 Telegram Stars.
- Ditambahkan kelas PaidMessagePriceChanged dan field paid_message_price_changed ke kelas Message yang mendeskripsikan pesan layanan tentang perubahan harga pesan berbayar yang dikirim ke chat.
- Ditambahkan field paid_star_count ke kelas Message yang berisi jumlah Telegram Stars yang dibayarkan untuk mengirim pesan.
Versi sebelumnya
Rilis sebelum Bot API 9.0 dicantumkan beserta tanggalnya. Deskripsi lengkapnya ada di changelog resmi.
- Bot API 8.3 — 12 Februari 2025
- Bot API 8.2 — 1 Januari 2025
- Bot API 8.1 — 4 Desember 2024
- Bot API 8.0 — 17 November 2024
- Bot API 7.11 — 31 Oktober 2024
- Bot API 7.10 — 6 September 2024
- Bot API 7.9 — 14 Agustus 2024
- Bot API 7.8 — 31 Juli 2024
- Bot API 7.7 — 7 Juli 2024
- Bot API 7.6 — 1 Juli 2024
- Bot API 7.5 — 18 Juni 2024
- Bot API 7.4 — 28 Mei 2024
- Bot API 7.3 — 6 Mei 2024
- Bot API 7.2 — 31 Maret 2024
- Bot API 7.1 — 16 Februari 2024
- Bot API 7.0 — 29 Desember 2023
- Bot API 6.9 — 22 September 2023
- Bot API 6.8 — 18 Agustus 2023
- Bot API 6.7 — 21 April 2023
- Bot API 6.6 — 9 Maret 2023
- Bot API 6.5 — 3 Februari 2023
- Bot API 6.4 — 30 Desember 2022
- Bot API 6.3 — 5 November 2022
- Bot API 6.2 — 12 Agustus 2022
- Bot API 6.1 — 20 Juni 2022
- Bot API 6.0 — 16 April 2022
- Bot API 5.7 — 31 Januari 2022
- Bot API 5.6 — 30 Desember 2021
- Bot API 5.5 — 7 Desember 2021
- Bot API 5.4 — 5 November 2021
- Bot API 5.3 — 25 Juni 2021
- Bot API 5.2 — 26 April 2021
- Bot API 5.1 — 9 Maret 2021
- Bot API 5.0 — 4 November 2020
- Bot API 4.9 — 4 Juni 2020
- Bot API 4.8 — 24 April 2020
- Bot API 4.7 — 30 Maret 2020
- Bot API 4.6 — 23 Januari 2020
- Bot API 4.5 — 31 Desember 2019
- Bot API 4.4 — 29 Juli 2019
- Bot API 4.3 — 31 Mei 2019
- Bot API 4.2 — 14 April 2019
- Bot API 4.1 — 27 Agustus 2018
- Bot API 4.0 — 26 Juli 2018
- Bot API 3.6 — 13 Februari 2018
- Bot API 3.5 — 17 November 2017
- Bot API 3.4 — 11 Oktober 2017
- Bot API 3.3 — 23 Agustus 2017
- Bot API 3.2 — 21 Juli 2017
- Bot API 3.1 — 30 Juni 2017
- Bot API 3.0 — 18 Mei 2017
- Bot API 2.3.1 — 4 Desember 2016
- Bot API 2.3 — 21 November 2016
- Bot API 2.2. — 3 Oktober 2016
- Bot API 2.1. — 22 Mei 2016
- Bot API 2.0 — 9 April 2016
Pertanyaan umum
Apa versi terbaru Telegram Bot API?
Bot API 10.5, dirilis pada 22 November 2026. Versi ini memiliki 194 metode.
Seberapa sering Telegram Bot API berubah?
Telegram biasanya merilis versi Bot API baru setiap satu hingga dua bulan. Setiap rilis menambahkan metode dan field; beberapa rilis juga berisi breaking change, yang ditandai dalam deskripsi.
Bagaimana cara mengetahui kapan sebuah metode ditambahkan?
Buka metode tersebut di referensi metode kami: bagian Riwayat versi menampilkan rilis yang menambahkannya dan rilis yang mengubahnya, dengan tautan ke halaman ini.