Optional
about_Optional
about_The maximum UTF-8 length of bios of Premium users (integer)
Optional
authorization_An unconfirmed session » will be autoconfirmed this many seconds after login. (integer)
Optional
autoarchive_Whether clients can invoke account.RawSetGlobalPrivacySettingsRequest with RawGlobalPrivacySettings, to automatically archive and mute new incoming chats from non-contacts. (boolean)
Optional
autologin_A list of Telegram domains that support automatic login with no user confirmation, click here for more info on URL authorization ». (array of strings)
Optional
background_Whether app clients should start a background TCP connection for MTProto update fetching (boolean)
Optional
boosts_Maximum boost level for channels. (integer)
Optional
boosts_The number of additional boost slots that the current user will receive when gifting a Telegram Premium subscription.
Optional
caption_The maximum UTF-8 length of media captions sendable by non-Premium users (integer)
Optional
caption_The maximum UTF-8 length of media captions sendable by Premium users (integer)
Optional
channel_After reaching at least this boost level », channels gain the ability to change their message accent palette emoji ». (integer)
Optional
channel_After reaching at least this boost level », channels gain the ability to set any custom wallpaper, not just fill channel wallpapers, see here » for more info. (integer)
Optional
channel_After reaching at least this boost level », channels gain the ability to change their status emoji ». (integer)
Optional
channel_After reaching at least this boost level », channels gain the ability to change their profile accent palette emoji ». (integer)
Optional
channel_After reaching at least this boost level », channels gain the ability to set a fill channel wallpaper, see here » for more info. (integer)
Optional
channels_The maximum number of channels and supergroups a non-Premium user may join (integer)
Optional
channels_The maximum number of channels and supergroups a Premium user may join (integer)
Optional
channels_The maximum number of public channels or supergroups a non-Premium user may create (integer)
Optional
channels_The maximum number of public channels or supergroups a Premium user may create (integer)
Optional
chat_To protect user privacy, read receipts for chats are only
stored for chat_read_mark_expire_period
seconds
after the message was sent. (integer)
Optional
chat_Per-user read receipts, fetchable using
messages.RawGetMessageReadParticipantsRequest, will
be available in groups with an amount of participants less
or equal to chat_read_mark_size_threshold
.
(integer)
Optional
chatlist_Maximum number of per-folder chat folder deep links » that can be created by non-Premium users. (integer)
Optional
chatlist_Maximum number of per-folder chat folder deep links » that can be created by Premium users. (integer)
Optional
chatlist_Users that import a folder using a
chat
folder deep link » should retrieve additions made to the
folder by invoking
chatlists.RawGetChatlistUpdatesRequest at most every
chatlist_update_period
seconds. (integer)
Optional
chatlists_Maximum number of shareable folders non-Premium users may have. (integer)
Optional
chatlists_Maximum number of shareable folders Premium users may have. (integer)
Optional
default_Default emoji status stickerset ID. (integer)
Note that the stickerset can be fetched using RawInputStickerSetEmojiDefaultStatuses.
Optional
dialog_Optional
dialog_Optional
dialog_Whether clients should show an option for managing dialog filters AKA folders (boolean)
Optional
dialog_Optional
dialog_Optional
dialog_Whether clients should actively show a tooltip, inviting the user to configure dialog filters AKA folders; typically this happens when the chat list is long enough to start getting cluttered. (boolean)
Optional
dialogs_The maximum number of chats a non-Premium user may pin in a folder (integer)
Optional
dialogs_The maximum number of chats a Premium user may pin in a folder (integer)
Optional
dialogs_The maximum number of chats a non-Premium user may pin (integer)
Optional
dialogs_The maximum number of chats a Premium user may pin (integer)
Optional
emojies_Animated emojis and animated dice should be scaled by this factor before being shown to the user (float)
Optional
emojies_A list of supported animated dice stickers (array of strings).
Optional
emojies_For
animated
dice emojis other than the basic , indicates the winning dice value and
the final frame of the animated sticker, at which to show
the fireworks (object with emoji keys and object
values, containing value
and
frame_start
float values)
Optional
emojies_A map of soundbites to be played when the user clicks on the specified animated emoji; the file reference field should be base64-decoded before downloading the file (map of file IDs (RawInputDocument.id), with emoji string keys)
Optional
fragment_List of phone number prefixes for anonymous Fragment phone numbers. (array of strings).
Optional
gif_Specifies the name of the service providing GIF search through gif_search_username (string)
Optional
gif_Specifies a list of emojis that should be suggested as search term in a bar above the GIF search box (array of string emojis)
Optional
giveaway_The maximum number of users that can be specified when making a direct giveaway. (integer)
Optional
giveaway_Optional
giveaway_The maximum number of countries that can be specified when restricting the set of participating countries in a giveaway. (itneger)
Optional
giveaway_Whether giveaways can be started by the current user. (boolean)
Optional
giveaway_The maximum duration in seconds of a giveaway. (integer)
Optional
groupcall_Maximum number of participants in a group call (livestreams allow ∞ participants) (integer)
Optional
hidden_Minimum number of participants required to hide the participants list of a supergroup using channels.RawToggleParticipantsHiddenRequest. (integer)
Optional
keep_Whether app clients should start a keepalive service to keep the app running and fetch updates even when the app is closed (boolean)
Optional
large_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)
Optional
message_The maximum number of custom emojis that may be present in a message. (integer)
Optional
pending_Contains a list of suggestions that should be actively shown as a tooltip to the user. (Array of strings, possible values shown in the suggestions section ».
Optional
pm_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)
Optional
premium_Contains the username of the official Telegram Premium bot that may be used to buy a Telegram Premium subscription, see here for detailed instructions » (string)
Optional
premium_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 subscription to the other user in the chat. (boolean)
Optional
premium_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 subscription to the other user in the chat. Can
only be true if premium_gift_attach_menu_icon
is also true. (boolean)
Optional
premium_Contains an invoice slug that may be used to buy a Telegram Premium subscription, see here for detailed instructions » (string)
Optional
premium_Array of string identifiers, indicating the order of Telegram Premium features in the Telegram Premium promotion popup, see here for the possible values »
Optional
premium_The user can't purchase Telegram Premium. The app must also hide all Premium features, including stars for other users, et cetera. (boolean)
Optional
qr_Whether the Settings->Devices menu should show an option to scan a QR login code (boolean)
Optional
qr_Whether the login screen should show a QR code login option, possibly as default login method (string, "disabled", "primary" or "secondary")
Optional
quote_Maximum UTF-8 length of RawInputReplyToMessage. (integer)
Optional
reactions_Maximum number of reactions that can be marked as allowed in a chat using RawChatReactionsSome. (integer)
Optional
reactions_Maximum number of unique reactions for any given message: for example, if there are 2000 and 1000 custom emoji reactions and reactions_uniq_max = 2, you can't add a reaction, because that would raise the number of unique reactions to 3 > 2. (integer)
Optional
reactions_Maximum number of reactions that can be added to a single message by a non-Premium user. (integer)
Optional
reactions_Maximum number of reactions that can be added to a single message by a Premium user. (integer)
Optional
recommended_The maximum number of similar channels that can be recommended by channels.RawGetChannelRecommendationsRequest to non-Premium users. (integer)
Optional
recommended_The maximum number of similar channels that can be recommended by channels.RawGetChannelRecommendationsRequest to Premium users. (integer)
Optional
ringtone_The maximum duration in seconds of uploadable notification sounds » (integer)
Optional
ringtone_The maximum number of saveable notification sounds »
Optional
ringtone_The maximum post-conversion size in bytes of uploadable notification sounds »
Optional
round_Contains a set of recommended codec parameters for round videos. (object, as described in the example)
Optional
saved_Maximum number of pinned dialogs in saved messages for non-Premium users. (integer)
Optional
saved_Maximum number of pinned dialogs in saved messages for Premium users. (integer)
Optional
saved_The maximum number of GIFs a non-Premium user may save (integer)
Optional
saved_The maximum number of GIFs a Premium user may save (integer)
Optional
small_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)
Optional
stickers_Specifies the validity period of the local cache of messages.RawGetStickersRequest, also relevant when generating the pagination hash when invoking the method. (integer)
Optional
stickers_Specifies that the app should not display local sticker suggestions » for emojis at all and just use the result of messages.RawGetStickersRequest (bool)
Optional
stickers_The maximum number of stickers a non-Premium user may add to Favorites » (integer)
Optional
stickers_The maximum number of stickers a Premium user may add to Favorites » (integer)
Optional
stickers_For Premium users, used to define the suggested sticker list, see the sticker docs for more info (integer, defaults to 2)
Optional
stickers_Defines how many Premium stickers to show in the sticker suggestion popup when entering an emoji into the text field, see the sticker docs for more info (integer, defaults to 0)
Optional
stories_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 just like for contacts,
even if the user was removed from the contact list.
(integer, defaults to 777000
)
Optional
stories_Whether
styled
text entities and links in story text captions can be
used by all users (enabled
), only
[Premium](/api/premium users) (premium
), or no
one (disabled
). (string)This 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
subscription has expired (if stories_entities ==
"premium"
and RawUser.premium
is
not set, or if stories_entities == "disabled"
).
Optional
stories_Indicates whether users can post stories. (string)One of:
enabled
- Any user can post stories.premium
- Only users with a
Premium
subscription can post stories.disabled
- Users can't post stories.Optional
stories_Maximum number of stories that can be sent in a month by non-Premium users. (integer)
Optional
stories_Maximum number of stories that can be sent in a month by Premium users. (integer)
Optional
stories_Maximum number of stories that can be sent in a week by non-Premium users. (integer)
Optional
stories_Maximum number of stories that can be sent in a week by Premium users. (integer)
Optional
stories_After enabling stories stealth mode, this many seconds must elapse before the user is allowed to enable it again. (integer)
Optional
stories_Enabling
stories
stealth mode with the future
flag will hide
views of any story opened in the next
stories_stealth_future_period
seconds.
(integer)
Optional
stories_Enabling
stories
stealth mode with the past
flag will erase
views of any story opened in the past
stories_stealth_past_period
seconds. (integer)
Optional
stories_Maximum number of story reaction media areas » that can be added to a story by non-Premium users. (integer)
Optional
stories_Maximum number of story reaction media areas » that can be added to a story by Premium users. (integer)
Optional
stories_Username of the inline bot to use to generate venue location tags for stories, see here » for more info. (string)
Optional
story_The maximum UTF-8 length of story captions for non-Premium users. (integer)
Optional
story_The maximum UTF-8 length of story captions for Premium users. (integer)
Optional
story_Optional
story_Optional
story_Optional
telegram_Minimum number of group members required to enable native antispam functionality. (integer)
Optional
telegram_The ID of the official native antispam bot, that will automatically delete spam messages if enabled as specified in the native antispam documentation ».
When fetching the admin list of a supergroup using channels.RawGetParticipantsRequest, 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)
Optional
topics_Optional
transcribe_The maximum allowed duration of media in seconds for speech recognition » for non-Premium users. (integer)
Optional
transcribe_The maximum number of speech recognition » calls per week for non-Premium users. (integer)
Optional
upload_The maximum number of file parts uploadable by
non-Premium
users (integer, the maximum file size can be extrapolated by
multiplying this value by 524288
, the biggest
possible chunk size)
Optional
upload_The maximum number of file parts uploadable by
Premium
users (integer, the maximum file size can be extrapolated by
multiplying this value by 524288
, the biggest
possible chunk size)
Optional
url_A list of domains that support automatic login with manual user confirmation, click here for more info on URL authorization ». (array of strings)
Optional
whitelisted_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.
RawMessageEntityTextUrl entities). (array of
strings)Note that when opening
named
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). Confirmation
should always be asked, even if we already
opened the
named
Mini App before, if the link is not visible (i.e.
RawMessageEntityTextUrl text links, inline buttons
etc.).
The maximum UTF-8 length of bios of non-Premium users (integer)