Telegram Bot API 변경 내역
9.0 버전(2025년 4월)부터 현재 Bot API 10.5(2026년 11월 22일)까지 Telegram Bot API의 모든 변경 사항을 최신순으로 정리했습니다. 메서드 이름은 파라미터와 예제가 포함된 레퍼런스로, 클래스 이름은 공식 문서로 연결됩니다.
Bot API 10.5 최신
새 메서드: setMySettings
봇 설정
- setMySettings 메서드를 추가했습니다. 봇은 인라인 모드 설정, 프라이버시 모드, 그룹 추가 허용 여부, 개인 채팅의 포럼 토픽 모드, 콜백 쿼리 수신 모드 등 자신의 설정을 변경할 수 있습니다.
- setMySettings 메서드의 callback_query_mode 파라미터에 따라, 봇이 보낸 메시지의 버튼에서 오는 콜백 쿼리를 CallbackQuery 클래스의 message 필드 대신 inline_message_id 필드와 함께 받을 수 있게 되었습니다.
- setMySettings 메서드의 has_topic_sidebar 파라미터로 봇과의 개인 채팅에서 토픽 목록을 사이드바에 표시할 수 있게 되었습니다.
- User 클래스에서 BotFullInfo 클래스를 분리하고 getMe 메서드의 반환 타입을 BotFullInfo로 변경했습니다. getMe에서만 반환되던 필드는 User 클래스에서 제거되었습니다.
- BotFullInfo 클래스에 active_usernames 필드를 추가했습니다. 봇은 자신의 모든 활성 사용자 이름 목록을 가져올 수 있습니다.
- BotFullInfo 클래스에 inline_query_placeholder 필드를 추가했습니다. 봇은 인라인 쿼리용 플레이스홀더를 가져올 수 있습니다.
- BotFullInfo 클래스에 needs_inline_query_location 필드를 추가했습니다. 봇은 인라인 쿼리마다 사용자 위치를 요청하는지 확인할 수 있습니다.
- BotFullInfo 클래스에 has_topic_sidebar 필드를 추가했습니다. 봇은 자신과의 개인 채팅에서 토픽이 사이드바에 표시되는지 확인할 수 있습니다.
일반
- 봇 소유자가
https://t.me/botinvite/<bot_username>링크를 눌러 한 번에 최대 10명의 사용자를 봇과의 개인 채팅에 초대할 수 있게 되었습니다. 봇은 초대된 사용자에게 메시지를 보낼 수 있습니다. - 봇 소유자가 봇과의 개인 채팅에 초대한 사용자에 관한 서비스 메시지를 위해 WriteAccessAllowed 클래스에 inviter 필드를 추가했습니다.
- RichBlockExpandableBlockQuotation 및 InputRichBlockExpandableBlockQuotation 클래스의 text 필드를 blocks 필드로 대체했습니다. 이제 펼칠 수 있는 인용 블록에 임의의 블록을 넣을 수 있습니다.
Bot API 10.4
새 메서드: sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData, getChatShareThemeBackdrops, getUniqueGift, deleteBusinessAccountGift
위젯
- HTML 위젯이 포함된 메시지를 위해 Widget 클래스와 Message 및 ExternalReplyInfo 클래스의 widget 필드를 추가했습니다.
- sendWidget 메서드를 추가했습니다. 봇은 HTML 위젯이 포함된 메시지를 보낼 수 있습니다. 현재 프로덕션 환경에서는 위젯을 개인 채팅에만 보낼 수 있으며, 전송된 위젯은 자동으로 콘텐츠 보호가 적용되어 전달할 수 없습니다.
- sendSharedWidget 메서드를 추가했습니다. 봇은 자신이 만든 공유 위젯을 다시 보낼 수 있습니다.
- 봇이 보냈거나 봇을 통해 보낸 메시지의 위젯이 봇에 보내는 쿼리를 위해 WidgetQuery 클래스와 Update 클래스의 widget_query 필드를 추가했습니다.
- 공유 위젯이 포함된 전달 메시지에서 봇에 보내는 쿼리를 위해 SharedWidgetQuery 클래스와 Update 클래스의 shared_widget_query 필드를 추가했습니다.
- 위젯 쿼리의 유형을 나타내는 WidgetQueryType, WidgetQueryTypeData, WidgetQueryTypeSignData, WidgetQueryTypeSentTransaction 및 WidgetQueryWallet 클래스를 추가했습니다. 쿼리에는 사용자의 TON 지갑 카드와 함께 봇에 전달할 데이터, 사용자의 TON 지갑으로 서명된 데이터, 또는 사용자의 TON 지갑에서 보낸 트랜잭션에 대한 알림이 포함될 수 있습니다.
- answerWidgetQuery 메서드를 추가했습니다. 봇은 위젯의 쿼리에 응답할 수 있습니다.
- editMessageWidgetData 메서드를 추가했습니다. 봇은 메시지에 포함된 위젯의 데이터를 변경할 수 있습니다.
- editSharedWidgetData 메서드를 추가했습니다. 봇은 공유 위젯의 공개 데이터를 변경할 수 있습니다.
- InputWidgetMessageContent 및 InputSharedWidgetMessageContent 클래스를 추가했습니다. 봇은 인라인 쿼리에 대한 응답으로 위젯을 보낼 수 있습니다. 현재 프로덕션 환경에서는 인라인 쿼리 응답으로 위젯을 보낼 수 없습니다.
- 위젯 메시지는 copyMessage 및 copyMessages 메서드로 복사할 수 없습니다.
- ChatPermissions 및 ChatMemberRestricted 클래스의 can_send_other_messages 권한이 이제 위젯 전송도 허용합니다.
임시 메시지
- sendMessage, sendRichMessage, sendAnimation, sendAudio, sendContact, sendDocument, sendLivePhoto, sendLocation, sendPhoto, sendSticker, sendVenue, sendVideo, sendVideoNote 및 sendVoice 메서드의 ephemeral_message_parameters 파라미터에 receiver_user_id 없이 callback_query_id를 지정하면, 채널 다이렉트 메시지 채팅을 제외한 모든 채팅에서 콜백 쿼리에 임시 답장을 보낼 수 있게 되었습니다.
- EphemeralMessageParameters 클래스의 receiver_user_id 필드와 위 메서드들의 chat_id 파라미터가 이제 선택 사항입니다.
리치 메시지 인용
- RichMessage에서 선택한 인용을 위해 TextQuote 클래스에 rich_texts 필드를 추가했습니다.
- ReplyParameters 클래스에 quote_rich_texts 필드를 추가했습니다. 봇은 리치 메시지를 인용할 수 있습니다.
TON 지갑
- TonWalletCard, TonWalletCardSticker, TonNft 및 TonNftAttribute 클래스와 ChatFullInfo 클래스의 ton_wallet_card 필드를 추가했습니다.
- TON 지갑을 이용한 송금에 관한 서비스 메시지를 위해 TonWalletTransfer 클래스와 Message 클래스의 ton_wallet_transfer 필드를 추가했습니다.
- StoryAreaPosition 클래스의 이름을 AreaPosition으로 변경했습니다. 이제 TON 지갑 카드의 스티커 위치를 나타내는 데에도 사용되기 때문입니다.
채팅 공유 테마
- 사용자나 채팅의 링크를 공유하는 화면의 테마를 나타내는 ChatShareTheme, ChatShareThemeEmoji 및 ChatShareThemeUniqueGift 클래스와 ChatFullInfo 클래스의 share_theme 필드를 추가했습니다.
- EmojiType, EmojiTypeEmoji 및 EmojiTypeCustomEmoji 클래스를 추가했습니다.
- ChatShareThemeBackdrop 및 ChatShareThemeBackdrops 클래스와 getChatShareThemeBackdrops 메서드를 추가했습니다.
선물
- getUniqueGift 메서드를 추가했습니다. 봇은 이름으로 고유 선물의 정보를 가져올 수 있습니다.
- deleteBusinessAccountGift 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정이 소유한 일반 선물을 Telegram Stars를 받지 않고 삭제할 수 있습니다.
일반
- Telegram Premium 구독자는 “agent”, “ai”, “app”, “game”, “gay”로 끝나는 보조 사용자 이름을 소유한 봇 최대 2개에 지정할 수 있게 되었습니다. 이러한 사용자 이름은 KeyboardButtonRequestManagedBot 클래스의 suggested_username 필드로 제안할 수 있습니다.
- RichMessage 안의 TON 블록체인 주소를 나타내는 RichTextTonAddress 클래스를 추가했습니다.
- TON 블록체인 주소를 위해 MessageEntity 클래스에 “ton_address” 타입을 추가했습니다.
- 은행 카드 번호를 위해 MessageEntity 클래스에 “bank_card_number” 타입을 추가했습니다.
- verifyUser 및 verifyChat 메서드에 custom_description_parse_mode 및 custom_description_entities 파라미터를 추가했습니다.
- 발신자가 Telegram Stars를 지불하지 않고 메시지를 보낼 수 있는 링크를 사용했다는 서비스 메시지를 위해 PaidMessagesWaived 클래스와 Message 클래스의 paid_messages_waived 필드를 추가했습니다.
https://t.me/<bot_username>/<message_thread_id>형식으로 봇과의 개인 채팅 토픽 링크를 만들 수 있게 되었습니다. 이 링크는 해당 토픽이 존재하는 개인 채팅의 사용자에게만 토픽을 엽니다.
Bot API 10.3
리치 메시지
- RichMessage 안의 버튼을 나타내는 RichMessageButton 클래스를 추가했습니다.
- RichTextButton 클래스를 추가했습니다.
- RichBlockButtons 및 InputRichBlockButtons 클래스를 추가했습니다.
- RichBlockTable 및 InputRichBlockTable 클래스에 is_compact 필드를 추가했습니다.
- 펼치고 다시 접을 수 있는 인용 블록을 나타내는 RichBlockExpandableBlockQuotation 및 InputRichBlockExpandableBlockQuotation 클래스를 추가했습니다.
- 파일을 담는 RichBlockDocument 및 InputRichBlockDocument 클래스를 추가했습니다.
- 리치 메시지에서 일반 파일을 업로드할 수 있도록
tg://document?id=형식의 링크를 지원합니다.
임시 메시지
- EphemeralMessageParameters 클래스를 추가하고, sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation 및 sendVenue 메서드의 receiver_user_id 및 callback_query_id 파라미터를 ephemeral_message_parameters 파라미터로 대체했습니다.
- sendRichMessage 메서드에 ephemeral_message_parameters 파라미터를 추가했습니다.
- EphemeralMessageParameters 클래스에 replace_callback_query_message 필드를 추가했습니다. 봇은 원본 메시지 자리에 임시 메시지를 표시할 수 있습니다.
- editEphemeralMessageMedia에서 새 파일 업로드를 지원합니다.
- editEphemeralMessageCaption 메서드에 show_caption_above_media 파라미터를 추가했습니다.
- editEphemeralMessageText 메서드에 rich_message 파라미터를 추가했습니다.
- ChatAdministratorRights 및 ChatMemberAdministrator 클래스에 can_send_welcome_messages 필드를 추가했습니다.
- promoteChatMember 메서드에 can_send_welcome_messages 파라미터를 추가했습니다.
답장 마크업
- DisabledButton 클래스와 InlineKeyboardButton 클래스의 disabled 필드를 추가했습니다.
- InlineKeyboardMarkup 및 ReplyKeyboardMarkup 클래스에 force_reply 필드를 추가했습니다.
일반
- sendMessageDraft 및 sendRichMessageDraft 메서드에 can_stop 및 keep_on_stop 파라미터를 추가했습니다.
- 사용자가 메시지 생성을 중지했다는 업데이트를 추가했습니다. MessageGenerationStopped 클래스와 Update 클래스의 stopped_message_generation 필드로 표현됩니다.
- 커뮤니티의 채팅 참여에 관한 서비스 메시지를 위해 CommunityChatJoined 클래스와 Message 클래스의 community_chat_joined 필드를 추가했습니다.
- UniqueGiftInfo 클래스에 text, entities, is_private 필드를 추가했습니다.
Bot API 10.2
새 메서드: editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, deleteEphemeralMessage
리치 메시지
- InputRichMessageMedia 클래스와 InputRichMessage 클래스의 media 필드를 추가했습니다. 봇은 리치 메시지를 보낼 때 markdown 또는 html 서식에 사용되는 미디어를 명시적으로 지정할 수 있습니다.
- 전송할 음성 메시지를 나타내는 InputMediaVoiceNote 클래스를 추가했습니다.
- 전송할 목록의 항목을 나타내는 InputRichBlockListItem 클래스를 추가했습니다.
- 보낼 리치 메시지의 서식에 사용할 수 있는 여러 블록 유형을 나타내는 InputRichBlockParagraph, InputRichBlockSectionHeading, InputRichBlockPreformatted, InputRichBlockFooter, InputRichBlockDivider, InputRichBlockMathematicalExpression, InputRichBlockAnchor, InputRichBlockList, InputRichBlockBlockQuotation, InputRichBlockPullQuotation, InputRichBlockCollage, InputRichBlockSlideshow, InputRichBlockTable, InputRichBlockDetails, InputRichBlockMap, InputRichBlockAnimation, InputRichBlockAudio, InputRichBlockPhoto, InputRichBlockVideo, InputRichBlockVoiceNote 및 InputRichBlockThinking 클래스를 추가했습니다.
- InputRichMessage 클래스에 blocks 필드를 추가했습니다. 봇은 블록 엔티티로 리치 메시지 서식을 지정할 수 있습니다.
임시 메시지
- 임시 메시지를 지원합니다. 봇은 특정 사용자와 봇에게만 보이는 그룹 메시지를 보내고 명령어를 받을 수 있습니다.
- BotCommand 클래스에 is_ephemeral 필드를 추가했습니다.
- Message 클래스에 receiver_user 필드를 추가했습니다.
- Message 클래스에 ephemeral_message_id 필드를 추가했습니다.
- sendMessage, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendPhoto, sendSticker, sendVideo, sendVideoNote, sendVoice, sendContact, sendLocation 및 sendVenue 메서드에 receiver_user_id 및 callback_query_id 파라미터를 추가했습니다.
- ReplyParameters 클래스에 ephemeral_message_id 필드를 추가했습니다. 봇은 임시 메시지에 답장할 수 있습니다.
- ReplyParameters 클래스의 message_id 필드는 ephemeral_message_id 필드가 있으면 선택 사항이 됩니다.
- editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption 및 editEphemeralMessageReplyMarkup 메서드를 추가했습니다. 봇은 임시 메시지를 수정할 수 있습니다.
- deleteEphemeralMessage 메서드를 추가했습니다. 봇은 임시 메시지를 삭제할 수 있습니다.
커뮤니티
- 커뮤니티를 초기 지원합니다. 커뮤니티는 공통 주제나 대상을 중심으로 연결된 여러 슈퍼그룹, 채널, 봇의 묶음입니다.
- 커뮤니티를 나타내는 Community 클래스를 추가했습니다.
- CommunityChatAdded 클래스와 Message 클래스의 community_chat_added 필드를 추가했습니다.
- CommunityChatRemoved 클래스와 Message 클래스의 community_chat_removed 필드를 추가했습니다.
- ChatFullInfo 클래스에 community 필드를 추가했습니다.
일반
- 사용자의 결제 구독 변경에 관한 업데이트를 추가했습니다. BotSubscriptionUpdated 클래스와 Update 클래스의 subscription 필드로 표현됩니다.
- 원래 Mini App 도메인과 다른 출처에서 Mini App 메서드를 사용하지 못하도록 하여 Mini App의 보안을 강화했습니다. 이 보호 기능은 2026년 7월 20일에 모든 Mini App에 자동으로 활성화됩니다. @BotFather Mini App에서 보호 기능을 해제할 수 있으며, 이 경우 Mini App에 신뢰할 수 없는 사이트로의 링크가 없도록 보장할 책임은 봇에 있음에 동의하는 것으로 간주됩니다.
Bot API 10.1
새 메서드: sendRichMessage, sendRichMessageDraft, answerChatJoinRequestQuery, sendChatJoinRequestWebApp
리치 메시지
- 리치 메시지를 지원합니다. 봇은 고도로 구조화된 텍스트를 보내고, AI가 생성한 답장을 매끄러운 리치 서식으로 스트리밍할 수 있습니다.
- 여러 유형의 리치 서식 텍스트를 나타내는 RichTextBold, RichTextItalic, RichTextUnderline, RichTextStrikethrough, RichTextSpoiler, RichTextDateTime, RichTextTextMention, RichTextSubscript, RichTextSuperscript, RichTextMarked, RichTextCode, RichTextCustomEmoji, RichTextMathematicalExpression, RichTextUrl, RichTextEmailAddress, RichTextPhoneNumber, RichTextBankCardNumber, RichTextMention, RichTextHashtag, RichTextCashtag, RichTextBotCommand, RichTextAnchor, RichTextAnchorLink, RichTextReference 및 RichTextReferenceLink 클래스를 추가했습니다.
- 리치 서식 텍스트를 나타내는 RichText 클래스를 추가했습니다.
- 리치 서식 텍스트의 캡션을 나타내는 RichBlockCaption 클래스를 추가했습니다.
- 표의 셀을 나타내는 RichBlockTableCell 클래스를 추가했습니다.
- 목록의 항목을 나타내는 RichBlockListItem 클래스를 추가했습니다.
- 리치 서식 메시지의 여러 블록 유형을 나타내는 RichBlockParagraph, RichBlockSectionHeading, RichBlockPreformatted, RichBlockFooter, RichBlockDivider, RichBlockMathematicalExpression, RichBlockAnchor, RichBlockList, RichBlockBlockQuotation, RichBlockPullQuotation, RichBlockCollage, RichBlockSlideshow, RichBlockTable, RichBlockDetails, RichBlockMap, RichBlockAnimation, RichBlockAudio, RichBlockPhoto, RichBlockVideo, RichBlockVoiceNote 및 RichBlockThinking 클래스를 추가했습니다.
- 리치 서식 메시지의 블록을 나타내는 RichBlock 클래스를 추가했습니다.
- 리치 서식 메시지를 나타내는 RichMessage 클래스를 추가했습니다.
- Message 클래스에 rich_message 필드를 추가했습니다.
- 보낼 리치 메시지를 나타내는 InputRichMessage 클래스를 추가했습니다.
- InputRichMessageContent 클래스를 추가하고, 인라인·게스트·Web App 쿼리의 결과에서 InputMessageContent로 사용할 수 있게 했습니다.
- sendRichMessage 메서드를 추가했습니다. 봇은 리치 메시지를 보낼 수 있습니다.
- sendRichMessageDraft 메서드를 추가했습니다. 봇은 작성 중인 리치 메시지를 스트리밍할 수 있습니다.
- editMessageText 메서드에 rich_message 파라미터를 추가했습니다. 봇은 리치 메시지를 수정할 수 있습니다.
가입 요청 쿼리
- User 클래스에 supports_join_request_queries 필드를 추가했습니다.
- ChatFullInfo 클래스에 guard_bot 필드를 추가했습니다.
- ChatJoinRequest 클래스에 query_id 필드를 추가했습니다.
- answerChatJoinRequestQuery 메서드를 추가했습니다.
- sendChatJoinRequestWebApp 메서드를 추가했습니다.
투표
- Link 클래스와 PollMedia 클래스의 link 필드를 추가했습니다.
- InputMediaLink 클래스를 추가하고 InputPollOptionMedia로 사용할 수 있게 했습니다.
Bot API 10.0
새 메서드: answerGuestQuery, deleteAllMessageReactions, deleteMessageReaction, sendLivePhoto, getManagedBotAccessSettings, setManagedBotAccessSettings, getUserPersonalChatMessages
게스트 모드
- 게스트 모드를 지원합니다. 봇은 자신이 멤버가 아닌 채팅에서도 특정 메시지를 받고 답장할 수 있습니다.
- User 클래스에 supports_guest_queries 필드를 추가했습니다.
- Message 클래스에 guest_bot_caller_user 및 guest_bot_caller_chat 필드를 추가했습니다.
- Message 클래스에 guest_query_id 필드를 추가했습니다.
- Update 클래스에 guest_message 필드를 추가했습니다.
- SentGuestMessage 클래스와 answerGuestQuery 메서드를 추가했습니다.
채팅 관리
- ChatMemberRestricted 및 ChatPermissions 클래스에 can_react_to_messages 필드를 추가했습니다.
- getChatAdministrators 메서드에 return_bots 파라미터를 추가했습니다.
- deleteAllMessageReactions 메서드를 추가했습니다.
- deleteMessageReaction 메서드를 추가했습니다.
- 그룹에서 다른 봇이 보낸 일부 메시지를 볼 수 있게 되었습니다.
투표
- InputMediaSticker, InputMediaLocation 및 InputMediaVenue 클래스를 추가했습니다.
- 투표의 미디어를 나타내는 PollMedia 클래스를 추가했습니다.
- Poll 클래스에 media 필드를 추가했습니다. 봇은 투표의 미디어를 확인할 수 있습니다.
- Poll 클래스에 explanation_media 필드를 추가했습니다. 봇은 퀴즈 해설의 미디어를 확인할 수 있습니다.
- PollOption 클래스에 media 필드를 추가했습니다. 봇은 투표 선택지의 미디어를 확인할 수 있습니다.
- InputPollMedia 클래스와 sendPoll 메서드의 media 및 explanation_media 파라미터를 추가했습니다. 봇은 투표에 미디어를 추가할 수 있습니다.
- InputPollOptionMedia 클래스와 InputPollOption 클래스의 media 필드를 추가했습니다. 봇은 투표 선택지에 미디어를 추가할 수 있습니다.
- Poll 클래스에 members_only 필드를 추가했습니다.
- sendPoll 메서드에 members_only 파라미터를 추가했습니다.
- Poll 클래스에 country_codes 필드를 추가했습니다.
- sendPoll 메서드에 country_codes 파라미터를 추가했습니다.
- 투표 선택지의 최소 개수를 2개에서 1개로 줄였습니다.
라이브 포토
- 짧은 동영상이 포함된 사진을 나타내는 LivePhoto 클래스를 추가했습니다.
- InputMediaLivePhoto 클래스를 추가했습니다.
- Message 및 ExternalReplyInfo 클래스에 live_photo 필드를 추가했습니다.
- sendLivePhoto 메서드를 추가했습니다. 봇은 라이브 포토를 보낼 수 있습니다.
- 라이브 포토가 포함된 유료 미디어를 나타내는 PaidMediaLivePhoto 클래스를 추가했습니다.
- InputPaidMediaLivePhoto 클래스를 추가했습니다. 봇은 라이브 포토를 유료 미디어로 보낼 수 있습니다.
- sendMediaGroup 및 editMessageMedia에서 라이브 포토를 사용할 수 있게 되었습니다.
일반
- 비즈니스 봇이 Telegram Premium 구독 없이도 사용자 계정을 관리할 수 있게 되었습니다.
- 두 봇 모두 봇 간 통신을 활성화한 경우 사용자 이름으로 다른 봇에게 메시지를 보낼 수 있게 되었습니다.
- 비즈니스 봇이 봇 간 통신을 활성화한 경우 비즈니스 봇에서 다른 봇에게 답장할 수 있게 되었습니다.
- sendMessageDraft 메서드에 빈 텍스트를 전달할 수 있게 되었습니다.
- BotAccessSettings 클래스와 getManagedBotAccessSettings 메서드를 추가했습니다.
- setManagedBotAccessSettings 메서드를 추가했습니다.
- getUserPersonalChatMessages 메서드를 추가했습니다.
Bot API 9.6
새 메서드: getManagedBotToken, replaceManagedBotToken, savePreparedKeyboardButton
관리 대상 봇
- User 클래스에 can_manage_bots 필드를 추가했습니다.
- KeyboardButtonRequestManagedBot 클래스와 KeyboardButton 클래스의 request_managed_bot 필드를 추가했습니다.
- ManagedBotCreated 클래스와 Message 클래스의 managed_bot_created 필드를 추가했습니다.
- 관리 대상 봇의 생성 및 토큰 변경에 관한 업데이트를 추가했습니다. ManagedBotUpdated 클래스와 Update 클래스의 managed_bot 필드로 표현됩니다.
- getManagedBotToken 및 replaceManagedBotToken 메서드를 추가했습니다.
- PreparedKeyboardButton 클래스와 savePreparedKeyboardButton 메서드를 추가했습니다. 봇은 Mini App에서 사용자, 채팅, 관리 대상 봇을 요청할 수 있습니다.
- WebApp 클래스에 requestChat 메서드를 추가했습니다.
https://t.me/newbot/{manager_bot_username}/{suggested_bot_username}[?name={suggested_bot_name}]링크를 지원합니다. 봇은 링크를 통해 관리 대상 봇 생성을 요청할 수 있습니다.
투표
- 정답이 여러 개인 퀴즈를 지원합니다.
- Poll 클래스의 correct_option_id 필드를 correct_option_ids 필드로 대체했습니다.
- sendPoll 메서드의 correct_option_id 파라미터를 correct_option_ids 파라미터로 대체했습니다.
- sendPoll 메서드에서 퀴즈에도 allows_multiple_answers를 전달할 수 있게 되었습니다.
- 투표 자동 종료까지의 최대 시간을 2628000초로 늘렸습니다.
- Poll 클래스에 allows_revoting 필드를 추가했습니다.
- sendPoll 메서드에 allows_revoting 파라미터를 추가했습니다.
- sendPoll 메서드에 shuffle_options 파라미터를 추가했습니다.
- sendPoll 메서드에 allow_adding_options 파라미터를 추가했습니다.
- sendPoll 메서드에 hide_results_until_closes 파라미터를 추가했습니다.
- Poll 클래스에 description 및 description_entities 필드를 추가했습니다.
- sendPoll 메서드에 description, description_parse_mode, description_entities 파라미터를 추가했습니다.
- PollOption 클래스에 선택지의 영구 식별자를 나타내는 persistent_id 필드를 추가했습니다.
- PollAnswer 클래스에 option_persistent_ids 필드를 추가했습니다.
- PollOption 클래스에 선택지를 추가한 사용자와 채팅을 나타내는 added_by_user 및 added_by_chat 필드를 추가했습니다.
- PollOption 클래스에 선택지가 추가된 날짜를 나타내는 addition_date 필드를 추가했습니다.
- PollOptionAdded 클래스와 Message 클래스의 poll_option_added 필드를 추가했습니다.
- PollOptionDeleted 클래스와 Message 클래스의 poll_option_deleted 필드를 추가했습니다.
- ReplyParameters 클래스에 poll_option_id 필드를 추가했습니다. 봇은 특정 투표 선택지에 답장할 수 있습니다.
- Message 클래스에 reply_to_poll_option_id 필드를 추가했습니다.
- 체크리스트 제목, 체크리스트 작업 텍스트, TextQuote, ReplyParameters 인용, sendGift, giftPremiumSubscription에서 “date_time” 엔티티를 사용할 수 있게 되었습니다.
Bot API 9.5
새 메서드: setChatMemberTag
- MessageEntity에 “date_time” 타입을 추가했습니다. 봇은 사용자에게 서식이 적용된 날짜와 시간을 표시할 수 있습니다.
- 모든 봇이 sendMessageDraft 메서드를 사용할 수 있게 되었습니다.
- ChatMemberMember 및 ChatMemberRestricted 클래스에 tag 필드를 추가했습니다.
- setChatMemberTag 메서드를 추가했습니다.
- ChatMemberRestricted 및 ChatPermissions 클래스에 can_edit_tag 필드를 추가했습니다.
- ChatMemberAdministrator 및 ChatAdministratorRights 클래스에 can_manage_tags 필드를 추가했습니다.
- promoteChatMember 메서드에 can_manage_tags 파라미터를 추가했습니다.
- Message 클래스에 sender_tag 필드를 추가했습니다.
- BottomButton 클래스에 iconCustomEmojiId 필드를 추가했습니다.
Bot API 9.4
새 메서드: setMyProfilePhoto, removeMyProfilePhoto, getUserProfileAudios
- 봇 소유자가 Telegram Premium 구독자인 경우, 봇이 개인 채팅, 그룹, 슈퍼그룹에 직접 보내는 메시지에서 커스텀 이모지를 사용할 수 있게 되었습니다.
- 봇이 createForumTopic 메서드로 개인 채팅에서 토픽을 생성할 수 있게 되었습니다.
- @BotFather Mini App의 새 설정으로 봇이 개인 채팅에서 사용자의 토픽 생성 및 삭제를 막을 수 있게 되었습니다.
- User 클래스에 allows_users_to_create_topics 필드를 추가했습니다.
- KeyboardButton 및 InlineKeyboardButton 클래스에 icon_custom_emoji_id 필드를 추가했습니다. 메시지에서 커스텀 이모지를 사용할 수 있는 봇은 버튼에 커스텀 이모지를 표시할 수 있습니다.
- KeyboardButton 및 InlineKeyboardButton 클래스에 style 필드를 추가했습니다. 봇은 버튼 색상을 변경할 수 있습니다.
- ChatOwnerLeft 클래스와 Message 클래스의 chat_owner_left 필드를 추가했습니다.
- ChatOwnerChanged 클래스와 Message 클래스의 chat_owner_changed 필드를 추가했습니다.
- setMyProfilePhoto 및 removeMyProfilePhoto 메서드를 추가했습니다. 봇은 자신의 프로필 사진을 관리할 수 있습니다.
- VideoQuality 클래스와 Video 클래스의 qualities 필드를 추가했습니다. 봇은 동영상에서 사용 가능한 다른 화질 정보를 가져올 수 있습니다.
- ChatFullInfo 클래스에 first_profile_audio 필드를 추가했습니다.
- UserProfileAudios 클래스와 getUserProfileAudios 메서드를 추가했습니다. 봇은 사용자 프로필에 추가된 오디오 목록을 가져올 수 있습니다.
- UniqueGiftModel 클래스에 rarity 필드를 추가했습니다.
- UniqueGift 클래스에 is_burned 필드를 추가했습니다.
Bot API 9.3
새 메서드: sendMessageDraft, getUserGifts, getChatGifts, repostStory
개인 채팅의 토픽
- User 클래스에 has_topics_enabled 필드를 추가했습니다. 개인 채팅에서 봇의 포럼 토픽 모드가 활성화되어 있는지 확인하는 데 사용할 수 있습니다.
- sendMessageDraft 메서드를 추가했습니다. 생성 중인 메시지를 사용자에게 부분적으로 스트리밍할 수 있습니다.
- 포럼 토픽 모드가 활성화된 개인 채팅의 메시지에 대해 Message 클래스의 message_thread_id 및 is_topic_message 필드를 지원합니다.
- 토픽이 있는 개인 채팅에서 sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendPoll, sendDice, sendInvoice, sendGame, sendMediaGroup, copyMessage, copyMessages, forwardMessage 및 forwardMessages 메서드의 message_thread_id 파라미터를 지원합니다. 봇은 특정 토픽에 메시지를 보낼 수 있습니다.
- 개인 채팅에서 sendChatAction 메서드의 message_thread_id 파라미터를 지원합니다. 봇은 개인 채팅의 특정 토픽에 채팅 액션을 보낼 수 있습니다.
- 토픽이 있는 개인 채팅에서 editForumTopic, deleteForumTopic 및 unpinAllForumTopicMessages 메서드의 message_thread_id 파라미터를 지원합니다. 봇은 개인 채팅의 토픽을 관리할 수 있습니다.
- ForumTopic 및 ForumTopicCreated 클래스에 is_name_implicit 필드를 추가했습니다.
선물
- getUserGifts 및 getChatGifts 메서드를 추가했습니다.
- UniqueGiftInfo 클래스의 last_resale_star_count 필드를 last_resale_currency 및 last_resale_amount 필드로 대체했습니다.
- getBusinessAccountGifts 메서드의 exclude_limited 파라미터를 exclude_limited_upgradable 및 exclude_limited_non_upgradable 파라미터로 대체했습니다.
- 선물을 보낸 뒤 구매한 업그레이드에 관한 메시지를 위해 UniqueGiftInfo.origin에 사용 가능한 값으로 “gifted_upgrade”를 추가했습니다.
- 구매 제안을 통한 선물 구매에 관한 메시지를 위해 UniqueGiftInfo.origin에 사용 가능한 값으로 “offer”를 추가했습니다.
- Message 클래스에 gift_upgrade_sent 필드를 추가했습니다.
- UniqueGift 클래스에 gift_id 필드를 추가했습니다.
- UniqueGift 클래스에 is_from_blockchain 필드를 추가했습니다.
- TON 블록체인에서 할당된 선물을 걸러낼 수 있도록 getBusinessAccountGifts 메서드에 exclude_from_blockchain 파라미터를 추가했습니다.
- Gift 클래스에 personal_total_count 및 personal_remaining_count 필드를 추가했습니다.
- Gift 및 UniqueGift 클래스에 is_premium 필드를 추가했습니다.
- GiftInfo 및 OwnedGiftRegular 클래스에 is_upgrade_separate 필드를 추가했습니다.
- 고유 선물을 기반으로 사용자 이름, 메시지 답장, 링크 미리보기의 색 구성을 나타내는 UniqueGiftColors 클래스를 추가했습니다.
- Gift 클래스에 has_colors 필드를 추가했습니다.
- UniqueGift 클래스에 colors 필드를 추가했습니다.
- GiftBackground 클래스와 Gift 클래스의 background 필드를 추가했습니다.
- Gift 클래스에 unique_gift_variant_count 필드를 추가했습니다.
- GiftInfo 및 OwnedGiftRegular 클래스에 unique_gift_number 필드를 추가했습니다.
- AcceptedGiftTypes 클래스에 gifts_from_channels 필드를 추가했습니다.
기타
- Fragment에서 구매한 추가 활성 사용자 이름이 있는 봇은 기본 사용자 이름을 비활성화할 수 있게 되었습니다.
- 봇이 채널 채팅에서 can_restrict_members 권한을 비활성화할 수 있게 되었습니다.
- repostStory 메서드를 추가했습니다. 봇은 자신이 관리하는 여러 비즈니스 계정 간에 스토리를 리포스트할 수 있습니다.
- UserRating 클래스와 ChatFullInfo 클래스의 rating 필드를 추가했습니다.
- 유료 미디어의 최대 가격을 25000 Telegram Stars로 높였습니다.
- ChatFullInfo 클래스에 paid_message_star_count 필드를 추가했습니다.
- forwardMessage 및 copyMessage 메서드에 message_effect_id 파라미터를 추가했습니다.
- ChatFullInfo 클래스에 unique_gift_colors 필드를 추가했습니다.
- ChecklistTask 클래스에 completed_by_chat 필드를 추가했습니다.
Bot API 9.2
새 메서드: approveSuggestedPost, declineSuggestedPost
체크리스트
- ReplyParameters 클래스에 checklist_task_id 필드를 추가했습니다. 봇은 체크리스트의 특정 작업에 답장할 수 있습니다.
- Message 클래스에 reply_to_checklist_task_id 필드를 추가했습니다.
선물
- Gift 및 UniqueGift 클래스에 publisher_chat 필드를 추가했습니다. 선물을 발행한 채팅의 정보를 가져오는 데 사용할 수 있습니다.
채널 다이렉트 메시지
- Chat 및 ChatFullInfo 클래스에 is_direct_messages 필드를 추가했습니다. 채널 다이렉트 메시지 채팅으로 사용되는 슈퍼그룹을 식별하는 데 사용할 수 있습니다.
- ChatFullInfo 클래스에 parent_chat 필드를 추가했습니다. 채널 다이렉트 메시지 채팅의 상위 채널 채팅을 나타냅니다.
- 다이렉트 메시지 채팅의 토픽을 나타내는 DirectMessagesTopic 클래스와 Message 클래스의 direct_messages_topic 필드를 추가했습니다.
- sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, sendMediaGroup, copyMessage, copyMessages, forwardMessage 및 forwardMessages 메서드에 direct_messages_topic_id 파라미터를 추가했습니다. 이 파라미터로 다이렉트 메시지 채팅 토픽에 메시지를 보낼 수 있습니다.
제안 게시물
- SuggestedPostParameters 클래스와 sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendPaidMedia, sendSticker, sendVideoNote, sendVoice, sendLocation, sendVenue, sendContact, sendDice, sendInvoice, copyMessage 및 forwardMessage 메서드의 suggested_post_parameters 파라미터를 추가했습니다. 이 파라미터로 다이렉트 메시지 채팅 토픽에 제안 게시물을 보낼 수 있습니다.
- approveSuggestedPost 메서드를 추가했습니다. 봇은 들어온 제안 게시물을 승인할 수 있습니다.
- declineSuggestedPost 메서드를 추가했습니다. 봇은 들어온 제안 게시물을 거절할 수 있습니다.
- ChatMemberAdministrator 및 ChatAdministratorRights 클래스에 can_manage_direct_messages 필드를 추가했습니다.
- promoteChatMember 메서드에 can_manage_direct_messages 파라미터를 추가했습니다.
- Message 클래스에 is_paid_post 필드를 추가했습니다. 유료 게시물을 식별하는 데 사용할 수 있습니다. 대금을 받으려면 이러한 게시물을 24시간 동안 삭제하면 안 됩니다.
- 제안 게시물의 가격을 나타내는 SuggestedPostPrice 클래스를 추가했습니다.
- 제안 게시물을 나타내는 SuggestedPostInfo 클래스와 Message 클래스의 suggested_post_info 필드를 추가했습니다.
- 제안 게시물 승인에 관한 서비스 메시지를 나타내는 SuggestedPostApproved 클래스와 Message 클래스의 suggested_post_approved 필드를 추가했습니다.
- 제안 게시물 승인 실패에 관한 서비스 메시지를 나타내는 SuggestedPostApprovalFailed 클래스와 Message 클래스의 suggested_post_approval_failed 필드를 추가했습니다.
- 제안 게시물 거절에 관한 서비스 메시지를 나타내는 SuggestedPostDeclined 클래스와 Message 클래스의 suggested_post_declined 필드를 추가했습니다.
- 제안 게시물 결제 완료에 관한 서비스 메시지를 나타내는 SuggestedPostPaid 클래스와 Message 클래스의 suggested_post_paid 필드를 추가했습니다.
- 제안 게시물 결제 환불에 관한 서비스 메시지를 나타내는 SuggestedPostRefunded 클래스와 Message 클래스의 suggested_post_refunded 필드를 추가했습니다.
Bot API 9.1
새 메서드: sendChecklist, editMessageChecklist, getMyStarBalance
체크리스트
- 체크리스트의 작업을 나타내는 ChecklistTask 클래스를 추가했습니다.
- 체크리스트를 나타내는 Checklist 클래스를 추가했습니다.
- 체크리스트에 추가할 작업을 나타내는 InputChecklistTask 클래스를 추가했습니다.
- 생성할 체크리스트를 나타내는 InputChecklist 클래스를 추가했습니다.
- 메시지의 체크리스트를 나타내는 checklist 필드를 Message 및 ExternalReplyInfo 클래스에 추가했습니다.
- 체크리스트 작업의 상태 변경(완료/미완료 표시)에 관한 서비스 메시지를 나타내는 ChecklistTasksDone 클래스와 Message 클래스의 checklist_tasks_done 필드를 추가했습니다.
- 체크리스트에 새 작업이 추가되었다는 서비스 메시지를 나타내는 ChecklistTasksAdded 클래스와 Message 클래스의 checklist_tasks_added 필드를 추가했습니다.
- sendChecklist 메서드를 추가했습니다. 봇은 비즈니스 계정을 대신하여 체크리스트를 보낼 수 있습니다.
- editMessageChecklist 메서드를 추가했습니다. 봇은 비즈니스 계정을 대신하여 체크리스트를 수정할 수 있습니다.
선물
- OwnedGiftUnique 및 UniqueGiftInfo 클래스에 next_transfer_date 필드를 추가했습니다.
- UniqueGiftInfo 클래스에 last_resale_star_count 필드를 추가했습니다.
- UniqueGiftInfo 클래스의 origin 필드에 사용 가능한 값으로 “resale”을 추가했습니다.
일반
- 투표 선택지의 최대 개수를 12개로 늘렸습니다.
- getMyStarBalance 메서드를 추가했습니다. 봇은 현재 Telegram Stars 잔액을 가져올 수 있습니다.
- 채널 채팅으로 보내는 다이렉트 메시지의 가격 변경에 관한 서비스 메시지를 나타내는 DirectMessagePriceChanged 클래스와 Message 클래스의 direct_message_price_changed 필드를 추가했습니다.
- WebApp 클래스에 hideKeyboard 메서드를 추가했습니다.
Bot API 9.0
새 메서드: readBusinessMessage, deleteBusinessMessages, setBusinessAccountName, setBusinessAccountUsername, setBusinessAccountBio, setBusinessAccountProfilePhoto, removeBusinessAccountProfilePhoto, setBusinessAccountGiftSettings, getBusinessAccountStarBalance, transferBusinessAccountStars, getBusinessAccountGifts, convertGiftToStars, upgradeGift, transferGift, postStory, editStory, deleteStory, giftPremiumSubscription
비즈니스 계정
- BusinessBotRights 클래스를 추가하고, BusinessConnection 클래스의 can_reply 필드를 BusinessBotRights 타입의 rights 필드로 대체했습니다.
- readBusinessMessage 메서드를 추가했습니다. 봇은 비즈니스 계정을 대신하여 수신 메시지를 읽음으로 표시할 수 있습니다.
- deleteBusinessMessages 메서드를 추가했습니다. 봇은 비즈니스 계정을 대신하여 메시지를 삭제할 수 있습니다.
- setBusinessAccountName 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정의 이름과 성을 변경할 수 있습니다.
- setBusinessAccountUsername 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정의 사용자 이름을 변경할 수 있습니다.
- setBusinessAccountBio 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정의 소개를 변경할 수 있습니다.
- 설정할 프로필 사진을 나타내는 InputProfilePhoto 클래스를 추가했습니다.
- setBusinessAccountProfilePhoto 및 removeBusinessAccountProfilePhoto 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정의 프로필 사진을 변경할 수 있습니다.
- setBusinessAccountGiftSettings 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정의 받는 선물 관련 개인정보 설정을 변경할 수 있습니다.
- StarAmount 클래스와 getBusinessAccountStarBalance 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정의 현재 Telegram Stars 잔액을 확인할 수 있습니다.
- transferBusinessAccountStars 메서드를 추가했습니다. 봇은 출금을 위해 관리하는 비즈니스 계정의 잔액에서 자신의 잔액으로 Telegram Stars를 이체할 수 있습니다.
- OwnedGiftRegular, OwnedGiftUnique 및 OwnedGifts 클래스와 getBusinessAccountGifts 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정이 소유한 선물 목록을 가져올 수 있습니다.
- convertGiftToStars 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정이 받은 선물을 Telegram Stars로 전환할 수 있습니다.
- upgradeGift 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정이 받은 일반 선물을 고유 선물로 업그레이드할 수 있습니다.
- transferGift 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정이 소유한 고유 선물을 양도할 수 있습니다.
- 게시할 스토리의 콘텐츠를 나타내는 InputStoryContentPhoto 및 InputStoryContentVideo 클래스를 추가했습니다.
- 스토리의 클릭 가능한 활성 영역을 나타내는 StoryArea, StoryAreaPosition, LocationAddress, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeLink, StoryAreaTypeWeather 및 StoryAreaTypeUniqueGift 클래스를 추가했습니다.
- postStory 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정을 대신하여 스토리를 게시할 수 있습니다.
- editStory 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정을 대신하여 이전에 게시한 스토리를 수정할 수 있습니다.
- deleteStory 메서드를 추가했습니다. 봇은 관리하는 비즈니스 계정을 대신하여 이전에 게시한 스토리를 삭제할 수 있습니다.
Mini App
- DeviceStorage 필드를 추가했습니다. Mini App은 사용자 기기의 영구 로컬 저장소를 사용할 수 있습니다.
- SecureStorage 필드를 추가했습니다. Mini App은 민감한 데이터를 위해 사용자 기기의 보안 로컬 저장소를 사용할 수 있습니다.
선물
- 고유 선물의 속성을 나타내는 UniqueGiftModel, UniqueGiftSymbol, UniqueGiftBackdropColors 및 UniqueGiftBackdrop 클래스를 추가했습니다.
- 고유 선물로 업그레이드된 선물을 나타내는 UniqueGift 클래스를 추가했습니다.
- 사용자나 채팅이 받는 선물 유형을 나타내는 AcceptedGiftTypes 클래스를 추가했습니다.
- ChatFullInfo 클래스의 can_send_gift 필드를 AcceptedGiftTypes 타입의 accepted_gift_types 필드로 대체했습니다.
- 일반 선물을 보내거나 받았다는 서비스 메시지를 나타내는 GiftInfo 클래스와 Message 클래스의 gift 필드를 추가했습니다.
- 고유 선물을 보내거나 받았다는 서비스 메시지를 나타내는 UniqueGiftInfo 클래스와 Message 클래스의 unique_gift 필드를 추가했습니다.
Telegram Premium
- giftPremiumSubscription 메서드를 추가했습니다. 봇은 Telegram Stars로 결제한 Telegram Premium 구독을 사용자에게 선물할 수 있습니다.
- 봇이 구매한 Telegram Premium 구독 관련 트랜잭션을 위해 TransactionPartnerUser 클래스에 premium_subscription_duration 필드를 추가했습니다.
- TransactionPartnerUser 클래스에 transaction_type 필드를 추가했습니다. 모든 트랜잭션 유형을 더 쉽게 구분하고 처리할 수 있습니다.
일반
- 유료 미디어의 최대 가격을 10000 Telegram Stars로 높였습니다.
- 구독 기간당 최대 가격을 10000 Telegram Stars로 높였습니다.
- 채팅으로 보내는 유료 메시지의 가격 변경에 관한 서비스 메시지를 나타내는 PaidMessagePriceChanged 클래스와 Message 클래스의 paid_message_price_changed 필드를 추가했습니다.
- Message 클래스에 메시지를 보내기 위해 지불한 Telegram Stars 수를 담는 paid_star_count 필드를 추가했습니다.
이전 버전
Bot API 9.0 이전 릴리스는 날짜만 표시합니다. 전체 설명은 공식 변경 내역에서 확인할 수 있습니다.
- Bot API 8.3 — 2025년 2월 12일
- Bot API 8.2 — 2025년 1월 1일
- Bot API 8.1 — 2024년 12월 4일
- Bot API 8.0 — 2024년 11월 17일
- Bot API 7.11 — 2024년 10월 31일
- Bot API 7.10 — 2024년 9월 6일
- Bot API 7.9 — 2024년 8월 14일
- Bot API 7.8 — 2024년 7월 31일
- Bot API 7.7 — 2024년 7월 7일
- Bot API 7.6 — 2024년 7월 1일
- Bot API 7.5 — 2024년 6월 18일
- Bot API 7.4 — 2024년 5월 28일
- Bot API 7.3 — 2024년 5월 6일
- Bot API 7.2 — 2024년 3월 31일
- Bot API 7.1 — 2024년 2월 16일
- Bot API 7.0 — 2023년 12월 29일
- Bot API 6.9 — 2023년 9월 22일
- Bot API 6.8 — 2023년 8월 18일
- Bot API 6.7 — 2023년 4월 21일
- Bot API 6.6 — 2023년 3월 9일
- Bot API 6.5 — 2023년 2월 3일
- Bot API 6.4 — 2022년 12월 30일
- Bot API 6.3 — 2022년 11월 5일
- Bot API 6.2 — 2022년 8월 12일
- Bot API 6.1 — 2022년 6월 20일
- Bot API 6.0 — 2022년 4월 16일
- Bot API 5.7 — 2022년 1월 31일
- Bot API 5.6 — 2021년 12월 30일
- Bot API 5.5 — 2021년 12월 7일
- Bot API 5.4 — 2021년 11월 5일
- Bot API 5.3 — 2021년 6월 25일
- Bot API 5.2 — 2021년 4월 26일
- Bot API 5.1 — 2021년 3월 9일
- Bot API 5.0 — 2020년 11월 4일
- Bot API 4.9 — 2020년 6월 4일
- Bot API 4.8 — 2020년 4월 24일
- Bot API 4.7 — 2020년 3월 30일
- Bot API 4.6 — 2020년 1월 23일
- Bot API 4.5 — 2019년 12월 31일
- Bot API 4.4 — 2019년 7월 29일
- Bot API 4.3 — 2019년 5월 31일
- Bot API 4.2 — 2019년 4월 14일
- Bot API 4.1 — 2018년 8월 27일
- Bot API 4.0 — 2018년 7월 26일
- Bot API 3.6 — 2018년 2월 13일
- Bot API 3.5 — 2017년 11월 17일
- Bot API 3.4 — 2017년 10월 11일
- Bot API 3.3 — 2017년 8월 23일
- Bot API 3.2 — 2017년 7월 21일
- Bot API 3.1 — 2017년 6월 30일
- Bot API 3.0 — 2017년 5월 18일
- Bot API 2.3.1 — 2016년 12월 4일
- Bot API 2.3 — 2016년 11월 21일
- Bot API 2.2. — 2016년 10월 3일
- Bot API 2.1. — 2016년 5월 22일
- Bot API 2.0 — 2016년 4월 9일
자주 묻는 질문
Telegram Bot API의 최신 버전은 무엇인가요?
2026년 11월 22일에 출시된 Bot API 10.5입니다. 메서드는 194개입니다.
Telegram Bot API는 얼마나 자주 변경되나요?
Telegram은 보통 1~2개월마다 새 Bot API 버전을 출시합니다. 릴리스마다 메서드와 필드가 추가되며, 일부 릴리스에는 호환성을 깨는 변경 사항도 포함되어 설명에 표시됩니다.
메서드가 언제 추가되었는지 어떻게 알 수 있나요?
메서드 레퍼런스에서 해당 메서드를 여세요. 버전 기록 섹션에 메서드가 추가된 릴리스와 변경된 릴리스가 이 페이지로의 링크와 함께 표시됩니다.