{"layer":225,"constants":{"PhotoSize.type values":{"description":"[PhotoSize.type values &raquo;](https://core.telegram.org/api/files#photosizetype-values).","type":"map","entries":{"s":"Server-side resized image, bounded by 100x100 pixels.","m":"Server-side resized image, bounded by 320x320 pixels.","x":"Server-side resized image, bounded by 800x800 pixels.","y":"Server-side resized image, bounded by 1280x1280 pixels.","w":"Server-side resized image, bounded by 2560x2560 pixels.","a":"Server-side cropped image, 160x160 pixels.","b":"Server-side cropped image, 320x320 pixels.","c":"Server-side cropped image, 640x640 pixels.","d":"Server-side cropped image, 1280x1280 pixels.","i":"Stripped thumbnail, see [stripped thumbnails &raquo;](https://core.telegram.org/api/files#stripped-thumbnails).","j":"Vector outline thumbnail, see [vector thumbnails &raquo;](https://core.telegram.org/api/files#vector-thumbnails)."}},"basic suggestions":{"description":"[Basic suggestion identifiers &raquo;](https://core.telegram.org/api/config#basic-suggestions)","type":"map","entries":{"AUTOARCHIVE_POPULAR":"Users _should_ invoke [account.setGlobalPrivacySettings](https://core.telegram.org/method/account.setGlobalPrivacySettings) with [`globalPrivacySettings.archive_and_mute_new_noncontact_peers = boolTrue`](https://core.telegram.org/constructor/globalPrivacySettings), to automatically archive and mute new incoming chats from non-contacts.","VALIDATE_PASSWORD":"Users should make sure they still remember their [2-step verification password](https://core.telegram.org/api/srp).","VALIDATE_PHONE_NUMBER":"Users should check whether their [authorization phone number](https://core.telegram.org/api/auth) is correct and change the phone number if it is inaccessible.","NEWCOMER_TICKS":"Show the user a hint about the meaning of one and two ticks on sent messages.","SETUP_PASSWORD":"Show the user a hint, asking them to check whether they still remember their [2FA password](https://core.telegram.org/api/srp)","PREMIUM_ANNUAL":"Suggests the user to subscribe to Telegram Premium (with annual payments)","PREMIUM_UPGRADE":"Suggests the user to upgrade their existing Premium subscription from monthly payments to annual payments","PREMIUM_RESTORE":"Suggests the user to restore a recently expired Premium subscription","PREMIUM_CHRISTMAS":"Suggests the user to [gift Telegram Premium](https://core.telegram.org/api/premium#gifting-telegram-premium) subscriptions to friends for Christmas.","PREMIUM_GRACE":"Suggests the user to extend their expiring Telegram Premium subscription","BIRTHDAY_SETUP":"Suggests the user to set a [birthday&nbsp;&raquo;](https://core.telegram.org/api/profile#birthday).","STARS_SUBSCRIPTION_LOW_BALANCE":"When we get close to the end of the subscription period of one or more active subscriptions, and the current [Telegram Star balance](https://core.telegram.org/api/stars) is not high enough to autorenew at least one of them, this suggestion will be activated: when the user clicks on the suggestion, the client should fetch and display the list of expiring subscriptions by invoking [payments.getStarsSubscriptions](https://core.telegram.org/method/payments.getStarsSubscriptions), passing [inputPeerSelf](https://core.telegram.org/constructor/inputPeerSelf) to `peer` and setting the `missing_balance` flag: the returned subscriptions may be renewed by [filling up the current Telegram Star balance](https://core.telegram.org/api/stars) with at least [payments.starsStatus](https://core.telegram.org/constructor/payments.starsStatus).`subscriptions_missing_balance` stars.","USERPIC_SETUP":"Suggests the user to set a [profile picture &raquo;](https://core.telegram.org/api/files#uploading-profile-or-chat-pictures).","SETUP_LOGIN_EMAIL":"Suggests the user to set a [login email &raquo;](https://core.telegram.org/api/auth#email-verification).","SETUP_LOGIN_EMAIL_NOSKIP":"Requires the user to set a [login email &raquo;](https://core.telegram.org/api/auth#email-verification): this suggestion is not skippable, and must be presented as a non-dismissable full-screen view, which fully prevents usage of the app until a login email is configured.","SETUP_PASSKEY":"Invites the user to set up a [passkey &raquo;](https://core.telegram.org/api/passkeys)."}},"business features":{"description":"Business feature identifiers documented [here &raquo;](https://core.telegram.org/api/business#business-features-promo-page).","type":"map","entries":{"business_location":"Business users can set a [business location](https://core.telegram.org/api/business#location)","business_hours":"Business users can set [opening hours](https://core.telegram.org/api/business#opening-hours)","quick_replies":"Business users can create and use [quick reply shortcuts](https://core.telegram.org/api/business#quick-reply-shortcuts)","greeting_message":"Business users can set a [greeting message](https://core.telegram.org/api/business#greeting-messages)","away_message":"Business users can set an [away message](https://core.telegram.org/api/business#away-messages)","business_links":"Business users can create [business chat links](https://core.telegram.org/api/business#business-chat-links)","business_intro":"Business users can set a custom [business chat introduction](https://core.telegram.org/api/business#business-introduction)","business_bots":"Users can [connect business bots to their account&nbsp;&raquo;](https://core.telegram.org/api/bots/connected-business-bots)","emoji_status":"Business users can set a [custom emoji status](https://core.telegram.org/api/emoji-status).","folder_tags":"Business users can enable [folder tags](https://core.telegram.org/api/folders#folder-tags).","stories":"Business users can use [stories](https://core.telegram.org/api/stories) to showcase products (i.e. no additional functionality needs to be implemented by clients, it's just another way to use stories)."}},"business methods":{"description":"Methods supported by connected business bots, documented [here &raquo;](https://core.telegram.org/api/bots/connected-business-bots).","type":"map","entries":{"account.setGlobalPrivacySettings":"Set global privacy settings","account.updateProfile":"Updates user profile.","messages.deleteMessages":"Deletes messages by their identifiers.","messages.editMessage":"Edit message","messages.readHistory":"Marks message history as read.","messages.sendMedia":"Send a media","messages.sendMessage":"Sends a message to a chat","messages.sendMultiMedia":"Send an [album or grouped media](https://core.telegram.org/api/files#albums-grouped-media)","messages.setTyping":"Sends a current user typing event (see [SendMessageAction](https://core.telegram.org/type/SendMessageAction) for all event types) to a conversation partner or group.","messages.updatePinnedMessage":"Pin a message","payments.convertStarGift":"Convert a [received gift \u00bb](https://core.telegram.org/api/gifts) into Telegram Stars: this will permanently destroy the gift, converting it into [starGift](https://core.telegram.org/constructor/starGift).`convert_stars` [Telegram Stars](https://core.telegram.org/api/stars), added to the user's balance.","payments.exportInvoice":"Generate an [invoice deep link](https://core.telegram.org/api/links#invoice-links)","payments.getPaymentForm":"Get a payment form","payments.getSavedStarGifts":"Fetch the full list of [gifts \u00bb](https://core.telegram.org/api/gifts#list-all-received-gifts) owned, received or [hosted \u00bb](https://core.telegram.org/api/gifts#hosted-collectible-gifts) by a peer.","payments.getStarsStatus":"Get the current [Telegram Stars balance](https://core.telegram.org/api/stars) of the current account (with peer=[inputPeerSelf](https://core.telegram.org/constructor/inputPeerSelf)), or the stars balance of the bot or channel specified in `peer`.","payments.sendStarsForm":"Make a payment using [Telegram Stars, see here \u00bb](https://core.telegram.org/api/stars#using-stars) for more info.","payments.transferStarGift":"Transfer a [collectible gift](https://core.telegram.org/api/gifts#collectible-gifts) to another user or channel: can only be used if transfer is free (i.e. [messageActionStarGiftUnique](https://core.telegram.org/constructor/messageActionStarGiftUnique).`transfer_stars` is not set); see [here \u00bb](https://core.telegram.org/api/gifts#transferring-collectible-gifts) for more info on the full flow (including the different flow to use in case the transfer isn't free).","payments.upgradeStarGift":"Upgrade a [gift](https://core.telegram.org/api/gifts) to a [collectible gift](https://core.telegram.org/api/gifts#collectible-gifts): can only be used if the upgrade was already paid by the gift sender; see [here \u00bb](https://core.telegram.org/api/gifts#upgrade-a-gift-to-a-collectible-gift) for more info on the full flow (including the different flow to use in case the upgrade was not paid by the gift sender).","stories.deleteStories":"Deletes some posted [stories](https://core.telegram.org/api/stories)."}},"call rating comment types":{"description":"Call rating comment type identifiers documented [here &raquo;](https://core.telegram.org/api/calls#call-rating-comment-types).","type":"map","entries":{"echo":"The user heard their own voice (echo).","noise":"The user heard background noise.","interruptions":"The other side kept disappearing.","distorted_speech":"The speech was distorted.","silent_local":"The user couldn't hear the other side.","silent_remote":"The other side couldn't hear the user.","dropped":"The call ended unexpectedly.","distorted_video":"The video was distorted.","pixelated_video":"The video was pixelated."}},"channel suggestions":{"description":"[Channel suggestion identifiers &raquo;](https://core.telegram.org/api/config#channel-suggestions)","type":"map","entries":{"CONVERT_GIGAGROUP":"The [supergroup](https://core.telegram.org/api/channel) has many participants: the admin should call [channels.convertToGigagroup](https://core.telegram.org/method/channels.convertToGigagroup) to convert it to a gigagroup."}},"config description":{"description":"[Client configuration keys &raquo;](https://core.telegram.org/api/config#client-configuration).","type":"map","entries":{"weather_search_username":"Contains the username of the bot used to query the current weather, to use in [weather media areas as specified here&nbsp;&raquo;](https://core.telegram.org/api/stories#weather). (string)","story_weather_preload":"If true, clients should preload the current weather on startup (as opposed to only when creating a [weather media area](https://core.telegram.org/api/stories#weather)) by querying the bot specified in [weather_search_username](https://core.telegram.org/api/config#weather-search-username). (boolean)","emojies_animated_zoom":"[Animated emojis](https://core.telegram.org/api/animated-emojis) and [animated dice](https://core.telegram.org/api/dice) should be scaled by this factor before being shown to the user (float)","keep_alive_service":"Whether app clients should start a keepalive service to keep the app running and fetch updates even when the app is closed (boolean)","background_connection":"Whether app clients should start a background TCP connection for MTProto update fetching (boolean)","emojies_send_dice":"A list of supported [animated dice](https://core.telegram.org/api/dice) stickers (array of strings).","emojies_send_dice_success":"For [animated dice](https://core.telegram.org/api/dice) emojis other than the basic \ud83c\udfb2, indicates the winning dice value and the final frame of the animated sticker, at which to show the fireworks \ud83c\udf86 (object with emoji keys and object values, containing `value` and `frame_start` float values)","emojies_sounds":"A map of soundbites to be played when the user clicks on the specified [animated emoji](https://core.telegram.org/api/animated-emojis); the [file reference field](https://core.telegram.org/api/file-references) should be base64-decoded before [downloading the file](https://core.telegram.org/api/files) (map of [file IDs](https://core.telegram.org/api/files) ([inputDocument](https://core.telegram.org/constructor/inputDocument).id), with emoji string keys)\n\nExample:\n\n```json\n{\n    \"\\ud83c\\udf83\": {\n        \"id\": \"4956223179606458539\",\n        \"access_hash\": \"-2107001400913062971\",\n        \"file_reference_base64\": \"\"\n    },\n    \"\\u26b0\": {\n        \"id\": \"4956223179606458540\",\n        \"access_hash\": \"-1498869544183595185\",\n        \"file_reference_base64\": \"\"\n    }\n}\n```","gif_search_branding":"Specifies the name of the service providing GIF search through [gif_search_username](https://core.telegram.org/api/config#mtproto-configuration) (string)","gif_search_emojies":"Specifies a list of emojis that should be suggested as search term in a bar above the GIF search box (array of string emojis)","stickers_emoji_suggest_only_api":"Specifies that the app should not display [local sticker suggestions&nbsp;&raquo;](https://core.telegram.org/api/stickers#sticker-suggestions) for emojis at all and just use the result of [messages.getStickers](https://core.telegram.org/method/messages.getStickers) (bool)","stickers_emoji_cache_time":"Specifies the validity period of the local cache of [messages.getStickers](https://core.telegram.org/method/messages.getStickers), also relevant when generating the [pagination hash](https://core.telegram.org/api/offsets#hash-generation) when invoking the method. (integer)","qr_login_camera":"Whether the Settings->Devices menu should show an option to scan a [QR login code](https://core.telegram.org/api/qr-login) (boolean)","qr_login_code":"Whether the login screen should show a [QR code login option](https://core.telegram.org/api/qr-login), possibly as default login method (string, \"disabled\", \"primary\" or \"secondary\")","dialog_filters_enabled":"Whether clients should show an option for managing [dialog filters AKA folders](https://core.telegram.org/api/folders) (boolean)","dialog_filters_tooltip":"Whether clients should actively show a tooltip, inviting the user to configure [dialog filters AKA folders](https://core.telegram.org/api/folders); typically this happens when the chat list is long enough to start getting cluttered. (boolean)","autoarchive_setting_available":"Whether clients _can_ invoke [account.setGlobalPrivacySettings](https://core.telegram.org/method/account.setGlobalPrivacySettings) with [`globalPrivacySettings.archive_and_mute_new_noncontact_peers = boolTrue`](https://core.telegram.org/constructor/globalPrivacySettings), to automatically archive and mute new incoming chats from non-contacts. (boolean)","topics_pinned_limit":"Maximum number of [topics](https://core.telegram.org/api/forum#forum-topics) that can be pinned in a single [forum](https://core.telegram.org/api/forum). (integer)","telegram_antispam_user_id":"The ID of the official [native antispam bot](https://core.telegram.org/api/antispam), that will automatically delete spam messages if enabled as specified in the [native antispam documentation&nbsp;&raquo;](https://core.telegram.org/api/antispam).  \nWhen fetching the admin list of a supergroup using [channels.getParticipants](https://core.telegram.org/method/channels.getParticipants), if native antispam functionality in the specified supergroup, the bot should be manually added to the admin list displayed to the user.  (numeric string that represents a Telegram user/bot ID, should be casted to an int64)","telegram_antispam_group_size_min":"Minimum number of group members required to enable [native antispam functionality](https://core.telegram.org/api/antispam). (integer)","fragment_prefixes":"List of phone number prefixes for anonymous [Fragment](https://fragment.com) phone numbers. (array of strings).","hidden_members_group_size_min":"Minimum number of participants required to hide the participants list of a supergroup using [channels.toggleParticipantsHidden](https://core.telegram.org/method/channels.toggleParticipantsHidden). (integer)","url_auth_domains":"A list of domains that support automatic login with manual user confirmation, [click here for more info on URL authorization&nbsp;&raquo;](https://core.telegram.org/api/url-authorization#link-url-authorization). (array of strings)","autologin_domains":"A list of Telegram domains that support automatic login with no user confirmation, [click here for more info on URL authorization&nbsp;&raquo;](https://core.telegram.org/api/url-authorization#link-url-authorization). (array of strings)","whitelisted_domains":"A list of Telegram domains that can always be opened without additional user confirmation, when clicking on in-app links where the URL is not fully displayed (i.e. [messageEntityTextUrl](https://core.telegram.org/constructor/messageEntityTextUrl) entities). (array of strings)\n\nNote that when opening [direct Mini App links](https://core.telegram.org/api/links#direct-mini-app-links) for the first time, confirmation should still be requested from the user, even if the domain of the containing deep link is whitelisted (i.e. `t.me/<bot_username>/<short_name>?startapp=<start_parameter>`, where `t.me` is whitelisted).  \n\nConfirmation should **always** be asked, even if we already opened the [direct Mini App](https://core.telegram.org/api/links#direct-mini-app-links) before, if the link is not visible (i.e. [messageEntityTextUrl](https://core.telegram.org/constructor/messageEntityTextUrl) text links, inline buttons etc.).","round_video_encoding":"Contains a set of recommended codec parameters for round videos.  (object, as described in the example)","chat_read_mark_size_threshold":"Per-user read receipts, fetchable using [messages.getMessageReadParticipants](https://core.telegram.org/method/messages.getMessageReadParticipants), will be available in groups with an amount of participants less or equal to `chat_read_mark_size_threshold`. (integer)","chat_read_mark_expire_period":"To protect user privacy, read receipts for chats are only stored for `chat_read_mark_expire_period` seconds after the message was sent. (integer)","pm_read_date_expire_period":"To protect user privacy, read receipts for private chats are only stored for `pm_read_date_expire_period` seconds after the message was sent. (integer)","groupcall_video_participants_max":"Maximum number of participants in a group call (livestreams allow \u221e participants) (integer)","reactions_uniq_max":"Maximum number of unique reactions for any given message: for example, if there are 2000 \ud83d\udc4d and 1000 custom emoji \ud83d\ude01 reactions and reactions_uniq_max = 2, you can't add a \ud83d\udc4e reaction, because that would raise the number of unique reactions to 3 > 2. (integer)","reactions_in_chat_max":"Maximum number of reactions that can be marked as allowed in a chat using [chatReactionsSome](https://core.telegram.org/constructor/chatReactionsSome). (integer)","reactions_user_max_default":"Maximum number of reactions that can be added to a single message by a non-Premium user. (integer)","reactions_user_max_premium":"Maximum number of reactions that can be added to a single message by a Premium user. (integer)","default_emoji_statuses_stickerset_id":"Default emoji status stickerset ID. (integer)  \nNote that the stickerset can be fetched using [inputStickerSetEmojiDefaultStatuses](https://core.telegram.org/constructor/inputStickerSetEmojiDefaultStatuses).","ringtone_duration_max":"The maximum duration in seconds of [uploadable notification sounds&nbsp;&raquo;](https://core.telegram.org/api/ringtones) (integer)","ringtone_size_max":"The maximum post-conversion size in bytes of [uploadable notification sounds&nbsp;&raquo;](https://core.telegram.org/api/ringtones)","ringtone_saved_count_max":"The maximum number of [saveable notification sounds&nbsp;&raquo;](https://core.telegram.org/api/ringtones)","message_animated_emoji_max":"The maximum number of [custom emojis](https://core.telegram.org/api/custom-emoji) that may be present in a message. (integer)","stickers_premium_by_emoji_num":"Defines how many [Premium stickers](https://core.telegram.org/api/premium) to show in the sticker suggestion popup when entering an emoji into the text field, see the [sticker docs for more info](https://core.telegram.org/api/stickers#sticker-suggestions) (integer)","stickers_normal_by_emoji_per_premium_num":"For [Premium users](https://core.telegram.org/api/premium), used to define the suggested sticker list, see the [sticker docs for more info](https://core.telegram.org/api/stickers#sticker-suggestions) (integer)","premium_purchase_blocked":"The user can't purchase [Telegram Premium](https://core.telegram.org/api/premium). The app must also hide all Premium features, including stars for other users, et cetera. (boolean)","channels_limit_default":"The maximum number of [channels and supergroups](https://core.telegram.org/api/channel) a non-[Premium](https://core.telegram.org/api/premium) user may join (integer)","channels_limit_premium":"The maximum number of [channels and supergroups](https://core.telegram.org/api/channel) a [Premium](https://core.telegram.org/api/premium) user may join (integer)","saved_gifs_limit_default":"The maximum number of GIFs a non-[Premium](https://core.telegram.org/api/premium) user may save (integer)","saved_gifs_limit_premium":"The maximum number of GIFs a [Premium](https://core.telegram.org/api/premium) user may save (integer)","stickers_faved_limit_default":"The maximum number of stickers a non-[Premium](https://core.telegram.org/api/premium) user may [add to Favorites&nbsp;&raquo;](https://core.telegram.org/api/stickers#favorite-stickersets) (integer)","stickers_faved_limit_premium":"The maximum number of stickers a [Premium](https://core.telegram.org/api/premium) user may [add to Favorites&nbsp;&raquo;](https://core.telegram.org/api/stickers#favorite-stickersets) (integer)","dialog_filters_limit_default":"The maximum number of [folders](https://core.telegram.org/api/folders) a non-[Premium](https://core.telegram.org/api/premium) user may create (integer)","dialog_filters_limit_premium":"The maximum number of [folders](https://core.telegram.org/api/folders) a [Premium](https://core.telegram.org/api/premium) user may create (integer)","dialog_filters_chats_limit_default":"The maximum number of chats a non-[Premium](https://core.telegram.org/api/premium) user may add to a [folder](https://core.telegram.org/api/folders) (integer)","dialog_filters_chats_limit_premium":"The maximum number of chats a [Premium](https://core.telegram.org/api/premium) user may add to a [folder](https://core.telegram.org/api/folders) (integer)","dialogs_pinned_limit_default":"The maximum number of chats a non-[Premium](https://core.telegram.org/api/premium) user may pin (integer)","dialogs_pinned_limit_premium":"The maximum number of chats a [Premium](https://core.telegram.org/api/premium) user may pin (integer)","dialogs_folder_pinned_limit_default":"The maximum number of chats a non-[Premium](https://core.telegram.org/api/premium) user may pin in a folder (integer)","dialogs_folder_pinned_limit_premium":"The maximum number of chats a [Premium](https://core.telegram.org/api/premium) user may pin in a folder (integer)","channels_public_limit_default":"The maximum number of public [channels or supergroups](https://core.telegram.org/api/channel) a non-[Premium](https://core.telegram.org/api/premium) user may create (integer)","channels_public_limit_premium":"The maximum number of public [channels or supergroups](https://core.telegram.org/api/channel) a [Premium](https://core.telegram.org/api/premium) user may create (integer)","caption_length_limit_default":"The maximum UTF-8 length of media captions sendable by non-[Premium](https://core.telegram.org/api/premium) users (integer)","caption_length_limit_premium":"The maximum UTF-8 length of media captions sendable by [Premium](https://core.telegram.org/api/premium) users (integer)","upload_max_fileparts_default":"The maximum number of file parts uploadable by non-[Premium](https://core.telegram.org/api/premium) users (integer, the maximum file size can be extrapolated by multiplying this value by `524288`, the biggest possible chunk size)","upload_max_fileparts_premium":"The maximum number of file parts uploadable by [Premium](https://core.telegram.org/api/premium) users (integer, the maximum file size can be extrapolated by multiplying this value by `524288`, the biggest possible chunk size)","about_length_limit_default":"The maximum UTF-8 length of bios of non-[Premium](https://core.telegram.org/api/premium) users (integer)","about_length_limit_premium":"The maximum UTF-8 length of bios of [Premium](https://core.telegram.org/api/premium) users (integer)","premium_promo_order":"Array of string identifiers, indicating the order of [Telegram Premium](https://core.telegram.org/api/premium) features in the Telegram Premium promotion popup, [see here for the possible values&nbsp;&raquo;](https://core.telegram.org/api/premium#telegram-premium-features)","business_promo_order":"Array of string identifiers, indicating the order of [Telegram Business](https://core.telegram.org/api/business) features in the Telegram Business promotion popup, [see here for the possible values&nbsp;&raquo;](https://core.telegram.org/api/business#business-features-promo-page)","premium_bot_username":"Contains the username of the official [Telegram Premium](https://core.telegram.org/api/premium) bot that may be used to buy a [Telegram Premium](https://core.telegram.org/api/premium) subscription, see [here for detailed instructions&nbsp;&raquo;](https://core.telegram.org/api/premium) (string)","premium_invoice_slug":"Contains an [invoice slug](https://core.telegram.org/api/payments) that may be used to buy a [Telegram Premium](https://core.telegram.org/api/premium) subscription, see [here for detailed instructions&nbsp;&raquo;](https://core.telegram.org/api/premium) (string)","premium_gift_attach_menu_icon":"Whether a gift icon should be shown in the attachment menu in private chats with users, offering the current user to gift a [Telegram Premium](https://core.telegram.org/api/premium) subscription to the other user in the chat. (boolean)","premium_gift_text_field_icon":"Whether a gift icon should be shown in the text bar in private chats with users (ie like the `/` icon in chats with bots), offering the current user to gift a [Telegram Premium](https://core.telegram.org/api/premium) subscription to the other user in the chat. Can only be true if `premium_gift_attach_menu_icon` is also true. (boolean)","chatlist_update_period":"Users that import a folder using a [chat folder deep link \u00bb](https://core.telegram.org/api/links#chat-folder-links) should retrieve additions made to the folder by invoking [chatlists.getChatlistUpdates](https://core.telegram.org/method/chatlists.getChatlistUpdates) at most every `chatlist_update_period` seconds. (integer)","chatlist_invites_limit_default":"Maximum number of per-folder [chat folder deep links \u00bb](https://core.telegram.org/api/links#chat-folder-links) that can be created by non-[Premium](https://core.telegram.org/api/premium) users. (integer)","chatlist_invites_limit_premium":"Maximum number of per-folder [chat folder deep links \u00bb](https://core.telegram.org/api/links#chat-folder-links) that can be created by [Premium](https://core.telegram.org/api/premium) users. (integer)","chatlists_joined_limit_default":"Maximum number of [shareable folders](https://core.telegram.org/api/links#chat-folder-links) non-[Premium](https://core.telegram.org/api/premium) users may have. (integer)","chatlists_joined_limit_premium":"Maximum number of [shareable folders](https://core.telegram.org/api/links#chat-folder-links) [Premium](https://core.telegram.org/api/premium) users may have. (integer)","small_queue_max_active_operations_count":"A soft limit, specifying the maximum number of files that should be downloaded in parallel from the same DC, for files smaller than 20MB. (integer)","large_queue_max_active_operations_count":"A soft limit, specifying the maximum number of files that should be downloaded in parallel from the same DC, for files bigger than 20MB. (integer)","authorization_autoconfirm_period":"An [unconfirmed session&nbsp;&raquo;](https://core.telegram.org/api/auth#confirming-login) will be autoconfirmed this many seconds after login. (integer)","story_viewers_expire_period":"The exact list of users that viewed the story will be hidden from the poster this many seconds after the story expires. (integer)\n\nThis limit applies **only** to non-[Premium](https://core.telegram.org/api/premium) users, [Premium](https://core.telegram.org/api/premium) users can **always** access the viewer list.","story_expiring_limit_default":"The maximum number of active [stories](https://core.telegram.org/api/stories) for non-[Premium](https://core.telegram.org/api/premium) users (integer).","story_expiring_limit_premium":"The maximum number of active [stories](https://core.telegram.org/api/stories) for [Premium](https://core.telegram.org/api/premium) users (integer).","story_caption_length_limit_premium":"The maximum UTF-8 length of story captions for [Premium](https://core.telegram.org/api/premium) users. (integer)","story_caption_length_limit_default":"The maximum UTF-8 length of story captions for non-[Premium](https://core.telegram.org/api/premium) users. (integer)","stories_posting":"Indicates whether users can post stories. (string)\n\nOne of:\n\n* `enabled` - Any user can post stories.\n* `premium` - Only users with a [Premium](https://core.telegram.org/api/premium) subscription can post stories.\n* `disabled` - Users can't post stories.","stories_stealth_past_period":"Enabling [stories stealth mode](https://core.telegram.org/api/stories#stealth-mode) with the `past` flag will erase views of any story opened in the past `stories_stealth_past_period` seconds. (integer)","stories_stealth_future_period":"Enabling [stories stealth mode](https://core.telegram.org/api/stories#stealth-mode) with the `future` flag will hide views of any story opened in the next `stories_stealth_future_period` seconds. (integer)","stories_stealth_cooldown_period":"After enabling [stories stealth mode](https://core.telegram.org/api/stories#stealth-mode), this many seconds must elapse before the user is allowed to enable it again. (integer)","stories_sent_weekly_limit_default":"Maximum number of stories that can be sent in a week by non-[Premium](https://core.telegram.org/api/premium) users. (integer)","stories_sent_weekly_limit_premium":"Maximum number of stories that can be sent in a week by [Premium](https://core.telegram.org/api/premium) users. (integer)","stories_sent_monthly_limit_default":"Maximum number of stories that can be sent in a month by non-[Premium](https://core.telegram.org/api/premium) users. (integer)","stories_sent_monthly_limit_premium":"Maximum number of stories that can be sent in a month by [Premium](https://core.telegram.org/api/premium) users. (integer)","stories_suggested_reactions_limit_default":"Maximum number of [story reaction media areas&nbsp;&raquo;](https://core.telegram.org/api/stories#media-areas) that can be added to a story by non-[Premium](https://core.telegram.org/api/premium) users. (integer)","stories_suggested_reactions_limit_premium":"Maximum number of [story reaction media areas&nbsp;&raquo;](https://core.telegram.org/api/stories#media-areas) that can be added to a story by [Premium](https://core.telegram.org/api/premium) users. (integer)","stories_venue_search_username":"Username of the inline bot to use to generate venue location tags for stories, see [here&nbsp;&raquo;](https://core.telegram.org/api/stories#location-tags) for more info. (string)","stories_changelog_user_id":"ID of the official Telegram user that will post stories about new Telegram features: stories posted by this user should be shown on the [active or active and hidden stories bar](https://core.telegram.org/api/stories#watching-stories) just like for contacts, even if the user was removed from the contact list. (integer)","stories_entities":"Whether [styled text entities](https://core.telegram.org/api/entities) and links in story text captions can be used by all users (`enabled`), only [Premium](https://core.telegram.org/api/premium) users) (`premium`), or no one (`disabled`). (string)\n\nThis field is used both when posting stories, to indicate to the user whether they can use entities, and when viewing stories, to hide entities (client-side) on stories posted by users whose [Premium](https://core.telegram.org/api/premium) subscription has expired (if `stories_entities == \"premium\"` and [user](https://core.telegram.org/constructor/user).`premium` is not set, or if `stories_entities == \"disabled\"`).","stories_area_url_max":"Maximum number of [URL media areas&nbsp;&raquo;](https://core.telegram.org/api/stories#media-areas) that can be added to a posted story. (integer)","giveaway_gifts_purchase_available":"Whether [giveaways](https://core.telegram.org/api/giveaways) can be started by the current user. (boolean)","giveaway_add_peers_max":"The maximum number of users that can be specified when making a [direct giveaway](https://core.telegram.org/api/giveaways). (integer)","giveaway_countries_max":"The maximum number of countries that can be specified when restricting the set of participating countries in a [giveaway](https://core.telegram.org/api/giveaways).  (integer)","giveaway_boosts_per_premium":"The number of [boosts](https://core.telegram.org/api/boost) that will be gained by a channel for each winner of a [giveaway](https://core.telegram.org/api/giveaways). (integer)","giveaway_period_max":"The maximum duration in seconds of a [giveaway](https://core.telegram.org/api/giveaways). (integer)","boosts_channel_level_max":"Maximum [boost level](https://core.telegram.org/api/boost) for channels. (integer)","boosts_per_sent_gift":"The number of additional [boost slots](https://core.telegram.org/api/boost) that the current user will receive when [gifting a Telegram Premium subscription](https://core.telegram.org/api/premium#gifting-telegram-premium).","transcribe_audio_trial_weekly_number":"The maximum number of [speech recognition&nbsp;&raquo;](https://core.telegram.org/api/transcribe) calls per week for non-[Premium](https://core.telegram.org/api/premium) users. (integer)","transcribe_audio_trial_duration_max":"The maximum allowed duration of media in seconds for [speech recognition&nbsp;&raquo;](https://core.telegram.org/api/transcribe) for non-[Premium](https://core.telegram.org/api/premium) users. (integer)","recommended_channels_limit_default":"The maximum number of similar channels that can be recommended by [channels.getChannelRecommendations&raquo;](https://core.telegram.org/method/channels.getChannelRecommendations) to non-[Premium](https://core.telegram.org/api/premium) users. (integer)","recommended_channels_limit_premium":"The maximum number of similar channels that can be recommended by [channels.getChannelRecommendations&raquo;](https://core.telegram.org/method/channels.getChannelRecommendations) to [Premium](https://core.telegram.org/api/premium) users. (integer)","quote_length_max":"Maximum UTF-8 length of [quoted text](https://core.telegram.org/constructor/inputReplyToMessage). (integer)","channel_bg_icon_level_min":"After reaching at least this [boost level&nbsp;&raquo;](https://core.telegram.org/api/boost), channels gain the ability to change their [message accent palette emoji&nbsp;&raquo;](https://core.telegram.org/api/colors).  (integer)","channel_profile_bg_icon_level_min":"After reaching at least this [boost level&nbsp;&raquo;](https://core.telegram.org/api/boost) and the boost level specified in the `channel_min_level` field of the [help.peerColorOption](https://core.telegram.org/constructor/help.peerColorOption) constructor for the chosen palette, channels gain the ability to change the emoji and color used in the [profile accent palette&nbsp;&raquo;](https://core.telegram.org/api/colors).  (integer)","group_profile_bg_icon_level_min":"After reaching at least this [boost level](https://core.telegram.org/api/boost) and the boost level specified in the `group_min_level` field of the [help.peerColorOption](https://core.telegram.org/constructor/help.peerColorOption) constructor for the chosen palette, supergroups gain the ability to change the emoji and color used in the [profile accent palette&nbsp;&raquo;](https://core.telegram.org/api/colors).  (integer)","channel_emoji_status_level_min":"After reaching at least this [boost level&nbsp;&raquo;](https://core.telegram.org/api/boost), channels gain the ability to change their [status emoji&nbsp;&raquo;](https://core.telegram.org/api/emoji-status).  (integer)","group_emoji_status_level_min":"After reaching at least this [boost level&nbsp;&raquo;](https://core.telegram.org/api/boost), supergroups gain the ability to change their [status emoji&nbsp;&raquo;](https://core.telegram.org/api/emoji-status).  (integer)","channel_wallpaper_level_min":"After reaching at least this [boost level&nbsp;&raquo;](https://core.telegram.org/api/boost), channels gain the ability to set a [fill channel wallpaper, see here &raquo; for more info](https://core.telegram.org/api/wallpapers#channel-and-supergroup-wallpapers).  (integer)","group_wallpaper_level_min":"After reaching at least this [boost level&nbsp;&raquo;](https://core.telegram.org/api/boost), supergroups gain the ability to set a [fill supergroup wallpaper, see here &raquo; for more info](https://core.telegram.org/api/wallpapers#channel-and-supergroup-wallpapers).  (integer)","channel_custom_wallpaper_level_min":"After reaching at least this [boost level&nbsp;&raquo;](https://core.telegram.org/api/boost), channels gain the ability to set any custom [wallpaper](https://core.telegram.org/api/wallpapers), not just [fill channel wallpapers, see here &raquo; for more info](https://core.telegram.org/api/wallpapers).  (integer)","group_custom_wallpaper_level_min":"After reaching at least this [boost level&nbsp;&raquo;](https://core.telegram.org/api/boost), supergroups gain the ability to set any custom [wallpaper](https://core.telegram.org/api/wallpapers), not just [fill supergroup wallpapers, see here &raquo; for more info](https://core.telegram.org/api/wallpapers).  (integer)","group_transcribe_level_min":"After reaching at least this [boost level&nbsp;&raquo;](https://core.telegram.org/api/boost), non-[Premium](https://core.telegram.org/api/premium) users in the supergroup gain the ability to [transcribe any voice message](https://core.telegram.org/api/transcribe), without using up their free transcription quota.  (integer)","group_emoji_stickers_level_min":"After reaching at least this [boost level&nbsp;&raquo;](https://core.telegram.org/api/boost), supergroups gain the ability to associate a [custom emoji stickerset&nbsp;&raquo;](https://core.telegram.org/api/custom-emoji), which can be used by all users of the group (including non-[Premium](https://core.telegram.org/api/premium) users!), for messages sent within the group.  (integer)","channel_restrict_sponsored_level_min":"After reaching at least this [boost level](https://core.telegram.org/api/boost), channel owners may disable ads on the channel for all users using [channels.restrictSponsoredMessages](https://core.telegram.org/method/channels.restrictSponsoredMessages).  (integer)","saved_dialogs_pinned_limit_default":"Maximum number of pinned dialogs in [saved messages](https://core.telegram.org/api/saved-messages) for non-[Premium](https://core.telegram.org/api/premium) users.  (integer)","saved_dialogs_pinned_limit_premium":"Maximum number of pinned dialogs in [saved messages](https://core.telegram.org/api/saved-messages) for [Premium](https://core.telegram.org/api/premium) users.  (integer)","can_edit_factcheck":"If true, the current user is an independent fact-checker and [may edit fact-checks&nbsp;&raquo;](https://core.telegram.org/api/factcheck).  (boolean)","factcheck_length_limit":"Maximum UTF-8 length [of fact-checks&nbsp;&raquo;](https://core.telegram.org/api/factcheck).  (integer)","quick_replies_limit":"Maximum number of [quick reply shortcuts&nbsp;&raquo;](https://core.telegram.org/api/business#quick-reply-shortcuts) that may be created. (integer)","quick_reply_messages_limit":"Maximum number of messages that may be added to a  [quick reply shortcut&nbsp;&raquo;](https://core.telegram.org/api/business#quick-reply-shortcuts). (integer)","intro_title_length_limit":"Maximum UTF-8 length of the [business introduction title&nbsp;&raquo;](https://core.telegram.org/constructor/businessIntro). (integer)","intro_description_length_limit":"Maximum UTF-8 length of the [business introduction description&nbsp;&raquo;](https://core.telegram.org/constructor/businessIntro). (integer)","business_chat_links_limit":"Maximum number of active [business chat links](https://core.telegram.org/api/business#business-chat-links). (integer)","upload_premium_speedup_upload":"Indicates the file upload speedup enjoyed by [Premium subscribers](https://core.telegram.org/api/premium), used [as specified here&nbsp;&raquo;](https://core.telegram.org/api/files#uploading-files) in the Premium modal shown when receiving `FLOOD_WAIT_PREMIUM_X` errors during file uploads. (integer)","upload_premium_speedup_download":"Indicates the file download speedup enjoyed by [Premium subscribers](https://core.telegram.org/api/premium), used [as specified here&nbsp;&raquo;](https://core.telegram.org/api/files#downloading-files) in the Premium modal shown when receiving `FLOOD_WAIT_PREMIUM_X` errors during file downloads. (integer)","upload_premium_speedup_notify_period":"The Premium modal shown when receiving `FLOOD_WAIT_PREMIUM_X` errors during file uploads/downloads should be shown at most every `upload_premium_speedup_notify_period` seconds.  (integer)","stories_pinned_to_top_count_max":"The maximum number of [stories that can be pinned on top of the profile&nbsp;&raquo;](https://core.telegram.org/api/stories#pinned-or-archived-stories).  (integer)","channel_revenue_withdrawal_enabled":"If true, indicates that [channel ad revenue withdrawal is enabled in the current region](https://core.telegram.org/api/revenue); otherwise, all ad revenue-related UI options should be hidden from the user. (boolean)","stars_purchase_blocked":"If false, indicates that [Telegram Stars may be used in the current region](https://core.telegram.org/api/stars); otherwise, all Star-related UI options should be hidden from the user. (boolean)","stars_revenue_withdrawal_min":"Minimum required amount of [Telegram Stars](https://core.telegram.org/api/stars) on a channel or bot's balance to allow [withdrawal&nbsp;&raquo;](https://core.telegram.org/api/stars#withdrawing-revenue). (integer)","stars_paid_post_amount_max":"Maximum price in [Telegram Stars](https://core.telegram.org/api/stars) for posted [paid media](https://core.telegram.org/api/paid-media). (integer)","stars_gifts_enabled":"[Star gifting functionality](https://core.telegram.org/api/stars#buying-or-gifting-stars) should only be enabled if this flag is equal to true. (boolean)","bot_preview_medias_max":"Maximum number of [main mini app previews&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#main-mini-app-previews) that can be added for a localization. (integer)","web_app_allowed_protocols":"Specifies a list of allowed schemes for URLs received in [web_app_open_link events](https://core.telegram.org/api/web-events#web-app-open-link). (array of strings)","ton_proxy_address":"Specifies the domain name to be used to securely open [TON sites&nbsp;&raquo;](https://core.telegram.org/api/links#ton-sites). (string)","stars_subscription_amount_max":"Specifies the maximum allowed price in Stars of a [Telegram Star subscription &raquo;](https://core.telegram.org/api/stars#star-subscriptions). (int)","stars_usd_sell_rate_x1000":"Specifies the number of US dollars required to buy one thousand [Telegram Stars](https://core.telegram.org/api/stars). (float)","stars_usd_withdraw_rate_x1000":"Specifies the number of US dollars that will be received by [withdrawing &raquo;](https://core.telegram.org/api/stars#withdrawing-revenue) one thousand [Telegram Stars](https://core.telegram.org/api/stars). (float)","stars_paid_reaction_amount_max":"Maximum number of [paid reactions](https://core.telegram.org/api/reactions#paid-reactions) that may be sent on a post. (integer)","stargifts_message_length_max":"The maximum length of [gift messages, see here &raquo;](https://core.telegram.org/api/gifts) for more info. (integer)","stargifts_blocked":"If true, [gifts &raquo;](https://core.telegram.org/api/gifts) must be disabled. (boolean)","stargifts_convert_period_max":"A [Gift &raquo;](https://core.telegram.org/api/gifts) can be converted back into [Telegram Stars](https://core.telegram.org/api/stars) only if it was received less than `stargifts_convert_period_max` seconds ago. (integer)","video_ignore_alt_documents":"If true, indicates that the [messageMediaDocument](https://core.telegram.org/constructor/messageMediaDocument).`alt_documents` field must be ignored. (boolean)","starref_start_param_prefixes":"Start parameter [referral program prefixes for referral links &raquo;](https://core.telegram.org/api/links#referral-links). (array of strings)","starref_program_allowed":"If false, the current user [cannot create referral programs &raquo;](https://core.telegram.org/api/bots/referrals#creating-an-affiliate-program) for bots they own. (boolean)","starref_connect_allowed":"If false, the current user [cannot join referral programs, becoming an affiliate &raquo;](https://core.telegram.org/api/bots/referrals#becoming-an-affiliate). (boolean)","starref_min_commission_permille":"Minimum allowed permille affiliate commission for [referral programs &raquo;](https://core.telegram.org/api/bots/referrals). (integer)","starref_max_commission_permille":"Maximum allowed permille affiliate commission for [referral programs &raquo;](https://core.telegram.org/api/bots/referrals). (integer)","inapp_update_check_delay":"[help.getAppUpdate](https://core.telegram.org/method/help.getAppUpdate) should be invoked every `inapp_update_check_delay` update seconds to check for app updates. (integer)","premium_manage_subscription_url":"URL/deep link that can be opened to manage the premium subscription. (string)","sponsored_links_inapp_allow":"If true, non-[deep/TON links](https://core.telegram.org/api/links) opened from [sponsored messages](https://core.telegram.org/api/sponsored-messages) must be opened in the in-app browser (if present); otherwise they must be opened in the standard, external browser. (boolean)","ignore_restriction_reasons":"Array of strings, containing restriction reasons that must be ignored if encountered in [restrictionReason](https://core.telegram.org/constructor/restrictionReason).`reason`.","restriction_add_platforms":"Array of strings, containing additional platform identifiers that must be used when parsing [restrictionReason](https://core.telegram.org/constructor/restrictionReason).","new_noncontact_peers_require_premium_without_ownpremium":"If true, the [globalPrivacySettings](https://core.telegram.org/constructor/globalPrivacySettings).`new_noncontact_peers_require_premium` setting may be enabled even if we don't have a [Premium](https://core.telegram.org/api/premium) account, see [here &raquo;](https://core.telegram.org/api/privacy#global-privacy-settings) for more info.  (boolean)","bot_verification_description_length_limit":"Maximum UTF-8 length of [bot verification description fields &raquo;](https://core.telegram.org/api/bots/verification). (integer)","channel_autotranslation_level_min":"After reaching at least this [boost level&nbsp;&raquo;](https://core.telegram.org/api/boost), channels gain the ability to enable [autotranslation for all users &raquo;](https://core.telegram.org/api/translation#autotranslation-for-channels).  (integer)","conference_call_size_limit":"Maximum number of members in an [E2E conference call](https://core.telegram.org/api/end-to-end/group-calls).","freeze_since_date":"If set and non-zero, indicates the unixtime when the account was [frozen](https://core.telegram.org/api/auth#frozen-accounts). (integer)","freeze_until_date":"If set and non-zero, indicates the unixtime when a [frozen](https://core.telegram.org/api/auth#frozen-accounts) account be deleted, unless an appeal is submitted to the `freeze_appeal_url` and accepted. (integer)","freeze_appeal_url":"A URL that the user can open to submit an appeal. (string)","poll_answers_max":"The maximum number of allowed [quiz poll answers](https://core.telegram.org/api/poll). (integer)","stargifts_pinned_to_top_limit":"Maximum number of [gifts](https://core.telegram.org/api/gifts) that [be pinned to a profile &raquo;](https://core.telegram.org/api/gifts#pinning-a-received-gift). (integer)","stars_paid_message_amount_max":"Specifies the maximum price of [paid messages &raquo;](https://core.telegram.org/api/paid-messages). (integer)","stars_paid_message_commission_permille":"When sending a [paid message](https://core.telegram.org/api/paid-messages), the receiver will receive an amount of stars equal to the price of the message multiplied by `stars_paid_message_commission_permille` divided by 1000. (integer)","stars_paid_messages_available":"Specifies whether [paid messages &raquo;](https://core.telegram.org/api/paid-messages) can be enabled for the current user. (bool)","stars_paid_messages_channel_amount_default":"When choosing the price for [paid direct channel messages](https://core.telegram.org/api/paid-messages), the UI should display [stars_paid_messages_channel_amount_default](https://core.telegram.org/api/config#stars-paid-messages-channel-amount-default) as the initial default value.","stars_revenue_withdrawal_max":"Maximum amount of [Telegram Stars](https://core.telegram.org/api/stars) that can be [withdrawn &raquo;](https://core.telegram.org/api/stars#withdrawing-revenue) from a channel or bot's balance. (integer)","stars_stargift_resale_amount_max":"The maximum price that can be specified when [reselling collectible gifts &raquo;](https://core.telegram.org/api/gifts#reselling-collectible-gifts). (integer)","stars_stargift_resale_amount_min":"The minimum price that can be specified when [reselling collectible gifts &raquo;](https://core.telegram.org/api/gifts#reselling-collectible-gifts). (integer)","stars_stargift_resale_commission_permille":"When [reselling collectible gifts &raquo;](https://core.telegram.org/api/gifts#reselling-collectible-gifts), you will get `resell_stars*stars_stargift_resale_commission_permille/1000` stars. (integer)","stars_suggested_post_age_min":"A [suggested post](https://core.telegram.org/api/suggested-posts) must stay posted on the channel at least for the specified amount of seconds in order for the transaction to complete successfully. (integer)","stars_suggested_post_amount_max":"Maximum price in [Stars](https://core.telegram.org/api/stars) for a [suggested post &raquo;](https://core.telegram.org/api/suggested-posts). (integer)","stars_suggested_post_amount_min":"Minimum price in [Stars](https://core.telegram.org/api/stars) for a [suggested post &raquo;](https://core.telegram.org/api/suggested-posts). (integer)","stars_suggested_post_commission_permille":"When [suggesting posts &raquo;](https://core.telegram.org/api/suggested-posts), the channel will get `price*stars_suggested_post_commission_permille/1000` stars. (integer)","stars_suggested_post_future_max":"When [suggesting scheduled posts at a specific time &raquo;](https://core.telegram.org/api/suggested-posts), the client may only allow dates at most `stars_suggested_post_future_max` seconds in the future. (integer)","stars_suggested_post_future_min":"When [suggesting scheduled posts at a specific time &raquo;](https://core.telegram.org/api/suggested-posts), the client may only allow dates at least `stars_suggested_post_future_max` seconds in the future. (integer)","todo_item_length_max":"Maximum length of [todo list item titles &raquo;](https://core.telegram.org/api/todo). (integer)","todo_items_max":"Maximum number of [todo list items &raquo;](https://core.telegram.org/api/todo). (integer)","todo_title_length_max":"Maximum length of the title of a [todo list &raquo;](https://core.telegram.org/api/todo). (integer)","ton_blockchain_explorer_url":"Contains the base explorer URL to prepend to TON addresses. (string)","ton_suggested_post_amount_max":"Maximum price in nanograms for a [suggested post &raquo;](https://core.telegram.org/api/suggested-posts). (integer)","ton_suggested_post_amount_min":"Maximum price in nanograms for a [suggested post &raquo;](https://core.telegram.org/api/suggested-posts). (integer)","ton_suggested_post_commission_permille":"When [suggesting posts &raquo;](https://core.telegram.org/api/suggested-posts) while paying using Grams, the channel will get `price*ton_suggested_post_commission_permille/1000` nanograms. (integer)","ton_topup_url":"URL to open to topup the current TON balance. (string)","ton_usd_rate":"Current TON to USD conversion rate.  (float)","stargifts_collection_gifts_limit":"Maximum number of gifts that can be added to a [gift collection](https://core.telegram.org/api/gifts#gift-collections). (integer)","stargifts_collections_limit":"Maximum number of [gift collections](https://core.telegram.org/api/gifts#gift-collections) that can be added to a profile. (integer)","stars_rating_learnmore_url":"URL users can open to obtain more info about [star ratings &raquo;](https://core.telegram.org/api/stars#star-rating). (string)","stories_album_stories_limit":"Maximum number of stories that can be added to a [story album](https://core.telegram.org/api/stories#story-albums). (integer)","stories_albums_limit":"Maximum number of [story albums](https://core.telegram.org/api/stories#story-albums) that can be added to a profile. (integer)","ton_stargift_resale_amount_max":"The maximum price in nanograms that can be specified when [reselling collectible gifts &raquo;](https://core.telegram.org/api/gifts#reselling-collectible-gifts) using Grams. (integer)","ton_stargift_resale_amount_min":"The minimum price in nanograms that can be specified when [reselling collectible gifts &raquo;](https://core.telegram.org/api/gifts#reselling-collectible-gifts) using Grams. (integer)","ton_stargift_resale_commission_permille":"When [reselling collectible gifts &raquo;](https://core.telegram.org/api/gifts#reselling-collectible-gifts) using Grams, you will get `price*ton_stargift_resale_commission_permille/1000` nanograms. (integer)","need_age_video_verification":"Specifies whether [age verification &raquo;](https://core.telegram.org/api/age-verification) is required in the current jurisdiction to view sensitive content. \n\nThis flag will also be set to `false` if the current jurisdiction requires age verification for restricted content, **and** the user has successfully passed it on another device, or on the current device.  \n\n(boolean)","verify_age_country":"Unique name for the country or region whose legislation required [age verification &raquo;](https://core.telegram.org/api/age-verification).  (string)","verify_age_min":"Contains the minimum age required to view `sensitive` content, in the context of [age verification &raquo;](https://core.telegram.org/api/age-verification).  (integer)","verify_age_bot_username":"Contains the username of the bot whose [Main Mini App](https://core.telegram.org/api/bots/webapps#main-mini-apps) must be opened in order to proceed with [age verification &raquo;](https://core.telegram.org/api/age-verification).  (string)","call_requests_disabled":"If not set or false, an incoming [messageActionConferenceCall](https://core.telegram.org/constructor/messageActionConferenceCall) with the `missed` and `active` flags **not** set should trigger ringing and an incoming call screen, just like for one-on-one calls. (boolean)","passkeys_account_passkeys_max":"Maximum number of [passkeys &raquo;](https://core.telegram.org/api/passkeys) that can be associated to a single account.  (integer)","settings_display_passkeys":"[Passkey support &raquo;](https://core.telegram.org/api/passkeys) should only be enabled if this key is equal to true. (bool)","stars_groupcall_message_amount_max":"Maximum number of [Telegram Stars](https://core.telegram.org/api/stars) that can be paid to send a single text message during a [group call or live video stream &raquo;](https://core.telegram.org/api/group-calls). (integer)","stars_groupcall_message_limits":"Defines the highlight tiers applied to [paid messages/comments sent during a group call or live video stream &raquo;](https://core.telegram.org/api/group-calls#paid-live-story-comments), as a function of the number of [Telegram Stars](https://core.telegram.org/api/stars) donated with the message.  \n\nThis is a JSON array of objects, each describing one tier with the following keys:\n\n* `stars` (long integer) - Minimum number of donated Stars required to reach this tier.\n* `pin_period` (integer) - For how many seconds a message in this tier stays pinned/highlighted.\n* `text_length_max` (integer) - Maximum number of UTF-8 characters allowed in a message in this tier.\n* `emoji_max` (integer) - Maximum number of [custom emojis](https://core.telegram.org/api/custom-emoji) allowed in a message in this tier.\n* `color1` (string) - The first color used to show the message text, as a 6-digit hexadecimal RGB string (e.g. `955CDB`).\n* `color2` (string) - The second color used to show the message text, as a 6-digit hexadecimal RGB string (e.g. `955CDB`).\n* `color2` (string) - Background color used to show the message text, as a 6-digit hexadecimal RGB string.\n\nTiers are sorted by ascending `stars`, and the tier with `stars` equal to `0` describes the appearance of free (non-paid) messages (clients should assume such a tier exists, falling back to a default if the array does not provide one).  \nTo render a given message, clients select the tier with the highest `stars` threshold that is still less than or equal to the amount donated with the message ([groupCallMessage](https://core.telegram.org/constructor/groupCallMessage).`paid_message_stars`).","whitelisted_bots":"Array of bot user IDs that official clients grant additional trust, treating them like bots the user has already explicitly opened or added to the [attachment menu](https://core.telegram.org/api/bots/attach). Specifically, for a whitelisted bot:\n\n* The [bot launch confirmation prompt &raquo;](https://core.telegram.org/api/bots/webapps) shown before opening one of its [Mini Apps](https://core.telegram.org/api/bots/webapps) is skipped, as if the user had already confirmed opening it.\n* Its [Mini Apps](https://core.telegram.org/api/bots/webapps) are allowed to read the system clipboard through the [`web_app_read_text_from_clipboard` &raquo;](https://core.telegram.org/api/web-events#web-app-read-text-from-clipboard) event, just like the Mini Apps of [attachment menu](https://core.telegram.org/api/bots/attach) bots.","stargifts_craft_attribute_permilles":"Attribute persistence probabilities used when displaying the [collectible gift crafting UI &raquo;](https://core.telegram.org/api/gifts#crafting-collectible-gifts).  \nThis is an array of 4 arrays of integers; the array with index N has N+1 integers, each containing a probability in permille, see [here &raquo;](https://core.telegram.org/api/gifts#crafting-collectible-gifts) for more info.","no_forwards_request_expire_period":"Pending [requests to disable content protection in private chats &raquo;](https://core.telegram.org/api/content-protection#for-users) will automatically expire [no_forwards_request_expire_period &raquo;](https://core.telegram.org/api/config#no-forwards-request-expire-period) seconds after they're sent, unless they are manually accepted or rejected, first. (integer)","contact_note_length_limit":"Maximum length of [private contact notes &raquo;](https://core.telegram.org/api/contacts#private-notes-for-contacts). (integer)","group_call_message_length_limit":"Maximum length, in UTF-8 characters, of a text message sent during a [group call or live video stream &raquo;](https://core.telegram.org/api/group-calls). (integer)","group_call_message_ttl":"Number of seconds a text message sent during a [group call or live video stream &raquo;](https://core.telegram.org/api/group-calls) stays displayed before disappearing. (integer)","message_typing_draft_ttl":"[Live draft messages &raquo;](https://core.telegram.org/api/bots/ai#live-response-streaming) should be deleted automatically by graphical clients this many seconds after they're received, or when receiving a normal message within the same chat/bot forum topic, whichever comes first.  (integer)","bots_create_limit_default":"Maximum number of [bots](https://core.telegram.org/api/bots) that can be owned by non-[Premium](https://core.telegram.org/api/premium) users. (integer)","bots_create_limit_premium":"Maximum number of [bots](https://core.telegram.org/api/bots) that can be owned by [Premium](https://core.telegram.org/api/premium) users. (integer)","poll_answer_delete_period":"For [polls](https://core.telegram.org/api/poll) that allow users to add their own answer options, the time window (in seconds) during which the user that added an option may still delete it again. (integer)","poll_close_period_max":"Maximum allowed value, in seconds, for the auto-close timer of a [poll](https://core.telegram.org/api/poll). (integer)","music_search_username":"Username of the inline bot used to search for music. (string)","aicompose_tone_examples_num":"Number of preview examples available for each [custom AI composer tone &raquo;](https://core.telegram.org/api/ai#ai-compose-tones), to be cycled through with [aicompose.getToneExample](https://core.telegram.org/method/aicompose.getToneExample). (integer)","aicompose_tone_prompt_length_max":"Maximum UTF-8 length of the `prompt` of a [custom AI composer tone &raquo;](https://core.telegram.org/api/ai#ai-compose-tones). (integer)","aicompose_tone_title_length_max":"Maximum UTF-8 length of the `title` of a [custom AI composer tone &raquo;](https://core.telegram.org/api/ai#ai-compose-tones). (integer)","poll_countries_max":"Maximum number of countries that can be selected when restricting a [poll](https://core.telegram.org/api/poll) by country. (integer)","aicompose_tone_saved_limit_default":"Maximum number of [custom AI composer tones &raquo;](https://core.telegram.org/api/ai#ai-compose-tones) a non-[Premium](https://core.telegram.org/api/premium) user may install. (integer)","aicompose_tone_saved_limit_premium":"Maximum number of [custom AI composer tones &raquo;](https://core.telegram.org/api/ai#ai-compose-tones) a [Premium](https://core.telegram.org/api/premium) user may install. (integer)","phone_country_iso2":"Two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the current user, derived by the server from the user's phone number. Clients use it to enforce [country-restricted polls &raquo;](https://core.telegram.org/api/poll#country-restricted-polls): the user may vote only if this code is contained in the poll's [`countries_iso2`](https://core.telegram.org/constructor/poll) list. (string)"}},"disallowed t.me subdomains":{"description":"Reserved `t.me` subdomains that cannot be registered as public usernames.","type":"list","entries":["addemoji","addlist","addstickers","addstyle","addtheme","auction","auth","boost","call","confirmphone","contact","giftcode","invoice","joinchat","login","m","nft","proxy","setlanguage","share","socks","web","a","k","z"]},"incoming web events":{"description":"Incoming web events documented [here &raquo;](https://core.telegram.org/api/web-events#event-types).","type":"map","entries":{"payment_form_submit":"Event payload: JSON object with `credentials` and `title` fields.\n\n* `title` is the censored credit card title.  \n* `credentials` is a service-specific JSON object with information about the payment credentials provided by the user to the payment system.  \n\n**Neither Telegram, nor bots will have access to your credit card information.**  \nCredit card details will be handled only by the payment system, see the [payment documentation for more info&nbsp;&raquo;](https://core.telegram.org/api/payments).","share_score":"No event payload.\n\nWill be called by games when the user explicitly clicks on the **share score** button to share the game, along with their score.  \nTypically done by using [messages.forwardMessages](https://core.telegram.org/method/messages.forwardMessages) on the game message with the `with_my_score` flag.","share_game":"No event payload.\n\nWill be called by games when the user explicitly clicks on the **share game** button to share the game, without sharing their score.  \nTypically done by using [messages.forwardMessages](https://core.telegram.org/method/messages.forwardMessages) on the game message without the `with_my_score` flag, or by sharing the game's [deep link](https://core.telegram.org/api/links#game-links).","web_app_close":"No event payload, OR a JSON object with the following fields (which should be properly validated by the client).\n\n* `return_back` - If true, if the web app was opened through a [deep link](https://core.telegram.org/api/links) in another app (i.e. not through a deep link in a Telegram client), the Telegram client should return to the app that opened the link, not to the main page of the Telegram client. (boolean, optional)\n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) when the mini app webview should be closed.","web_app_open_popup":"Event data: a JSON object with the following fields (which should be properly validated by the client).\n\n* `title` - Title for the popup (optional string, max 64 characters)\n* `message` - Message of the popup (string, max 256 characters)\n* `buttons` - An array of the following objects (array of 1-3 objects)\n  * `type` - Button type (string, one of `ok`, `close`, `cancel`, `default`, `destructive` (in this case, the button must be red))\n  * `text` - Button text (string, optional for `ok`, `close` and `cancel` types)\n  * `id` - Button ID (unique string)\n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to open a native pop-up over the webview.\n\nBy default, buttons should be displayed on one row.  \nIf the mini app provides two buttons that can't fit horizontally on one row, display each button on a separate row.  \nIf the mini app provides three buttons, always display each button on a separate row.  \n\n* If the user presses any of the buttons, call `window.Telegram.WebView.receiveEvent(\"popup_closed\", {\"button_id\": \"<button id>\"})`\n* If the user cancels the interaction without pressing any of the specified buttons, call `window.Telegram.WebView.receiveEvent(\"popup_closed\", {})`\n\nDisable handling of this event if a popup is already being displayed, re-enable handling only after the `popup_closed` response event is emitted.  \nWhile handling is enabled, maximum 3 consecutive valid events of this type can be handled in a timespan of 3 seconds, ignore excess events.","web_app_request_write_access":"Event data: `null`\n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to ask permission from the user to send them messages.  \n\nUpon receiving this event, clients should first invoke [bots.canSendMessage](https://core.telegram.org/method/bots.canSendMessage), to check whether they have already granted the bot permission to write them in some way.  \n\n* If the method returns [boolTrue](https://core.telegram.org/constructor/boolTrue), a [write_access_requested event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#write-access-requested) with `{\"status\": \"allowed\"}` should be sent to the Mini App.\n* Otherwise, if the method returns [boolFalse](https://core.telegram.org/constructor/boolFalse), a prompt should be shown to the user, indicating that the bot is asking permission to send messages to them.  \n  If the user accepts, invoke [bots.allowSendMessage](https://core.telegram.org/method/bots.allowSendMessage), and if the method call succeeds emit a [write_access_requested event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#write-access-requested) with `{\"status\": \"allowed\"}`.  \n  Otherwise, if the user refuses or the [bots.allowSendMessage](https://core.telegram.org/method/bots.allowSendMessage) call fails, emit a [write_access_requested event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#write-access-requested) with `{\"status\": \"cancelled\"}`.","web_app_request_phone":"Event data: `null`\n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to ask the user to share their phone number as a contact.\n\nUpon receiving this event, clients should show a prompt to the user, indicating that the bot is asking them to share their phone number (optionally also asking the user to unblock the bot, if it's currently blocked).  \n\nIf they accept, the user's phone number should be shared by sending a contact to the bot (unblocking it first, if it's currently blocked by the user); if all RPC queries (to unblock the bot, to send the message) succeed, a [phone_requested event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#write-access-requested) should be sent with `{\"status\": \"sent\"}`.  \n\nIf the user refuses or any intermediate method call fails, a [phone_requested event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#write-access-requested) should be sent with `{\"status\": \"cancelled\"}`.","web_app_biometry_get_info":"Event data: `null`\n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to ask the client to initialize the biometric authentication manager object for the current bot, emitting a [`biometry_info_received` event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#biometry-info-received) on completion.  \n\nThis request should just initialize the client-side state, i.e. by checking if biometric authentication is even available or not, it should not ask the user anything.","web_app_biometry_request_access":"Event data: a JSON object, with an optional `reason` string field (1-128 chars, used in the prompt), containing the reason why the bot is asking to use biometric authentication.  \n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to ask the user permission to use biometric authentication, emitting a [`biometry_info_received` event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#biometry-info-received) on completion.  \n\nThis request should not actually prompt biometric authentication, it should just ask the user permission to use it through a popup that should be shown only **once** (for this bot): no popup must be shown if the user has already previously allowed, denied or cancelled a biometry permission popup from this bot.","web_app_biometry_update_token":"Event data: a JSON object with the following fields:\n\n* `token` - The new token (string, 0-1024 chars), or an empty string to remove it.  \n* `reason` - Optional string field, containing the reason why the bot is asking to authenticate using biometrics (1-128 chars, used in the prompt).  \n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to authenticate using biometrics and store the biometric token securely stored on-device, emitting a [`biometry_token_updated` event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#biometry-token-updated) on completion.  \n\nThis token (which may be for example the private key of a cryptocurrency wallet, or some other data the app must keep safe) must be safely stored by the Telegram client, associating it to the bot that owns the mini app.  \n\nFor example, the token may be directly stored in the on-device secure storage, accessible only after biometric authentication, or it may be stored to normal, non-secure storage, but **in encrypted form**, encrypted using the key returned from the device's secure storage after biometric authentication (for example on Android, using the CryptoObject returned by <a href=\"https://developer.android.com/reference/android/hardware/biometrics/BiometricPrompt.AuthenticationResult#getCryptoObject()\">the biometric prompt authentication result</a>).  \n\nIf the user has [previously disallowed](https://core.telegram.org/api/web-events#web-app-biometry-request-access) the bot from using biometric authentication, this request should immediately fail, emitting an appropriate [`biometry_token_updated` event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#biometry-token-updated).","web_app_biometry_request_auth":"Event data: a JSON object, with an optional `reason` string field, containing the reason why the bot is asking to authenticate using biometrics (1-128 chars, used in the prompt).  \n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to authenticate using biometrics and fetch the [previously stored secure token](https://core.telegram.org/api/web-events#web-app-biometry-update-token), emitting a [`biometry_auth_requested` event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#biometry-auth-requested) on completion, containing either an error, or the decrypted [biometric token&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-update-token) (or an empty string if no token was configured yet).  \n\nShould only be used if the `token_saved` field of the [biometry_info_received object&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#biometry-info-received) is equal to `true`, otherwise set a new token first using [web_app_biometry_update_token&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-update-token).  \n\nIf the user has [previously disallowed](https://core.telegram.org/api/web-events#web-app-biometry-request-access) the bot from using biometric authentication, this request should immediately fail, emitting an appropriate [`biometry_auth_requested` event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#biometry-auth-requested).","web_app_biometry_open_settings":"Event data: `null`\n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to open the biometric authentication settings page for bots, useful when the app needs to request permission to use biometrics from users who have previously denied it.\n\nNote that this event should only be handled in response to user interaction with the Mini App interface (e.g. a click inside the Mini App or on the main button), and it must be handled at most once a second.","web_app_invoke_custom_method":"Event data: a JSON object with the following fields:\n\n* `req_id` - A string with the ID of the current request\n* `method` - A string, containing the name of the called custom method\n* `params` - An object containing the parameters of the method call\n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to make custom method calls to Telegram's servers on behalf of the user.  \n\nThis event should trigger a [bots.invokeWebViewCustomMethod](https://core.telegram.org/method/bots.invokeWebViewCustomMethod) request, passing the `method` to `custom_method`, and the `params` to `params`.  \n\nUpon receiving a reply, a [custom_method_invoked event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#custom-method-invoked) should be emitted, with the following fields:\n\n* `req_id` - The `req_id` from the `web_app_invoke_custom_method` object\n* `result` - The JSON data contained in the response of the [bots.invokeWebViewCustomMethod](https://core.telegram.org/method/bots.invokeWebViewCustomMethod) method, if the method call succeeded\n* `error` - The text of the RPC error, if the method call failed","web_app_read_text_from_clipboard":"Event data: a JSON object with the following fields:\n\n* `req_id` - A string with the ID of the current request\n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to obtain the contents of the system clipboard.  \n\nOnly for Mini Apps owned by bots added to the [attachment menu](https://core.telegram.org/api/bots/attach) or contained in the [`whitelisted_bots` &raquo;](https://core.telegram.org/api/config#whitelisted-bots) configuration parameter, regardless of how the Mini App itself was launched, this event should trigger a [clipboard_text_received event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#clipboard-text-received) with the following payload:  \n\n* `req_id` - The `req_id` from the `web_app_read_text_from_clipboard` request\n* `data` - A string with the clipboard contents\n\nNote that this method can be called only in response to a user interaction with the Mini App interface (e.g. a click inside the Mini App or on the main or settings button).  \nNote that user interactions must have a TTL of 10 seconds: events of this type must be ignored and a [clipboard_text_received event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#clipboard-text-received) with the correct `req_id` and no `data` field must be sent if the last Mini App user interaction (as described above) happened more than 10 seconds ago.  \n\nA [clipboard_text_received event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#clipboard-text-received) with the correct `req_id` and no `data` field must also be sent if the bot is neither installed in the [attachment menu](https://core.telegram.org/api/bots/attach) nor contained in the [`whitelisted_bots` &raquo;](https://core.telegram.org/api/config#whitelisted-bots) configuration parameter.","web_app_open_scan_qr_popup":"Event data: a JSON object with the following fields:\n\n- `text` - Optional string, containing the text to be displayed under the 'Scan QR' heading, 0-64 characters.  \n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to prompt the client to open the native QR code scanner and start continuously scanning for QR codes.  \n\nA [`qr_text_received` event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#qr-text-received) should be emitted every time a new QR code is scanned, until the user closes the popup via the UI or the Mini App closes the popup with a [web_app_close_scan_qr_popup](https://core.telegram.org/api/web-events#web-app-close-scan-qr-popup) event.\n\nClosing the popup should emit a [`scan_qr_popup_closed` event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#scan-qr-popup-closed); the same event should be emitted if the scan QR code popup cannot be opened due to permission issues.","web_app_close_scan_qr_popup":"Event data: `null`\n\nEmitted by [bot mini apps](https://core.telegram.org/api/bots/webapps) to prompt the client to close the native QR code scanner opened using [web_app_open_scan_qr_popup](https://core.telegram.org/api/web-events#web-app-open-scan-qr-popup).  \n\nThe [`scan_qr_popup_closed` event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#scan-qr-popup-closed) event should *not* be emitted if the QR code popup is closed using this event.","web_app_setup_closing_behavior":"Event data: a JSON object with a boolean `need_confirmation`.\n\nIf equal to `true`, the client should require user confirmation with a \"Changes that you made may not be saved.\" popup with \"Cancel\"/\"Close anyway\" buttons before closing the webview, to avoid accidentally aborting a sensitive operation; otherwise no confirmation should be requested.","web_app_set_background_color":"Event data: a JSON object with a string `color` with a hex RGB color.  \n\nUsed to set the mini app background and lower overscroll color.","web_app_set_header_color":"Event data: a JSON object with the following fields:\n\n* `color_key` - A string with one of the following values:\n  * `bg_color` - The `bg_color` from the [theme parameters](https://core.telegram.org/api/bots/webapps#theme-parameters) should be used.\n  * `secondary_bg_color` - The `secondary_bg_color` from the [theme parameters](https://core.telegram.org/api/bots/webapps#theme-parameters) should be used.\n* `color` - A color in hex RGB format (`#ffffff`).\n\nThe two fields are mutually exclusive, if none of the two fields are provided the default header color is used.\n\nUsed to set the mini app header and upper overscroll color.","web_app_data_send":"Event data: a JSON object with a string `data` field.  \n\nUsed **only** by [keyboard button mini apps](https://core.telegram.org/api/bots/webapps#keyboard-button-mini-apps) to send back data to the bot as specified [here&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#keyboard-button-mini-apps). The Mini App will be closed.","web_app_switch_inline_query":"Event data: a JSON object with the following keys:\n\n* `query` - The inline query that will be inserted in the chat's input field, after the bot's username.  \n  May be an empty string, in which case just the bot's username will be inserted, triggering an empty inline query.\n* `chat_types` - An array of strings, containing a combination of `users`, `bots`, `groups`, `channels`.  \n  If non-empty, the client should prompt the user to choose a specific chat of the specified type(s), then open the chosen chat and inserts the bot's username and the specified inline query in the input field.  \n  The array values specify which types of chats the user will be able to choose from.  \n  If empty, the current chat is used.  \n\nUsed by [inline mode mini apps](https://core.telegram.org/api/bots/webapps#inline-mode-mini-apps) to send back data to the bot as specified [here&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#inline-mode-mini-apps). The Mini App will be closed.","web_app_trigger_haptic_feedback":"Event data: a JSON object with the following fields:\n\n* `type` - One of the following values (string):\n  * `impact` - An impact occurred.\n  * `notification` - A task or action has succeeded, failed, or produced a warning.\n  * `selection_change` - The user has changed a selection.\n* `impact_style` - Only for `impact` feedbacks, one of the following values (string):\n  * `light` - Indicates a collision between small or lightweight UI objects\n  * `medium` - Indicates a collision between medium-sized or medium-weight UI objects\n  * `heavy` - Indicates a collision between large or heavyweight UI objects\n  * `rigid` - Indicates a collision between hard or inflexible UI objects\n  * `soft` - Indicates a collision between soft or flexible UI objects\n* `notification_type` - Only for `notification` feedbacks, one of the following values (string):\n  * `error` - Indicates that a task or action has failed\n  * `success` - Indicates that a task or action has completed successfully\n  * `warning` - Indicates that a task or action produced a warning\n\nUsed to trigger haptic feedback for a user interaction in a webapp.","web_app_open_link":"Event data: a JSON object with the following fields:\n\n- `url` - The URL to open\n- `try_instant_view` - Optional boolean, if set, equal to `true` and the scheme of the URL is either `http` or `https`, the link should be opened in [Instant View mode](https://core.telegram.org/methods#working-with-instant-view-pages) if possible. \n- `try_browser` - Optional string, if set, must contain one of the following browser identifiers, and the client should attempt to open the link using the specified browser (if it's currently installed on the device): \n  - `google-chrome` or `chrome` - Google Chrome\n  - `mozilla-firefox` or `firefox` - Firefox\n  - `microsoft-edge` or `edge` - Microsoft Edge\n  - `opera` - Opera\n  - `opera-mini` - Opera Mini\n  - `brave` or `brave-browser` - Brave Browser\n  - `duckduckgo` or `duckduckgo-browser` - Duckduckgo Browser\n  - `samsung` or `samsung-browser` - Samsung Browser\n  - `vivaldi` or `vivaldi-browser` - Vivaldi\n  - `kiwi` or `kiwi-browser` - Kiwi\n  - `uc` or `uc-browser` - UC browser\n  - `tor` or `tor-browser` - TOR browser\n\nUsed to open a link in an external browser (or in a new tab for browser clients). The Mini App will not be closed.  \n\nOnly URLs with the scheme equal to one of the schemes specified in [web_app_allowed_protocols](https://core.telegram.org/api/config#web-app-allowed-protocols) may be opened.  \n\nNote that this method can be called only in response to a user interaction with the Mini App interface (e.g. a click inside the Mini App or on the main or settings button).  \nAfter opening the URL, further events of this type should be ignored until the user interacts again with the Mini App interface (as above).  \nNote that user interactions must have a TTL of 1 second: events of this type must be ignored if the last Mini App user interaction happened more than 1 second ago.","web_app_open_tg_link":"Event data: a JSON object with the following fields:\n\n- `path_full` - string field, containing the path+query component of a [t.me deep link](https://core.telegram.org/api/links) (`url = 'https://t.me' + path_full`)\n- `force_request` - optional boolean field, if set and true the client must ignore any locally cached information for the deep link (mainly used to refresh the cache information for [stickerset links &raquo;](https://core.telegram.org/api/links#stickerset-links))\n\nUsed to open a [t.me deep link](https://core.telegram.org/api/links). The Mini App must not be closed.","web_app_open_invoice":"Event data: a JSON object with a string `slug` field, containing an [invoice deep link](https://core.telegram.org/api/links#invoice-links).\n\nUsed to initiate [payment of an invoice&nbsp;&raquo;](https://core.telegram.org/api/payments), by opening an invoice popup over the Mini App: the Mini App itself must not be closed.  \n\nThe payment status must be reported back to the mini app using [invoice_closed](https://core.telegram.org/api/bots/webapps#invoice-closed).","web_app_expand":"No event payload.\n\nExpands the mini app to the maximum available height.  \nThe mini app must also be expanded when the user swipes up on the webview.  \n\nThis event must be ignored _during_ a user swipe down, used to reduce the webview.","web_app_request_viewport":"No event payload.\n\nUsed by mini apps to request information about the viewport, clients should emit a [viewport_changed event](https://core.telegram.org/api/bots/webapps#viewport-changed).","web_app_request_theme":"No event payload.\n\nUsed by mini apps to request information about the current theme, clients should emit a [theme_changed event](https://core.telegram.org/api/bots/webapps#theme-changed).","web_app_ready":"No event payload.\n\nEmitted by mini apps when they are fully loaded, signaling to client apps that the loading spinner placeholder can be removed.  \n\nNote that there is no guarantee that this event will be emitted when the mini app is fully loaded: clients should remove the loading spinner upon receiving this event or when the page finishes loading (native webview/iframe event), whichever event comes first.","web_app_setup_main_button":"Event payload: JSON object with the following fields:\n\n* `is_visible` - Whether the main button is visible (boolean, false by default)\n* `is_active` - Whether the main button is active (boolean, true by default)\n* `text` - Button text (string, if `trim(text)` is empty the button must be hidden)\n* `color` - Button color in hex RGB format (string, defaults to the [`button_color` theme parameter](https://core.telegram.org/api/bots/webapps#theme-parameters))\n* `text_color` - Button text color in hex RGB format (string, defaults to the [`button_text_color` theme parameter](https://core.telegram.org/api/bots/webapps#theme-parameters))\n* `is_progress_visible` - Indicates whether the button should display a loading indicator (boolean, false by default)\n* `has_shine_effect` - Whether the button should have a shine effect (boolean, false by default)\n* `icon_custom_emoji_id` - Optional long integer in string form, containing the ID of the [custom emoji&nbsp;&raquo;](https://core.telegram.org/api/custom-emoji) to show as the button icon.\n\nConfigures the main button, located immediately below the webview: when the user presses it a [`main_button_pressed` event should be emitted by the client](https://core.telegram.org/api/bots/webapps#main-button-pressed).  \n\nSome clients implement a horizontal media type tab bar located at the bottom of the screen, opened when the user clicks on the attachment menu button: this tab bar contains a horizontal list of buttons used to attach media of a certain type and to open installed [attachment menu mini apps](https://core.telegram.org/api/bots/attach).  \nIn clients that implement a tab bar, if and only if the user opens a mini app through a tab bar button and the mini app emits a `web_app_setup_main_button` with `is_visible=true`, the main button should be displayed (replacing the tab bar) only after the first tap inside of the webview, to prevent bots from immediately blocking the tab bar.  \n\nOtherwise, the main button can be displayed right away with no user interaction when receiving a `web_app_setup_main_button` event with `is_visible=true`.","web_app_setup_back_button":"Event data: a JSON object with an `is_visible` boolean field.\n\nDetermines whether to show or hide the back button: when the user presses it a [`back_button_pressed` event should be emitted by the client](https://core.telegram.org/api/bots/webapps#back-button-pressed).  \nNote that on supported platforms, the OS back button can be used instead of a custom back button: in this case, if `is_visible` is true pressing the OS back button should emit a [`back_button_pressed` event](https://core.telegram.org/api/bots/webapps#back-button-pressed), otherwise the webview should be closed.","web_app_setup_settings_button":"Event data: a JSON object with an `is_visible` boolean field.\n\nDetermines whether to show or hide the settings button: when the user presses it a [`settings_button_pressed` event should be emitted by the client](https://core.telegram.org/api/bots/webapps#settings-button-pressed).","resize_frame":"Event payload: JSON object with `height` field.\n\nCalled by supported pages inside of [IV](https://instantview.telegram.org) iframe embeds, indicates the new size of the embed frame.","web_app_setup_swipe_behavior":"Event payload: JSON object with boolean `allow_vertical_swipe` field.  \n\nCalled by [bot web apps](https://core.telegram.org/api/bots/webapps) to tell the client to enable or disable the vertical swipe gesture usually used on mobile to minimize the web app.","web_app_set_bottom_bar_color":"Event data: a JSON object with a string `color` with a hex RGB color.  \n\nUsed to set the mini app bottom bar color.","web_app_setup_secondary_button":"Event payload: JSON object with the following fields:\n\n* `is_visible` - Whether the button is visible (boolean, false by default)\n* `is_active` - Whether the button is active (boolean, true by default)\n* `text` - Button text (string, if `trim(text)` is empty the button must be hidden)\n* `color` - Button color in hex RGB format (string, defaults to the [`button_color` theme parameter](https://core.telegram.org/api/bots/webapps#theme-parameters))\n* `text_color` - Button text color in hex RGB format (string, defaults to the [`button_text_color` theme parameter](https://core.telegram.org/api/bots/webapps#theme-parameters))\n* `is_progress_visible` - Indicates whether the button should display a loading indicator (boolean, false by default)\n* `has_shine_effect` - Whether the button should have a shine effect (boolean, false by default)\n* `position` - One of `left`, `right`, `top`, `bottom` (string, defaults to `left`)\n* `icon_custom_emoji_id` - Optional long integer in string form, containing the ID of the [custom emoji&nbsp;&raquo;](https://core.telegram.org/api/custom-emoji) to show as the button icon.\n\nConfigures the secondary button, located immediately below the webview, either on the left, right, top or bottom of the main button (if it is visible, otherwise it is located where the main button is usually located).  \n\nWhen the user presses it a [`secondary_button_pressed` event should be emitted by the client](https://core.telegram.org/api/bots/webapps#secondary-button-pressed).  \n\nSome clients implement a horizontal media type tab bar located at the bottom of the screen, opened when the user clicks on the attachment menu button: this tab bar contains a horizontal list of buttons used to attach media of a certain type and to open installed [attachment menu mini apps](https://core.telegram.org/api/bots/attach).  \nIn clients that implement a tab bar, if and only if the user opens a mini app through a tab bar button and the mini app emits a `web_app_setup_secondary_button` with `is_visible=true`, the secondary button should be displayed (replacing the tab bar) only after the first tap inside of the webview, to prevent bots from immediately blocking the tab bar.  \n\nOtherwise, the secondary button can be displayed right away with no user interaction when receiving a `web_app_setup_secondary_button` event with `is_visible=true`.","web_app_share_to_story":"Event payload: JSON object with the following fields:\n\n* `media_url` - A string containing an HTTPS URL of the media to share as a story\n* `text` - An optional string caption for the media\n* `widget_link` - An optional object describing a [URL media area &raquo;](https://core.telegram.org/api/stories#urls) to be included in the story, with the following fields:\n  * `url` - A string with the URL of the widget\n  * `text` - An optional string with a label for the widget\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to share a [story on the user's profile &raquo;](https://core.telegram.org/api/stories), specifying an optional caption and [URL widget &raquo;](https://core.telegram.org/api/stories#urls).  \n\nThis event should open the app's story editor with the specified media, caption and widget, letting the user tweak the story before posting it.","web_app_request_fullscreen":"Event payload: a JSON object with the following fields:\n\n* `blur` - Optional boolean, indicating whether background content should be blurred when the Mini App is in fullscreen mode (defaults to `true`).\n\nEmitted by [mini web apps](https://core.telegram.org/api/bots/webapps) to request expansion of the web app to fullscreen mode.  \n\nOn success, emits a [fullscreen_changed event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#fullscreen-changed) with `is_fullscreen=true` and `blur_enabled` set to the effective `blur` value.  \nOn failure, emits a [fullscreen_failed event](https://core.telegram.org/api/bots/webapps#fullscreen-failed) with `error` equal to `UNSUPPORTED` (Fullscreen mode is not supported on this device or platform) or `ALREADY_FULLSCREEN` (The Mini App is already in fullscreen mode).","web_app_exit_fullscreen":"Event payload: `null`\n\nEmitted by [mini web apps](https://core.telegram.org/api/bots/webapps) to request exiting fullscreen mode.  \n\nThis method should unconditionally emit a [fullscreen_changed event](https://core.telegram.org/api/bots/webapps#fullscreen-changed) with `is_fullscreen=false` (even if we've already exited fullscreen mode).  \nOn platforms where fullscreen mode is not supported, must emit a [fullscreen_failed event](https://core.telegram.org/api/bots/webapps#fullscreen-failed) with `error` equal to `UNSUPPORTED` instead of `fullscreen_changed`.","web_app_start_accelerometer":"Event payload: JSON object with the following fields:\n\n* `refresh_rate` - An optional integer indicating the refresh rate in milliseconds, ranging from 20 to 1000 (defaults to 1000).  \n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to start accelerometer tracking.  \n\nThe specified refresh rate may be ignored on platforms where it is not supported, or if it doesn't fall within the supported range: this should not cause an error, tracking should be started with the closest supported refresh rate.  \n\nEmits an [accelerometer_started event](https://core.telegram.org/api/bots/webapps#accelerometer-started) on success, or an [accelerometer_failed event](https://core.telegram.org/api/bots/webapps#accelerometer-failed) with `error=UNSUPPORTED` on platforms with no accelerometer tracking.  \n\nUntil [web_app_stop_accelerometer](https://core.telegram.org/api/web-events#web-app-stop-accelerometer) is emitted by the mini app, the client will emit [accelerometer_changed events](https://core.telegram.org/api/bots/webapps#accelerometer-changed) at most every `refresh_rate` milliseconds with accelerometer readings.","web_app_stop_accelerometer":"Event payload: `null`\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to stop accelerometer tracking, stopping the emission of [accelerometer_changed events](https://core.telegram.org/api/bots/webapps#accelerometer-changed).  \n\nEmits an [accelerometer_stopped event](https://core.telegram.org/api/bots/webapps#accelerometer-stopped) on success, or an [accelerometer_failed event](https://core.telegram.org/api/bots/webapps#accelerometer-failed) with `error=UNSUPPORTED` on platforms with no accelerometer tracking.","web_app_start_gyroscope":"Event payload: JSON object with the following fields:\n\n* `refresh_rate` - An optional integer indicating the refresh rate in milliseconds, ranging from 20 to 1000 (defaults to 1000).  \n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to start gyroscope tracking.  \n\nThe specified refresh rate may be ignored on platforms where it is not supported, or if it doesn't fall within the supported range: this should not cause an error, tracking should be started with the closest supported refresh rate.  \n\nEmits a [gyroscope_started event](https://core.telegram.org/api/bots/webapps#gyroscope-started) on success, or a [gyroscope_failed event](https://core.telegram.org/api/bots/webapps#gyroscope-failed) with `error=UNSUPPORTED` on platforms with no gyroscope tracking.  \n\nUntil [web_app_stop_gyroscope](https://core.telegram.org/api/web-events#web-app-stop-gyroscope) is emitted by the mini app, the client will emit [gyroscope_changed events](https://core.telegram.org/api/bots/webapps#gyroscope-changed) at most every `refresh_rate` milliseconds with gyroscope readings.","web_app_stop_gyroscope":"Event payload: `null`\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to stop gyroscope tracking, stopping the emission of [gyroscope_changed events](https://core.telegram.org/api/bots/webapps#gyroscope-changed).  \n\nEmits a [gyroscope_stopped event](https://core.telegram.org/api/bots/webapps#gyroscope-stopped) on success, or a [gyroscope_failed event](https://core.telegram.org/api/bots/webapps#gyroscope-failed) with `error=UNSUPPORTED` on platforms with no gyroscope tracking.","web_app_start_device_orientation":"Event payload: JSON object with the following fields:\n\n* `refresh_rate` - An optional integer indicating the refresh rate in milliseconds, ranging from 20 to 1000 (defaults to 1000).  \n* `need_absolute` - An optional boolean, indicating whether the app is requesting to receive absolute orientation data, allowing it to determine the device's attitude relative to magnetic north (useful to implement features like a compass, defaults to `false`)\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to start device orientation tracking.  \n\nThe specified refresh rate may be ignored on platforms where it is not supported, or if it doesn't fall within the supported range: this should not cause an error, tracking should be started with the closest supported refresh rate.  \nAbsolute orientation data may also not be supported on some platforms, in which case relative orientation events will be sent, instead.  \n\nEmits a [device_orientation_started event](https://core.telegram.org/api/bots/webapps#device-orientation-started) on success, or a [device_orientation_failed event](https://core.telegram.org/api/bots/webapps#device-orientation-failed) with `error=UNSUPPORTED` on platforms with no device orientation tracking.  \n\nUntil [web_app_stop_device_orientation](https://core.telegram.org/api/web-events#web-app-stop-device-orientation) is emitted by the mini app, the client will emit [device_orientation_changed events](https://core.telegram.org/api/bots/webapps#device-orientation-changed) at most every `refresh_rate` milliseconds with device orientation readings.","web_app_stop_device_orientation":"Event payload: `null`\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to stop device orientation tracking, stopping the emission of [device_orientation_changed events](https://core.telegram.org/api/bots/webapps#device-orientation-changed).  \n\nEmits a [device_orientation_stopped event](https://core.telegram.org/api/bots/webapps#device-orientation-stopped) on success, or a [device_orientation_failed event](https://core.telegram.org/api/bots/webapps#device-orientation-failed) with `error=UNSUPPORTED` on platforms with no device orientation tracking.","web_app_add_to_home_screen":"Event payload: `null`\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to ask the user to add a shortcut to the mini app (using the bot's logo) on the homescreen.  \n\nIgnore incoming events of this type if another event of the same type is still being handled, or if the last click of the user within the app occurred more than 10 seconds ago.  \n\nEmits a [home_screen_added event](https://core.telegram.org/api/bots/webapps#home-screen-added) if the shortcut was (already) added successfully, and a [home_screen_failed event](https://core.telegram.org/api/bots/webapps#home-screen-failed) with `error=\"UNSUPPORTED\"` on unsupported platforms.  \n\nIt is acceptable to not emit the `home_screen_added` and `home_screen_failed` events if the current platform doesn't have a way to determine the installation status of the shortcut.","web_app_check_home_screen":"Event payload: `null`\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to check if a shortcut to the mini app was added to the homescreen.  \n\nMust emit a [home_screen_checked event &raquo;](https://core.telegram.org/api/bots/webapps#home-screen-checked) event with the status (including on unsupported platforms, see the [event documentation &raquo;](https://core.telegram.org/api/bots/webapps#home-screen-checked) for this case).","web_app_set_emoji_status":"Event payload: JSON object with the following fields:\n\n- `custom_emoji_id` - Long integer in string form, containing the ID of the [custom emoji](https://core.telegram.org/api/custom-emoji) to set as emoji status (string)\n- `duration` - Optional integer, indicating the TTL of the status; if 0, the status doesn't expire (integer, defaults to 0)\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to manually set (or remove) the [status emoji](https://core.telegram.org/api/emoji-status) of a user.  \n\nIgnore incoming events of this type if another event of the same type is still being handled, or if the last click of the user within the app occurred more than 10 seconds ago.  \n\nEmits an [emoji_status_set event](https://core.telegram.org/api/bots/webapps#emoji-status-set) on success and [emoji_status_failed event](https://core.telegram.org/api/bots/webapps#emoji-status-failed) on failure.","web_app_request_emoji_status_access":"Event payload: `null`\n\nIgnore incoming events of this type if another event of the same type is still being handled, or if the last click of the user within the app occurred more than 10 seconds ago.  \n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to ask permission to update the [emoji status](https://core.telegram.org/api/emoji-status) of a user using the [bots.updateUserEmojiStatus](https://core.telegram.org/method/bots.updateUserEmojiStatus) method.  \n\nIf the user already previously agreed (i.e. the [userFull](https://core.telegram.org/constructor/userFull).`bot_can_manage_emoji_status` flag of the bot is set for the user), emit an [emoji_status_access_requested event](https://core.telegram.org/api/bots/webapps#emoji-status-access-requested) event with `status=\"allowed\"` and terminate the flow.  \n\nIf the user refuses, emit an [emoji_status_access_requested event](https://core.telegram.org/api/bots/webapps#emoji-status-access-requested) event with `status=\"cancelled\"` and terminate the flow.  \n\nIf the user agrees, the client must invoke the [bots.toggleUserEmojiStatusPermission](https://core.telegram.org/method/bots.toggleUserEmojiStatusPermission) method, passing `enabled=true` and the ID of the bot: if the method returns [boolTrue](https://core.telegram.org/constructor/boolTrue), emit an [emoji_status_access_requested event](https://core.telegram.org/api/bots/webapps#emoji-status-access-requested) event with `status=\"allowed\"`; otherwise emit the same event with `status=\"cancelled\"`.  \n\nOn success, the bot will be able to use [bots.updateUserEmojiStatus](https://core.telegram.org/method/bots.updateUserEmojiStatus) to change the emoji status of the user.","web_app_request_safe_area":"Event payload: `null`\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to request the emission of a [safe_area_changed event &raquo;](https://core.telegram.org/api/bots/webapps#safe-area-changed), containing the current system-defined safe area inset padding values.","web_app_request_content_safe_area":"Event payload: `null`\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to request the emission of a [content_safe_area_changed event &raquo;](https://core.telegram.org/api/bots/webapps#content-safe-area-changed), containing the current content-defined safe area inset padding values.","web_app_check_location":"Event payload: `null`\n\nMust be used by [mini apps](https://core.telegram.org/api/bots/webapps) to initialize the geolocation object in the client and obtain basic information about geolocation capabilities and status, as a [location_checked event &raquo;](https://core.telegram.org/api/bots/webapps#location-checked).  \n\nThis event should not actually ask anything from the user, just return the current settings (not the current geolocation).","web_app_request_location":"Event payload: `null`\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to request the emission of a [location_requested event &raquo;](https://core.telegram.org/api/bots/webapps#location-requested), containing current geolocation data of the user (or nothing if the user denied access to their current geolocation).  \n\nThis event should ask the user permission to share their location with the current mini app only if the user hasn't already denied or allowed location access to the mini app, in which case no prompt must be shown.","web_app_open_location_settings":"Event payload: `null`\n\nUsed by [mini apps](https://core.telegram.org/api/bots/webapps) to request opening the geolocation settings page for bots, useful when the app needs to request permission to use the current geolocation from users who have previously denied it.\n\nNote that this event should only be handled in response to user interaction with the Mini App interface (e.g. a click inside the Mini App or on the main button within the last 10 seconds) and only if an event of the same type isn't already being handled.","web_app_request_file_download":"Event data: a JSON object with `url` and `file_name` string fields.\n\nUsed by [bot web apps](https://core.telegram.org/api/bots/webapps) to request the download of a file.  \n\nHandle this event using the following steps:\n\n1) Invoke [bots.checkDownloadFileParams](https://core.telegram.org/method/bots.checkDownloadFileParams), passing the `url`, `file_name` and the ID of the bot.  \n  Ignore further `web_app_request_file_download` events until step 3 is reached (new `web_app_request_file_download` *can* be accepted while the previous file is being downloaded).   \n  1.1) If the method doesn't return [boolTrue](https://core.telegram.org/constructor/boolTrue), emit a [file_download_requested](https://core.telegram.org/api/bots/webapps#file-download-requested) event with status equal to `cancelled` and abort the process.\n2) If [boolTrue](https://core.telegram.org/constructor/boolTrue) is returned, show a prompt to the user, notifying them that `$nameOfTheBot` is asking to download a file with name `file_name`.  \n  2.1) If the user refuses to download the file, emit a [file_download_requested](https://core.telegram.org/api/bots/webapps#file-download-requested) event with status equal to `cancelled` and abort the process.  \n3) If the user agrees, start downloading the file from `url` as `file_name` and emit a [file_download_requested](https://core.telegram.org/api/bots/webapps#file-download-requested) event with status equal to `downloading`.  \n4) When the download is finished, show a toast to the user, indicating that the file was downloaded successfully.","web_app_send_prepared_message":"Event data: a JSON object with an `id` string field.\n\nUsed by [bot web apps](https://core.telegram.org/api/bots/webapps) to invite the user to send a [prepared inline message &raquo;](https://core.telegram.org/api/bots/inline#21-using-a-prepared-inline-message).","web_app_toggle_orientation_lock":"Event data: a JSON object with a `locked` boolean field (defaults to `false`).\n\nUsed by [bot web apps](https://core.telegram.org/api/bots/webapps) to enable or disable the orientation lock.","web_app_device_storage_save_key":"Event data: a JSON object with the following keys:\n\n- `req_id` - A string with the ID of the current request\n- `key` - A string with the key to save\n- `value` - A string with the value to save, or `null` to remove the key.  \n\nUsed by [bot web apps](https://core.telegram.org/api/bots/webapps) to save or remove a key from a persistent local storage on the user's device, associated to the currently logged in user and mini app.  \n\nAll data is stored locally and is available only to the bot that created it. Each bot can store up to 5 MB per user using this storage.  \n\nEmits a [device_storage_key_saved event &raquo;](https://core.telegram.org/api/bots/webapps#device-storage-key-saved) on success and a [device_storage_failed event &raquo;](https://core.telegram.org/api/bots/webapps#device-storage-failed) on failure.","web_app_device_storage_get_key":"Event data: a JSON object with the following keys:\n\n- `req_id` - A string with the ID of the current request\n- `key` - A string with the key to fetch\n\nUsed by [bot web apps](https://core.telegram.org/api/bots/webapps) to fetch a key from a persistent local storage on the user's device, associated to the currently logged in user and mini app.  \n\nEmits a [device_storage_key_received event &raquo;](https://core.telegram.org/api/bots/webapps#device-storage-key-received) on success and a [device_storage_failed event &raquo;](https://core.telegram.org/api/bots/webapps#device-storage-failed) on failure.","web_app_device_storage_clear":"Event data: a JSON object with the following keys:\n\n- `req_id` - A string with the ID of the current request\n\nUsed by [bot web apps](https://core.telegram.org/api/bots/webapps) to clear the persistent local storage on the user's device, associated to the currently logged in user and mini app.  \n\nEmits a [device_storage_cleared event &raquo;](https://core.telegram.org/api/bots/webapps#device-storage-cleared) on success and a [device_storage_failed event &raquo;](https://core.telegram.org/api/bots/webapps#device-storage-failed) on failure.","web_app_secure_storage_save_key":"Event data: a JSON object with the following keys:\n\n- `req_id` - A string with the ID of the current request\n- `key` - A string with the key to save\n- `value` - A string with the value to save, or `null` to remove the key.  \n\nUsed by [bot web apps](https://core.telegram.org/api/bots/webapps) to save or remove a key from a secure storage on the user's device, associated to the currently logged in user and mini app.  \n\nOn **iOS**, it uses the system **Keychain**; on **Android**, it uses the **Keystore**. This ensures that all stored values are encrypted at rest and inaccessible to unauthorized applications.  \n\nSecure storage is suitable for storing tokens, secrets, authentication state, and other sensitive user-specific information. Each bot can store up to **10 items per user**.   \n\nEmits a [secure_storage_key_saved event &raquo;](https://core.telegram.org/api/bots/webapps#secure-storage-key-saved) on success and a [secure_storage_failed event &raquo;](https://core.telegram.org/api/bots/webapps#secure-storage-failed) on failure.","web_app_secure_storage_get_key":"Event data: a JSON object with the following keys:\n\n- `req_id` - A string with the ID of the current request\n- `key` - A string with the key to get.  \n\nUsed by [bot web apps](https://core.telegram.org/api/bots/webapps) to fetch a key from a secure storage on the user's device, associated to the currently logged in user and mini app.  \n\nEmits a [secure_storage_key_received event &raquo;](https://core.telegram.org/api/bots/webapps#secure-storage-key-received) on success and a [secure_storage_failed event &raquo;](https://core.telegram.org/api/bots/webapps#secure-storage-failed) on failure.\n\nIf the returned `can_restore` flag is true, the key will not be returned, but it can be restored by invoking [web_app_secure_storage_restore_key](https://core.telegram.org/api/web-events#web-app-secure-storage-restore-key).","web_app_secure_storage_clear":"Event data: a JSON object with the following keys:\n\n- `req_id` - A string with the ID of the current request\n\nUsed by [bot web apps](https://core.telegram.org/api/bots/webapps) to clear the secure storage on the user's device, associated to the currently logged in user and mini app.  \n\nEmits a [secure_storage_cleared event &raquo;](https://core.telegram.org/api/bots/webapps#secure-storage-cleared) on success and a [secure_storage_failed event &raquo;](https://core.telegram.org/api/bots/webapps#secure-storage-failed) on failure.","web_app_secure_storage_restore_key":"Event data: a JSON object with the following keys:\n\n- `req_id` - A string with the ID of the current request\n- `key` - A string with the key to restore.  \n\nUsed by [bot web apps](https://core.telegram.org/api/bots/webapps) to restore a key from a secure storage on the user's device, associated to the currently logged in user and mini app.  \n\nEmits a [secure_storage_key_restored event &raquo;](https://core.telegram.org/api/bots/webapps#secure-storage-key-restored) on success and a [secure_storage_failed event &raquo;](https://core.telegram.org/api/bots/webapps#secure-storage-failed) on failure.","web_app_hide_keyboard":"Event payload: `null`\n\nHides the on-screen keyboard, if it is currently visible. Does nothing if the keyboard is not active.","web_app_verify_age":"Event payload: a JSON object with the following keys:\n\n- `passed` - Boolean, indicates whether the user passed age verification\n- `age` - Optional integer, detected age if the user passed age verification\n- `gender` - Optional boolean, indicates the detected gender if the user passed age verification\n- `genderProbability` - Optional float, probability of the detected gender if the user passed age verification\n\nIndicates the result of [age verification, see here for more info on the full flow &raquo;](https://core.telegram.org/api/age-verification).","navigationBarColor":"Event data: a JSON array `[r, g, b, a]`, where `r`, `g`, `b` are integer color components in the `0-255` range and `a` is an optional opacity in the `0-1` range (defaulting to `1`).\n\nEmitted by a page open in the [in-app browser](https://core.telegram.org/api/web-events) to set the color of the client's navigation/background bar.","actionBarColor":"Event data: a JSON array `[r, g, b, a]`, where `r`, `g`, `b` are integer color components in the `0-255` range and `a` is an optional opacity in the `0-1` range (defaulting to `1`).\n\nEmitted by a page open in the [in-app browser](https://core.telegram.org/api/web-events) to set the color of the client's action bar.","allowScroll":"Event data: a JSON array `[allow_x, allow_y]` of two booleans (each defaulting to `true`).\n\nEmitted by a page open in the [in-app browser](https://core.telegram.org/api/web-events) to control whether the client's swipe-to-dismiss gesture should allow horizontal (`allow_x`) and vertical (`allow_y`) scrolling to the page.","siteName":"Event data: a string with the human-readable name of the site.\n\nEmitted by a page open in the [in-app browser](https://core.telegram.org/api/web-events) to set the site name displayed and stored in the browsing history for the current page.","oauth_request":"Event payload: a JSON object with the following keys:\n\n- `url` - Optional string, if set must contain an [oauth deep link &raquo;](https://core.telegram.org/api/links#oauth-links) to pass to the [OAuth login flow &raquo;](https://core.telegram.org/api/url-authorization#oauth-authorization-for-mini-apps).  \n\nUsed to initiate the [OAuth login flow &raquo;](https://core.telegram.org/api/url-authorization#oauth-authorization-for-mini-apps) (if `url` is set), **or** to check if the current client supports OAuth login (if `url` is **not** set).  \n\nRegardless of the contents of the event, the client should immediately reply with the [`oauth_supported` event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#oauth-supported), with `version` equal to `1`.","web_app_request_chat":"Event payload: a JSON object with the following keys:\n\n- `req_id` - String, a [bots.requestedButton](https://core.telegram.org/constructor/bots.requestedButton).`webapp_req_id` obtained by the bot from [bots.requestWebViewButton](https://core.telegram.org/method/bots.requestWebViewButton)\n\nUsed by [Mini Apps](https://core.telegram.org/api/bots/webapps) to ask the client to run a [peer request](https://core.telegram.org/api/bots/buttons#requesting-peers-via-mini-apps) prepared by the bot.\n\nClients must invoke [bots.getRequestedWebViewButton](https://core.telegram.org/method/bots.getRequestedWebViewButton), passing the Mini App bot and `req_id` as [bots.getRequestedWebViewButton](https://core.telegram.org/method/bots.getRequestedWebViewButton).`webapp_req_id`.\n\n[bots.getRequestedWebViewButton](https://core.telegram.org/method/bots.getRequestedWebViewButton) will return a [keyboardButtonRequestPeer](https://core.telegram.org/constructor/keyboardButtonRequestPeer) that clients must handle as specified in [requesting peers via Mini Apps](https://core.telegram.org/api/bots/buttons#requesting-peers-via-mini-apps).  \n\nOn success, emits a [`requested_chat_sent` event](https://core.telegram.org/api/bots/webapps#requested-chat-sent).  \nOn failure or cancellation, emits a [`requested_chat_failed` event](https://core.telegram.org/api/bots/webapps#requested-chat-failed)."}},"inverted suggestions":{"description":"[Inverted suggestion identifiers &raquo;](https://core.telegram.org/api/config#inverted-suggestions)","type":"map","entries":{"BIRTHDAY_CONTACTS_TODAY":"If not dismissed, indicates that the client should display the tooltip that recommends to gift a Telegram Premium subscription to contacts on their [birthday&nbsp;&raquo;](https://core.telegram.org/api/profile#birthday).  \n\nThis suggestion can be dismissed by invoking [help.dismissSuggestion](https://core.telegram.org/method/help.dismissSuggestion) when the user hides the tooltip, but it is also automatically dismissed by the server if the user gifts one or more Telegram Premium subscriptions to friends with birthdays falling within the next/previous 24 hours."}},"mini app events":{"description":"Outgoing mini app events documented [here &raquo;](https://core.telegram.org/api/bots/webapps#incoming-events-client-to-mini-app).","type":"map","entries":{"main_button_pressed":"Params: `null`\n\nSent by the client when the user presses the main button located at the bottom of the webview, handle this event only if the main button was [previously configured by a `web_app_setup_main_button` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-setup-main-button).","back_button_pressed":"Params: `null`\n\nSent by the client when the user presses the (OS or UI) back button, if it was [previously enabled by a `web_app_setup_back_button` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-setup-back-button).","settings_button_pressed":"Params: `null`\n\nSent by the client when the user presses the settings button, if it was [previously enabled by a `web_app_setup_settings_button` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-setup-settings-button).","invoice_closed":"Params: JSON object with the following fields:\n\n* `slug` - Invoice identifier (string)\n* `status` - One of the following values (string):\n  * `cancelled` \u2013 The user closed the invoice popup without paying, before the call to [payments.sendPaymentForm](https://core.telegram.org/method/payments.sendPaymentForm).\n  * `failed` \u2013 The user tried to pay, but the payment failed: the call to [payments.sendPaymentForm](https://core.telegram.org/method/payments.sendPaymentForm) returned an RPC error and the popup was closed.\n  * `pending` \u2013 The payment is still processing: the bot will receive a further service message about a successful payment. [payments.sendPaymentForm](https://core.telegram.org/method/payments.sendPaymentForm) was successfully invoked returning [payments.paymentVerificationNeeded](https://core.telegram.org/constructor/payments.paymentVerificationNeeded), the user completed all additional verification forms returned by the method and the invoice popup was closed, but the client hasn't received a [messageActionPaymentSent](https://core.telegram.org/constructor/messageActionPaymentSent) service message yet.  \n  Note that eventual errors will not be sent as a `failed` event if the user fails additional validation (i.e. 3-D Secure) returned by [payments.paymentVerificationNeeded](https://core.telegram.org/constructor/payments.paymentVerificationNeeded): the state will remain `pending`.  \n  * `paid` \u2013 The invoice was paid successfully: the client completed the [payment flow&nbsp;&raquo;](https://core.telegram.org/api/payments), the invoice popup was closed and a [messageActionPaymentSent](https://core.telegram.org/constructor/messageActionPaymentSent) service message was received by the client.\n\nSent by the client to report the [payment status](https://core.telegram.org/api/payments) of an invoice obtained from a [`web_app_open_invoice` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-open-invoice).","viewport_changed":"Params: a JSON object with the following fields:\n\n* `height` - The current height of the visible area of the Mini App (excluding the bottom [main button](https://core.telegram.org/api/bots/webapps#main-button-pressed), if visible) (integer)\n* `is_state_stable` - If true, the viewport is currently being resized (animation in progress), more events of this type may be emitted. (boolean)\n* `is_expanded` - Whether the Mini App is expanded to its maximum height after the user swiped up or after the Mini App emitted a [web_app_expand](https://core.telegram.org/api/web-events#web-app-expand) event (boolean)\n\nEmitted when the viewport is changed.","theme_changed":"Params: a JSON object with the following fields:\n\n* `theme_params` - A [theme parameters object&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#theme-parameters) (object)\n\nEmitted when requested by the Mini App using a [`web_app_request_theme` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-request-theme), or when the app theme changes.  \n\n\n##### Theme parameters\n\nBot Mini Apps can be themed according to the following theme parameters, passed as a JSON object to the `theme_params` parameter of the [messages.requestSimpleWebView](https://core.telegram.org/method/messages.requestSimpleWebView), [messages.requestWebView](https://core.telegram.org/method/messages.requestWebView) and [messages.requestAppWebView](https://core.telegram.org/method/messages.requestAppWebView) methods.  \n\nThis JSON object has the following keys, containing color theme information (hex string, RGB, no alpha) to pass to the Mini App.  \n\nSee [here &raquo;](https://core.telegram.org/bots/webapps#themeparams) for more info on the contents of the object.","popup_closed":"Params: a JSON object with an optional `button_id` string field.\n\nEmitted when the user presses a button or cancels a popup brought up by a previous [`web_app_open_popup` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-open-popup).","write_access_requested":"Params: a JSON object with the following fields:\n\n* `status` - `allowed` or `cancelled`\n\nUsed by clients to reply to a [`web_app_request_write_access` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-request-write-access), indicating whether the user has allowed the bot to send messages to the user (`allowed`) or not (`cancelled`).","phone_requested":"Params: a JSON object with the following fields:\n\n* `status` - `sent` or `cancelled`\n\nUsed by clients to reply to a [`web_app_request_phone` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-request-phone), indicating whether the user has shared their phone number with the bot (`allowed`) or not (`cancelled`).","biometry_info_received":"Params: a JSON object with the following fields:\n\n* `available` - boolean, if true, indicates that biometric authentication is available on the current device.\n* `type` - optional string, set if `available` is true, contains the type of biometric authentication, one of:\n  * `finger` - fingerprint-based biometrics\n  * `face` - face-based biometrics\n  * `unknown` - biometrics of an unknown type\n* `access_requested` - boolean, indicates whether the app has previously requested permission to use biometrics through a [`web_app_biometry_request_access` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-request-access)\n* `access_granted` - boolean, indicates whether the user has granted the app permission to use biometrics in response to a [`web_app_biometry_request_access` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-request-access).  \n  If false and `access_requested` is true, the user has denied the app permission to use biometrics, in which case the app should open a prompt notifying the user that the biometric settings must be changed to use biometrics, and if the user clicks on the in-app confirm button, a [web_app_biometry_open_settings event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-open-settings) must be emitted.\n* `token_saved` - boolean, whether a token was safely stored on-device by a previous [web_app_biometry_update_token event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-update-token).  \n* `device_id` - string, a unique device identifier that can be used to match the token to the device.\n\nUsed by clients to reply to a [`web_app_biometry_get_info` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-get-info) or a [`web_app_biometry_request_access` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-request-access).","biometry_token_updated":"Params: a JSON object with the following fields:\n\n* `status` - string, one of:\n  * `updated` - If the token was successfully updated.\n  * `removed` - If the token was successfully removed.\n  * `failed` - If biometric authentication failed, or the app doesn't have permission to use biometrics (a [biometry_info_received event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#biometry-info-received) event will also be emitted if the app hasn't previously initialized the state using [`web_app_biometry_get_info` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-get-info) or a [`web_app_biometry_request_access` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-request-access)).  \n\nUsed by clients to reply to a [`web_app_biometry_update_token` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-update-token).","biometry_auth_requested":"Params: a JSON object with the following fields:\n\n* `status` - string, either `authorized` or `failed`.  \n  If `failed`, a [biometry_info_received event&nbsp;&raquo;](https://core.telegram.org/api/bots/webapps#biometry-info-received) event will also be emitted if the app hasn't previously initialized the state using [`web_app_biometry_get_info` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-get-info) or a [`web_app_biometry_request_access` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-request-access).  \n* `token` - optional string, set if `status` is `authorized`, contains the token previously set using the [`web_app_biometry_update_token` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-update-token).  \n\nUsed by clients to reply to a [`web_app_biometry_request_auth` biometric authentication request&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-biometry-request-auth).","custom_method_invoked":"Params: a JSON object with the following fields:\n\n* `req_id` - The `req_id` from the `web_app_invoke_custom_method` request\n* `result` - The JSON data contained in the response of the [bots.invokeWebViewCustomMethod](https://core.telegram.org/method/bots.invokeWebViewCustomMethod) method, if the method call succeeded\n* `error` - The text of the RPC error, if the method call failed\n\nUsed by clients to reply to [`web_app_invoke_custom_method` events&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-invoke-custom-method).","clipboard_text_received":"Params: a JSON object with the following fields:\n\n* `req_id` - The `req_id` from the `web_app_read_text_from_clipboard` request\n* `data` - A string with the clipboard contents (optional, if not provided consider the request failed)\n\nUsed by clients to reply to [`web_app_read_text_from_clipboard` events&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-read-text-from-clipboard).","qr_text_received":"Params: a JSON object with the following fields:\n\n* `data` - string with the contents of a scanned QR code.\n\nEmitted by clients if a new QR code was scanned by the native QR code scanner opened with a [`web_app_open_scan_qr_popup` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-open-scan-qr-popup).","scan_qr_popup_closed":"Params: `null` or an empty object\n\nEmitted by clients if the QR code scanner popup opened with a [`web_app_open_scan_qr_popup` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-open-scan-qr-popup) was closed by the user or failed to open altogether due to permission issues.","visibility_changed":"Params: a JSON object with a single `is_visible=true|false` boolean field.\n\nEmitted the Mini App becomes active (`true`) or inactive (`false`), e.g., opened/closed from minimized state or selected/deselected among tabs).","secondary_button_pressed":"Params: `null`\n\nSent by the client when the user presses the secondary button located at the bottom of the webview, handle this event only if the secondary button was [previously configured by a `web_app_setup_secondary_button` event&nbsp;&raquo;](https://core.telegram.org/api/web-events#web-app-setup-secondary-button).","fullscreen_changed":"Params: a JSON object with the following fields:\n\n* `is_fullscreen` - boolean indicating whether the mini app is currently in fullscreen mode.\n* `blur_enabled` - Optional boolean, present when `is_fullscreen=true`, indicating whether background content is blurred in fullscreen mode.\n\nSent by the client when replying to [web_app_request_fullscreen](https://core.telegram.org/api/web-events#web-app-request-fullscreen) and [web_app_exit_fullscreen](https://core.telegram.org/api/web-events#web-app-exit-fullscreen) events.","fullscreen_failed":"Params: a JSON object with the following fields:\n\n* `error` - string indicating the error, one of:\n  * `UNSUPPORTED` - Fullscreen mode is not supported on this device or platform\n  * `ALREADY_FULLSCREEN` - The Mini App is already in fullscreen mode\n\nSent by the client if a failure occurs while handling [web_app_request_fullscreen](https://core.telegram.org/api/web-events#web-app-request-fullscreen) and [web_app_exit_fullscreen](https://core.telegram.org/api/web-events#web-app-exit-fullscreen) events.","accelerometer_started":"Params: `null`\n\nSent by the client in response to a [web_app_start_accelerometer event &raquo;](https://core.telegram.org/api/web-events#web-app-start-accelerometer) if accelerometer tracking is started successfully.\n\nUntil [web_app_stop_accelerometer](https://core.telegram.org/api/web-events#web-app-stop-accelerometer) is emitted by the mini app, the client will also emit [accelerometer_changed events](https://core.telegram.org/api/bots/webapps#accelerometer-changed) at most every `refresh_rate` milliseconds with accelerometer readings.","accelerometer_failed":"Params: JSON object with the following fields:\n\n* `error` - String, one of:\n  * `UNSUPPORTED` - Accelerometer tracking is not supported on this device or platform.\n\nSent by the client in response to a [web_app_start_accelerometer event &raquo;](https://core.telegram.org/api/web-events#web-app-start-accelerometer) if accelerometer tracking cannot be started.","accelerometer_stopped":"Params: `null`\n\nSent by the client in response to a [web_app_stop_accelerometer event &raquo;](https://core.telegram.org/api/web-events#web-app-stop-accelerometer) if accelerometer tracking is stopped successfully.","accelerometer_changed":"Params: JSON object with `x`, `y` and `z` fields of type `float`, containing the current acceleration in the X, Y and Z-axis, measured in m/s\u00b2.  \n\nSent periodically by the client at most every `refresh_rate` milliseconds after [web_app_start_accelerometer &raquo;](https://core.telegram.org/api/web-events#web-app-start-accelerometer) is invoked and until [web_app_stop_accelerometer](https://core.telegram.org/api/web-events#web-app-stop-accelerometer) is invoked.","gyroscope_started":"Params: `null`\n\nSent by the client in response to a [web_app_start_gyroscope event &raquo;](https://core.telegram.org/api/web-events#web-app-start-gyroscope) if gyroscope tracking is started successfully.\n\nUntil [web_app_stop_gyroscope](https://core.telegram.org/api/web-events#web-app-stop-gyroscope) is emitted by the mini app, the client will also emit [gyroscope_changed events](https://core.telegram.org/api/bots/webapps#gyroscope-changed) at most every `refresh_rate` milliseconds with gyroscope readings.","gyroscope_failed":"Params: JSON object with the following fields:\n\n* `error` - String, one of:\n  * `UNSUPPORTED` - Gyroscope tracking is not supported on this device or platform.\n\nSent by the client in response to a [web_app_start_gyroscope event &raquo;](https://core.telegram.org/api/web-events#web-app-start-gyroscope) if gyroscope tracking cannot be started.","gyroscope_stopped":"Params: `null`\n\nSent by the client in response to a [web_app_stop_gyroscope event &raquo;](https://core.telegram.org/api/web-events#web-app-stop-gyroscope) if gyroscope tracking is stopped successfully.","gyroscope_changed":"Params: JSON object with `x`, `y` and `z` fields of type `float`, containing the current rotation rate around the X, Y and Z-axis, measured in rad/s.  \n\nSent periodically by the client at most every `refresh_rate` milliseconds after [web_app_start_gyroscope &raquo;](https://core.telegram.org/api/web-events#web-app-start-gyroscope) is invoked and until [web_app_stop_gyroscope](https://core.telegram.org/api/web-events#web-app-stop-gyroscope) is invoked.","device_orientation_started":"Params: `null`\n\nSent by the client in response to a [web_app_start_device_orientation event &raquo;](https://core.telegram.org/api/web-events#web-app-start-device-orientation) if device orientation tracking is started successfully.\n\nUntil [web_app_stop_device_orientation](https://core.telegram.org/api/web-events#web-app-stop-device-orientation) is emitted by the mini app, the client will also emit [device_orientation events](https://core.telegram.org/api/bots/webapps#device-orientation-changed) at most every `refresh_rate` milliseconds with device orientation readings.","device_orientation_failed":"Params: JSON object with the following fields:\n\n* `error` - String, one of:\n  * `UNSUPPORTED` - Device orientation tracking is not supported on this device or platform.\n\nSent by the client in response to a [web_app_start_device_orientation event &raquo;](https://core.telegram.org/api/web-events#web-app-start-device-orientation) if device orientation tracking cannot be started.","device_orientation_stopped":"Params: `null`\n\nSent by the client in response to a [web_app_stop_device_orientation event &raquo;](https://core.telegram.org/api/web-events#web-app-stop-device-orientation) if device orientation tracking is stopped successfully.","device_orientation_changed":"Params: JSON object with the following fields:\n\n- `alpha` - The rotation around the Z-axis, measured in radians.\n- `beta` - The rotation around the X-axis, measured in radians.\n- `gamma` - The rotation around the Y-axis, measured in radians.\n- `absolute` - A boolean that indicates whether or not the device is providing orientation data in absolute values (may be false even if absolute data was requested if and only if the device/platform doesn't support absolute orientation tracking).  \n\nSent periodically by the client at most every `refresh_rate` milliseconds after [web_app_start_device_orientation &raquo;](https://core.telegram.org/api/web-events#web-app-start-device-orientation) is invoked and until [web_app_stop_device_orientation](https://core.telegram.org/api/web-events#web-app-stop-device-orientation) is invoked.","home_screen_added":"Params: `null`\n\nSent by the client in response to a [web_app_add_to_home_screen event &raquo;](https://core.telegram.org/api/web-events#web-app-add-to-home-screen) if the shortcut was (already) added successfully.  \n\nIt is acceptable to not emit this event if the current platform doesn't have a way to determine the installation status of the shortcut.","home_screen_failed":"Params: JSON object with the following fields:\n\n* `error` - String, one of:\n  * `UNSUPPORTED` - Shortcuts are not supported on this platform, or installation of the shortcut failed, or status cannot be reported.\n\nSent by the client in response to a [web_app_add_to_home_screen event &raquo;](https://core.telegram.org/api/web-events#web-app-add-to-home-screen) if the shortcut could not be added.  \n\nIt is acceptable to not emit this event if the current platform doesn't have a way to determine the installation status of the shortcut.","home_screen_checked":"Params: JSON object with the following fields:\n\n* `status` - String, one of:  \n  * `unsupported` \u2013 the feature is not supported, and it is not possible to add the icon to the home screen,\n  * `unknown` \u2013 the feature is supported, and the icon can be added, but it is not possible to determine if the icon has already been added,\n  * `added` \u2013 the icon has already been added to the home screen,\n  * `missed` \u2013 the icon has not been added to the home screen.\n\n**Always** sent by the client in response to a [web_app_check_home_screen event &raquo;](https://core.telegram.org/api/web-events#web-app-check-home-screen).","emoji_status_failed":"Params: JSON object with the following fields:\n\n* `error` - String, one of:\n  * `UNSUPPORTED` \u2013 The feature is not supported by the client.\n  * `SUGGESTED_EMOJI_INVALID` \u2013 One or more emoji identifiers are invalid.\n  * `DURATION_INVALID` \u2013 The specified duration is invalid.\n  * `USER_DECLINED` \u2013 The user closed the dialog without setting a status.\n  * `SERVER_ERROR` \u2013 A server error occurred when attempting to set the status.\n  * `UNKNOWN_ERROR` \u2013 An unknown error occurred.\n\nSent by the client in response to a [web_app_set_emoji_status event &raquo;](https://core.telegram.org/api/web-events#web-app-set-emoji-status) if the emoji status could not be set.","emoji_status_set":"Params: `null`\n\nSent by the client in response to a [web_app_set_emoji_status event &raquo;](https://core.telegram.org/api/web-events#web-app-set-emoji-status) if the emoji status was set successfully.","emoji_status_access_requested":"Params: JSON object with the following fields:\n\n* `status` - String, one of:\n  * `allowed` \u2013 The user (already) granted the bot permission to edit their emoji status\n  * `cancelled` \u2013 The user declined the request, or an error occurred. \n\nSent by the client in response to a [web_app_request_emoji_status_access event &raquo;](https://core.telegram.org/api/web-events#web-app-request-emoji-status-access).","file_download_requested":"Params: a JSON object with the following fields:\n\n* `status` - Either `cancelled` (the download was aborted by the user or was not allowed by the API) or `downloading` (the download has successfully started).  \n\nEmitted by clients during the [mini app](https://core.telegram.org/api/bots/webapps) file download flow, initiated by the [web_app_request_file_download &raquo;](https://core.telegram.org/api/web-events#web-app-request-file-download) event.","prepared_message_failed":"Params: a JSON object with the following fields:\n\n* `error` - Contains the text of the RPC error returned by [messages.getPreparedInlineMessage](https://core.telegram.org/method/messages.getPreparedInlineMessage), or `USER_DECLINED` if the user aborted the sharing process, or `MESSAGE_SEND_FAILED` if sending fails for another reason.\n\nEmitted by clients in case of errors during the [share prepared messages flow](https://core.telegram.org/api/bots/inline#21-using-a-prepared-inline-message), initiated by the [web_app_send_prepared_message &raquo;](https://core.telegram.org/api/web-events#web-app-send-prepared-message) event.","prepared_message_sent":"Params: `null`\n\nEmitted by clients when the [share prepared messages flow](https://core.telegram.org/api/bots/inline#21-using-a-prepared-inline-message) initiated by the [web_app_send_prepared_message &raquo;](https://core.telegram.org/api/web-events#web-app-send-prepared-message) event completes successfully.","safe_area_changed":"Params: a JSON object with the following fields:\n\n* `top` - The top inset in pixels, representing the space to avoid at the top of the screen (integer).\n* `bottom` - The bottom inset in pixels, representing the space to avoid at the bottom of the screen (integer).\n* `left` - The left inset in pixels, representing the space to avoid on the left side of the screen (integer).\n* `right` - The right inset in pixels, representing the space to avoid on the left side of the screen (integer).\n\nEmitted by clients when any of the system-defined safe area inset padding values change, or when explicitly requested by the mini app using [web_app_request_safe_area](https://core.telegram.org/api/web-events#web-app-request-safe-area).  \n\nSee [here &raquo;](https://core.telegram.org/bots/webapps#safeareainset) for more info.","content_safe_area_changed":"Params: a JSON object with the following fields:\n\n* `top` - The top inset in pixels, representing the space to avoid at the top of the content area (integer).\n* `bottom` - The bottom inset in pixels, representing the space to avoid at the bottom of the content area (integer).\n* `left` - The left inset in pixels, representing the space to avoid on the left side of the content area (integer).\n* `right` - The right inset in pixels, representing the space to avoid on the left side of the content area (integer).\n\nEmitted by clients when any of the content-defined safe area inset padding values change, or when explicitly requested by the mini app using [web_app_request_content_safe_area](https://core.telegram.org/api/web-events#web-app-request-content-safe-area).  \n\nSee [here &raquo;](https://core.telegram.org/bots/webapps#contentsafeareainset) for more info.","location_requested":"Params: a JSON object with the following fields:\n\n* `available` - Boolean, indicates whether location data is available or not; if false, the following fields must not be set.  \n* `latitude` - Float, contains latitude in degrees.\n* `longitude` - Float, contains longitude in degrees.\n* `altitude` - Float or null, contains the altitude above the sea level in meters, must be null if not supported by the device or platform.\n* `course` - Float or null, contains the direction the device is moving in degrees, must be null if not supported by the device or platform.\n* `speed` - Float or null, contains the speed of the device in m/s, must be null if not supported by the device or platform.\n* `horizontal_accuracy` - Float or null, contains the accuracy of the latitude and longitude values in meters, must be null if not supported by the device or platform.\n* `vertical_accuracy` - Float or null, contains the accuracy of the altitude value in meters, must be null if not supported by the device or platform.\n* `course_accuracy` - Float or null, contains the accuracy of the course value in degrees, must be null if not supported by the device or platform.\n* `speed_accuracy` - Float or null, contains the accuracy of the speed value in m/s, must be null if not supported by the device or platform.\n\nEmitted in response to a [web_app_request_location event](https://core.telegram.org/api/web-events#web-app-request-location).","location_checked":"Params: a JSON object with the following fields:\n\n* `available` - Boolean, indicates whether location data is available on the current platform or device.\n* `access_requested` - Optional boolean, must be set if `available` is true, indicates whether the mini app has already requested access to location data.\n* `access_granted` - Optional boolean, if set and `true` indicates that the user granted the mini app access to location data.\n\nEmitted in response to a [web_app_check_location event](https://core.telegram.org/api/web-events#web-app-check-location).","device_storage_key_saved":"Params: a JSON object with the following fields:\n\n* `req_id` - String, `req_id` from the requesting [web_app_device_storage_save_key event](https://core.telegram.org/api/web-events#web-app-device-storage-save-key)\n\nIndicates the key was saved or removed successfully.  \n\nEmitted in response to a [web_app_device_storage_save_key event](https://core.telegram.org/api/web-events#web-app-device-storage-save-key).","device_storage_key_received":"Params: a JSON object with the following fields:\n\n* `req_id` - String, `req_id` from the requesting [web_app_device_storage_get_key event](https://core.telegram.org/api/web-events#web-app-device-storage-get-key)\n* `value` - String or null, the requested value or no value if the specified key is not set.  \n\nReturns the requested key.  \n\nEmitted in response to a [web_app_device_storage_get_key event](https://core.telegram.org/api/web-events#web-app-device-storage-get-key).","device_storage_cleared":"Params: a JSON object with the following fields:\n\n* `req_id` - String, `req_id` from the requesting [web_app_device_storage_clear event](https://core.telegram.org/api/web-events#web-app-device-storage-clear)\n\nIndicates the storage was cleared.  \n\nEmitted in response to a [web_app_device_storage_clear event](https://core.telegram.org/api/web-events#web-app-device-storage-clear).","device_storage_failed":"Params: a JSON object with the following fields:\n\n* `req_id` - String, `req_id` from the requesting event\n* `error` - String, the error that prevented the request from succeeding.  \n\nEmitted in response to a [web_app_device_storage_save_key](https://core.telegram.org/api/web-events#web-app-device-storage-save-key), [web_app_device_storage_get_key](https://core.telegram.org/api/web-events#web-app-device-storage-get-key) or [web_app_device_storage_clear](https://core.telegram.org/api/web-events#web-app-device-storage-clear) event.","secure_storage_key_saved":"Params: a JSON object with the following fields:\n\n* `req_id` - String, `req_id` from the requesting [web_app_secure_storage_save_key event](https://core.telegram.org/api/web-events#web-app-secure-storage-save-key)\n\nIndicates the key was saved or removed successfully.  \n\nEmitted in response to a [web_app_secure_storage_save_key event](https://core.telegram.org/api/web-events#web-app-secure-storage-save-key).","secure_storage_key_received":"Params: a JSON object with the following fields:\n\n* `req_id` - String, `req_id` from the requesting [web_app_secure_storage_get_key event](https://core.telegram.org/api/web-events#web-app-secure-storage-get-key)\n* `value` - String or null, the requested value or no value if the specified key is not set.  \n* `can_restore` - Boolean, true if `value` is null but the value can be restored using a [web_app_secure_storage_restore_key event](https://core.telegram.org/api/web-events#web-app-secure-storage-restore-key)\n\nReturns the requested key.  \n\nEmitted in response to a [web_app_secure_storage_get_key event](https://core.telegram.org/api/web-events#web-app-secure-storage-get-key).","secure_storage_key_restored":"Params: a JSON object with the following fields:\n\n* `req_id` - String, `req_id` from the requesting [web_app_secure_storage_restore_key event](https://core.telegram.org/api/web-events#web-app-secure-storage-restore-key)\n* `value` - String, the restored value\n\nRestores the requested key.  \n\nEmitted in response to a [web_app_secure_storage_restore_key event](https://core.telegram.org/api/web-events#web-app-secure-storage-restore-key).","secure_storage_cleared":"Params: a JSON object with the following fields:\n\n* `req_id` - String, `req_id` from the requesting [web_app_secure_storage_clear event](https://core.telegram.org/api/web-events#web-app-secure-storage-clear)\n\nIndicates the storage was cleared.  \n\nEmitted in response to a [web_app_secure_storage_clear event](https://core.telegram.org/api/web-events#web-app-secure-storage-clear).","secure_storage_failed":"Params: a JSON object with the following fields:\n\n* `req_id` - String, `req_id` from the requesting event\n* `error` - String, the error that prevented the request from succeeding; most notably, `UNSUPPORTED` for platforms that do not support secure storage.  \n\nEmitted in response to a [web_app_secure_storage_save_key](https://core.telegram.org/api/web-events#web-app-secure-storage-save-key), [web_app_secure_storage_get_key](https://core.telegram.org/api/web-events#web-app-secure-storage-get-key), [web_app_secure_storage_restore_key](https://core.telegram.org/api/web-events#web-app-secure-storage-restore-key) or [web_app_secure_storage_clear](https://core.telegram.org/api/web-events#web-app-secure-storage-clear) event.","oauth_supported":"Params: a JSON object with the following fields:\n\n* `version` - Integer, currently must be equal to `1`\n\nIndicates that the current client supports [OAuth login &raquo;](https://core.telegram.org/api/url-authorization#oauth-authorization-for-mini-apps).  \n\nUnconditionally emitted in response to all [oauth_request events &raquo;](https://core.telegram.org/api/web-events#oauth-request).","oauth_result_confirmed":"Params: a JSON object with the following fields:\n\n* `result_url` - String or null, contains the final redirection URL\n\nEmitted in response to a non-empty and valid [oauth_request event &raquo;](https://core.telegram.org/api/web-events#oauth-request) if the [OAuth login flow &raquo;](https://core.telegram.org/api/url-authorization#oauth-authorization-for-mini-apps) succeeded.","oauth_result_failed":"Params: Null or an empty JSON object.  \n\nEmitted in response to a non-empty and valid [oauth_request event &raquo;](https://core.telegram.org/api/web-events#oauth-request) if the [OAuth login flow &raquo;](https://core.telegram.org/api/url-authorization#oauth-authorization-for-mini-apps) failed or if it was explicitly cancelled by the user.","requested_chat_sent":"Params: a JSON object with the following fields:\n\n* `req_id` - String, `req_id` from the requesting [web_app_request_chat event](https://core.telegram.org/api/web-events#web-app-request-chat)\n\nIndicates that the requested peers were sent to the bot using [messages.sendBotRequestedPeer](https://core.telegram.org/method/messages.sendBotRequestedPeer).\n\nEmitted in response to a [web_app_request_chat event](https://core.telegram.org/api/web-events#web-app-request-chat), see [here &raquo;](https://core.telegram.org/api/bots/buttons#requesting-peers-via-mini-apps) for the full flow.","requested_chat_failed":"Params: a JSON object with the following fields:\n\n* `req_id` - String, `req_id` from the requesting [web_app_request_chat event](https://core.telegram.org/api/web-events#web-app-request-chat)\n* `error` - Optional string, the error that prevented the request from succeeding.\n\nIndicates that the [peer request](https://core.telegram.org/api/bots/buttons#requesting-peers-via-mini-apps) was cancelled or has failed.\n\nEmitted in response to a [web_app_request_chat event](https://core.telegram.org/api/web-events#web-app-request-chat), see [here &raquo;](https://core.telegram.org/api/bots/buttons#requesting-peers-via-mini-apps) for the full flow."}},"post story content types":{"description":"Story content types accepted by [post story deep links &raquo;](https://core.telegram.org/api/links#post-story-links).","type":"map","entries":{"photo":"Compose a photo story.","video":"Compose a video story.","live":"Compose a live story."}},"premium features":{"description":"[Telegram Premium feature identifiers &raquo;](https://core.telegram.org/api/premium#telegram-premium-features).","type":"map","entries":{"stories":"[Telegram Premium](https://core.telegram.org/api/premium) adds some [story-related](https://core.telegram.org/api/stories) features.\n\nStory-related Premium features also have certain sub-identifiers, which are used if the user chooses to [subscribe to Telegram Premium](https://core.telegram.org/api/premium#subscribing-to-telegram-premium) after hitting one of the following story-related limitations.  \n\nIf the user instead signs up simply after reading the promo page for story-related features, pass just `stories` as feature identifier.  \n\nHere's the full list of story-related features and their sub-identifiers (contained in the title header):\n\n<!-- start premium story features 6 -->\n\n###### `stories__priority_order`\n\nStories posted by Premium users are shown first to users when fetching the list of active stories with [stories.getAllStories&nbsp;&raquo;](https://core.telegram.org/method/stories.getAllStories).\n\n###### `stories__stealth_mode`\n\nPremium users can activate [stealth mode&nbsp;&raquo;](https://core.telegram.org/api/stories#stealth-mode).\n\n###### `stories__permanent_views_history`\n\nPremium users can [fetch the full viewer list of stories, even after they expire&nbsp;&raquo;](https://core.telegram.org/api/stories#fetching-the-interaction-list)\n\n###### `stories__expiration_durations`\n\nPremium users can set [custom expiration options when posting stories&nbsp;&raquo;](https://core.telegram.org/api/stories)\n\n###### `stories__save_stories_to_gallery`\n\nPremium users can save other users' unprotected stories.\n\n###### `stories__links_and_formatting`\n\nPremium users can use [styled text entities](https://core.telegram.org/api/entities) and links in story captions and [URL media areas](https://core.telegram.org/api/stories#urls), as specified by the [stories_entities&nbsp;&raquo;](https://core.telegram.org/api/config#stories-entities) config key.\n\n###### `stories__quality`\n\nPremium users can view stories in a higher quality.\n\n<!-- end premium story features -->\n\nThere are a few more Premium story features that are listed in the [limits &raquo;](https://core.telegram.org/api/premium#double-limits) section.  \n\nSee the [stories documentation&nbsp;&raquo;](https://core.telegram.org/api/stories) for more information on stories.","double_limits":"Clicking on this entry should open a secondary popup with a list of the improved Premium limits, as follows.\n\nLimit-related Premium features also have certain sub-identifiers, which are used if the user chooses to [subscribe to Telegram Premium](https://core.telegram.org/api/premium#subscribing-to-telegram-premium) after hitting one of the following limitations.  \n\nIf the user instead signs up simply after reading the promo page for limits, pass just `double_limits` as feature identifier.  \n\nHere's the full list of improved limits and their sub-identifiers (contained in the title header):\n\n<!-- start premium limits 6 -->\n\n###### `double_limits__channels`\n\nConfig keys: [channels_limit_premium &raquo;](https://core.telegram.org/api/config#channels-limit-premium)/[channels_limit_default &raquo;](https://core.telegram.org/api/config#channels-limit-default)\n\nThe maximum number of [channels and supergroups](https://core.telegram.org/api/channel) a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may join (integer)\n\n###### `double_limits__saved_gifs`\n\nConfig keys: [saved_gifs_limit_premium &raquo;](https://core.telegram.org/api/config#saved-gifs-limit-premium)/[saved_gifs_limit_default &raquo;](https://core.telegram.org/api/config#saved-gifs-limit-default)\n\nThe maximum number of GIFs a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may save (integer)\n\n###### `double_limits__stickers_faved`\n\nConfig keys: [stickers_faved_limit_premium &raquo;](https://core.telegram.org/api/config#stickers-faved-limit-premium)/[stickers_faved_limit_default &raquo;](https://core.telegram.org/api/config#stickers-faved-limit-default)\n\nThe maximum number of stickers a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may [add to Favorites&nbsp;&raquo;](https://core.telegram.org/api/stickers#favorite-stickersets) (integer)\n\n###### `double_limits__dialog_filters`\n\nConfig keys: [dialog_filters_limit_premium &raquo;](https://core.telegram.org/api/config#dialog-filters-limit-premium)/[dialog_filters_limit_default &raquo;](https://core.telegram.org/api/config#dialog-filters-limit-default)\n\nThe maximum number of [folders](https://core.telegram.org/api/folders) a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may create (integer)\n\n###### `double_limits__dialog_filters_chats`\n\nConfig keys: [dialog_filters_chats_limit_premium &raquo;](https://core.telegram.org/api/config#dialog-filters-chats-limit-premium)/[dialog_filters_chats_limit_default &raquo;](https://core.telegram.org/api/config#dialog-filters-chats-limit-default)\n\nThe maximum number of chats a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may add to a [folder](https://core.telegram.org/api/folders) (integer)\n\n###### `double_limits__dialogs_pinned`\n\nConfig keys: [dialogs_pinned_limit_premium &raquo;](https://core.telegram.org/api/config#dialogs-pinned-limit-premium)/[dialogs_pinned_limit_default &raquo;](https://core.telegram.org/api/config#dialogs-pinned-limit-default)\n\nThe maximum number of chats a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may pin (integer)\n\n###### `double_limits__dialogs_folder_pinned`\n\nConfig keys: [dialogs_folder_pinned_limit_premium &raquo;](https://core.telegram.org/api/config#dialogs-folder-pinned-limit-premium)/[dialogs_folder_pinned_limit_default &raquo;](https://core.telegram.org/api/config#dialogs-folder-pinned-limit-default)\n\nThe maximum number of chats a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may pin in a folder (integer)\n\n###### `double_limits__channels_public`\n\nConfig keys: [channels_public_limit_premium &raquo;](https://core.telegram.org/api/config#channels-public-limit-premium)/[channels_public_limit_default &raquo;](https://core.telegram.org/api/config#channels-public-limit-default)\n\nThe maximum number of public [channels or supergroups](https://core.telegram.org/api/channel) a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may create (integer)\n\n###### `double_limits__caption_length`\n\nConfig keys: [caption_length_limit_premium &raquo;](https://core.telegram.org/api/config#caption-length-limit-premium)/[caption_length_limit_default &raquo;](https://core.telegram.org/api/config#caption-length-limit-default)\n\nThe maximum UTF-8 length of media captions sendable by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users (integer)\n\n###### `double_limits__about_length`\n\nConfig keys: [about_length_limit_premium &raquo;](https://core.telegram.org/api/config#about-length-limit-premium)/[about_length_limit_default &raquo;](https://core.telegram.org/api/config#about-length-limit-default)\n\nThe maximum UTF-8 length of bios of [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users (integer)\n\n###### `double_limits__chatlist_invites`\n\nConfig keys: [chatlist_invites_limit_premium &raquo;](https://core.telegram.org/api/config#chatlist-invites-limit-premium)/[chatlist_invites_limit_default &raquo;](https://core.telegram.org/api/config#chatlist-invites-limit-default)\n\nMaximum number of per-folder [chat folder deep links \u00bb](https://core.telegram.org/api/links#chat-folder-links) that can be created by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)\n\n###### `double_limits__chatlists_joined`\n\nConfig keys: [chatlists_joined_limit_premium &raquo;](https://core.telegram.org/api/config#chatlists-joined-limit-premium)/[chatlists_joined_limit_default &raquo;](https://core.telegram.org/api/config#chatlists-joined-limit-default)\n\nMaximum number of [shareable folders](https://core.telegram.org/api/links#chat-folder-links) [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users may have. (integer)\n\n###### `double_limits__story_expiring`\n\nConfig keys: [story_expiring_limit_premium &raquo;](https://core.telegram.org/api/config#story-expiring-limit-premium)/[story_expiring_limit_default &raquo;](https://core.telegram.org/api/config#story-expiring-limit-default)\n\nThe maximum number of active [stories](https://core.telegram.org/api/stories) for [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users (integer).\n\n###### `double_limits__story_caption_length`\n\nConfig keys: [story_caption_length_limit_premium &raquo;](https://core.telegram.org/api/config#story-caption-length-limit-premium)/[story_caption_length_limit_default &raquo;](https://core.telegram.org/api/config#story-caption-length-limit-default)\n\nThe maximum UTF-8 length of story captions for [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)\n\n###### `double_limits__stories_sent_weekly`\n\nConfig keys: [stories_sent_weekly_limit_premium &raquo;](https://core.telegram.org/api/config#stories-sent-weekly-limit-premium)/[stories_sent_weekly_limit_default &raquo;](https://core.telegram.org/api/config#stories-sent-weekly-limit-default)\n\nMaximum number of stories that can be sent in a week by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)\n\n###### `double_limits__stories_sent_monthly`\n\nConfig keys: [stories_sent_monthly_limit_premium &raquo;](https://core.telegram.org/api/config#stories-sent-monthly-limit-premium)/[stories_sent_monthly_limit_default &raquo;](https://core.telegram.org/api/config#stories-sent-monthly-limit-default)\n\nMaximum number of stories that can be sent in a month by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)\n\n###### `double_limits__stories_suggested_reactions`\n\nConfig keys: [stories_suggested_reactions_limit_premium &raquo;](https://core.telegram.org/api/config#stories-suggested-reactions-limit-premium)/[stories_suggested_reactions_limit_default &raquo;](https://core.telegram.org/api/config#stories-suggested-reactions-limit-default)\n\nMaximum number of [story reaction media areas&nbsp;&raquo;](https://core.telegram.org/api/stories#media-areas) that can be added to a story by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)\n\n###### `double_limits__recommended_channels`\n\nConfig keys: [recommended_channels_limit_premium &raquo;](https://core.telegram.org/api/config#recommended-channels-limit-premium)/[recommended_channels_limit_default &raquo;](https://core.telegram.org/api/config#recommended-channels-limit-default)\n\nThe maximum number of similar channels that can be recommended by [channels.getChannelRecommendations&raquo;](https://core.telegram.org/method/channels.getChannelRecommendations) to [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)\n\n###### `double_limits__saved_dialogs_pinned`\n\nConfig keys: [saved_dialogs_pinned_limit_premium &raquo;](https://core.telegram.org/api/config#saved-dialogs-pinned-limit-premium)/[saved_dialogs_pinned_limit_default &raquo;](https://core.telegram.org/api/config#saved-dialogs-pinned-limit-default)\n\nMaximum number of pinned dialogs in [saved messages](https://core.telegram.org/api/saved-messages) for [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users.  (integer)\n\n###### `double_limits__bots_create`\n\nConfig keys: [bots_create_limit_default &raquo;](https://core.telegram.org/api/config#bots-create-limit-premium)/[bots_create_limit_premium &raquo;](https://core.telegram.org/api/config#bots-create-limit-default)\n\nMaximum number of [bots](https://core.telegram.org/api/bots) that can be owned by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users.  (integer)\n\n###### `double_limits__aicompose_tone_saved`\n\nConfig keys: [aicompose_tone_saved_limit_premium &raquo;](https://core.telegram.org/api/config#aicompose-tone-saved-limit-premium)/[aicompose_tone_saved_limit_default &raquo;](https://core.telegram.org/api/config#aicompose-tone-saved-limit-default)\n\nMaximum number of [custom AI composer tones &raquo;](https://core.telegram.org/api/ai#ai-compose-tones) that can be installed by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users.  (integer)\n\n<!-- end premium limits -->","business":"Premium users currently have access to subscription-gated [Telegram Business features&nbsp;&raquo;](https://core.telegram.org/api/business); [connected business bots&nbsp;&raquo;](https://core.telegram.org/api/bots/connected-business-bots) are also available to non-Premium users.","last_seen":"Premium users can view the last seen and message read times of other users even if they can't view the last seen or read time for the current user.","message_privacy":"Premium users can disallow incoming voice and video note messages in private chats using [inputPrivacyKeyVoiceMessages](https://core.telegram.org/constructor/inputPrivacyKeyVoiceMessages) and [restrict incoming messages from non-contacts](https://core.telegram.org/api/privacy#require-premium-for-new-non-contact-users).","more_upload":"Premium users can upload bigger files, as specified by the [upload_max_fileparts_default](https://core.telegram.org/api/config#upload-max-fileparts-default) vs [upload_max_fileparts_premium](https://core.telegram.org/api/config#upload-max-fileparts-premium) config keys.","faster_download":"Premium users have no download speed limits (i.e. they can't receive `FLOOD_PREMIUM_WAIT_X` errors when downloading files, see [here&nbsp;&raquo;](https://core.telegram.org/api/files) for more info).","wallpapers":"Premium users [can set custom chat wallpapers both for them and the other user in the chat](https://core.telegram.org/api/wallpapers#installing-wallpapers-in-a-specific-chat-or-channel).","peer_colors":"Premium users can [choose a custom color and background emoji for their profile background and messages](https://core.telegram.org/api/colors).","voice_to_text":"Premium users can [transcribe voice messages without limits](https://core.telegram.org/api/transcribe).","translations":"Premium users can enable [real-time chat translation](https://core.telegram.org/api/translation).","no_ads":"Premium users see no [sponsored messages](https://core.telegram.org/api/sponsored-messages).","unique_reactions":"Premium users have access to more [message reactions](https://core.telegram.org/api/reactions).","premium_stickers":"Premium users have access to premium [stickersets](https://core.telegram.org/api/stickers).","animated_emoji":"Premium users can send custom [animated emojis](https://core.telegram.org/api/custom-emoji).","advanced_chat_management":"Premium users can [reorder the default folder](https://core.telegram.org/api/folders), auto-archive and hide new chats from non-contacts.","profile_badge":"Premium users have a [badge](https://core.telegram.org/api/premium#badge) next to their name, showing that they are helping support Telegram.","animated_userpics":"[Animated profile pictures](https://core.telegram.org/api/files#animated-profile-pictures) of Premium users will play in-chat and when browsing the dialog list.","app_icons":"Premium users can change the default icon of the Telegram app.","infinite_reactions":"Premium users can use [custom emojis](https://core.telegram.org/api/custom-emoji) when [reacting to messages](https://core.telegram.org/api/reactions).","emoji_status":"Premium users can set a [status emoji](https://core.telegram.org/api/emoji-status).","saved_tags":"Premium users can use [saved message tags](https://core.telegram.org/api/saved-messages#tags).","effects":"Premium users can use [message effects](https://core.telegram.org/api/effects).","channel_boost":"Premium users can [boost chats and channels](https://core.telegram.org/api/boost).","forum_topic_icon":"Premium users can set a [custom emoji](https://core.telegram.org/api/custom-emoji) as a [forum topic icon](https://core.telegram.org/api/forum)","todo":"Premium users can [post todo lists &raquo;](https://core.telegram.org/api/todo)","paid_messages":"Premium users can [require payment in Telegram stars in order to receive messages from new users &raquo;](https://core.telegram.org/api/paid-messages).","pm_noforwards":"Premium users can [enable content protection in private chats &raquo;](https://core.telegram.org/api/content-protection#for-users).","ai_compose":"Premium users have **50x** more [AI text transformations &raquo;](https://core.telegram.org/api/ai#compose-messages) per day."}},"premium limits":{"description":"[Telegram Premium limit identifiers &raquo;](https://core.telegram.org/api/premium#double-limits).","type":"map","entries":{"double_limits__channels":"Config keys: [channels_limit_premium &raquo;](https://core.telegram.org/api/config#channels-limit-premium)/[channels_limit_default &raquo;](https://core.telegram.org/api/config#channels-limit-default)\n\nThe maximum number of [channels and supergroups](https://core.telegram.org/api/channel) a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may join (integer)","double_limits__saved_gifs":"Config keys: [saved_gifs_limit_premium &raquo;](https://core.telegram.org/api/config#saved-gifs-limit-premium)/[saved_gifs_limit_default &raquo;](https://core.telegram.org/api/config#saved-gifs-limit-default)\n\nThe maximum number of GIFs a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may save (integer)","double_limits__stickers_faved":"Config keys: [stickers_faved_limit_premium &raquo;](https://core.telegram.org/api/config#stickers-faved-limit-premium)/[stickers_faved_limit_default &raquo;](https://core.telegram.org/api/config#stickers-faved-limit-default)\n\nThe maximum number of stickers a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may [add to Favorites&nbsp;&raquo;](https://core.telegram.org/api/stickers#favorite-stickersets) (integer)","double_limits__dialog_filters":"Config keys: [dialog_filters_limit_premium &raquo;](https://core.telegram.org/api/config#dialog-filters-limit-premium)/[dialog_filters_limit_default &raquo;](https://core.telegram.org/api/config#dialog-filters-limit-default)\n\nThe maximum number of [folders](https://core.telegram.org/api/folders) a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may create (integer)","double_limits__dialog_filters_chats":"Config keys: [dialog_filters_chats_limit_premium &raquo;](https://core.telegram.org/api/config#dialog-filters-chats-limit-premium)/[dialog_filters_chats_limit_default &raquo;](https://core.telegram.org/api/config#dialog-filters-chats-limit-default)\n\nThe maximum number of chats a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may add to a [folder](https://core.telegram.org/api/folders) (integer)","double_limits__dialogs_pinned":"Config keys: [dialogs_pinned_limit_premium &raquo;](https://core.telegram.org/api/config#dialogs-pinned-limit-premium)/[dialogs_pinned_limit_default &raquo;](https://core.telegram.org/api/config#dialogs-pinned-limit-default)\n\nThe maximum number of chats a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may pin (integer)","double_limits__dialogs_folder_pinned":"Config keys: [dialogs_folder_pinned_limit_premium &raquo;](https://core.telegram.org/api/config#dialogs-folder-pinned-limit-premium)/[dialogs_folder_pinned_limit_default &raquo;](https://core.telegram.org/api/config#dialogs-folder-pinned-limit-default)\n\nThe maximum number of chats a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may pin in a folder (integer)","double_limits__channels_public":"Config keys: [channels_public_limit_premium &raquo;](https://core.telegram.org/api/config#channels-public-limit-premium)/[channels_public_limit_default &raquo;](https://core.telegram.org/api/config#channels-public-limit-default)\n\nThe maximum number of public [channels or supergroups](https://core.telegram.org/api/channel) a [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) user may create (integer)","double_limits__caption_length":"Config keys: [caption_length_limit_premium &raquo;](https://core.telegram.org/api/config#caption-length-limit-premium)/[caption_length_limit_default &raquo;](https://core.telegram.org/api/config#caption-length-limit-default)\n\nThe maximum UTF-8 length of media captions sendable by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users (integer)","double_limits__about_length":"Config keys: [about_length_limit_premium &raquo;](https://core.telegram.org/api/config#about-length-limit-premium)/[about_length_limit_default &raquo;](https://core.telegram.org/api/config#about-length-limit-default)\n\nThe maximum UTF-8 length of bios of [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users (integer)","double_limits__chatlist_invites":"Config keys: [chatlist_invites_limit_premium &raquo;](https://core.telegram.org/api/config#chatlist-invites-limit-premium)/[chatlist_invites_limit_default &raquo;](https://core.telegram.org/api/config#chatlist-invites-limit-default)\n\nMaximum number of per-folder [chat folder deep links \u00bb](https://core.telegram.org/api/links#chat-folder-links) that can be created by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)","double_limits__chatlists_joined":"Config keys: [chatlists_joined_limit_premium &raquo;](https://core.telegram.org/api/config#chatlists-joined-limit-premium)/[chatlists_joined_limit_default &raquo;](https://core.telegram.org/api/config#chatlists-joined-limit-default)\n\nMaximum number of [shareable folders](https://core.telegram.org/api/links#chat-folder-links) [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users may have. (integer)","double_limits__story_expiring":"Config keys: [story_expiring_limit_premium &raquo;](https://core.telegram.org/api/config#story-expiring-limit-premium)/[story_expiring_limit_default &raquo;](https://core.telegram.org/api/config#story-expiring-limit-default)\n\nThe maximum number of active [stories](https://core.telegram.org/api/stories) for [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users (integer).","double_limits__story_caption_length":"Config keys: [story_caption_length_limit_premium &raquo;](https://core.telegram.org/api/config#story-caption-length-limit-premium)/[story_caption_length_limit_default &raquo;](https://core.telegram.org/api/config#story-caption-length-limit-default)\n\nThe maximum UTF-8 length of story captions for [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)","double_limits__stories_sent_weekly":"Config keys: [stories_sent_weekly_limit_premium &raquo;](https://core.telegram.org/api/config#stories-sent-weekly-limit-premium)/[stories_sent_weekly_limit_default &raquo;](https://core.telegram.org/api/config#stories-sent-weekly-limit-default)\n\nMaximum number of stories that can be sent in a week by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)","double_limits__stories_sent_monthly":"Config keys: [stories_sent_monthly_limit_premium &raquo;](https://core.telegram.org/api/config#stories-sent-monthly-limit-premium)/[stories_sent_monthly_limit_default &raquo;](https://core.telegram.org/api/config#stories-sent-monthly-limit-default)\n\nMaximum number of stories that can be sent in a month by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)","double_limits__stories_suggested_reactions":"Config keys: [stories_suggested_reactions_limit_premium &raquo;](https://core.telegram.org/api/config#stories-suggested-reactions-limit-premium)/[stories_suggested_reactions_limit_default &raquo;](https://core.telegram.org/api/config#stories-suggested-reactions-limit-default)\n\nMaximum number of [story reaction media areas&nbsp;&raquo;](https://core.telegram.org/api/stories#media-areas) that can be added to a story by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)","double_limits__recommended_channels":"Config keys: [recommended_channels_limit_premium &raquo;](https://core.telegram.org/api/config#recommended-channels-limit-premium)/[recommended_channels_limit_default &raquo;](https://core.telegram.org/api/config#recommended-channels-limit-default)\n\nThe maximum number of similar channels that can be recommended by [channels.getChannelRecommendations&raquo;](https://core.telegram.org/method/channels.getChannelRecommendations) to [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users. (integer)","double_limits__saved_dialogs_pinned":"Config keys: [saved_dialogs_pinned_limit_premium &raquo;](https://core.telegram.org/api/config#saved-dialogs-pinned-limit-premium)/[saved_dialogs_pinned_limit_default &raquo;](https://core.telegram.org/api/config#saved-dialogs-pinned-limit-default)\n\nMaximum number of pinned dialogs in [saved messages](https://core.telegram.org/api/saved-messages) for [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users.  (integer)","double_limits__bots_create":"Config keys: [bots_create_limit_default &raquo;](https://core.telegram.org/api/config#bots-create-limit-premium)/[bots_create_limit_premium &raquo;](https://core.telegram.org/api/config#bots-create-limit-default)\n\nMaximum number of [bots](https://core.telegram.org/api/bots) that can be owned by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users.  (integer)","double_limits__aicompose_tone_saved":"Config keys: [aicompose_tone_saved_limit_premium &raquo;](https://core.telegram.org/api/config#aicompose-tone-saved-limit-premium)/[aicompose_tone_saved_limit_default &raquo;](https://core.telegram.org/api/config#aicompose-tone-saved-limit-default)\n\nMaximum number of [custom AI composer tones &raquo;](https://core.telegram.org/api/ai#ai-compose-tones) that can be installed by [Premium](https://core.telegram.org/api/premium)/non-[Premium](https://core.telegram.org/api/premium) users.  (integer)"}},"premium story features":{"description":"[Premium story feature identifiers &raquo;](https://core.telegram.org/api/premium#stories)","type":"map","entries":{"stories__priority_order":"Stories posted by Premium users are shown first to users when fetching the list of active stories with [stories.getAllStories&nbsp;&raquo;](https://core.telegram.org/method/stories.getAllStories).","stories__stealth_mode":"Premium users can activate [stealth mode&nbsp;&raquo;](https://core.telegram.org/api/stories#stealth-mode).","stories__permanent_views_history":"Premium users can [fetch the full viewer list of stories, even after they expire&nbsp;&raquo;](https://core.telegram.org/api/stories#fetching-the-interaction-list)","stories__expiration_durations":"Premium users can set [custom expiration options when posting stories&nbsp;&raquo;](https://core.telegram.org/api/stories)","stories__save_stories_to_gallery":"Premium users can save other users' unprotected stories.","stories__links_and_formatting":"Premium users can use [styled text entities](https://core.telegram.org/api/entities) and links in story captions and [URL media areas](https://core.telegram.org/api/stories#urls), as specified by the [stories_entities&nbsp;&raquo;](https://core.telegram.org/api/config#stories-entities) config key.","stories__quality":"Premium users can view stories in a higher quality."}},"settings paths":{"description":"In-app settings deep link paths openable via [settings deep links \u00bb](https://core.telegram.org/api/links#settings-links).","type":"list","entries":["appearance","appearance/themes","appearance/themes/edit","appearance/themes/create","appearance/wallpapers","appearance/wallpapers/edit","appearance/wallpapers/set","appearance/wallpapers/choose-photo","appearance/your-color/profile","appearance/your-color/profile/add-icons","appearance/your-color/profile/use-gift","appearance/your-color/profile/reset","appearance/your-color/name","appearance/your-color/name/add-icons","appearance/your-color/name/use-gift","appearance/night-mode","appearance/auto-night-mode","appearance/text-size","appearance/text-size/use-system","appearance/message-corners","appearance/animations","appearance/stickers-and-emoji","appearance/stickers-and-emoji/edit","appearance/stickers-and-emoji/trending","appearance/stickers-and-emoji/archived","appearance/stickers-and-emoji/archived/edit","appearance/stickers-and-emoji/emoji","appearance/stickers-and-emoji/emoji/edit","appearance/stickers-and-emoji/emoji/archived","appearance/stickers-and-emoji/emoji/archived/edit","appearance/stickers-and-emoji/emoji/suggest","appearance/stickers-and-emoji/emoji/quick-reaction","appearance/stickers-and-emoji/emoji/quick-reaction/choose","appearance/stickers-and-emoji/suggest-by-emoji","appearance/stickers-and-emoji/large-emoji","appearance/stickers-and-emoji/dynamic-order","appearance/stickers-and-emoji/emoji/show-more","appearance/app-icon","appearance/tap-for-next-media","ask-question","auto_delete","business","business/do-not-hide-ads","change_number","chat/browser","chat/browser/enable-browser","chat/browser/clear-cookies","chat/browser/clear-cache","chat/browser/history","chat/browser/clear-history","chat/browser/never-open","chat/browser/clear-list","chat/browser/search","data","data/storage","data/storage/edit","data/storage/auto-remove","data/storage/clear-cache","data/storage/max-cache","data/usage","data/usage/mobile","data/usage/wifi","data/usage/reset","data/usage/roaming","data/auto-download/mobile","data/auto-download/mobile/enable","data/auto-download/mobile/usage","data/auto-download/mobile/photos","data/auto-download/mobile/stories","data/auto-download/mobile/videos","data/auto-download/mobile/files","data/auto-download/wifi","data/auto-download/wifi/enable","data/auto-download/wifi/usage","data/auto-download/wifi/photos","data/auto-download/wifi/stories","data/auto-download/wifi/videos","data/auto-download/wifi/files","data/auto-download/roaming","data/auto-download/roaming/enable","data/auto-download/roaming/usage","data/auto-download/roaming/photos","data/auto-download/roaming/stories","data/auto-download/roaming/videos","data/auto-download/roaming/files","data/auto-download/reset","data/save-to-photos/chats","data/save-to-photos/chats/max-video-size","data/save-to-photos/chats/add-exception","data/save-to-photos/chats/delete-all","data/save-to-photos/groups","data/save-to-photos/groups/max-video-size","data/save-to-photos/groups/add-exception","data/save-to-photos/groups/delete-all","data/save-to-photos/channels","data/save-to-photos/channels/max-video-size","data/save-to-photos/channels/add-exception","data/save-to-photos/channels/delete-all","data/less-data-calls","data/open-links","data/share-sheet","data/share-sheet/suggested-chats","data/share-sheet/suggest-by","data/share-sheet/reset","data/saved-edited-photos","data/pause-music","data/raise-to-listen","data/raise-to-speak","data/show-18-content","data/proxy","data/proxy/edit","data/proxy/use-proxy","data/proxy/add-proxy","data/proxy/share-list","data/proxy/use-for-calls","devices","devices/edit","devices/link-desktop","devices/terminate-sessions","devices/auto-terminate","edit","edit/set-photo","edit/first-name","edit/last-name","edit/bio","edit/birthday","edit/change-number","edit/username","edit/your-color","edit/channel","edit/add-account","edit/log-out","edit_profile","emoji-status","profile-color/profile","profile-color/profile/add-icons","profile-color/profile/use-gift","profile-color/name","profile-color/name/add-icons","profile-color/name/use-gift","profile-photo/use-emoji","faq","features","folders","folders/edit","folders/create","folders/add-recommended","folders/show-tags","folders/tab-view","language","language/show-button","language/translate-chats","language/do-not-translate","login_email","notifications","notifications/accounts","notifications/private-chats","notifications/private-chats/edit","notifications/private-chats/show","notifications/private-chats/preview","notifications/private-chats/sound","notifications/private-chats/add-exception","notifications/private-chats/delete-exceptions","notifications/private-chats/light-color","notifications/private-chats/vibrate","notifications/private-chats/priority","notifications/groups","notifications/groups/edit","notifications/groups/show","notifications/groups/preview","notifications/groups/sound","notifications/groups/add-exception","notifications/groups/delete-exceptions","notifications/groups/light-color","notifications/groups/vibrate","notifications/groups/priority","notifications/channels","notifications/channels/edit","notifications/channels/show","notifications/channels/preview","notifications/channels/sound","notifications/channels/add-exception","notifications/channels/delete-exceptions","notifications/channels/light-color","notifications/channels/vibrate","notifications/channels/priority","notifications/stories","notifications/stories/new","notifications/stories/important","notifications/stories/show-sender","notifications/stories/sound","notifications/stories/add-exception","notifications/stories/delete-exceptions","notifications/stories/light-color","notifications/stories/vibrate","notifications/stories/priority","notifications/reactions","notifications/reactions/messages","notifications/reactions/stories","notifications/reactions/show-sender","notifications/reactions/sound","notifications/reactions/light-color","notifications/reactions/vibrate","notifications/reactions/priority","notifications/in-app-sounds","notifications/in-app-vibrate","notifications/in-app-preview","notifications/in-chat-sounds","notifications/in-app-popup","notifications/lock-screen-names","notifications/include-channels","notifications/include-muted-chats","notifications/count-unread-messages","notifications/new-contacts","notifications/pinned-messages","notifications/reset","notifications/web","power-saving","power-saving/videos","power-saving/gifs","power-saving/stickers","power-saving/emoji","power-saving/effects","power-saving/preload","power-saving/background","power-saving/call-animations","power-saving/particles","power-saving/transitions","password","phone_privacy","premium","privacy","privacy/blocked","privacy/blocked/edit","privacy/blocked/block-user","privacy/blocked/block-user/chats","privacy/blocked/block-user/contacts","privacy/active-websites","privacy/active-websites/edit","privacy/active-websites/disconnect-all","privacy/passcode","privacy/passcode/disable","privacy/passcode/change","privacy/passcode/auto-lock","privacy/passcode/face-id","privacy/passcode/fingerprint","privacy/2sv","privacy/2sv/change","privacy/2sv/disable","privacy/2sv/change-email","privacy/passkey","privacy/passkey/create","privacy/auto-delete","privacy/auto-delete/set-custom","privacy/login-email","privacy/phone-number","privacy/phone-number/never","privacy/phone-number/always","privacy/last-seen","privacy/last-seen/never","privacy/last-seen/always","privacy/last-seen/hide-read-time","privacy/profile-photos","privacy/profile-photos/never","privacy/profile-photos/always","privacy/profile-photos/set-public","privacy/profile-photos/update-public","privacy/profile-photos/remove-public","privacy/bio","privacy/bio/never","privacy/bio/always","privacy/gifts","privacy/gifts/show-icon","privacy/gifts/never","privacy/gifts/always","privacy/gifts/accepted-types","privacy/birthday","privacy/birthday/add","privacy/birthday/never","privacy/birthday/always","privacy/saved-music","privacy/saved-music/never","privacy/saved-music/always","privacy/forwards","privacy/forwards/never","privacy/forwards/always","privacy/calls","privacy/calls/never","privacy/calls/always","privacy/calls/p2p","privacy/calls/p2p/never","privacy/calls/p2p/always","privacy/calls/ios-integration","privacy/voice","privacy/voice/never","privacy/voice/always","privacy/messages","privacy/messages/set-price","privacy/messages/exceptions","privacy/invites","privacy/invites/never","privacy/invites/always","privacy/self-destruct","privacy/data-settings","privacy/data-settings/sync-contacts","privacy/data-settings/delete-synced","privacy/data-settings/suggest-contacts","privacy/data-settings/delete-cloud-drafts","privacy/data-settings/clear-payment-info","privacy/data-settings/link-previews","privacy/data-settings/bot-settings","privacy/data-settings/map-provider","privacy/archive-and-mute","privacy-policy","qr-code","qr-code/share","qr-code/scan","search","send-gift","send-gift/self","stars","stars/top-up","stars/stats","stars/gift","stars/earn","themes","ton","saved-messages","calls","calls/all","calls/missed","calls/edit","calls/show-tab","calls/start-call","my-profile","my-profile/posts","my-profile/posts/all-stories","my-profile/posts/add-album","my-profile/gifts","my-profile/archived-posts"]},"topup":{"description":"Stars top-up purposes documented [here &raquo;](https://core.telegram.org/api/links#stars-topup-link).","type":"map","entries":{"subs":"Buy **Stars** to keep your channel subscriptions.","subadvance12":"Buy **Stars** to keep your subscriptions active for the next 12 months."}},"unauthed":{"description":"Methods that can be invoked without authorization, documented [here &raquo;](https://core.telegram.org/api/auth#we-are-authorized).","type":"map","entries":{"account.deleteAccount":"Delete the user's account from the telegram servers.","account.getPassword":"Obtain configuration for two-factor authorization with password","account.sendVerifyEmailCode":"Send an email verification code.","account.verifyEmail":"Verify an email address.","auth.bindTempAuthKey":"Binds a temporary authorization key `temp_auth_key_id` to the permanent authorization key `perm_auth_key_id`.","auth.cancelCode":"Cancel the login verification code","auth.checkPaidAuth":"Checks the status of a [login payment](https://core.telegram.org/api/auth#paid-auth).","auth.checkPassword":"Try logging to an account protected by a [2FA password](https://core.telegram.org/api/srp).","auth.exportLoginToken":"Generate a login token, for [login via QR code](https://core.telegram.org/api/qr-login).  ","auth.finishPasskeyLogin":"Complete login with a passkey over an unauthenticated connection, see [here \u00bb](https://core.telegram.org/api/passkeys#logging-in-with-a-passkey) for more info.","auth.importAuthorization":"Logs in a user using a key transmitted from his native data-center.","auth.importBotAuthorization":"Login as a bot","auth.importLoginToken":"Login using a redirected login token, generated in case of DC mismatch during [QR code login](https://core.telegram.org/api/qr-login).","auth.importWebTokenAuthorization":"Login by importing an authorization token","auth.initPasskeyLogin":"Initialize login with a passkey over an unauthenticated connection, see [here \u00bb](https://core.telegram.org/api/passkeys#logging-in-with-a-passkey) for more info.","auth.reportMissingCode":"Official apps only, reports that the SMS authentication code wasn't delivered.","auth.requestFirebaseSms":"Request an SMS code via Firebase.","auth.resendCode":"Resend the login code via another medium, the phone code type is determined by the return value of the previous auth.sendCode/auth.resendCode: see [login](https://core.telegram.org/api/auth) for more info.","auth.resetLoginEmail":"Reset the [login email \u00bb](https://core.telegram.org/api/auth#email-verification).","auth.sendCode":"Send the verification code for login","auth.signIn":"Signs in a user with a validated phone number.","auth.signUp":"Registers a validated phone number in the system.","help.getAppConfig":"Get app-specific configuration, see [client configuration](https://core.telegram.org/api/config#client-configuration) for more info on the result.","help.getConfig":"Returns current configuration, including data center configuration.","help.getCountriesList":"Get name, ISO code, localized name and phone codes/patterns of all available countries","help.getDeepLinkInfo":"Get info about an unsupported deep link, see [here for more info \u00bb](https://core.telegram.org/api/links#unsupported-links).","help.getNearestDc":"Returns info on data center nearest to the user.","help.saveAppLog":"Saves logs of application on the server.","initConnection":"Initialize connection","invokeWithLayer":"Invoke the specified query using the specified API [layer](https://core.telegram.org/api/invoking#layers)","langpack.getDifference":"Get new strings in language pack","langpack.getLangPack":"Get localization pack strings","langpack.getLanguage":"Get information about a language in a localization pack","langpack.getLanguages":"Get information about all languages in a localization pack","langpack.getStrings":"Get strings from a language pack","payments.assignAppStoreTransaction":"Informs server about a purchase made through the App Store: for official applications only.","payments.assignPlayMarketTransaction":"Informs server about a purchase made through the Play Store: for official applications only.","payments.canPurchaseStore":"Checks whether a purchase is possible. Must be called before in-store purchase, official apps only.","payments.getPaymentForm":"Get a payment form","payments.sendPaymentForm":"Send compiled payment form"}},"videoSize.type values":{"description":"[videoSize.type values &raquo;](https://core.telegram.org/api/files#videosizetype-values).","type":"map","entries":{"p":"Small animated profile picture preview, in MPEG4 format.","u":"Animated profile picture, in MPEG4 format.","v":"Video preview, in MPEG4 format.","f":"[Premium sticker effect&nbsp;&raquo;](https://core.telegram.org/api/stickers#premium-animated-sticker-effects), in [TGS&nbsp;&raquo;](https://core.telegram.org/api/stickers#animated-stickers) format."}},"webpage type":{"description":"Web page type values from the [webPage](https://core.telegram.org/constructor/webPage) constructor.","type":"map","entries":{"app":"Preview of a [Mini App link \u00bb](https://core.telegram.org/api/links#main-mini-app-links): the `photo` is the app icon, and clients render a button that launches the [Mini App \u00bb](https://core.telegram.org/api/bots/webapps).","article":"Preview of a generic external article or webpage. If `cached_page` is set, clients render an [instant view](https://instantview.telegram.org) button.","document":"Preview of an external document or file, contained in the `document` field.","gif":"Preview of an external animated GIF. If `embed_url`+`embed_type` are set the GIF is rendered using an embedded player, otherwise the animation is contained in the `document` field.","photo":"Preview of an external photo, contained in the `photo` field.","profile":"Preview of an external author or profile page; clients typically render this with a small thumbnail (forced small media).","telegram_aicomposetone":"Preview of an [AI compose tone link \u00bb](https://core.telegram.org/api/links#ai-compose-tone-links), shared when previewing a [custom AI composer tone \u00bb](https://core.telegram.org/api/ai#ai-compose-tones). The `attributes` field contains a [webPageAttributeAiComposeTone](https://core.telegram.org/constructor/webPageAttributeAiComposeTone) with the [custom emoji \u00bb](https://core.telegram.org/api/custom-emoji) representing the tone; clients render a button that applies the shared tone.","telegram_album":"Preview of a [message link \u00bb](https://core.telegram.org/api/links#message-links) pointing to a group of messages (album), rendered as a grouped media album rather than as a single-media preview. For this type the album media is **not** taken from the top-level `photo`/`document` fields: instead, a [cached\\_page](https://core.telegram.org/constructor/webPage#) ([instant view](https://instantview.telegram.org)) must be present, and clients render the items of its first [pageBlockCollage](https://core.telegram.org/constructor/pageBlockCollage) or [pageBlockSlideshow](https://core.telegram.org/constructor/pageBlockSlideshow) block. Each [pageBlockPhoto](https://core.telegram.org/constructor/pageBlockPhoto)/[pageBlockVideo](https://core.telegram.org/constructor/pageBlockVideo) item in that block references a photo or video by ID, resolved against the `photos` and `documents` of the `cached_page`. The instant view itself is not offered as a button (the album media replaces it).","telegram_auction":"Preview of an [auction link \u00bb](https://core.telegram.org/api/links#auction-links) to a [collectible gift auction \u00bb](https://core.telegram.org/api/auctions). The `attributes` field contains a [webPageAttributeStarGiftAuction](https://core.telegram.org/constructor/webPageAttributeStarGiftAuction) with the auctioned gift and the auction end date; clients render a button to join the auction, or to view the results once the auction has ended.","telegram_background":"Preview of a [wallpaper deep link \u00bb](https://core.telegram.org/api/links#wallpaper-links) to a [chat wallpaper \u00bb](https://core.telegram.org/api/wallpapers). The wallpaper settings (background colors, gradient rotation, pattern intensity, blur/motion, etc.) are parsed from the deep link in the `url`, not from dedicated fields. Image wallpapers carry the wallpaper image in the `document` field. Pattern wallpapers also use the `document` field, with `application/x-tgwallpattern` or `image/png` as the pattern MIME type; the colors from the `url` are rendered as the pattern background and tint. Solid-color and gradient wallpapers carry no media and are rendered from the colors encoded in the `url`. No `photo` is present. Clients render a button to apply the background.","telegram_bot":"Preview of a [bot link \u00bb](https://core.telegram.org/api/links#bot-links), rendered like a profile preview using the bot's avatar in the `photo` field.","telegram_botapp":"Preview of a [direct Mini App link \u00bb](https://core.telegram.org/api/links#direct-mini-app-links) to a named bot Mini App: the `photo` is the app preview, and clients render a button that opens the Mini App.","telegram_call":"Preview of a [conference link \u00bb](https://core.telegram.org/api/links#conference-links) to a [group call/conference call \u00bb](https://core.telegram.org/api/group-calls); clients render a button to join the call (no `photo`/`document` is present).","telegram_channel":"Preview of a [public username link \u00bb](https://core.telegram.org/api/links#public-username-links) to a channel, using the channel's avatar in the `photo` field; clients render a button to open/join the channel.","telegram_channel_boost":"Preview of a [boost link \u00bb](https://core.telegram.org/api/links#boost-links) to [boost a channel \u00bb](https://core.telegram.org/api/boost), using the channel avatar in the `photo` field; clients render a button to boost the channel.","telegram_channel_direct":"Preview of a [monoforum link \u00bb](https://core.telegram.org/api/links#monoforum-links) to the direct messages of a channel, using the channel avatar in the `photo` field.","telegram_channel_request":"Preview of a [chat invite link \u00bb](https://core.telegram.org/api/links#chat-invite-links) to a channel that has [join requests \u00bb](https://core.telegram.org/api/invites#join-requests) enabled; clients render a \"Request to join\" button.","telegram_chat":"Preview of a [public username link \u00bb](https://core.telegram.org/api/links#public-username-links) to a basic group, using the group avatar in the `photo` field; clients render a button to open/join the group.","telegram_chat_request":"Preview of a [chat invite link \u00bb](https://core.telegram.org/api/links#chat-invite-links) to a group that has [join requests \u00bb](https://core.telegram.org/api/invites#join-requests) enabled; clients render a \"Request to join\" button.","telegram_chatlist":"Preview of a [chat folder link \u00bb](https://core.telegram.org/api/links#chat-folder-links) to a [shareable chat folder \u00bb](https://core.telegram.org/api/folders#shared-folders) (no `photo`/`document` is present): clients use the `site_name`, `title` and `description` fields for the preview text, no [WebPageAttribute](https://core.telegram.org/type/WebPageAttribute) is required, and the action button opens the deep link in `url` to import the folder.","telegram_collection":"Preview of a [gift collection link \u00bb](https://core.telegram.org/api/links#gift-collection-links) to a [gift collection \u00bb](https://core.telegram.org/api/gifts#gift-collections). The `attributes` field contains a [webPageAttributeStarGiftCollection](https://core.telegram.org/constructor/webPageAttributeStarGiftCollection) with the collection's icon stickers; clients render a button to view the collection.","telegram_community":"Preview of a [chat folder link \u00bb](https://core.telegram.org/api/links#chat-folder-links) to a [shareable chat folder \u00bb](https://core.telegram.org/api/folders#shared-folders), rendered like `telegram_chatlist`.","telegram_giftcode":"Preview of a [premium giftcode link \u00bb](https://core.telegram.org/api/links#premium-giftcode-links) to a [Telegram Premium gift code \u00bb](https://core.telegram.org/api/giveaways); clients render a button to view/redeem the gift code (no `photo`/`document` is present).","telegram_group_boost":"Preview of a [boost link \u00bb](https://core.telegram.org/api/links#boost-links) to [boost a supergroup \u00bb](https://core.telegram.org/api/boost), using the supergroup avatar in the `photo` field; clients render a button to boost the supergroup.","telegram_livestream":"Preview of a [video chat/livestream link \u00bb](https://core.telegram.org/api/links#video-chat-livestream-links) to a [live video stream \u00bb](https://core.telegram.org/api/group-calls), rendered as a video chat preview marked as a livestream; clients render a button to watch the stream.","telegram_megagroup":"Preview of a [public username link \u00bb](https://core.telegram.org/api/links#public-username-links) to a supergroup, using the supergroup avatar in the `photo` field; clients render a button to open/join the supergroup.","telegram_megagroup_request":"Preview of a [chat invite link \u00bb](https://core.telegram.org/api/links#chat-invite-links) to a supergroup that has [join requests \u00bb](https://core.telegram.org/api/invites#join-requests) enabled; clients render a \"Request to join\" button.","telegram_message":"Preview of a [message link \u00bb](https://core.telegram.org/api/links#message-links) to a single message; clients render a button to open the message. Any `cached_page` instant view is ignored for this type.","telegram_newbot":"Preview of a [managed bot creation request link \u00bb](https://core.telegram.org/api/links#managed-bot-creation-request-links) used to create a new bot; clients render a button to create/register the managed bot.","telegram_nft":"Preview of a [collectible gift link \u00bb](https://core.telegram.org/api/links#collectible-gift-link) to a [collectible (unique) gift \u00bb](https://core.telegram.org/api/gifts#collectible-gifts). The `attributes` field contains a [webPageAttributeUniqueStarGift](https://core.telegram.org/constructor/webPageAttributeUniqueStarGift) with the unique gift; clients render a button to view the collectible.","telegram_stickerset":"Preview of a [stickerset link \u00bb](https://core.telegram.org/api/links#stickerset-links) to a [sticker or custom emoji set \u00bb](https://core.telegram.org/api/stickers). The `attributes` field contains a [webPageAttributeStickerSet](https://core.telegram.org/constructor/webPageAttributeStickerSet) with a few preview stickers and the `emojis`/`text_color` flags; clients display the preview stickers and render a button to view the sticker set (or custom emoji set, if the `emojis` flag is set).","telegram_story":"Preview of a [story link \u00bb](https://core.telegram.org/api/links#story-links) to a [story \u00bb](https://core.telegram.org/api/stories). The `attributes` field contains a [webPageAttributeStory](https://core.telegram.org/constructor/webPageAttributeStory) with the story's peer and ID (and optionally the embedded [storyItem](https://core.telegram.org/constructor/storyItem)); the preview media and caption are taken from the story, and clients render a button to view it.","telegram_story_album":"Preview of a [story album link \u00bb](https://core.telegram.org/api/links#story-album-links) to a [story album \u00bb](https://core.telegram.org/api/stories): a `photo` (and optional video `document`) cover is present, and clients render a button to view the story album.","telegram_theme":"Preview of a [theme link \u00bb](https://core.telegram.org/api/links#theme-links) to a [theme \u00bb](https://core.telegram.org/api/themes). The `attributes` field contains a [webPageAttributeTheme](https://core.telegram.org/constructor/webPageAttributeTheme) with the theme file(s) and theme settings; clients render a button to apply the theme.","telegram_user":"Preview of a [public username link \u00bb](https://core.telegram.org/api/links#public-username-links) to a user, rendered like a profile preview using the user's avatar in the `photo` field.","telegram_videochat":"Preview of a [video chat/livestream link \u00bb](https://core.telegram.org/api/links#video-chat-livestream-links) to a [video chat \u00bb](https://core.telegram.org/api/group-calls), rendered as a video chat preview.","telegram_voicechat":"Preview of a [video chat/livestream link \u00bb](https://core.telegram.org/api/links#video-chat-livestream-links) to a [voice chat \u00bb](https://core.telegram.org/api/group-calls), rendered as a (non-video) video chat preview; clients render a button to join the voice chat.","video":"Preview of an external video. If `embed_url`+`embed_type` are set the video is rendered using an embedded player, otherwise the video is contained in the `document` field."}}},"push":{"AUTH_REGION":"New login from unrecognized device {1}, location: {2}","AUTH_UNKNOWN":"New login from unrecognized device {1}","CHANNEL_MESSAGES":"{1} posted an album","CHANNEL_MESSAGE_AUDIO":"{1} posted a voice message","CHANNEL_MESSAGE_CONTACT":"{1} posted a contact {2}","CHANNEL_MESSAGE_DOC":"{1} posted a file","CHANNEL_MESSAGE_DOCS":"{1} posted {2} files","CHANNEL_MESSAGE_FWDS":"{1} posted {2} forwarded messages","CHANNEL_MESSAGE_GAME":"{1} invited you to play {2}","CHANNEL_MESSAGE_GAME_SCORE":"{1} scored {3} in game {2}","CHANNEL_MESSAGE_GEO":"{1} posted a location","CHANNEL_MESSAGE_GEOLIVE":"{1} posted a live location","CHANNEL_MESSAGE_GIF":"{1} posted a GIF","CHANNEL_MESSAGE_GIVEAWAY":"{1} posted a giveaway of {2}x {3}m Premium subscriptions","CHANNEL_MESSAGE_GIVEAWAY_STARS":"{1} posted a giveaway of {3} stars {2}","CHANNEL_MESSAGE_NOTEXT":"{1} posted a message","CHANNEL_MESSAGE_PAID_MEDIA":"{1} posted a paid post for {2} star","CHANNEL_MESSAGE_PHOTO":"{1} posted a photo","CHANNEL_MESSAGE_PHOTOS":"{1} posted {2} photos","CHANNEL_MESSAGE_PLAYLIST":"{1} posted {2} music files","CHANNEL_MESSAGE_POLL":"{1} posted a poll {2}","CHANNEL_MESSAGE_QUIZ":"{1} posted a quiz {2}","CHANNEL_MESSAGE_ROUND":"{1} posted a video message","CHANNEL_MESSAGE_STICKER":"{1} posted a {2} sticker","CHANNEL_MESSAGE_STORY":"{1} shared a story","CHANNEL_MESSAGE_TEXT":"{1}: {2}","CHANNEL_MESSAGE_TODO":"{1} posted a checklist {2}","CHANNEL_MESSAGE_TODO_APPEND":"{1} added {2} tasks","CHANNEL_MESSAGE_TODO_DONE":"{1} toggled {2} tasks","CHANNEL_MESSAGE_VIDEO":"{1} posted a video","CHANNEL_MESSAGE_VIDEOS":"{1} posted {2} videos","CHAT_ADD_MEMBER":"{1} invited {3} to the group {2}","CHAT_ADD_YOU":"{1} invited you to the group {2}","CHAT_CREATED":"{1} invited you to the group {2}","CHAT_DELETE_MEMBER":"{1} removed {3} from the group {2}","CHAT_DELETE_YOU":"{1} removed you from the group {2}","CHAT_JOINED":"{1} joined the group {2}","CHAT_LEFT":"{1} left the group {2}","CHAT_MESSAGES":"{1} sent an album to the group {2}","CHAT_MESSAGE_AUDIO":"{1} sent a voice message to the group {2}","CHAT_MESSAGE_CONTACT":"{1} shared a contact {3} in the group {2}","CHAT_MESSAGE_DOC":"{1} sent a file to the group {2}","CHAT_MESSAGE_DOCS":"{1} sent {3} files to the group {2}","CHAT_MESSAGE_FWDS":"{1} forwarded {3} messages to the group {2}","CHAT_MESSAGE_GAME":"{1} invited the group {2} to play {3}","CHAT_MESSAGE_GAME_SCORE":"{1} scored {4} in game {3} in the group {2}","CHAT_MESSAGE_GEO":"{1} sent a location to the group {2}","CHAT_MESSAGE_GEOLIVE":"{1} shared a live location with the group {2}","CHAT_MESSAGE_GIF":"{1} sent a GIF to the group {2}","CHAT_MESSAGE_GIVEAWAY":"{1} sent a giveaway of {3}x {4}m Premium subscriptions to the group {2}","CHAT_MESSAGE_GIVEAWAY_STARS":"{1} sent a giveaway of {4} stars {3} to the group {2}","CHAT_MESSAGE_INVOICE":"{1} sent an invoice to the group {2} for {3}","CHAT_MESSAGE_NOTEXT":"{1} sent a message to the group {2}","CHAT_MESSAGE_PAID_MEDIA":"{1} posted a paid post in {2} group for {3} star","CHAT_MESSAGE_PHOTO":"{1} sent a photo to the group {2}","CHAT_MESSAGE_PHOTOS":"{1} sent {3} photos to the group {2}","CHAT_MESSAGE_PLAYLIST":"{1} sent {3} music files to the group {2}","CHAT_MESSAGE_POLL":"{1} sent a poll {3} to the group {2}","CHAT_MESSAGE_QUIZ":"{1} sent a quiz {3} to the group {2}","CHAT_MESSAGE_ROUND":"{1} sent a video message to the group {2}","CHAT_MESSAGE_STICKER":"{1} sent a {3} sticker to the group {2}","CHAT_MESSAGE_STORY":"{1} shared a story to the group","CHAT_MESSAGE_TEXT":"{1} @ {2}: {3}","CHAT_MESSAGE_TODO":"{1} sent a checklist {3} to the group {2}","CHAT_MESSAGE_TODO_APPEND":"{1} added {3} tasks in the group {2}","CHAT_MESSAGE_TODO_DONE":"{1} toggled {3} tasks in the group {2}","CHAT_MESSAGE_VIDEO":"{1} sent a video to the group {2}","CHAT_MESSAGE_VIDEOS":"{1} sent {3} videos to the group {2}","CHAT_PHOTO_EDITED":"{1} changed the group photo for {2}","CHAT_REACT_AUDIO":"{1}: {3} to your voice message in {2}","CHAT_REACT_CONTACT":"{1}: {3} to your contact {4} in {2}","CHAT_REACT_DOC":"{1}: {3} to your file in {2}","CHAT_REACT_GAME":"{1}: {3} to your game in {2}","CHAT_REACT_GEO":"{1}: {3} to your map in {2}","CHAT_REACT_GEOLIVE":"{1}: {3} to your live location in {2}","CHAT_REACT_GIF":"{1}: {3} to your GIF in {2}","CHAT_REACT_GIVEAWAY":"{1} reacted {3} in group {2} to your giveaway","CHAT_REACT_INVOICE":"{1}: {3} to your invoice in {2}","CHAT_REACT_NOTEXT":"{1}: {3} to your message in {2}","CHAT_REACT_PAID_MEDIA":"{1} reacted {3} in group {2} to your paid post for {4} star","CHAT_REACT_PHOTO":"{1}: {3} to your photo in {2}","CHAT_REACT_POLL":"{1}: {3} to your poll {4} in {2}","CHAT_REACT_QUIZ":"{1}: {3} to your quiz {4} in {2}","CHAT_REACT_ROUND":"{1}: {3} to your video message in {2}","CHAT_REACT_STICKER":"{1}: {3} to your {4} sticker in {2}","CHAT_REACT_TEXT":"{1}: {3} in {2} to your \"{4}\"","CHAT_REACT_TODO":"{1}: {3} to your checklist {4} in {2}","CHAT_REACT_VIDEO":"{1}: {3} to your video in {2}","CHAT_REQ_JOINED":"{2}|{1} was accepted into the group","CHAT_RETURNED":"{1} returned to the group {2}","CHAT_TITLE_EDITED":"{1} renamed the group {2}","CHAT_VOICECHAT_END":"{1} ended a voice chat in the group {2}","CHAT_VOICECHAT_INVITE":"{1} invited {3} to a voice chat in the group {2}","CHAT_VOICECHAT_INVITE_YOU":"{1} invited you to a voice chat in the group {2}","CHAT_VOICECHAT_START":"{1} started a voice chat in the group {2}","CONF_CALL_MISSED":"You missed a call from {1}","CONTACT_JOINED":"{1} joined Telegram!","DC_UPDATE":"Open this notification to update app settings","ENCRYPTED_MESSAGE":"You have a new message","ENCRYPTION_ACCEPT":"You have a new message","ENCRYPTION_REQUEST":"You have a new message","LOCKED_MESSAGE":"You have a new message","MESSAGES":"{1} sent you an album","MESSAGE_AUDIO":"{1} sent you a voice message","MESSAGE_CONTACT":"{1} shared a contact {2} with you","MESSAGE_DOC":"{1} sent you a file","MESSAGE_DOCS":"{1} sent you {2} files","MESSAGE_FWDS":"{1} forwarded you {2} messages","MESSAGE_GAME":"{1} invited you to play {2}","MESSAGE_GAME_SCORE":"{1} scored {3} in game {2}","MESSAGE_GEO":"{1} sent you a location","MESSAGE_GEOLIVE":"{1} sent you a live location","MESSAGE_GIF":"{1} sent you a GIF","MESSAGE_GIFTCODE":"{1} sent you a Gift Code for {2} of Telegram Premium","MESSAGE_GIVEAWAY":"{1} sent you a giveaway of {2}x {3}m Premium subscriptions","MESSAGE_GIVEAWAY_STARS":"{1} sent you a giveaway of {3} stars {2}","MESSAGE_INVOICE":"{1} sent you an invoice for {2}","MESSAGE_NOTEXT":"{1} sent you a message","MESSAGE_PAID_MEDIA":"{1} sent you a paid post for {2} star","MESSAGE_PHOTO":"{1} sent you a photo","MESSAGE_PHOTOS":"{1} sent you {2} photos","MESSAGE_PHOTO_SECRET":"{1} sent you a self-destructing photo","MESSAGE_PLAYLIST":"{1} sent you {2} music files","MESSAGE_POLL":"{1} sent you a poll {2}","MESSAGE_QUIZ":"{1} sent you a quiz {2}","MESSAGE_RECURRING_PAY":"You were charged {2} by {1}","MESSAGE_ROUND":"{1} sent you a video message","MESSAGE_SAME_WALLPAPER":"{1} set a same wallpaper for this chat","MESSAGE_SCREENSHOT":"{1} took a screenshot","MESSAGE_STARGIFT":"{1} sent you a Gift worth {2} Stars","MESSAGE_STARGIFT_UNPACK_UPGRADE":"{1} unpacked the Gift that you helped upgrade","MESSAGE_STARGIFT_UPGRADE":"{1} upgraded your Gift","MESSAGE_STICKER":"{1} sent you a {2} sticker","MESSAGE_STORY":"{1} shared a story with you","MESSAGE_STORY_MENTION":"{1} mentioned you in a story","MESSAGE_SUGGEST_BIRTHDAY":"{1} suggested you your birthday","MESSAGE_TEXT":"{1}: {2}","MESSAGE_TODO":"{1} sent you a checklist {2}","MESSAGE_UNIQUE_STARGIFT":"{1} transferred you a Gift!","MESSAGE_VIDEO":"{1} sent you a video","MESSAGE_VIDEOS":"{1} sent you {2} videos","MESSAGE_VIDEO_SECRET":"{1} sent you a self-destructing video","MESSAGE_WALLPAPER":"{1} set a new wallpaper for this chat","OAUTH_REQUEST":"Login request for {1} from {2}","PHONE_CALL_MISSED":"You missed a call from {1}","PHONE_CALL_REQUEST":"{1} is calling you!","PINNED_AUDIO":"{1} pinned a voice message","PINNED_CONTACT":"{1} pinned a contact {2}","PINNED_DOC":"{1} pinned a file","PINNED_GAME":"{1} pinned a game","PINNED_GAME_SCORE":"{1} pinned a game score","PINNED_GEO":"{1} pinned a map","PINNED_GEOLIVE":"{1} pinned a live location","PINNED_GIF":"{1} pinned a GIF","PINNED_GIVEAWAY":"{1} pinned a giveaway","PINNED_INVOICE":"{1} pinned an invoice","PINNED_NOTEXT":"{1} pinned a message","PINNED_PAID_MEDIA":"{1} pinned a paid post for {2} star","PINNED_PHOTO":"{1} pinned a photo","PINNED_POLL":"{1} pinned a poll {2}","PINNED_QUIZ":"{1} pinned a quiz {2}","PINNED_ROUND":"{1} pinned a video message","PINNED_STICKER":"{1} pinned a {2} sticker","PINNED_TEXT":"{1} pinned \"{2}\"","PINNED_TODO":"{1} pinned a checklist {2}","PINNED_VIDEO":"{1} pinned a video","REACT_AUDIO":"{1}: {2} to your voice message","REACT_CONTACT":"{1}: {2} to your contact {3}","REACT_DOC":"{1}: {2} to your file","REACT_GAME":"{1}: {2} to your game","REACT_GEO":"{1}: {2} to your map","REACT_GEOLIVE":"{1}: {2} to your live location","REACT_GIF":"{1}: {2} to your GIF","REACT_GIVEAWAY":"{1} reacted {2} to your giveaway","REACT_HIDDEN":"New reaction to your message","REACT_INVOICE":"{1}: {2} to your invoice","REACT_NOTEXT":"{1}: {2} to your message","REACT_PHOTO":"{1}: {2} to your photo","REACT_POLL":"{1}: {2} to your poll {3}","REACT_QUIZ":"{1}: {2} to your quiz {3}","REACT_ROUND":"{1}: {2} to your video message","REACT_STICKER":"{1}: {2} to your {3} sticker","REACT_STORY":"{1}: {2} to your story","REACT_STORY_HIDDEN":"New reaction to your story","REACT_TEXT":"{1}: {2} to your \"{3}\"","REACT_TODO":"{1}: {2} to your checklist {3}","REACT_VIDEO":"{1}: {2} to your video","STORY_HIDDEN_AUTHOR":"A new story was posted","STORY_LIVE":"started a live stream!","STORY_NOTEXT":"posted a story"},"push_arguments":{"AUTH_REGION":{"1":"Device name","2":"Location"},"AUTH_UNKNOWN":{"1":"Device name"},"CHANNEL_MESSAGES":{"1":"Message author"},"CHANNEL_MESSAGE_AUDIO":{"1":"Message author"},"CHANNEL_MESSAGE_CONTACT":{"1":"Message author","2":"Contact name"},"CHANNEL_MESSAGE_DOC":{"1":"Message author"},"CHANNEL_MESSAGE_DOCS":{"1":"Channel name","2":"Number of documents that were posted"},"CHANNEL_MESSAGE_FWDS":{"1":"Message author","2":"Number of forwarded messages"},"CHANNEL_MESSAGE_GAME":{"1":"Message author","2":"Game name"},"CHANNEL_MESSAGE_GAME_SCORE":{"1":"User","2":"Game name","3":"Score"},"CHANNEL_MESSAGE_GEO":{"1":"Channel name"},"CHANNEL_MESSAGE_GEOLIVE":{"1":"Channel name"},"CHANNEL_MESSAGE_GIF":{"1":"Channel name"},"CHANNEL_MESSAGE_GIVEAWAY":{"1":"Channel name","2":"Number of Telegram Premium subscriptions in the giveaway","3":"Duration in months of each Telegram Premium subscription in the giveaway"},"CHANNEL_MESSAGE_GIVEAWAY_STARS":{"1":"Channel name","2":"Number of winners in the giveaway","3":"Number of Telegram Stars being given away"},"CHANNEL_MESSAGE_NOTEXT":{"1":"Channel name"},"CHANNEL_MESSAGE_PAID_MEDIA":{"1":"Channel name","2":"[Stars](/api/stars)"},"CHANNEL_MESSAGE_PHOTO":{"1":"Channel name"},"CHANNEL_MESSAGE_PHOTOS":{"1":"Channel name","2":"Number of photos that was sent"},"CHANNEL_MESSAGE_PLAYLIST":{"1":"Channel name","2":"Number of audio files that were posted"},"CHANNEL_MESSAGE_POLL":{"1":"Channel name","2":"Poll name"},"CHANNEL_MESSAGE_QUIZ":{"1":"Channel name","2":"Quiz name"},"CHANNEL_MESSAGE_ROUND":{"1":"Channel name"},"CHANNEL_MESSAGE_STICKER":{"1":"Channel name","2":"Sticker emoji"},"CHANNEL_MESSAGE_STORY":{"1":"Channel name"},"CHANNEL_MESSAGE_TEXT":{"1":"Channel name","2":"Message body"},"CHANNEL_MESSAGE_TODO":{"1":"Channel name","2":"Checklist title"},"CHANNEL_MESSAGE_TODO_APPEND":{"1":"Channel name","2":"Number of added tasks"},"CHANNEL_MESSAGE_TODO_DONE":{"1":"Channel name","2":"Number of toggled tasks"},"CHANNEL_MESSAGE_VIDEO":{"1":"Channel name"},"CHANNEL_MESSAGE_VIDEOS":{"1":"Channel name","2":"Number of videos that were posted"},"CHAT_ADD_MEMBER":{"1":"Message author","2":"Chat name","3":"New participant name"},"CHAT_ADD_YOU":{"1":"User name","2":"Group name"},"CHAT_CREATED":{"1":"Message author","2":"Chat name"},"CHAT_DELETE_MEMBER":{"1":"Message author","2":"Chat name","3":"Dropped participant name"},"CHAT_DELETE_YOU":{"1":"Message author","2":"Chat name"},"CHAT_JOINED":{"1":"User name","2":"Group name"},"CHAT_LEFT":{"1":"Message author","2":"Chat name"},"CHAT_MESSAGES":{"1":"User name","2":"Group name"},"CHAT_MESSAGE_AUDIO":{"1":"Message author","2":"Chat name"},"CHAT_MESSAGE_CONTACT":{"1":"User name","2":"Group name","3":"Contact name"},"CHAT_MESSAGE_DOC":{"1":"User name","2":"Group name"},"CHAT_MESSAGE_DOCS":{"1":"User name","2":"Group name","3":"Number of documents that were sent"},"CHAT_MESSAGE_FWDS":{"1":"User name","2":"Group name","3":"Number of messages that were forwarded"},"CHAT_MESSAGE_GAME":{"1":"User name","2":"Group name","3":"Game name"},"CHAT_MESSAGE_GAME_SCORE":{"1":"User name","2":"Group name","3":"Game name","4":"Score"},"CHAT_MESSAGE_GEO":{"1":"Message author","2":"Chat name"},"CHAT_MESSAGE_GEOLIVE":{"1":"User name","2":"Group name"},"CHAT_MESSAGE_GIF":{"1":"User name","2":"Group name"},"CHAT_MESSAGE_GIVEAWAY":{"1":"User name","2":"Group name","3":"Number of Telegram Premium subscriptions in the giveaway","4":"Duration in months of each Telegram Premium subscription in the giveaway"},"CHAT_MESSAGE_GIVEAWAY_STARS":{"1":"User name","2":"Group name","3":"Number of winners in the giveaway","4":"Number of Telegram Stars being given away"},"CHAT_MESSAGE_INVOICE":{"1":"User name","2":"Group name","3":"Product name"},"CHAT_MESSAGE_NOTEXT":{"1":"Message author","2":"Chat name"},"CHAT_MESSAGE_PAID_MEDIA":{"1":"Message author","2":"Chat name","3":"[Stars](/api/stars)"},"CHAT_MESSAGE_PHOTO":{"1":"Message author","2":"Chat name"},"CHAT_MESSAGE_PHOTOS":{"1":"User name","2":"Group name","3":"Number of photos that were sent"},"CHAT_MESSAGE_PLAYLIST":{"1":"User name","2":"Group name","3":"Number of audio files that were sent"},"CHAT_MESSAGE_POLL":{"1":"User name","2":"Group name","3":"Poll name"},"CHAT_MESSAGE_QUIZ":{"1":"User name","2":"Group name","3":"Quiz name"},"CHAT_MESSAGE_ROUND":{"1":"User name","2":"Group name"},"CHAT_MESSAGE_STICKER":{"1":"User name","2":"Group name","3":"Sticker emoji"},"CHAT_MESSAGE_STORY":{"1":"Group name"},"CHAT_MESSAGE_TEXT":{"1":"Message author","2":"Chat name","3":"Message body"},"CHAT_MESSAGE_TODO":{"1":"User","2":"Group name","3":"Checklist title"},"CHAT_MESSAGE_TODO_APPEND":{"1":"User","2":"Group name","3":"Number of added tasks"},"CHAT_MESSAGE_TODO_DONE":{"1":"User name","2":"Group name","3":"Number of toggled tasks"},"CHAT_MESSAGE_VIDEO":{"1":"Message author","2":"Chat name"},"CHAT_MESSAGE_VIDEOS":{"1":"User name","2":"Group name","3":"Number of videos that were sent"},"CHAT_PHOTO_EDITED":{"1":"Message author","2":"Chat name"},"CHAT_REACT_AUDIO":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REACT_CONTACT":{"1":"User name","2":"Group name","3":"Reaction","4":"Contact name"},"CHAT_REACT_DOC":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REACT_GAME":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REACT_GEO":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REACT_GEOLIVE":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REACT_GIF":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REACT_GIVEAWAY":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REACT_INVOICE":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REACT_NOTEXT":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REACT_PAID_MEDIA":{"1":"User name","2":"Group name","3":"Reaction","4":"[Stars](/api/stars)"},"CHAT_REACT_PHOTO":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REACT_POLL":{"1":"User name","2":"Group name","3":"Reaction","4":"Poll name"},"CHAT_REACT_QUIZ":{"1":"User name","2":"Group name","3":"Reaction","4":"Quiz name"},"CHAT_REACT_ROUND":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REACT_STICKER":{"1":"User name","2":"Group name","3":"Reaction","4":"Sticker emoji"},"CHAT_REACT_TEXT":{"1":"User name","2":"Group name","3":"Reaction","4":"Message body"},"CHAT_REACT_TODO":{"1":"User name","2":"Group name","3":"Reaction","4":"Checklist title"},"CHAT_REACT_VIDEO":{"1":"User name","2":"Group name","3":"Reaction"},"CHAT_REQ_JOINED":{"1":"User name","2":"Chat name"},"CHAT_RETURNED":{"1":"Message author","2":"Chat name"},"CHAT_TITLE_EDITED":{"1":"User name","2":"Group name"},"CHAT_VOICECHAT_END":{"1":"User name","2":"Chat name"},"CHAT_VOICECHAT_INVITE":{"1":"User name","2":"Chat name","3":"Invited users"},"CHAT_VOICECHAT_INVITE_YOU":{"1":"User name","2":"Chat name"},"CHAT_VOICECHAT_START":{"1":"User name","2":"Chat name"},"CONF_CALL_MISSED":{"1":"User name"},"CONTACT_JOINED":{"1":"Contact name"},"DC_UPDATE":[],"ENCRYPTED_MESSAGE":[],"ENCRYPTION_ACCEPT":[],"ENCRYPTION_REQUEST":[],"LOCKED_MESSAGE":[],"MESSAGES":{"1":"User name"},"MESSAGE_AUDIO":{"1":"Message author"},"MESSAGE_CONTACT":{"1":"User name","2":"Contact name"},"MESSAGE_DOC":{"1":"User name"},"MESSAGE_DOCS":{"1":"User name","2":"Number of documents that were sent"},"MESSAGE_FWDS":{"1":"User name","2":"Number of messages that were forwarded"},"MESSAGE_GAME":{"1":"User name","2":"Game name"},"MESSAGE_GAME_SCORE":{"1":"User name","2":"Game name","3":"Score"},"MESSAGE_GEO":{"1":"Message author"},"MESSAGE_GEOLIVE":{"1":"User name"},"MESSAGE_GIF":{"1":"User name"},"MESSAGE_GIFTCODE":{"1":"User name","2":"Duration of Telegram Premium subscription"},"MESSAGE_GIVEAWAY":{"1":"User name","2":"Number of Telegram Premium subscriptions in the giveaway","3":"Duration in months of each Telegram Premium subscription in the giveaway"},"MESSAGE_GIVEAWAY_STARS":{"1":"User name","2":"Number of winners in the giveaway","3":"Number of Telegram Stars being given away"},"MESSAGE_INVOICE":{"1":"User name","2":"Product"},"MESSAGE_NOTEXT":{"1":"Message author"},"MESSAGE_PAID_MEDIA":{"1":"Message author","2":"[Stars](/api/stars)"},"MESSAGE_PHOTO":{"1":"Message author"},"MESSAGE_PHOTOS":{"1":"User name","2":"Number of photos that were sent"},"MESSAGE_PHOTO_SECRET":{"1":"User name"},"MESSAGE_PLAYLIST":{"1":"User name","2":"Number of audio files that were sent"},"MESSAGE_POLL":{"1":"User name","2":"Poll name"},"MESSAGE_QUIZ":{"1":"User name","2":"Quiz name"},"MESSAGE_RECURRING_PAY":{"1":"The entity to which money was sent for a recurring subscription","2":"The amount of money charged for a recurring subscription"},"MESSAGE_ROUND":{"1":"User name"},"MESSAGE_SAME_WALLPAPER":{"1":"User name"},"MESSAGE_SCREENSHOT":{"1":"User name"},"MESSAGE_STARGIFT":{"1":"User name","2":"Number of Telegram Stars"},"MESSAGE_STARGIFT_UNPACK_UPGRADE":{"1":"User name"},"MESSAGE_STARGIFT_UPGRADE":{"1":"User name"},"MESSAGE_STICKER":{"1":"User name","2":"Sticker emoji"},"MESSAGE_STORY":{"1":"User name"},"MESSAGE_STORY_MENTION":{"1":"User name"},"MESSAGE_SUGGEST_BIRTHDAY":{"1":"User name"},"MESSAGE_TEXT":{"1":"Message author","2":"Message body"},"MESSAGE_TODO":{"1":"User name","2":"Checklist title"},"MESSAGE_UNIQUE_STARGIFT":{"1":"User name"},"MESSAGE_VIDEO":{"1":"Message author"},"MESSAGE_VIDEOS":{"1":"User name","2":"Number of videos that were sent"},"MESSAGE_VIDEO_SECRET":{"1":"User name"},"MESSAGE_WALLPAPER":{"1":"User name"},"OAUTH_REQUEST":{"1":"Domain of the URL where the user is trying to log in, the full URL is passed in the `data_url` field of the custom arguments","2":"Human-readable description of a country and a region from which the authorization is performed, based on the IP address of the user"},"PHONE_CALL_MISSED":{"1":"User name"},"PHONE_CALL_REQUEST":{"1":"User name"},"PINNED_AUDIO":{"1":"User name"},"PINNED_CONTACT":{"1":"User name","2":"Contact name"},"PINNED_DOC":{"1":"User name"},"PINNED_GAME":{"1":"User name"},"PINNED_GAME_SCORE":{"1":"User name"},"PINNED_GEO":{"1":"User name"},"PINNED_GEOLIVE":{"1":"User name"},"PINNED_GIF":{"1":"User name"},"PINNED_GIVEAWAY":{"1":"User name"},"PINNED_INVOICE":{"1":"User name"},"PINNED_NOTEXT":{"1":"User name"},"PINNED_PAID_MEDIA":{"1":"User name","2":"[Stars](/api/stars)"},"PINNED_PHOTO":{"1":"User name"},"PINNED_POLL":{"1":"User name","2":"Poll name"},"PINNED_QUIZ":{"1":"User name","2":"Quiz name"},"PINNED_ROUND":{"1":"User name"},"PINNED_STICKER":{"1":"User name","2":"Sticker emoji"},"PINNED_TEXT":{"1":"User name","2":"Message body"},"PINNED_TODO":{"1":"User name","2":"Checklist title"},"PINNED_VIDEO":{"1":"User name"},"REACT_AUDIO":{"1":"User name","2":"Reaction"},"REACT_CONTACT":{"1":"User name","2":"Reaction","3":"Contact name"},"REACT_DOC":{"1":"User name","2":"Reaction"},"REACT_GAME":{"1":"User name","2":"Reaction"},"REACT_GEO":{"1":"User name","2":"Reaction"},"REACT_GEOLIVE":{"1":"User name","2":"Reaction"},"REACT_GIF":{"1":"User name","2":"Reaction"},"REACT_GIVEAWAY":{"1":"User name","2":"Reaction"},"REACT_HIDDEN":[],"REACT_INVOICE":{"1":"User name","2":"Reaction"},"REACT_NOTEXT":{"1":"User name","2":"Reaction"},"REACT_PHOTO":{"1":"User name","2":"Reaction"},"REACT_POLL":{"1":"User name","2":"Reaction","3":"Poll name"},"REACT_QUIZ":{"1":"User name","2":"Reaction","3":"Quiz name"},"REACT_ROUND":{"1":"User name","2":"Reaction"},"REACT_STICKER":{"1":"User name","2":"Reaction","3":"Sticker emoji"},"REACT_STORY":{"1":"Peer where the story was posted","2":"Reaction"},"REACT_STORY_HIDDEN":[],"REACT_TEXT":{"1":"User name","2":"Reaction","3":"Message body"},"REACT_TODO":{"1":"User name","2":"Reaction","3":"Checklist title"},"REACT_VIDEO":{"1":"User name","2":"Reaction"},"STORY_HIDDEN_AUTHOR":[],"STORY_LIVE":[],"STORY_NOTEXT":[]}}