Telegram Premium users can grant their favorite channels additional features like the ability to post stories by giving them boosts.
Channels level up as they gain more boosts – and for each level, they gain additional features.
Additionally, channel admins may gain even more boosts by starting giveaways ».
The maximum possible boost level for a channel is specified in the boosts_channel_level_max config key.
Schema:
myBoost#c448415c flags:# slot:int peer:flags.0?Peer date:int expires:int cooldown_until_date:flags.1?int = MyBoost;
premium.myBoosts#9ae228e2 my_boosts:Vector<MyBoost> chats:Vector<Chat> users:Vector<User> = premium.MyBoosts;
prepaidGiveaway#b2539d54 id:long months:int quantity:int date:int = PrepaidGiveaway;
premium.boostsStatus#4959427a flags:# my_boost:flags.2?true level:int current_level_boosts:int boosts:int gift_boosts:flags.4?int next_level_boosts:flags.0?int premium_audience:flags.1?StatsPercentValue boost_url:string prepaid_giveaways:flags.3?Vector<PrepaidGiveaway> my_boost_slots:flags.2?Vector<int> = premium.BoostsStatus;
boost#2a1c8c71 flags:# gift:flags.1?true giveaway:flags.2?true unclaimed:flags.3?true id:string user_id:flags.0?long giveaway_msg_id:flags.2?int date:int expires:int used_gift_slug:flags.4?string multiplier:flags.5?int = Boost;
premium.boostsList#86f8613c flags:# count:int boosts:Vector<Boost> next_offset:flags.0?string users:Vector<User> = premium.BoostsList;
---functions---
premium.getMyBoosts#0be77b4a = premium.MyBoosts;
premium.applyBoost#6b7da746 flags:# slots:flags.0?Vector<int> peer:InputPeer = premium.MyBoosts;
premium.getBoostsStatus#042f1f61 peer:InputPeer = premium.BoostsStatus;
premium.getUserBoosts#39854d1f peer:InputPeer user_id:InputUser = premium.BoostsList;
premium.getBoostsList#60f67660 flags:# gifts:flags.0?true peer:InputPeer offset:string limit:int = premium.BoostsList;Each user has a certain number of boost slots that can be assigned to channels: the precise number depends on whether they bought or were gifted a Premium subscription, and can be fetched using premium.getMyBoosts, along with info about the channels currently occupying each slot, if any.
Gifting a Telegram Premium subscription to another user will create boosts_per_sent_gift new boost slots for us, and one boost slot for the destination user.
Use premium.applyBoost to assign some of your boost slots to a channel.
A PREMIUM_ACCOUNT_REQUIRED error will be returned if the current account does not have a Telegram Premium subscription.
A BOOST_NOT_MODIFIED RPC error will be returned when calling any of the two methods if the user is already boosting the specified channel with the same slots.
After assigning a slot a channel, the user may not change the boosted channel for that slot for a certain cooldown period, specified in the myBoost.cooldown_until_date field: if the cooldown period isn't over yet, the method will return a 420 FLOOD_WAIT_X error, indicating the number of seconds left before a different channel can be boosted.
Users may also invoke premium.getBoostsStatus, to get the current boost status of a channel as a premium.boostsStatus constructor, check out the constructor page for more info.
Channel administrators may invoke premium.getBoostsList to fetch the list of users currently boosting the channel, and premium.getUserBoosts to get info about the boosts sent to a channel by a specific user.
With each boost, channels can post 1 additional story per day to their subscribers' story feeds.
inputPeerChannel#27bcbbfc channel_id:long access_hash:long = InputPeer;
messages.chats#64ff9fd5 chats:Vector<Chat> = messages.Chats;
---functions---
stories.getChatsToSend#a56a8b60 = messages.Chats;Everything works exactly the same as when posting stories as a user, with the only difference that clients should pass the appropriate inputPeerChannel instead of inputPeerSelf to stories.canSendStory, stories.sendStory and all the other story methods, see the main documentation » for more info.
Use stories.getChatsToSend to obtain a list of channels where the user can post stories; stories.canSendStory must still be used before uploading a story to make sure no other limit was reached, as described in the main documentation ».
After reaching at least the boost level specified in the channel_min_level field of the help.peerColorOption constructor for the chosen palette, channels gain the ability to change their message accent palette ».
After reaching at least the boost level specified in the channel_bg_icon_level_min config parameter, channels gain the ability to change the emoji used in the message accent palette ».
After reaching at least the boost level specified in the channel_profile_bg_icon_level_min config parameter and the boost level specified in the channel_min_level field of the help.peerColorOption constructor for the chosen palette, channels gain the ability to change the emoji and color used in the profile accent palette ».
After reaching at least the boost level specified in the channel_wallpaper_level_min config parameter, channels gain the ability to set a fill channel wallpaper, see here » for more info.
After reaching at least the boost level specified in the channel_custom_wallpaper_level_min config parameter, channels gain the ability to set any custom wallpaper, not just fill channel wallpapers, see here » for more info.
After reaching at least the boost level specified in the channel_emoji_status_level_min config parameter, channels gain the ability to change their status emoji ».