Bot API 9.0

[coder2020official]

April 11, 2025
Bot API 9.0

Business Accounts

• Added the class BusinessBotRights and replaced the field can_reply with the field rights of the type BusinessBotRights in the class BusinessConnection.
• Added the method readBusinessMessage, allowing bots to mark incoming messages as read on behalf of a business account.
• Added the method deleteBusinessMessages, allowing bots to delete messages on behalf of a business account.
• Added the method setBusinessAccountName, allowing bots to change the first and last name of a managed business account.
• Added the method setBusinessAccountUsername, allowing bots to change the username of a managed business account.
• Added the method setBusinessAccountBio, allowing bots to change the bio of a managed business account.
• Added the class InputProfilePhoto, describing a profile photo to be set.
• Added the methods setBusinessAccountProfilePhoto and removeBusinessAccountProfilePhoto, allowing bots to change the profile photo of a managed business account.
• Added the method setBusinessAccountGiftSettings, allowing bots to change the privacy settings pertaining to incoming gifts in a managed business account.
• Added the class StarAmount and the method getBusinessAccountStarBalance, allowing bots to check the current Telegram Star balance of a managed business account.
• Added the method transferBusinessAccountStars, allowing bots to transfer Telegram Stars from the balance of a managed business account to their own balance for withdrawal.
• Added the classes OwnedGiftRegular, OwnedGiftUnique, OwnedGifts and the method getBusinessAccountGifts, allowing bots to fetch the list of gifts owned by a managed business account.
• Added the method convertGiftToStars, allowing bots to convert gifts received by a managed business account to Telegram Stars.
• Added the method upgradeGift, allowing bots to upgrade regular gifts received by a managed business account to unique gifts.
• Added the method transferGift, allowing bots to transfer unique gifts owned by a managed business account.
• Added the classes InputStoryContentPhoto and InputStoryContentVideo representing the content of a story to post.
• Added the classes StoryArea, StoryAreaPosition, LocationAddress, StoryAreaTypeLocation, StoryAreaTypeSuggestedReaction, StoryAreaTypeLink, StoryAreaTypeWeather and StoryAreaTypeUniqueGift, describing clickable active areas on stories.
• Added the method postStory, allowing bots to post a story on behalf of a managed business account.
• Added the method editStory, allowing bots to edit stories they had previously posted on behalf of a managed business account.
• Added the method deleteStory, allowing bots to delete stories they had previously posted on behalf of a managed business account.

Mini Apps

• Added the field DeviceStorage, allowing Mini Apps to use persistent local storage on the user's device.
• Added the field SecureStorage, allowing Mini Apps to use a secure local storage on the user's device for sensitive data.

Gifts

• Added the classes UniqueGiftModel, UniqueGiftSymbol, UniqueGiftBackdropColors, and UniqueGiftBackdrop to describe the properties of a unique gift.
• Added the class UniqueGift describing a gift that was upgraded to a unique one.
• Added the class AcceptedGiftTypes describing the types of gifts that are accepted by a user or a chat.
• Replaced the field can_send_gift with the field accepted_gift_types of the type AcceptedGiftTypes in the class ChatFullInfo.
• Added the class GiftInfo and the field gift to the class Message, describing a service message about a regular gift that was sent or received.
• Added the class UniqueGiftInfo and the field unique_gift to the class Message, describing a service message about a unique gift that was sent or received.

Telegram Premium

• Added the method giftPremiumSubscription, allowing bots to gift a user a Telegram Premium subscription paid in Telegram Stars.
• Added the field premium_subscription_duration to the class TransactionPartnerUser for transactions involving a Telegram Premium subscription purchased by the bot.
• Added the field transaction_type to the class TransactionPartnerUser, simplifying the differentiation and processing of all transaction types.

General

• Increased the maximum price for paid media to 10000 Telegram Stars.
• Increased the maximum price for a subscription period to 10000 Telegram Stars.
• Added the class PaidMessagePriceChanged and the field paid_message_price_changed to the class Message, describing a service message about a price change for paid messages sent to the chat.
• Added the field paid_star_count to the class Message, containing the number of Telegram Stars that were paid to send the message.

[coder2020official]

Skipped setting and removing profile photos for now

[coder2020official]

InputStoryContent might need more review / testing

[coder2020official]

Posting, editing, deleting stories will need testing

[coder2020official]

Done, but needs testing from my side too & careful review

[coder2020official]

@Badiboy I think I am done, but there may be parts where you will need to carefully review. E.g I have kind of tested posting stories, but areas in post_story did not work. Request seems fine to me, maybe I have passed wrong values.

I haven't contributed in a while so forgot some things, please check carefully and take your time

[Badiboy]

Got it.

[Badiboy]

Added the class InputProfilePhoto, describing a profile photo to be set.

Do not see this class.

[Badiboy]

Mmmm... We forgot for contnent_type in all last updates? 😳

Upd. Not for all, but for:

• refunded_payment
• paid_media (not sure?!)

(We can make this update later, after merge this one)

[Badiboy]

Update

• update_types
• content_type_service
• content_type_media
  with all new (not only from this update)content_types that are not there.

(We can make this update later, after merge this one)

[Badiboy]

I'm done. You made huge work.

[coder2020official]

I should be done for most, can you check my comments for unresolved suggestions

[coder2020official]

Also skipped content type media etc for now

[Badiboy]

Optional[bool] => bool

[Badiboy]

Optional[bool] => bool

[Badiboy]

The last ) Then merge ))

[coder2020official]

Done I think, you can merge
Duration is 0-60 according to API; Apparently server recalculates duration anyways

[Badiboy]

Good work!

[luckyway7]

Done I think, you can merge Duration is 0-60 according to API; Apparently server recalculates duration anyways

content_types=refunded_payment still not working :(