diff --git a/data/web/corefork.telegram.org/api/config.html b/data/web/corefork.telegram.org/api/config.html index 13c91ad1f2..36864ddf3d 100644 --- a/data/web/corefork.telegram.org/api/config.html +++ b/data/web/corefork.telegram.org/api/config.html @@ -360,21 +360,7 @@ While help.getConfig returns MTProto-specif

about_length_limit_premium

The maximum UTF-8 length of bios of Premium users (integer)

premium_promo_order

-

Array of string identifiers, indicating the order of Telegram Premium features in the Telegram Premimum promotion popup, possible values:

- +

Array of string identifiers, indicating the order of Telegram Premium features in the Telegram Premimum promotion popup, see here for the possible values »

premium_bot_username

Contains the username of the official Telegram Premium bot that may be used to buy a Telegram Premium subscription, see here for detailed instructions » (string)

premium_invoice_slug

diff --git a/data/web/corefork.telegram.org/api/premium.html b/data/web/corefork.telegram.org/api/premium.html index 9099580c95..0169e909d3 100644 --- a/data/web/corefork.telegram.org/api/premium.html +++ b/data/web/corefork.telegram.org/api/premium.html @@ -48,8 +48,55 @@

This page describes how should client apps handle Premium features: for a user-friendly overview of Telegram Premium features, see the Telegram Premium FAQ.

+

Telegram Premium features

+
inputUserSelf#f7c1b13f = InputUser;
+
+user#3ff6ecb0 flags:# self:flags.10?true contact:flags.11?true mutual_contact:flags.12?true deleted:flags.13?true bot:flags.14?true bot_chat_history:flags.15?true bot_nochats:flags.16?true verified:flags.17?true restricted:flags.18?true min:flags.20?true bot_inline_geo:flags.21?true support:flags.23?true scam:flags.24?true apply_min_photo:flags.25?true fake:flags.26?true bot_attach_menu:flags.27?true premium:flags.28?true attach_menu_enabled:flags.29?true id:long access_hash:flags.0?long first_name:flags.1?string last_name:flags.2?string username:flags.3?string phone:flags.4?string photo:flags.5?UserProfilePhoto status:flags.6?UserStatus bot_info_version:flags.14?int restriction_reason:flags.18?Vector<RestrictionReason> bot_inline_placeholder:flags.19?string lang_code:flags.22?string = User;
+
+---functions---
+
+help.getAppConfig#98914110 = JSONValue;
+users.getUsers#d91a548 id:Vector<InputUser> = Vector<User>;
+

Telegram Premium offers a set of additional features and raised limits: info about them can be fetched using ħelp.getAppConfig, as described in the client configuration page ».
+Use users.getUsers with inputUserSelf to fetch info about the current subscription status from the premium flag of the returned user constructor.

+

The following fields are related to Telegram Premium, and clients should be aware of the current subscription status to eventually modify their behavior accordingly.

+

Promo page

+

Clients should show a Telegram Premium button in the settings.
+Clicking on this button in the settings, clicking on the star of a Premium user or hitting one of the Premium limits listed below should open a Telegram Premium modal.
+This modal should list the following Premium features contained in the premium_promo_order appConfig field, and presented in the order dynamically specified by the appConfig.

+

Note that whenever config keys end with a * in the following list, the * should be replaced with default or premium, to fetch the appropriate limit value for normal and Premium users.

+ +

Badge

+

Users with a Telegram Premium subscription (user.premium is set) should have a Telegram Premium badge next to their name.

+

Sticker suggestions

+

The suggested sticker selection logic is slightly different for Premium users, see here for more info ».

Subscribing to Telegram Premium

-

Apps should implement a Telegram Premium modal, listing the Premium features contained in the premium_promo_order app configuration parameter ».

Here's how to pay for a Telegram Premium subscription, when the user clicks on the subscribe button: