Telegram Bot API değişiklik günlüğü
Telegram Bot API'deki 9.0 sürümünden (Nisan 2025) güncel Bot API 10.5 sürümüne (22 Kasım 2026) kadar tüm değişiklikler, en yeniden eskiye. Metot adları parametreler ve örnekler içeren referansımıza, sınıf adları ise resmi dokümantasyona bağlanır.
Bot API 10.5 En yeni
Yeni metotlar: setMySettings
Bot ayarları
- Botların ayarlarını değiştirmesini sağlayan setMySettings metodu eklendi: satır içi mod ayarları, gizlilik modu, gruplara eklenebilme, özel sohbetlerde forum konusu modu ve callback sorgularını alma modu.
- setMySettings metodunun callback_query_mode parametresine bağlı olarak, botun gönderdiği mesajlardaki butonlardan gelen callback sorgularını CallbackQuery sınıfında message alanı yerine inline_message_id alanıyla alabilme özelliği eklendi.
- setMySettings metodunun has_topic_sidebar parametresiyle botların, botla özel sohbetlerde konu listesini kenar çubuğunda gösterebilmesi sağlandı.
- BotFullInfo sınıfı User sınıfından ayrıldı ve getMe metodunun dönüş tipi BotFullInfo olarak değiştirildi. Yalnızca getMe içinde döndürülen alanlar User sınıfından kaldırıldı.
- BotFullInfo sınıfına active_usernames alanı eklendi; bot tüm aktif kullanıcı adlarının listesini alabilir.
- BotFullInfo sınıfına inline_query_placeholder alanı eklendi; bot satır içi sorgular için yer tutucusunu alabilir.
- BotFullInfo sınıfına needs_inline_query_location alanı eklendi; bot her satır içi sorguda kullanıcının konumunu isteyip istemediğini kontrol edebilir.
- BotFullInfo sınıfına has_topic_sidebar alanı eklendi; bot, botla özel sohbetlerdeki konuların kenar çubuğunda gösterilip gösterilmediğini kontrol edebilir.
Genel
- Bot sahipleri
https://t.me/botinvite/<bot_username>bağlantısına basarak botla özel sohbete aynı anda en fazla 10 kullanıcı davet edebilir. Bot, davet edilen kullanıcılara mesaj gönderebilir. - Bot sahibi tarafından botla özel sohbete davet edilen kullanıcılarla ilgili servis mesajları için WriteAccessAllowed sınıfına inviter alanı eklendi.
- RichBlockExpandableBlockQuotation ve InputRichBlockExpandableBlockQuotation sınıflarında text alanı blocks alanıyla değiştirildi; genişletilebilir alıntı blokları artık herhangi bir blok içerebilir.
Bot API 10.4
Yeni metotlar: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData, getChatShareThemeBackdrops, getUniqueGift, deleteBusinessAccountGift
Widget'lar
- HTML widget'ları içeren mesajlar için Widget sınıfı ve Message ile ExternalReplyInfo sınıflarına widget alanı eklendi.
- Botların HTML widget'ları içeren mesajlar göndermesini sağlayan sendWidget metodu eklendi. Şu anda üretim ortamında widget'lar yalnızca özel sohbetlere gönderilebilir; gönderilen widget'lar otomatik olarak korumalı içeriktir ve bu nedenle iletilemez.
- Botların kendi oluşturduğu paylaşılan widget'ları yeniden göndermesini sağlayan sendSharedWidget metodu eklendi.
- Bot tarafından veya bot aracılığıyla gönderilen mesajlardaki widget'ların bota gönderdiği sorgular için WidgetQuery sınıfı ve Update sınıfına widget_query alanı eklendi.
- Paylaşılan widget içeren iletilmiş mesajlardan bota gönderilen sorgular için SharedWidgetQuery sınıfı ve Update sınıfına shared_widget_query alanı eklendi.
- Widget'tan gelen sorgunun türünü tanımlayan WidgetQueryType, WidgetQueryTypeData, WidgetQueryTypeSignData, WidgetQueryTypeSentTransaction ve WidgetQueryWallet sınıfları eklendi. Bir sorgu; kullanıcının TON cüzdan kartıyla birlikte bot için veri, kullanıcının TON cüzdanıyla imzalanmış veri veya kullanıcının TON cüzdanından gönderilen bir işlem bildirimi içerebilir.
- Botların widget sorgularını yanıtlamasını sağlayan answerWidgetQuery metodu eklendi.
- Botların bir mesajdaki widget verisini değiştirmesini sağlayan editMessageWidgetData metodu eklendi.
- Botların paylaşılan bir widget'ın herkese açık verisini değiştirmesini sağlayan editSharedWidgetData metodu eklendi.
- Botların satır içi sorgulara yanıt olarak widget göndermesini sağlayan InputWidgetMessageContent ve InputSharedWidgetMessageContent sınıfları eklendi. Şu anda üretim ortamında widget'lar satır içi sorgulara yanıt olarak gönderilemez.
- Widget mesajları copyMessage ve copyMessages metotlarıyla kopyalanamaz.
- ChatPermissions ve ChatMemberRestricted sınıflarındaki can_send_other_messages yetkisi artık widget göndermeye de izin veriyor.
Geçici mesajlar
- Botlar, sendMessage, sendRichMessage, sendAnimation, sendAudio, sendContact, sendDocument, sendLivePhoto, sendLocation, sendPhoto, sendSticker, sendVenue, sendVideo, sendVideoNote ve sendVoice metotlarının ephemeral_message_parameters parametresinde receiver_user_id olmadan callback_query_id belirterek, kanal doğrudan mesaj sohbetleri dışındaki tüm sohbetlerde callback sorgularına geçici yanıt gönderebilir.
- EphemeralMessageParameters sınıfının receiver_user_id alanı ve adı geçen metotların chat_id parametresi artık isteğe bağlı.
Zengin mesajlardan alıntılar
- Bir RichMessage içinden seçilen alıntılar için TextQuote sınıfına rich_texts alanı eklendi.
- ReplyParameters sınıfına quote_rich_texts alanı eklendi; botlar zengin mesajlardan alıntı yapabilir.
TON cüzdanı
- TonWalletCard, TonWalletCardSticker, TonNft ve TonNftAttribute sınıfları ile ChatFullInfo sınıfına ton_wallet_card alanı eklendi.
- TON cüzdanıyla yapılan transferlere ilişkin servis mesajları için TonWalletTransfer sınıfı ve Message sınıfına ton_wallet_transfer alanı eklendi.
- StoryAreaPosition sınıfının adı AreaPosition olarak değiştirildi, çünkü artık TON cüzdan kartlarındaki çıkartmaların konumunu tanımlamak için de kullanılıyor.
Sohbet paylaşım temaları
- Bir kullanıcının veya sohbetin bağlantısını paylaşma ekranının temasını tanımlayan ChatShareTheme, ChatShareThemeEmoji ve ChatShareThemeUniqueGift sınıfları ile ChatFullInfo sınıfına share_theme alanı eklendi.
- EmojiType, EmojiTypeEmoji ve EmojiTypeCustomEmoji sınıfları eklendi.
- ChatShareThemeBackdrop ve ChatShareThemeBackdrops sınıfları ile getChatShareThemeBackdrops metodu eklendi.
Hediyeler
- Botların benzersiz bir hediye hakkında adına göre bilgi almasını sağlayan getUniqueGift metodu eklendi.
- Botların yönetilen bir işletme hesabına ait normal hediyeleri, karşılığında Telegram Stars almadan silmesini sağlayan deleteBusinessAccountGift metodu eklendi.
Genel
- Telegram Premium aboneliği olan kullanıcılar, sahip oldukları en fazla 2 bota “agent”, “ai”, “app”, “game” veya “gay” ile biten ikincil kullanıcı adları atayabilir. Bu tür kullanıcı adları KeyboardButtonRequestManagedBot sınıfının suggested_username alanında önerilebilir.
- Bir RichMessage içinde TON blokzincirindeki bir adresi temsil eden RichTextTonAddress sınıfı eklendi.
- TON blokzincirindeki adresler için MessageEntity sınıfına “ton_address” türü eklendi.
- Banka kartı numaraları için MessageEntity sınıfına “bank_card_number” türü eklendi.
- verifyUser ve verifyChat metotlarına custom_description_parse_mode ve custom_description_entities parametreleri eklendi.
- Gönderenin Telegram Stars ödemeden mesaj göndermeye izin veren bir bağlantı kullandığına dair servis mesajları için PaidMessagesWaived sınıfı ve Message sınıfına paid_messages_waived alanı eklendi.
- Botla özel sohbetlerdeki konulara
https://t.me/<bot_username>/<message_thread_id>biçiminde bağlantı oluşturma özelliği eklendi. Böyle bir bağlantı, konuyu yalnızca o konunun bulunduğu özel sohbetteki kullanıcı için açar.
Bot API 10.3
Zengin mesajlar
- Bir RichMessage içindeki butonu temsil eden RichMessageButton sınıfı eklendi.
- RichTextButton sınıfı eklendi.
- RichBlockButtons ve InputRichBlockButtons sınıfları eklendi.
- RichBlockTable ve InputRichBlockTable sınıflarına is_compact alanı eklendi.
- Genişletilip yeniden daraltılabilen alıntı bloğunu temsil eden RichBlockExpandableBlockQuotation ve InputRichBlockExpandableBlockQuotation sınıfları eklendi.
- Dosya içeren RichBlockDocument ve InputRichBlockDocument sınıfları eklendi.
- Zengin mesajlarda genel dosya yüklemeleri için
tg://document?id=biçimindeki bağlantılar desteklendi.
Geçici mesajlar
- EphemeralMessageParameters sınıfı eklendi ve sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation ve sendVenue metotlarındaki receiver_user_id ile callback_query_id parametreleri ephemeral_message_parameters parametresiyle değiştirildi.
- sendRichMessage metoduna ephemeral_message_parameters parametresi eklendi.
- EphemeralMessageParameters sınıfına replace_callback_query_message alanı eklendi; botlar geçici mesajı orijinal mesajın yerinde gösterebilir.
- editEphemeralMessageMedia metodunda yeni dosya yükleme desteklendi.
- editEphemeralMessageCaption metoduna show_caption_above_media parametresi eklendi.
- editEphemeralMessageText metoduna rich_message parametresi eklendi.
- ChatAdministratorRights ve ChatMemberAdministrator sınıflarına can_send_welcome_messages alanı eklendi.
- promoteChatMember metoduna can_send_welcome_messages parametresi eklendi.
Yanıt klavyesi
- DisabledButton sınıfı ve InlineKeyboardButton sınıfına disabled alanı eklendi.
- InlineKeyboardMarkup ve ReplyKeyboardMarkup sınıflarına force_reply alanı eklendi.
Genel
- sendMessageDraft ve sendRichMessageDraft metotlarına can_stop ve keep_on_stop parametreleri eklendi.
- Kullanıcının mesaj üretimini durdurmasına ilişkin güncellemeler eklendi; bunlar MessageGenerationStopped sınıfı ve Update sınıfındaki stopped_message_generation alanıyla temsil edilir.
- Bir topluluktan bir sohbete katılımla ilgili servis mesajları için CommunityChatJoined sınıfı ve Message sınıfına community_chat_joined alanı eklendi.
- UniqueGiftInfo sınıfına text, entities ve is_private alanları eklendi.
Bot API 10.2
Yeni metotlar: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage
Zengin mesajlar
- InputRichMessageMedia sınıfı ve InputRichMessage sınıfına media alanı eklendi; botlar zengin mesaj gönderirken markdown veya html biçimlendirmesinde kullanılan medyayı açıkça belirtebilir.
- Gönderilecek bir sesli mesajı temsil eden InputMediaVoiceNote sınıfı eklendi.
- Gönderilecek bir listedeki öğeyi temsil eden InputRichBlockListItem sınıfı eklendi.
- Giden bir zengin mesajı biçimlendirmek için kullanılabilen farklı blok türlerini temsil eden InputRichBlockParagraph, InputRichBlockSectionHeading, InputRichBlockPreformatted, InputRichBlockFooter, InputRichBlockDivider, InputRichBlockMathematicalExpression, InputRichBlockAnchor, InputRichBlockList, InputRichBlockBlockQuotation, InputRichBlockPullQuotation, InputRichBlockCollage, InputRichBlockSlideshow, InputRichBlockTable, InputRichBlockDetails, InputRichBlockMap, InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote ve InputRichBlockThinking sınıfları eklendi.
- InputRichMessage sınıfına blocks alanı eklendi; botlar zengin mesaj biçimlendirmesini blok öğeleriyle belirtebilir.
Geçici mesajlar
- Geçici mesajlar desteği getirildi; botlar yalnızca belirli bir kullanıcı ve bot tarafından görülebilen grup mesajları gönderebilir ve komutlar alabilir.
- BotCommand sınıfına is_ephemeral alanı eklendi.
- Message sınıfına receiver_user alanı eklendi.
- Message sınıfına ephemeral_message_id alanı eklendi.
- sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation ve sendVenue metotlarına receiver_user_id ve callback_query_id parametreleri eklendi.
- ReplyParameters sınıfına ephemeral_message_id alanı eklendi; botlar geçici mesajlara yanıt verebilir.
- ReplyParameters sınıfındaki message_id alanı, ephemeral_message_id alanı varsa isteğe bağlı olarak işaretlendi.
- Botların geçici mesajları düzenlemesini sağlayan editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption ve editEphemeralMessageReplyMarkup metotları eklendi.
- Botların geçici mesajları silmesini sağlayan deleteEphemeralMessage metodu eklendi.
Topluluklar
- Topluluklar için ilk destek getirildi: ortak bir konu veya kitle etrafında birbirine bağlanan birkaç süper grup, kanal ve bot.
- Bir topluluğu temsil eden Community sınıfı eklendi.
- CommunityChatAdded sınıfı ve Message sınıfına community_chat_added alanı eklendi.
- CommunityChatRemoved sınıfı ve Message sınıfına community_chat_removed alanı eklendi.
- ChatFullInfo sınıfına community alanı eklendi.
Genel
- Kullanıcının ödeme aboneliğindeki değişikliklere ilişkin güncellemeler eklendi; bunlar BotSubscriptionUpdated sınıfı ve Update sınıfındaki subscription alanıyla temsil edilir.
- Mini App metotlarının orijinal Mini App alan adından farklı kaynaklardan kullanılması engellenerek Mini App güvenliği sıkılaştırıldı. Koruma 20 Temmuz 2026'da tüm Mini App'ler için otomatik olarak etkinleştirilecek. Korumayı @BotFather Mini App'i üzerinden devre dışı bırakabilirsiniz. Bunu yaparsanız, Mini App'te güvenilmeyen sitelere bağlantı bulunmamasını sağlamanın botun sorumluluğunda olduğunu kabul etmiş olursunuz.
Bot API 10.1
Yeni metotlar: sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp
Zengin mesajlar
- Zengin mesajlar desteği eklendi; botlar yüksek düzeyde yapılandırılmış metin gönderebilir ve yapay zekâ tarafından üretilen yanıtları kesintisiz zengin biçimlendirmeyle akış hâlinde iletebilir.
- Farklı zengin biçimlendirilmiş metin türlerini temsil eden RichTextBold, RichTextItalic, RichTextUnderline, RichTextStrikethrough, RichTextSpoiler, RichTextDateTime, RichTextTextMention, RichTextSubscript, RichTextSuperscript, RichTextMarked, RichTextCode, RichTextCustomEmoji, RichTextMathematicalExpression, RichTextUrl, RichTextEmailAddress, RichTextPhoneNumber, RichTextBankCardNumber, RichTextMention, RichTextHashtag, RichTextCashtag, RichTextBotCommand, RichTextAnchor, RichTextAnchorLink, RichTextReference ve RichTextReferenceLink sınıfları eklendi.
- Zengin biçimlendirilmiş metni temsil eden RichText sınıfı eklendi.
- Zengin biçimlendirilmiş metnin açıklamasını temsil eden RichBlockCaption sınıfı eklendi.
- Tablodaki bir hücreyi temsil eden RichBlockTableCell sınıfı eklendi.
- Listedeki bir öğeyi temsil eden RichBlockListItem sınıfı eklendi.
- Zengin biçimlendirilmiş mesajdaki farklı blok türlerini temsil eden RichBlockParagraph, RichBlockSectionHeading, RichBlockPreformatted, RichBlockFooter, RichBlockDivider, RichBlockMathematicalExpression, RichBlockAnchor, RichBlockList, RichBlockBlockQuotation, RichBlockPullQuotation, RichBlockCollage, RichBlockSlideshow, RichBlockTable, RichBlockDetails, RichBlockMap, RichBlockAnimation, RichBlockAudio, RichBlockPhoto, RichBlockVideo, RichBlockVoiceNote ve RichBlockThinking sınıfları eklendi.
- Zengin biçimlendirilmiş mesajdaki bir bloğu temsil eden RichBlock sınıfı eklendi.
- Zengin biçimlendirilmiş mesajı temsil eden RichMessage sınıfı eklendi.
- Message sınıfına rich_message alanı eklendi.
- Gönderilecek zengin mesajı tanımlayan InputRichMessage sınıfı eklendi.
- InputRichMessageContent sınıfı eklendi ve satır içi, misafir ve Web App sorgularının sonuçlarında InputMessageContent olarak kullanılmasına izin verildi.
- Botların zengin mesaj göndermesini sağlayan sendRichMessage metodu eklendi.
- Botların kısmi zengin mesajları akış hâlinde iletmesini sağlayan sendRichMessageDraft metodu eklendi.
- editMessageText metoduna rich_message parametresi eklendi; botlar zengin mesajları düzenleyebilir.
Katılma isteği sorguları
- User sınıfına supports_join_request_queries alanı eklendi.
- ChatFullInfo sınıfına guard_bot alanı eklendi.
- ChatJoinRequest sınıfına query_id alanı eklendi.
- answerChatJoinRequestQuery metodu eklendi.
- sendChatJoinRequestWebApp metodu eklendi.
Anketler
- Link sınıfı ve PollMedia sınıfına link alanı eklendi.
- InputMediaLink sınıfı eklendi ve InputPollOptionMedia olarak kullanılmasına izin verildi.
Bot API 10.0
Yeni metotlar: answerGuestQuery, deleteAllMessageReactions, deleteMessageReaction, sendLivePhoto, getManagedBotAccessSettings, setManagedBotAccessSettings, getUserPersonalChatMessages
Misafir modu
- Misafir modu desteği getirildi; botlar üyesi olmadıkları sohbetlerde belirli mesajları alabilir ve yanıt verebilir.
- User sınıfına supports_guest_queries alanı eklendi.
- Message sınıfına guest_bot_caller_user ve guest_bot_caller_chat alanları eklendi.
- Message sınıfına guest_query_id alanı eklendi.
- Update sınıfına guest_message alanı eklendi.
- SentGuestMessage sınıfı ve answerGuestQuery metodu eklendi.
Sohbet yönetimi
- ChatMemberRestricted ve ChatPermissions sınıflarına can_react_to_messages alanı eklendi.
- getChatAdministrators metoduna return_bots parametresi eklendi.
- deleteAllMessageReactions metodu eklendi.
- deleteMessageReaction metodu eklendi.
- Gruplarda diğer botların gönderdiği belirli mesajları görebilme özelliği eklendi.
Anketler
- InputMediaSticker, InputMediaLocation ve InputMediaVenue sınıfları eklendi.
- Bir anketteki medyayı temsil eden PollMedia sınıfı eklendi.
- Poll sınıfına media alanı eklendi; botlar anketlerdeki medyayı görebilir.
- Poll sınıfına explanation_media alanı eklendi; botlar quiz açıklamalarındaki medyayı görebilir.
- PollOption sınıfına media alanı eklendi; botlar anket seçeneklerindeki medyayı görebilir.
- InputPollMedia sınıfı ve sendPoll metoduna media ile explanation_media parametreleri eklendi; botlar anketlere medya ekleyebilir.
- InputPollOptionMedia sınıfı ve InputPollOption sınıfına media alanı eklendi; botlar anket seçeneklerine medya ekleyebilir.
- Poll sınıfına members_only alanı eklendi.
- sendPoll metoduna members_only parametresi eklendi.
- Poll sınıfına country_codes alanı eklendi.
- sendPoll metoduna country_codes parametresi eklendi.
- Minimum anket seçeneği sayısı 2'den 1'e düşürüldü.
Canlı fotoğraflar
- Kısa bir video içeren fotoğrafı temsil eden LivePhoto sınıfı eklendi.
- InputMediaLivePhoto sınıfı eklendi.
- Message ve ExternalReplyInfo sınıflarına live_photo alanı eklendi.
- Botların canlı fotoğraf göndermesini sağlayan sendLivePhoto metodu eklendi.
- Canlı fotoğraf içeren ücretli medyayı tanımlayan PaidMediaLivePhoto sınıfı eklendi.
- Botların canlı fotoğrafları ücretli medya olarak göndermesini sağlayan InputPaidMediaLivePhoto sınıfı eklendi.
- sendMediaGroup ve editMessageMedia metotlarında canlı fotoğraf kullanımına izin verildi.
Genel
- İşletme botlarının, Telegram Premium aboneliği olmayan kullanıcı hesaplarını da yönetmesine izin verildi.
- Her iki bot da bottan bota iletişimi etkinleştirdiyse, diğer botlara kullanıcı adıyla mesaj gönderme özelliği eklendi.
- İşletme botu bottan bota iletişimi etkinleştirdiyse, işletme botundan diğer botlara yanıt verme özelliği eklendi.
- Botların sendMessageDraft metodunda boş metin göndermesine izin verildi.
- BotAccessSettings sınıfı ve getManagedBotAccessSettings metodu eklendi.
- setManagedBotAccessSettings metodu eklendi.
- getUserPersonalChatMessages metodu eklendi.
Bot API 9.6
Yeni metotlar: getManagedBotToken, replaceManagedBotToken, savePreparedKeyboardButton
Yönetilen botlar
- User sınıfına can_manage_bots alanı eklendi.
- KeyboardButtonRequestManagedBot sınıfı ve KeyboardButton sınıfına request_managed_bot alanı eklendi.
- ManagedBotCreated sınıfı ve Message sınıfına managed_bot_created alanı eklendi.
- Yönetilen botların oluşturulması ve token'larının değişmesiyle ilgili güncellemeler eklendi; bunlar ManagedBotUpdated sınıfı ve Update sınıfındaki managed_bot alanıyla temsil edilir.
- getManagedBotToken ve replaceManagedBotToken metotları eklendi.
- PreparedKeyboardButton sınıfı ve savePreparedKeyboardButton metodu eklendi; botlar Mini App'lerden kullanıcı, sohbet ve yönetilen bot isteyebilir.
- WebApp sınıfına requestChat metodu eklendi.
https://t.me/newbot/{manager_bot_username}/{suggested_bot_username}[?name={suggested_bot_name}]bağlantıları desteklendi; botlar bağlantı aracılığıyla yönetilen bot oluşturulmasını isteyebilir.
Anketler
- Birden fazla doğru cevabı olan quiz'ler desteklendi.
- Poll sınıfında correct_option_id alanı correct_option_ids alanıyla değiştirildi.
- sendPoll metodunda correct_option_id parametresi correct_option_ids parametresiyle değiştirildi.
- sendPoll metodunda quiz'ler için allows_multiple_answers geçirilmesine izin verildi.
- Anketin otomatik kapanması için maksimum süre 2628000 saniyeye çıkarıldı.
- Poll sınıfına allows_revoting alanı eklendi.
- sendPoll metoduna allows_revoting parametresi eklendi.
- sendPoll metoduna shuffle_options parametresi eklendi.
- sendPoll metoduna allow_adding_options parametresi eklendi.
- sendPoll metoduna hide_results_until_closes parametresi eklendi.
- Poll sınıfına description ve description_entities alanları eklendi.
- sendPoll metoduna description, description_parse_mode ve description_entities parametreleri eklendi.
- PollOption sınıfına seçeneğin kalıcı tanımlayıcısını temsil eden persistent_id alanı eklendi.
- PollAnswer sınıfına option_persistent_ids alanı eklendi.
- PollOption sınıfına seçeneği ekleyen kullanıcıyı ve sohbeti belirten added_by_user ve added_by_chat alanları eklendi.
- PollOption sınıfına seçeneğin eklendiği tarihi belirten addition_date alanı eklendi.
- PollOptionAdded sınıfı ve Message sınıfına poll_option_added alanı eklendi.
- PollOptionDeleted sınıfı ve Message sınıfına poll_option_deleted alanı eklendi.
- ReplyParameters sınıfına poll_option_id alanı eklendi; botlar belirli bir anket seçeneğine yanıt verebilir.
- Message sınıfına reply_to_poll_option_id alanı eklendi.
- “date_time” öğelerine kontrol listesi başlığında, kontrol listesi görevi metninde, TextQuote içinde, ReplyParameters alıntısında, sendGift ve giftPremiumSubscription metotlarında izin verildi.
Bot API 9.5
Yeni metotlar: setChatMemberTag
- MessageEntity sınıfına “date_time” türü eklendi; botlar kullanıcıya biçimlendirilmiş tarih ve saat gösterebilir.
- Tüm botların sendMessageDraft metodunu kullanmasına izin verildi.
- ChatMemberMember ve ChatMemberRestricted sınıflarına tag alanı eklendi.
- setChatMemberTag metodu eklendi.
- ChatMemberRestricted ve ChatPermissions sınıflarına can_edit_tag alanı eklendi.
- ChatMemberAdministrator ve ChatAdministratorRights sınıflarına can_manage_tags alanı eklendi.
- promoteChatMember metoduna can_manage_tags parametresi eklendi.
- Message sınıfına sender_tag alanı eklendi.
- BottomButton sınıfına iconCustomEmojiId alanı eklendi.
Bot API 9.4
Yeni metotlar: setMyProfilePhoto, removeMyProfilePhoto, getUserProfileAudios
- Bot sahibinin Telegram Premium aboneliği varsa, botların özel sohbetlere, gruplara ve süper gruplara doğrudan gönderdiği mesajlarda özel emoji kullanmasına izin verildi.
- Botların createForumTopic metoduyla özel sohbetlerde konu oluşturmasına izin verildi.
- Botlar, @BotFather Mini App'indeki yeni bir ayarla kullanıcıların özel sohbetlerde konu oluşturmasını ve silmesini engelleyebilir.
- User sınıfına allows_users_to_create_topics alanı eklendi.
- KeyboardButton ve InlineKeyboardButton sınıflarına icon_custom_emoji_id alanı eklendi; mesajda özel emoji kullanabilen botlar butonlarda özel emoji gösterebilir.
- KeyboardButton ve InlineKeyboardButton sınıflarına style alanı eklendi; botlar butonların rengini değiştirebilir.
- ChatOwnerLeft sınıfı ve Message sınıfına chat_owner_left alanı eklendi.
- ChatOwnerChanged sınıfı ve Message sınıfına chat_owner_changed alanı eklendi.
- Botların profil fotoğraflarını yönetmesini sağlayan setMyProfilePhoto ve removeMyProfilePhoto metotları eklendi.
- VideoQuality sınıfı ve Video sınıfına qualities alanı eklendi; botlar videonun mevcut diğer kaliteleri hakkında bilgi alabilir.
- ChatFullInfo sınıfına first_profile_audio alanı eklendi.
- UserProfileAudios sınıfı ve getUserProfileAudios metodu eklendi; botlar bir kullanıcının profiline eklenen sesleri listeleyebilir.
- UniqueGiftModel sınıfına rarity alanı eklendi.
- UniqueGift sınıfına is_burned alanı eklendi.
Bot API 9.3
Yeni metotlar: sendMessageDraft, getUserGifts, getChatGifts, repostStory
Özel sohbetlerde konular
- User sınıfına has_topics_enabled alanı eklendi; bununla botun özel sohbetlerde forum konusu modunun etkin olup olmadığı belirlenebilir.
- Kısmi mesajların üretilirken kullanıcıya akış hâlinde iletilmesini sağlayan sendMessageDraft metodu eklendi.
- Forum konusu modu etkin özel sohbetlerdeki mesajlar için Message sınıfında message_thread_id ve is_topic_message alanları desteklendi.
- Konulu özel sohbetlerde sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, sendMediaGroup, copyMessage, copyMessages, forwardMessage ve forwardMessages metotlarında message_thread_id parametresi desteklendi; botlar belirli bir konuya mesaj gönderebilir.
- Özel sohbetlerde sendChatAction metodunda message_thread_id parametresi desteklendi; botlar özel sohbetlerde belirli bir konuya sohbet eylemi gönderebilir.
- Konulu özel sohbetlerde editForumTopic, deleteForumTopic ve unpinAllForumTopicMessages metotlarında message_thread_id parametresi desteklendi; botlar özel sohbetlerdeki konuları yönetebilir.
- ForumTopic ve ForumTopicCreated sınıflarına is_name_implicit alanı eklendi.
Hediyeler
- getUserGifts ve getChatGifts metotları eklendi.
- UniqueGiftInfo sınıfında last_resale_star_count alanı last_resale_currency ve last_resale_amount alanlarıyla değiştirildi.
- getBusinessAccountGifts metodunda exclude_limited parametresi exclude_limited_upgradable ve exclude_limited_non_upgradable parametreleriyle değiştirildi.
- Gönderildikten sonra yükseltmesi satın alınan bir hediyenin yükseltilmesiyle ilgili mesajlar için UniqueGiftInfo.origin alanına “gifted_upgrade” değeri eklendi.
- Bir hediyenin satın alma teklifiyle satın alınmasıyla ilgili mesajlar için UniqueGiftInfo.origin alanına “offer” değeri eklendi.
- Message sınıfına gift_upgrade_sent alanı eklendi.
- UniqueGift sınıfına gift_id alanı eklendi.
- UniqueGift sınıfına is_from_blockchain alanı eklendi.
- TON blokzincirinden atanan hediyeleri filtrelemek için getBusinessAccountGifts metoduna exclude_from_blockchain parametresi eklendi.
- Gift sınıfına personal_total_count ve personal_remaining_count alanları eklendi.
- Gift ve UniqueGift sınıflarına is_premium alanı eklendi.
- GiftInfo ve OwnedGiftRegular sınıflarına is_upgrade_separate alanı eklendi.
- Benzersiz bir hediyeye dayalı olarak kullanıcı adı, mesaj yanıtları ve bağlantı önizlemeleri için renk şemasını tanımlayan UniqueGiftColors sınıfı eklendi.
- Gift sınıfına has_colors alanı eklendi.
- UniqueGift sınıfına colors alanı eklendi.
- GiftBackground sınıfı ve Gift sınıfına background alanı eklendi.
- Gift sınıfına unique_gift_variant_count alanı eklendi.
- GiftInfo ve OwnedGiftRegular sınıflarına unique_gift_number alanı eklendi.
- AcceptedGiftTypes sınıfına gifts_from_channels alanı eklendi.
Diğer
- Fragment'ta satın alınmış ek aktif kullanıcı adları olan botların ana kullanıcı adlarını devre dışı bırakmasına izin verildi.
- Botların kanal sohbetlerinde can_restrict_members yetkisini kapatmasına izin verildi.
- Botların yönettikleri farklı işletme hesapları arasında hikayeleri yeniden paylaşmasını sağlayan repostStory metodu eklendi.
- UserRating sınıfı ve ChatFullInfo sınıfına rating alanı eklendi.
- Ücretli medya için maksimum fiyat 25000 Telegram Stars'a çıkarıldı.
- ChatFullInfo sınıfına paid_message_star_count alanı eklendi.
- forwardMessage ve copyMessage metotlarına message_effect_id parametresi eklendi.
- ChatFullInfo sınıfına unique_gift_colors alanı eklendi.
- ChecklistTask sınıfına completed_by_chat alanı eklendi.
Bot API 9.2
Yeni metotlar: approveSuggestedPost, declineSuggestedPost
Kontrol listeleri
- ReplyParameters sınıfına checklist_task_id alanı eklendi; botlar kontrol listesindeki belirli bir göreve yanıt verebilir.
- Message sınıfına reply_to_checklist_task_id alanı eklendi.
Hediyeler
- Gift ve UniqueGift sınıflarına, hediyeyi yayımlayan sohbet hakkında bilgi almak için kullanılabilen publisher_chat alanı eklendi.
Kanallarda doğrudan mesajlar
- Chat ve ChatFullInfo sınıflarına, kanal doğrudan mesaj sohbeti olarak kullanılan süper grupları belirlemeye yarayan is_direct_messages alanı eklendi.
- ChatFullInfo sınıfına, bir kanal doğrudan mesaj sohbetinin üst kanal sohbetini belirten parent_chat alanı eklendi.
- Doğrudan mesaj sohbetindeki bir konuyu tanımlayan DirectMessagesTopic sınıfı ve Message sınıfına direct_messages_topic alanı eklendi.
- sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, sendMediaGroup, copyMessage, copyMessages, forwardMessage ve forwardMessages metotlarına direct_messages_topic_id parametresi eklendi. Bu parametre, doğrudan mesaj sohbetindeki bir konuya mesaj göndermek için kullanılabilir.
Önerilen gönderiler
- SuggestedPostParameters sınıfı ve sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, copyMessage ve forwardMessage metotlarına suggested_post_parameters parametresi eklendi. Bu parametre, doğrudan mesaj sohbetindeki bir konuya önerilen gönderi göndermek için kullanılabilir.
- Botların gelen önerilen gönderileri onaylamasını sağlayan approveSuggestedPost metodu eklendi.
- Botların gelen önerilen gönderileri reddetmesini sağlayan declineSuggestedPost metodu eklendi.
- ChatMemberAdministrator ve ChatAdministratorRights sınıflarına can_manage_direct_messages alanı eklendi.
- promoteChatMember metoduna can_manage_direct_messages parametresi eklendi.
- Message sınıfına ücretli gönderileri belirlemeye yarayan is_paid_post alanı eklendi. Ödemenin alınması için bu tür gönderiler 24 saat boyunca silinmemelidir.
- Önerilen gönderinin fiyatını tanımlayan SuggestedPostPrice sınıfı eklendi.
- Önerilen gönderiyi tanımlayan SuggestedPostInfo sınıfı ve Message sınıfına suggested_post_info alanı eklendi.
- Önerilen gönderinin onaylanmasıyla ilgili servis mesajını tanımlayan SuggestedPostApproved sınıfı ve Message sınıfına suggested_post_approved alanı eklendi.
- Önerilen gönderinin onaylanamamasıyla ilgili servis mesajını tanımlayan SuggestedPostApprovalFailed sınıfı ve Message sınıfına suggested_post_approval_failed alanı eklendi.
- Önerilen gönderinin reddedilmesiyle ilgili servis mesajını tanımlayan SuggestedPostDeclined sınıfı ve Message sınıfına suggested_post_declined alanı eklendi.
- Önerilen gönderi için başarılı ödemeyle ilgili servis mesajını tanımlayan SuggestedPostPaid sınıfı ve Message sınıfına suggested_post_paid alanı eklendi.
- Önerilen gönderi için ödeme iadesiyle ilgili servis mesajını tanımlayan SuggestedPostRefunded sınıfı ve Message sınıfına suggested_post_refunded alanı eklendi.
Bot API 9.1
Yeni metotlar: sendChecklist, editMessageChecklist, getMyStarBalance
Kontrol listeleri
- Kontrol listesindeki bir görevi temsil eden ChecklistTask sınıfı eklendi.
- Kontrol listesini temsil eden Checklist sınıfı eklendi.
- Kontrol listesine eklenecek bir görevi temsil eden InputChecklistTask sınıfı eklendi.
- Oluşturulacak kontrol listesini temsil eden InputChecklist sınıfı eklendi.
- Message ve ExternalReplyInfo sınıflarına mesajdaki kontrol listesini tanımlayan checklist alanı eklendi.
- Kontrol listesindeki görevlerin durum değişiklikleriyle (ör. tamamlandı/tamamlanmadı olarak işaretlenmesi) ilgili servis mesajını tanımlayan ChecklistTasksDone sınıfı ve Message sınıfına checklist_tasks_done alanı eklendi.
- Kontrol listesine yeni görevler eklenmesiyle ilgili servis mesajını tanımlayan ChecklistTasksAdded sınıfı ve Message sınıfına checklist_tasks_added alanı eklendi.
- Botların bir işletme hesabı adına kontrol listesi göndermesini sağlayan sendChecklist metodu eklendi.
- Botların bir işletme hesabı adına kontrol listesini düzenlemesini sağlayan editMessageChecklist metodu eklendi.
Hediyeler
- OwnedGiftUnique ve UniqueGiftInfo sınıflarına next_transfer_date alanı eklendi.
- UniqueGiftInfo sınıfına last_resale_star_count alanı eklendi.
- UniqueGiftInfo sınıfındaki origin alanına olası değer olarak “resale” eklendi.
Genel
- Anketteki maksimum seçenek sayısı 12'ye çıkarıldı.
- Botların güncel Telegram Stars bakiyesini almasını sağlayan getMyStarBalance metodu eklendi.
- Kanal sohbetine gönderilen doğrudan mesajların fiyat değişikliğiyle ilgili servis mesajını tanımlayan DirectMessagePriceChanged sınıfı ve Message sınıfına direct_message_price_changed alanı eklendi.
- WebApp sınıfına hideKeyboard metodu eklendi.
Bot API 9.0
Yeni metotlar: readBusinessMessage, deleteBusinessMessages, setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto, removeBusinessAccountProfilePhoto, setBusinessAccountGiftSettings, getBusinessAccountStarBalance, transferBusinessAccountStars, getBusinessAccountGifts, convertGiftToStars, upgradeGift, transferGift, postStory, editStory, deleteStory, giftPremiumSubscription
İşletme hesapları
- BusinessBotRights sınıfı eklendi ve BusinessConnection sınıfında can_reply alanı BusinessBotRights tipindeki rights alanıyla değiştirildi.
- Botların bir işletme hesabı adına gelen mesajları okundu olarak işaretlemesini sağlayan readBusinessMessage metodu eklendi.
- Botların bir işletme hesabı adına mesaj silmesini sağlayan deleteBusinessMessages metodu eklendi.
- Botların yönetilen bir işletme hesabının adını ve soyadını değiştirmesini sağlayan setBusinessAccountName metodu eklendi.
- Botların yönetilen bir işletme hesabının kullanıcı adını değiştirmesini sağlayan setBusinessAccountUsername metodu eklendi.
- Botların yönetilen bir işletme hesabının biyografisini değiştirmesini sağlayan setBusinessAccountBio metodu eklendi.
- Ayarlanacak profil fotoğrafını tanımlayan InputProfilePhoto sınıfı eklendi.
- Botların yönetilen bir işletme hesabının profil fotoğrafını değiştirmesini sağlayan setBusinessAccountProfilePhoto ve removeBusinessAccountProfilePhoto metotları eklendi.
- Botların yönetilen bir işletme hesabında gelen hediyelere ilişkin gizlilik ayarlarını değiştirmesini sağlayan setBusinessAccountGiftSettings metodu eklendi.
- StarAmount sınıfı ve getBusinessAccountStarBalance metodu eklendi; botlar yönetilen bir işletme hesabının güncel Telegram Stars bakiyesini kontrol edebilir.
- Botların yönetilen bir işletme hesabının bakiyesinden Telegram Stars'ı çekim için kendi bakiyelerine aktarmasını sağlayan transferBusinessAccountStars metodu eklendi.
- OwnedGiftRegular, OwnedGiftUnique, OwnedGifts sınıfları ve getBusinessAccountGifts metodu eklendi; botlar yönetilen bir işletme hesabına ait hediyelerin listesini alabilir.
- Botların yönetilen bir işletme hesabının aldığı hediyeleri Telegram Stars'a dönüştürmesini sağlayan convertGiftToStars metodu eklendi.
- Botların yönetilen bir işletme hesabının aldığı normal hediyeleri benzersiz hediyelere yükseltmesini sağlayan upgradeGift metodu eklendi.
- Botların yönetilen bir işletme hesabına ait benzersiz hediyeleri transfer etmesini sağlayan transferGift metodu eklendi.
- Paylaşılacak hikayenin içeriğini temsil eden InputStoryContentPhoto ve InputStoryContentVideo sınıfları eklendi.
- Hikayelerdeki tıklanabilir aktif alanları tanımlayan StoryArea, StoryAreaPosition, LocationAddress, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeLink, StoryAreaTypeWeather ve StoryAreaTypeUniqueGift sınıfları eklendi.
- Botların yönetilen bir işletme hesabı adına hikaye paylaşmasını sağlayan postStory metodu eklendi.
- Botların yönetilen bir işletme hesabı adına daha önce paylaştıkları hikayeleri düzenlemesini sağlayan editStory metodu eklendi.
- Botların yönetilen bir işletme hesabı adına daha önce paylaştıkları hikayeleri silmesini sağlayan deleteStory metodu eklendi.
Mini App'ler
- Mini App'lerin kullanıcının cihazında kalıcı yerel depolama kullanmasını sağlayan DeviceStorage alanı eklendi.
- Mini App'lerin hassas veriler için kullanıcının cihazında güvenli yerel depolama kullanmasını sağlayan SecureStorage alanı eklendi.
Hediyeler
- Benzersiz hediyenin özelliklerini tanımlamak için UniqueGiftModel, UniqueGiftSymbol, UniqueGiftBackdropColors ve UniqueGiftBackdrop sınıfları eklendi.
- Benzersiz hediyeye yükseltilmiş bir hediyeyi tanımlayan UniqueGift sınıfı eklendi.
- Bir kullanıcının veya sohbetin kabul ettiği hediye türlerini tanımlayan AcceptedGiftTypes sınıfı eklendi.
- ChatFullInfo sınıfında can_send_gift alanı AcceptedGiftTypes tipindeki accepted_gift_types alanıyla değiştirildi.
- Gönderilen veya alınan normal bir hediyeyle ilgili servis mesajını tanımlayan GiftInfo sınıfı ve Message sınıfına gift alanı eklendi.
- Gönderilen veya alınan benzersiz bir hediyeyle ilgili servis mesajını tanımlayan UniqueGiftInfo sınıfı ve Message sınıfına unique_gift alanı eklendi.
Telegram Premium
- Botların bir kullanıcıya Telegram Stars ile ödenen Telegram Premium aboneliği hediye etmesini sağlayan giftPremiumSubscription metodu eklendi.
- Bot tarafından satın alınan Telegram Premium aboneliğini içeren işlemler için TransactionPartnerUser sınıfına premium_subscription_duration alanı eklendi.
- TransactionPartnerUser sınıfına transaction_type alanı eklendi; tüm işlem türlerinin ayırt edilmesi ve işlenmesi kolaylaştı.
Genel
- Ücretli medya için maksimum fiyat 10000 Telegram Stars'a çıkarıldı.
- Abonelik dönemi için maksimum fiyat 10000 Telegram Stars'a çıkarıldı.
- Sohbete gönderilen ücretli mesajların fiyat değişikliğiyle ilgili servis mesajını tanımlayan PaidMessagePriceChanged sınıfı ve Message sınıfına paid_message_price_changed alanı eklendi.
- Message sınıfına, mesajı göndermek için ödenen Telegram Stars sayısını içeren paid_star_count alanı eklendi.
Önceki sürümler
Bot API 9.0'dan önceki sürümler tarihleriyle listelenmiştir. Tam açıklamaları resmi değişiklik günlüğündedir.
- Bot API 8.3 — 12 Şubat 2025
- Bot API 8.2 — 1 Ocak 2025
- Bot API 8.1 — 4 Aralık 2024
- Bot API 8.0 — 17 Kasım 2024
- Bot API 7.11 — 31 Ekim 2024
- Bot API 7.10 — 6 Eylül 2024
- Bot API 7.9 — 14 Ağustos 2024
- Bot API 7.8 — 31 Temmuz 2024
- Bot API 7.7 — 7 Temmuz 2024
- Bot API 7.6 — 1 Temmuz 2024
- Bot API 7.5 — 18 Haziran 2024
- Bot API 7.4 — 28 Mayıs 2024
- Bot API 7.3 — 6 Mayıs 2024
- Bot API 7.2 — 31 Mart 2024
- Bot API 7.1 — 16 Şubat 2024
- Bot API 7.0 — 29 Aralık 2023
- Bot API 6.9 — 22 Eylül 2023
- Bot API 6.8 — 18 Ağustos 2023
- Bot API 6.7 — 21 Nisan 2023
- Bot API 6.6 — 9 Mart 2023
- Bot API 6.5 — 3 Şubat 2023
- Bot API 6.4 — 30 Aralık 2022
- Bot API 6.3 — 5 Kasım 2022
- Bot API 6.2 — 12 Ağustos 2022
- Bot API 6.1 — 20 Haziran 2022
- Bot API 6.0 — 16 Nisan 2022
- Bot API 5.7 — 31 Ocak 2022
- Bot API 5.6 — 30 Aralık 2021
- Bot API 5.5 — 7 Aralık 2021
- Bot API 5.4 — 5 Kasım 2021
- Bot API 5.3 — 25 Haziran 2021
- Bot API 5.2 — 26 Nisan 2021
- Bot API 5.1 — 9 Mart 2021
- Bot API 5.0 — 4 Kasım 2020
- Bot API 4.9 — 4 Haziran 2020
- Bot API 4.8 — 24 Nisan 2020
- Bot API 4.7 — 30 Mart 2020
- Bot API 4.6 — 23 Ocak 2020
- Bot API 4.5 — 31 Aralık 2019
- Bot API 4.4 — 29 Temmuz 2019
- Bot API 4.3 — 31 Mayıs 2019
- Bot API 4.2 — 14 Nisan 2019
- Bot API 4.1 — 27 Ağustos 2018
- Bot API 4.0 — 26 Temmuz 2018
- Bot API 3.6 — 13 Şubat 2018
- Bot API 3.5 — 17 Kasım 2017
- Bot API 3.4 — 11 Ekim 2017
- Bot API 3.3 — 23 Ağustos 2017
- Bot API 3.2 — 21 Temmuz 2017
- Bot API 3.1 — 30 Haziran 2017
- Bot API 3.0 — 18 Mayıs 2017
- Bot API 2.3.1 — 4 Aralık 2016
- Bot API 2.3 — 21 Kasım 2016
- Bot API 2.2. — 3 Ekim 2016
- Bot API 2.1. — 22 Mayıs 2016
- Bot API 2.0 — 9 Nisan 2016
Sık sorulan sorular
Telegram Bot API'nin en son sürümü hangisi?
22 Kasım 2026 tarihinde yayımlanan Bot API 10.5. Toplam 194 metot içerir.
Telegram Bot API ne sıklıkla değişiyor?
Telegram genellikle bir ila iki ayda bir yeni Bot API sürümü yayımlar. Her sürüm yeni metotlar ve alanlar ekler; bazı sürümler ayrıca açıklamalarda belirtilen uyumsuz değişiklikler içerir.
Bir metodun hangi sürümde eklendiğini nasıl öğrenirim?
Metodu metot referansımızda açın: Sürüm geçmişi bölümü, metodu ekleyen sürümü ve onu değiştiren sürümleri bu sayfaya bağlantılarla gösterir.