All Versions
23
Latest Version
Avg Release Cycle
130 days
Latest Release
31 days ago

Changelog History
Page 1

  • v10.0.0 Changes

    May 15, 2026

    First release of the library on the 10.x line — brings parity with Bot API 10.0 (May 2026) after a 3+ year gap on the 6.x line.

    🚀 > ⚠️ This release is breaking. Coming from 6.x? Read docs/MIGRATION_10.md first.

    Highlights

    • getChat now returns ChatFullInfo (Bot API 7.3 split). Chat keeps only the minimal nested representation; the rich profile fields move to ChatFullInfo.
    • 🚚 Legacy parameters removed (not @Deprecated): replyToMessageId + allowSendingWithoutReply → ReplyParameters; disableWebPagePreview → LinkPreviewOptions. Telegram dropped these from the spec in 7.0; the library tracks that.
    • MessageOrigin sealed type replaces Message.forward_from / forward_from_chat / forward_signature / forward_sender_name / forward_date.
    • 🗄 The 16 @Deprecated SystemFile / String overloads on Bot are gone.
    • 👕 ktlint bumped to 1.6.0, JDK target 17.

    🆕 New feature areas covered

    Reply parameters / link previews / forward origin (7.0) · Forum topics (6.3 — 6.4) · Reactions delivery + boosts + giveaways (7.0) · Business connections (7.2 + 9.0) · Telegram Stars + paid media (7.4 — 7.10) · Gifts (8.0 — 9.0) · Verification (8.3) · Stories (8.4) · Checklists (9.1) · Suggested posts (9.2) · Managed bots + access control (9.x / 10.0) · Guest mode + live photos (10.0).

    ~100 new entity types · ~50 new public methods · ~50 new fields on Message · ~50 new fields on ChatFullInfo.

    Migration

    Install (JitPack)

    repositories{
    maven { url"https://jitpack.io"}
}dependencies{
    implementation'com.github.kotlin-telegram-bot.kotlin-telegram-bot:telegram:10.0.0'}

    Tracking issue: #364 · Pull request: #366

  • v6.3.0 Changes

    February 08, 2025

    What's Changed

    • 🛠 fixed ChosenInlineResult by @IliaSobolev in #341
    • ⚡️ Update okhttp3 version to the latest && fix compile errors after that by @iakunin in #346

    🆕 New Contributors

    Full Changelog : 6.2.0...6.3.0

  • v6.2.0 Changes

    August 09, 2024

    What's Changed

    • 👉 Make CallbackQueryHandler "public final" class by @JcMinarro in #289
    • ➕ Add onSuccess() and onError() methods to apply Side Effects to a TelegramBotResult by @JcMinarro in #294
    • ➕ Add LeftChatMemberHandler by @JcMinarro in #299
    • ➕ Added processing of requests for joining the channel by @kudryavtsevma in #298
    • ➕ Add my chat member to update by @JcMinarro in #301
    • ⚡️ No process update after stop pooling by @JcMinarro in #302
    • 👌 Improve TelegramBotResult definition by @JcMinarro in #303
    • ⚡️ Update to Kotlin v1.9.10 by @thebix in #304
    • ⬆️ Bump library version to 6.1.0 by @thebix in #307
    • 🔧 Configure project to be runnable on modern java versions by @thebix in #305
    • Externalise coroutine dispatcher by @artemptushkin in #309
    • 📜 Provide 'parse_mode' to sendVideo Telegram API method by @thebix in #306
    • Migrate dependency management to the Gradle Version Catalog by @thebix in #308
    • Keep Handler publicly available by @JcMinarro in #311
    • Provide 'recurring', 'maxTipAmount', 'suggestedTipAmounts' to sendInvoice Telegram API method by @XaMeJleoH in #312
    • 👌 Support 'Login Url' payload for InlineKeyboardButton by @alexdavliatov in #315
    • Protect_Content field added by @kzRain in #265
    • 🛠 Fix mapToTelegramBotResult function by @Zheg-al in #279
    • Implement 'setMessageReaction' Telegram API method by @thebix in #322
    • ➕ add httpClientInterceptors property to Bot.Builder by @cramen in #325
    • GH-326 make it possible to disable set webhook on the bot start-up by @artemptushkin in #328
    • 🛠 Api definition fixes by @red-avtovo in #330
    • 🔧 GH-323 expose secret token for the webhook configuration by @artemptushkin in #324
    • Pass message thread id to reply to the correct thread by @v1ctor in #331

    🆕 New Contributors

    Full Changelog : 6.1.0...6.2.0

  • v6.1.0 Changes

    May 22, 2023

    What's Changed

    🆕 New Contributors

    Full Changelog : 6.0.7...6.1.0

  • v6.0.7 Changes

    May 10, 2022

    What's Changed

    🆕 New Contributors

    Full Changelog : 6.0.6...6.0.7

  • v6.0.6 Changes

    October 10, 2021

    What's Changed

    🆕 New Contributors

    Full Changelog : 6.0.5...6.0.6

  • v6.0.5 Changes

    August 14, 2021

    👌 Improvements:

    • sendInvoice, deleteMessage, sendPoll, answerCallbackQuery, deleteChatSticker, setChatStickerSet and getChatMember migrate to TelegramBotResult

    🛠 Fixes:

    • ⚡️ Potential fix for an issue with the bot not receiving updates after a certain amount of time running.

    🔋 Features:

    • ➕ Added onlyIfBanned field to unbanChatMember operation.
    • ➕ Added logout operation.
    • ➕ Added allowSendingWithoutReply parameters to several operations.
    • ➕ Added sendGame operation.
    • ➕ Added stopPoll operation.

  • v6.0.4 Changes

    February 22, 2021

    👌 Improvements:

    • 0️⃣ Extended the TelegramBotResult type. Added isSuccess, isError, getOrDefault, get and fold APIs.
    • setChatAdministratorCustomTitle method migrated to TelegramBotResult.
    • sendDice method migrated to TelegramBotResult.
    • setMyCommands method migrated to TelegramBotResult.
    • getMyCommands method migrated to TelegramBotResult.
    • answerInlineQuery method migrated to TelegramBotResult.
    • answerPrecheckoutQuery method migrated to TelegramBotResult.
    • answerShippingQuery method migrated to TelegramBotResult.

    🛠 Fixes:

    • canSendOtherMessages field serialization in ChatPermissions class.
    • Catch all throwable in handlers' execution.

    🔋 Features:

    • 👌 Support for sending audio and document albums.
    • bio, linkedChatId and location fields added to Chat class.
    • filename field added to Audio and Video classes.

  • v6.0.3 Changes

    February 14, 2021

    🛠 Fixes:

    • 👉 Use a Long for the date field in Message class.

    🔋 Features:

    • Bowling emoji for sendDice method.
    • copyMessage method.
    • messageId parameter added to unpinChatMessage method.
    • unpinAllChatMessages method.
    • senderChat and authorSignature fields added to Message class.
    • isAnonymous added to promoteChatMember method and ChatMember class.
    • ChatId class to represent a chat id or a channel usernames for api methods.

  • v6.0.2 Changes

    January 23, 2021

    🛠 Fixes:

    • ➕ Add missing parameters to the sendVoice operation #137
    • ⚡️ Changes to make execution ordering of updates handlers consistent across different updates #142

    🔋 Features:

    • ⚡️ Updates are now consumable across update handlers execution #142