CHANGELOG.md

Changelog

v1.20.0 (2026-03-19)

• resolve issues #242, #245, #261, #262
• support Bot API 9.5 (#263)

v1.19.0 (2026-02-12)

• support API 9.4 (February 9, 2026 update)
  • Bot Profile Management:
    • Added setMyProfilePhoto and removeMyProfilePhoto methods
  • Forum Topics in Private Chats:
    • Added allows_users_to_create_topics field to User
    • Added is_name_implicit field to ForumTopic and ForumTopicCreated
  • Colored Buttons:
    • Added style and icon_custom_emoji_id fields to KeyboardButton and InlineKeyboardButton
  • Video Quality:
    • Added VideoQuality type and qualities field to Video
  • Chat Owner Events:
    • Added ChatOwnerLeft and ChatOwnerChanged types
    • Added chat_owner_left and chat_owner_changed fields to Message
  • User Profile Audios:
    • Added UserProfileAudios type and getUserProfileAudios method
    • Added first_profile_audio field to ChatFullInfo
  • Gifts:
    • Added rarity field to UniqueGiftModel
    • Added is_burned field to UniqueGift
  • Miscellaneous:
    • Added repostStory method
    • Added UserRating type and rating field to ChatFullInfo
    • Added completed_by_chat field to ChecklistTask
    • Added message_effect_id to ForwardMessageParams and CopyMessageParams

v1.18.0 (2026-01-23)

• support API 9.3 (December 31, 2025 update)
  • Topics in private chats:
    • Added has_topics_enabled field to User
  • Gifts:
    • Added getUserGifts and getChatGifts methods
    • Replaced last_resale_star_count with last_resale_currency and last_resale_amount in UniqueGiftInfo
    • Replaced exclude_limited with exclude_limited_upgradable and exclude_limited_non_upgradable in getBusinessAccountGifts
    • Added gift_upgrade_sent field to Message
    • Added gift_id, is_from_blockchain, is_premium, colors fields to UniqueGift
    • Added personal_total_count, personal_remaining_count, is_premium, has_colors, background, unique_gift_variant_count fields to Gift
    • Added is_upgrade_separate, unique_gift_number fields to GiftInfo and OwnedGiftRegular
    • Added gifts_from_channels field to AcceptedGiftTypes
    • Added GiftBackground and UniqueGiftColors types
    • Added unique_gift_colors, paid_message_star_count fields to ChatFullInfo
  • Streaming:
    • Added sendMessageDraft method for streaming partial messages

v1.17.0 (2025-08-18)

• api 9.2 (#207)
• fix: hide token from logs (#206)
• use io.Pipe for build request (#205)
• 🛠️ fix: models.InputSticker model handling/usage (#201)
• style: replace empty interface{} with any (#200)

v1.16.0 (2025-07-08)

• support API 9.1 (#194)

v1.15.0 (2025-04-29)

• support API 9.0 (#176)
• fix json 'omitempty' fields for message struct - pinned_message/pinned_message (#175)
• Add MessageEntity Types (#169)
• fix: rawRequest - use errorsHandler for error on close resp body (#170)

v1.14.2 (2025-02-12)

• add MatchTypeCommand and MatchTypeCommandStartOnly
• updated UploadStickerFile method to match Telegram Bot API (#165)

v1.14.1 (2025-02-12)

• remove ci args for use default config
• make MaskPosition optional
• Add check for nil in addFormFieldInputFileUpload (#161)
• Change type of Stickers field in CreateNewStickerSetParams struct (#160)

v1.14.0 (2025-02-12)

• support API 8.3

v1.13.3 (2025-01-11)

• add option WithInitialOffset(offset int64) - allows to set initial offset for getUpdates method

v1.13.2 (2025-01-11)

• change field type WebAppUser.ID from int to int64

v1.13.1 (2025-01-10)

• add method bot.ID() int64
• add method bot.Token() string

v1.13.0 (2025-01-10)

• support API 8.2 (#144)
• fix unmarshal ChatBackground
• ValidateWebappRequest - now returns model WebAppUser (#143)

v1.12.1 (2024-12-19)

• add handler type for photo captions (#138)

v1.12.0 (2024-12-19)

• support API v8.1

v1.11.1 (2024-11-21)

• fix CreateNewStickerSetParams (#132)

v1.11.0 (2024-11-18)

• support API v8.0

v1.10.1 (2024-11-08)

• Fix arm64 panic (#130)

v1.10.0 (2024-10-31)

• support API v7.11

v1.9.1 (2024-10-21)

• fix unmarshal ChatBackground type (#126)

v1.9.0 (2024-10-17)

• IMPORTANT! New option WithNotAsyncHandlers allows to run handlers in the main goroutine. Now, by default, all handlers are run in separate goroutines.

v1.8.4 (2024-10-10)

• add method GetBusinessConnection (#123)

v1.8.3 (2024-10-07)

• add function bot.SetToken
• update GitHub action versions

v1.8.2 (2024-09-23)

• change field type FromChatID from string to any for ForwardMessageParams, ForwardMessagesParams, CopyMessageParams and CopyMessagesParams params

v1.8.1 (2024-09-16)

• change handlers map to slice (#115)
• feat: Ability to process updates across multiple gorutines (#112)
• add 'HandlerTypeCallbackQueryGameShortName' (#108)
• feat: add middlewares for handler (#105)

v1.8.0 (2024-09-13)

• support API v7.10
• change type for field Type in models.Chat and models.ChatFullInfo from string to models.ChatType
• add consts for ChatType
  • models.ChatTypePrivate
  • models.ChatTypeGroup
  • models.ChatTypeSupergroup
  • models.ChatTypeChannel

v1.7.3 (2024-09-10)

• Fix findHandler behavior

v1.7.2 (2024-08-23)

• fix: pass error with %w instead %v after rawRequest

v1.7.1 (2024-08-22)

• add option UseTestEnvironment for use test environment in API requests

v1.7.0 (2024-08-14)

• support API v7.9

v1.6.1 (2024-07-25)

• add ValidateWebappRequest func for validate MiniApp requests

v1.6.0 (2024-07-18)

• support API v7.6, 7.7
• add const models.ParseModeMarkdownV1

v1.5.0 (2024-06-24)

• support API v7.5

v1.4.1 (2024-06-19)

• fix: getGameHighScores returns an array of high scores instead of a single object (#94)
• Use any type for ChatID in SetGameScoreParams and GetGameHighScoreParams (#88)

v1.4.0 (2024-05-29)

• support API v7.4

v1.3.1 (2024-05-22)

• add Marshal functions for struct with many types
  • ChatBoostSource
  • ChatBackground
  • ChatMember
  • MenuButton
  • MaybeInaccessibleMessage
  • ReactionType
  • MessageOrigin

v1.3.0 (2024-05-20)

• support API v7.3

v1.2.2 (2024-04-25)

• fix race in test
• add example inline_keyboard_multiselect

v1.2.1 (2024-04-03)

• Added error handling for specific error codes (#69)
• fix: exit from waitUpdates function when context is terminated (#75)

v1.2.0 (2024-04-02)

• support API v7.2
• remove worker pool
• add option WithUpdatesChannelCap

v1.1.7 (2024-03-11)

• add error ErrorForbidden for responses with error code 403
• fix CopyMessages capture response
• ForwardMessages properly unmarshal result (#68)

v1.1.6 (2024-03-05)

• ForwardMessages return slice of MessageID (#66)

v1.1.5 (2024-03-04)

• add option WithAllowedUpdates (#65)

v1.1.4 (2024-02-27)

• fix CallbackQuery.Message field type from InaccessibleMessage to MaybeInaccessibleMessage

v1.1.3 (2024-02-22)

• fix json tag for DeleteMessagesParams.MessageIDs

v1.1.2 (2024-02-21)

• fix SetMessageReaction marshal func, fix get response for this method

v1.1.1 (2024-02-21)

• fix typo in json tag models.UsersShared for field UserIDs

v1.1.0 (2024-02-19)

• support API v7.1

v1.0.1 (2024-01-15)

• fix: add 'omitempty' to LinkPreviewOptions.URL

v1.0.0 (2024-01-10)

• support API v7.0

v0.8.3 (2023-12-07)

• Fix typo for setChatDescription params (#49)
• add example handler_match_func
• add function bot.FileDownloadLink

v0.8.2 (2023-10-16)

• add missed field HasSpoiler to InputMedia types

v0.8.1 (2023-10-09)

• json tag typo fix (#41) vvok12*

v0.8.0 (2023-09-28)

• support bot api 6.9

v0.7.15 (2023-08-24)

• support bot api 6.8

v0.7.14 (2023-08-14)

• update defaultUpdatesChanCap from 64 to 1024

v0.7.13 (2023-06-14)

• revert v0.7.7 changes

v0.7.12 (2023-06-13)

• check for empty token on bot init

v0.7.11 (2023-05-26)

• add missed ChatID to BotCommandScopeChat
• add missed BotCommandScopeChatAdministrators.MarshalCustom

v0.7.10 (2023-05-22)

• add ChatAction type with consts for sendChatAction method

v0.7.9 (2023-05-16)

• add option WithSkipGetMe()

v0.7.8 (2023-04-26)

• [BUGFIX] fix type of field Message.ReplyMarkup (#30)
• improve examples (#31)

v0.7.7 (2023-04-24)

• change models.ReplyMarkup from any to interface

v0.7.6 (2023-04-24)

• support bot api 6.7

v0.7.5 (2023-04-13)

• add option WithDebugHandler

v0.7.4 (2023-04-10)

• [BUGFIX] change field SendPollParams.IsAnonymous to *bool (#26)
• add helpers bot.True() and bot.False() for define *bool values

v0.7.3 (2023-04-05)

• make bot.ProcessUpdate public

v0.7.2 (2023-04-03)

• fix copyMessage method (#24)

v0.7.1 (2023-03-20)

• fix field name in MenuButtonWebApp #21

v0.7.0 (2023-03-14)

• support bot api 6.6

v0.6.0 (2023-03-01)

• [BREAKING] change UserID field type in methods params and models from int to int64 #19

v0.5.1 (2023-02-10)

• [BUGFIX] send http.NoBody if all params fields are empty. For example, method getMyCommands has not required fields

v0.5.0 (2023-02-06)

• support bot api 6.5

v0.4.3 (2023-02-05)

• [BUGFIX] SendChatAction now calls sendChatAction instead sendDice

v0.4.2 (2023-01-30)

• [BUGFIX] change field Thumb to InputFile type

v0.4.1 (2023-01-19)

• add func EscapeMarkdownUnescaped for escape only unescaped symbols

v0.4.0 (2023-01-13)

• [BREAKING] change some types from int to int64 #11

v0.3.4 (2023-01-10)

• support bot api 6.4

v0.3.3 (2022-12-28)

• add RegisterHandlerMatchFunc

v0.3.2 (2022-11-28)

• fix field type SendDocumentParams.Document from string to InputFile, add example

v0.3.1 (2022-11-05)

• support bot api 6.3

v0.3.0 (2022-10-14)

• [API CHANGE] method New now call getMe after init and returns error as second result on fail

v0.2.2 (2022-08-23)

• support bot api v6.2

v0.2.1 (2022-07-08)

• support bot api v6.1

v0.2.0 (2022-05-06)

• change API. Use bot funcs instead ofmethods package.

v0.1.1 (2022-05-02)

• add webhook support
• API refactoring
  • use bot.GetUpdates() instead of bot.Start()

v0.1.0 (2022-05-02)

• initial release