Update to TDLib 1.8.55

This commit is contained in:
c0re100 2025-09-28 17:55:16 +08:00
parent 9b94728dda
commit 926224f707
No known key found for this signature in database
GPG key ID: 7C3B3004FE745AAF
4 changed files with 4055 additions and 156 deletions

View file

@ -131,7 +131,9 @@ authorizationStateWaitPhoneNumber = AuthorizationState;
//@description The user must buy Telegram Premium as an in-store purchase to log in. Call checkAuthenticationPremiumPurchase and then setAuthenticationPremiumPurchaseTransaction
//@store_product_id Identifier of the store product that must be bought
authorizationStateWaitPremiumPurchase store_product_id:string = AuthorizationState;
//@support_email_address Email address to use for support if the user has issues with Telegram Premium purchase
//@support_email_subject Subject for the email sent to the support email address
authorizationStateWaitPremiumPurchase store_product_id:string support_email_address:string support_email_subject:string = AuthorizationState;
//@description TDLib needs the user's email address to authorize. Call setAuthenticationEmailAddress to provide the email address, or directly call checkAuthenticationEmailCode with Apple ID/Google ID token if allowed
//@allow_apple_id True, if authorization through Apple ID is allowed
@ -441,6 +443,9 @@ animation duration:int32 width:int32 height:int32 file_name:string mime_type:str
//@audio File containing the audio
audio duration:int32 title:string performer:string file_name:string mime_type:string album_cover_minithumbnail:minithumbnail album_cover_thumbnail:thumbnail external_album_covers:vector<thumbnail> audio:file = Audio;
//@description Contains a list of audio files @total_count Approximate total number of audio files found @audios List of audio files
audios total_count:int32 audios:vector<audio> = Audios;
//@description Describes a document of any type
//@file_name Original name of the file; as defined by the sender
//@mime_type MIME type of the file; as defined by the sender
@ -612,6 +617,33 @@ profilePhoto id:int64 small:file big:file minithumbnail:minithumbnail has_animat
chatPhotoInfo small:file big:file minithumbnail:minithumbnail has_animation:Bool is_personal:Bool = ChatPhotoInfo;
//@class ProfileTab @description Describes a tab shown in a user or a chat profile
//@description A tab with stories posted by the user or the channel chat and saved to profile
profileTabPosts = ProfileTab;
//@description A tab with gifts received by the user or the channel chat
profileTabGifts = ProfileTab;
//@description A tab with photos and videos posted by the channel
profileTabMedia = ProfileTab;
//@description A tab with documents posted by the channel
profileTabFiles = ProfileTab;
//@description A tab with messages posted by the channel and containing links
profileTabLinks = ProfileTab;
//@description A tab with audio messages posted by the channel
profileTabMusic = ProfileTab;
//@description A tab with voice notes posted by the channel
profileTabVoice = ProfileTab;
//@description A tab with animations posted by the channel
profileTabGifs = ProfileTab;
//@class UserType @description Represents the type of user. The following types are possible: regular users, deleted users and bots
//@description A regular user
@ -1196,6 +1228,15 @@ giftCollection id:int32 name:string icon:sticker gift_count:int32 = GiftCollecti
giftCollections collections:vector<giftCollection> = GiftCollections;
//@class CanSendGiftResult @description Describes whether a gift can be sent now by the current user
//@description The gift can be sent now by the current user
canSendGiftResultOk = CanSendGiftResult;
//@description The gift can't be sent now by the current user @reason Reason to be shown to the user
canSendGiftResultFail reason:formattedText = CanSendGiftResult;
//@class UpgradedGiftOrigin @description Describes origin from which the upgraded gift was obtained
//@description The gift was obtained by upgrading of a previously received gift
@ -1254,11 +1295,13 @@ upgradedGiftOriginalDetails sender_id:MessageSender receiver_id:MessageSender te
//@upgrade_star_count Number of Telegram Stars that must be paid to upgrade the gift; 0 if upgrade isn't possible
//@is_for_birthday True, if the gift is a birthday gift
//@is_premium True, if the gift can be bought only by Telegram Premium subscribers
//@next_send_date Point in time (Unix timestamp) when the gift can be sent next time by the current user; can be 0 or a date in the past.
//-If the date is in the future, then call canSendGift to get the reason, why the gift can't be sent now
//@user_limits Number of times the gift can be purchased by the current user; may be null if not limited
//@overall_limits Number of times the gift can be purchased all users; may be null if not limited
//@first_send_date Point in time (Unix timestamp) when the gift was send for the first time; for sold out gifts only
//@last_send_date Point in time (Unix timestamp) when the gift was send for the last time; for sold out gifts only
gift id:int64 publisher_chat_id:int53 sticker:sticker star_count:int53 default_sell_star_count:int53 upgrade_star_count:int53 is_for_birthday:Bool is_premium:Bool user_limits:giftPurchaseLimits overall_limits:giftPurchaseLimits first_send_date:int32 last_send_date:int32 = Gift;
gift id:int64 publisher_chat_id:int53 sticker:sticker star_count:int53 default_sell_star_count:int53 upgrade_star_count:int53 is_for_birthday:Bool is_premium:Bool next_send_date:int32 user_limits:giftPurchaseLimits overall_limits:giftPurchaseLimits first_send_date:int32 last_send_date:int32 = Gift;
//@description Describes an upgraded gift that can be transferred to another owner or transferred to the TON blockchain as an NFT
//@id Unique identifier of the gift
@ -1270,6 +1313,8 @@ gift id:int64 publisher_chat_id:int53 sticker:sticker star_count:int53 default_s
//@total_upgraded_count Total number of gifts that were upgraded from the same gift
//@max_upgraded_count The maximum number of gifts that can be upgraded from the same gift
//@is_premium True, if the original gift could have been bought only by Telegram Premium subscribers
//@is_theme_available True, if the gift can be used to set a theme in a chat
//@used_theme_chat_id Identifier of the chat for which the gift is used to set a theme; 0 if none or the gift isn't owned by the current user
//@owner_id Identifier of the user or the chat that owns the upgraded gift; may be null if none or unknown
//@owner_address Address of the gift NFT owner in TON blockchain; may be empty if none. Append the address to getOption("ton_blockchain_explorer_url") to get a link with information about the address
//@owner_name Name of the owner for the case when owner identifier and address aren't known
@ -1281,7 +1326,7 @@ gift id:int64 publisher_chat_id:int53 sticker:sticker star_count:int53 default_s
//@resale_parameters Resale parameters of the gift; may be null if resale isn't possible
//@value_currency ISO 4217 currency code of the currency in which value of the gift is represented; may be empty if unavailable
//@value_amount Estimated value of the gift; in the smallest units of the currency; 0 if unavailable
upgradedGift id:int64 regular_gift_id:int64 publisher_chat_id:int53 title:string name:string number:int32 total_upgraded_count:int32 max_upgraded_count:int32 is_premium:Bool owner_id:MessageSender owner_address:string owner_name:string gift_address:string model:upgradedGiftModel symbol:upgradedGiftSymbol backdrop:upgradedGiftBackdrop original_details:upgradedGiftOriginalDetails resale_parameters:giftResaleParameters value_currency:string value_amount:int53 = UpgradedGift;
upgradedGift id:int64 regular_gift_id:int64 publisher_chat_id:int53 title:string name:string number:int32 total_upgraded_count:int32 max_upgraded_count:int32 is_premium:Bool is_theme_available:Bool used_theme_chat_id:int53 owner_id:MessageSender owner_address:string owner_name:string gift_address:string model:upgradedGiftModel symbol:upgradedGiftSymbol backdrop:upgradedGiftBackdrop original_details:upgradedGiftOriginalDetails resale_parameters:giftResaleParameters value_currency:string value_amount:int53 = UpgradedGift;
//@description Contains information about value of an upgraded gift
//@currency ISO 4217 currency code of the currency in which the prices are represented
@ -1404,12 +1449,13 @@ sentGiftUpgraded gift:upgradedGift = SentGift;
//@collection_ids Identifiers of collections to which the gift is added; only for the receiver of the gift
//@sell_star_count Number of Telegram Stars that can be claimed by the receiver instead of the regular gift; 0 if the gift can't be sold by the current user
//@prepaid_upgrade_star_count Number of Telegram Stars that were paid by the sender for the ability to upgrade the gift
//@is_upgrade_separate True, if the upgrade was bought after the gift was sent. In this case, prepaid upgrade cost must not be added to the gift cost
//@transfer_star_count Number of Telegram Stars that must be paid to transfer the upgraded gift; only for the receiver of the gift
//@next_transfer_date Point in time (Unix timestamp) when the gift can be transferred to another owner; can be in the past; 0 if the gift can be transferred immediately or transfer isn't possible; only for the receiver of the gift
//@next_resale_date Point in time (Unix timestamp) when the gift can be resold to another user; can be in the past; 0 if the gift can't be resold; only for the receiver of the gift
//@export_date Point in time (Unix timestamp) when the upgraded gift can be transferred to the TON blockchain as an NFT; can be in the past; 0 if NFT export isn't possible; only for the receiver of the gift
//@prepaid_upgrade_hash If non-empty, then the user can pay for an upgrade of the gift using buyGiftUpgrade
receivedGift received_gift_id:string sender_id:MessageSender text:formattedText is_private:Bool is_saved:Bool is_pinned:Bool can_be_upgraded:Bool can_be_transferred:Bool was_refunded:Bool date:int32 gift:SentGift collection_ids:vector<int32> sell_star_count:int53 prepaid_upgrade_star_count:int53 transfer_star_count:int53 next_transfer_date:int32 next_resale_date:int32 export_date:int32 prepaid_upgrade_hash:string = ReceivedGift;
receivedGift received_gift_id:string sender_id:MessageSender text:formattedText is_private:Bool is_saved:Bool is_pinned:Bool can_be_upgraded:Bool can_be_transferred:Bool was_refunded:Bool date:int32 gift:SentGift collection_ids:vector<int32> sell_star_count:int53 prepaid_upgrade_star_count:int53 is_upgrade_separate:Bool transfer_star_count:int53 next_transfer_date:int32 next_resale_date:int32 export_date:int32 prepaid_upgrade_hash:string = ReceivedGift;
//@description Represents a list of gifts received by a user or a chat
//@total_count The total number of received gifts
@ -1865,12 +1911,14 @@ botInfo short_description:string description:string photo:photo animation:animat
//@outgoing_paid_message_star_count Number of Telegram Stars that must be paid by the current user for each sent message to the user
//@gift_settings Settings for gift receiving for the user
//@bot_verification Information about verification status of the user provided by a bot; may be null if none or unknown
//@main_profile_tab The main tab chosen by the user; may be null if not chosen manually
//@first_profile_audio The first audio file added to the user's profile; may be null if none
//@rating The current rating of the user; may be null if none
//@pending_rating The rating of the user after the next change; may be null if the user isn't the current user or there are no pending rating changes
//@pending_rating_date Unix timestamp when rating of the user will change to pending_rating; 0 if the user isn't the current user or there are no pending rating changes
//@business_info Information about business settings for Telegram Business accounts; may be null if none
//@bot_info For bots, information about the bot; may be null if the user isn't a bot
userFullInfo personal_photo:chatPhoto photo:chatPhoto public_photo:chatPhoto block_list:BlockList can_be_called:Bool supports_video_calls:Bool has_private_calls:Bool has_private_forwards:Bool has_restricted_voice_and_video_note_messages:Bool has_posted_to_profile_stories:Bool has_sponsored_messages_enabled:Bool need_phone_number_privacy_exception:Bool set_chat_background:Bool bio:formattedText birthdate:birthdate personal_chat_id:int53 gift_count:int32 group_in_common_count:int32 incoming_paid_message_star_count:int53 outgoing_paid_message_star_count:int53 gift_settings:giftSettings bot_verification:botVerification rating:userRating pending_rating:userRating pending_rating_date:int32 business_info:businessInfo bot_info:botInfo = UserFullInfo;
userFullInfo personal_photo:chatPhoto photo:chatPhoto public_photo:chatPhoto block_list:BlockList can_be_called:Bool supports_video_calls:Bool has_private_calls:Bool has_private_forwards:Bool has_restricted_voice_and_video_note_messages:Bool has_posted_to_profile_stories:Bool has_sponsored_messages_enabled:Bool need_phone_number_privacy_exception:Bool set_chat_background:Bool bio:formattedText birthdate:birthdate personal_chat_id:int53 gift_count:int32 group_in_common_count:int32 incoming_paid_message_star_count:int53 outgoing_paid_message_star_count:int53 gift_settings:giftSettings bot_verification:botVerification main_profile_tab:ProfileTab first_profile_audio:audio rating:userRating pending_rating:userRating pending_rating_date:int32 business_info:businessInfo bot_info:botInfo = UserFullInfo;
//@description Represents a list of users @total_count Approximate total number of users found @user_ids A list of user identifiers
users total_count:int32 user_ids:vector<int53> = Users;
@ -2160,9 +2208,10 @@ supergroup id:int53 access_hash:int64 usernames:usernames date:int32 status:Chat
//@invite_link Primary invite link for the chat; may be null. For chat administrators with can_invite_users right only
//@bot_commands List of commands of bots in the group
//@bot_verification Information about verification status of the supergroup or the channel provided by a bot; may be null if none or unknown
//@main_profile_tab The main tab chosen by the administrators of the channel; may be null if not chosen manually
//@upgraded_from_basic_group_id Identifier of the basic group from which supergroup was upgraded; 0 if none
//@upgraded_from_max_message_id Identifier of the last message in the basic group from which supergroup was upgraded; 0 if none
supergroupFullInfo photo:chatPhoto description:string member_count:int32 administrator_count:int32 restricted_count:int32 banned_count:int32 linked_chat_id:int53 direct_messages_chat_id:int53 slow_mode_delay:int32 slow_mode_delay_expires_in:double can_enable_paid_messages:Bool can_enable_paid_reaction:Bool can_get_members:Bool has_hidden_members:Bool can_hide_members:Bool can_set_sticker_set:Bool can_set_location:Bool can_get_statistics:Bool can_get_revenue_statistics:Bool can_get_star_revenue_statistics:Bool can_send_gift:Bool can_toggle_aggressive_anti_spam:Bool is_all_history_available:Bool can_have_sponsored_messages:Bool has_aggressive_anti_spam_enabled:Bool has_paid_media_allowed:Bool has_pinned_stories:Bool gift_count:int32 my_boost_count:int32 unrestrict_boost_count:int32 outgoing_paid_message_star_count:int53 sticker_set_id:int64 custom_emoji_sticker_set_id:int64 location:chatLocation invite_link:chatInviteLink bot_commands:vector<botCommands> bot_verification:botVerification upgraded_from_basic_group_id:int53 upgraded_from_max_message_id:int53 = SupergroupFullInfo;
supergroupFullInfo photo:chatPhoto description:string member_count:int32 administrator_count:int32 restricted_count:int32 banned_count:int32 linked_chat_id:int53 direct_messages_chat_id:int53 slow_mode_delay:int32 slow_mode_delay_expires_in:double can_enable_paid_messages:Bool can_enable_paid_reaction:Bool can_get_members:Bool has_hidden_members:Bool can_hide_members:Bool can_set_sticker_set:Bool can_set_location:Bool can_get_statistics:Bool can_get_revenue_statistics:Bool can_get_star_revenue_statistics:Bool can_send_gift:Bool can_toggle_aggressive_anti_spam:Bool is_all_history_available:Bool can_have_sponsored_messages:Bool has_aggressive_anti_spam_enabled:Bool has_paid_media_allowed:Bool has_pinned_stories:Bool gift_count:int32 my_boost_count:int32 unrestrict_boost_count:int32 outgoing_paid_message_star_count:int53 sticker_set_id:int64 custom_emoji_sticker_set_id:int64 location:chatLocation invite_link:chatInviteLink bot_commands:vector<botCommands> bot_verification:botVerification main_profile_tab:ProfileTab upgraded_from_basic_group_id:int53 upgraded_from_max_message_id:int53 = SupergroupFullInfo;
//@class SecretChatState @description Describes the current secret chat state
@ -2918,7 +2967,7 @@ videoChat group_call_id:int32 has_participants:Bool default_participant_id:Messa
//@message_auto_delete_time Current message auto-delete or self-destruct timer setting for the chat, in seconds; 0 if disabled. Self-destruct timer in secret chats starts after the message or its content is viewed. Auto-delete timer in other chats starts from the send date
//@emoji_status Emoji status to be shown along with chat title; may be null
//@background Background set for the chat; may be null if none
//@theme_name If non-empty, name of a theme, set for the chat
//@theme Theme set for the chat; may be null if none
//@action_bar Information about actions which must be possible to do through the chat action bar; may be null if none
//@business_bot_manage_bar Information about bar for managing a business bot in the chat; may be null if none
//@video_chat Information about video chat of the chat
@ -2926,7 +2975,7 @@ videoChat group_call_id:int32 has_participants:Bool default_participant_id:Messa
//@reply_markup_message_id Identifier of the message from which reply markup needs to be used; 0 if there is no default custom reply markup in the chat
//@draft_message A draft of a message in the chat; may be null if none
//@client_data Application-specific data associated with the chat. (For example, the chat scroll position or local chat notification settings can be stored here.) Persistent if the message database is used
chat id:int53 type:ChatType title:string photo:chatPhotoInfo accent_color_id:int32 background_custom_emoji_id:int64 profile_accent_color_id:int32 profile_background_custom_emoji_id:int64 permissions:chatPermissions last_message:message positions:vector<chatPosition> chat_lists:vector<ChatList> message_sender_id:MessageSender block_list:BlockList has_protected_content:Bool is_translatable:Bool is_marked_as_unread:Bool view_as_topics:Bool has_scheduled_messages:Bool can_be_deleted_only_for_self:Bool can_be_deleted_for_all_users:Bool can_be_reported:Bool default_disable_notification:Bool unread_count:int32 last_read_inbox_message_id:int53 last_read_outbox_message_id:int53 unread_mention_count:int32 unread_reaction_count:int32 notification_settings:chatNotificationSettings available_reactions:ChatAvailableReactions message_auto_delete_time:int32 emoji_status:emojiStatus background:chatBackground theme_name:string action_bar:ChatActionBar business_bot_manage_bar:businessBotManageBar video_chat:videoChat pending_join_requests:chatJoinRequestsInfo reply_markup_message_id:int53 draft_message:draftMessage client_data:string = Chat;
chat id:int53 type:ChatType title:string photo:chatPhotoInfo accent_color_id:int32 background_custom_emoji_id:int64 profile_accent_color_id:int32 profile_background_custom_emoji_id:int64 permissions:chatPermissions last_message:message positions:vector<chatPosition> chat_lists:vector<ChatList> message_sender_id:MessageSender block_list:BlockList has_protected_content:Bool is_translatable:Bool is_marked_as_unread:Bool view_as_topics:Bool has_scheduled_messages:Bool can_be_deleted_only_for_self:Bool can_be_deleted_for_all_users:Bool can_be_reported:Bool default_disable_notification:Bool unread_count:int32 last_read_inbox_message_id:int53 last_read_outbox_message_id:int53 unread_mention_count:int32 unread_reaction_count:int32 notification_settings:chatNotificationSettings available_reactions:ChatAvailableReactions message_auto_delete_time:int32 emoji_status:emojiStatus background:chatBackground theme:ChatTheme action_bar:ChatActionBar business_bot_manage_bar:businessBotManageBar video_chat:videoChat pending_join_requests:chatJoinRequestsInfo reply_markup_message_id:int53 draft_message:draftMessage client_data:string = Chat;
//@description Represents a list of chats @total_count Approximate total number of chats found @chat_ids List of chat identifiers
chats total_count:int32 chat_ids:vector<int53> = Chats;
@ -3280,13 +3329,32 @@ sharedUser user_id:int53 first_name:string last_name:string username:string phot
sharedChat chat_id:int53 title:string username:string photo:photo = SharedChat;
//@class BuiltInTheme @description Describes a built-in theme of an official app
//@description Classic light theme
builtInThemeClassic = BuiltInTheme;
//@description Regular light theme
builtInThemeDay = BuiltInTheme;
//@description Regular dark theme
builtInThemeNight = BuiltInTheme;
//@description Tinted dark theme
builtInThemeTinted = BuiltInTheme;
//@description Arctic light theme
builtInThemeArctic = BuiltInTheme;
//@description Describes theme settings
//@base_theme Base theme for this theme
//@accent_color Theme accent color in ARGB format
//@background The background to be used in chats; may be null
//@outgoing_message_fill The fill to be used as a background for outgoing messages
//@outgoing_message_fill The fill to be used as a background for outgoing messages; may be null if the fill from the base theme must be used instead
//@animate_outgoing_message_fill If true, the freeform gradient fill needs to be animated on every sent message
//@outgoing_message_accent_color Accent color of outgoing messages in ARGB format
themeSettings accent_color:int32 background:background outgoing_message_fill:BackgroundFill animate_outgoing_message_fill:Bool outgoing_message_accent_color:int32 = ThemeSettings;
themeSettings base_theme:BuiltInTheme accent_color:int32 background:background outgoing_message_fill:BackgroundFill animate_outgoing_message_fill:Bool outgoing_message_accent_color:int32 = ThemeSettings;
//@class RichText @description Describes a formatted text object
@ -4437,8 +4505,8 @@ messageScreenshotTaken = MessageContent;
//@only_for_self True, if the background was set only for self
messageChatSetBackground old_background_message_id:int53 background:chatBackground only_for_self:Bool = MessageContent;
//@description A theme in the chat has been changed @theme_name If non-empty, name of a new theme, set for the chat. Otherwise, chat theme was reset to the default one
messageChatSetTheme theme_name:string = MessageContent;
//@description A theme in the chat has been changed @theme New theme for the chat; may be null if chat theme was reset to the default one
messageChatSetTheme theme:ChatTheme = MessageContent;
//@description The auto-delete or self-destruct timer for messages in the chat has been changed @message_auto_delete_time New value auto-delete or self-destruct time, in seconds; 0 if disabled @from_user_id If not 0, a user identifier, which default setting was automatically applied
messageChatSetMessageAutoDeleteTime message_auto_delete_time:int32 from_user_id:int53 = MessageContent;
@ -4598,6 +4666,7 @@ messageGiveawayPrizeStars star_count:int53 transaction_id:string boosted_chat_id
//@text Message added to the gift
//@sell_star_count Number of Telegram Stars that can be claimed by the receiver instead of the regular gift; 0 if the gift can't be sold by the receiver
//@prepaid_upgrade_star_count Number of Telegram Stars that were paid by the sender for the ability to upgrade the gift
//@is_upgrade_separate True, if the upgrade was bought after the gift was sent. In this case, prepaid upgrade cost must not be added to the gift cost
//@is_private True, if the sender and gift text are shown only to the gift receiver; otherwise, everyone will be able to see them
//@is_saved True, if the gift is displayed on the user's or the channel's profile page; only for the receiver of the gift
//@is_prepaid_upgrade True, if the message is about prepaid upgrade of the gift by another user
@ -4607,7 +4676,7 @@ messageGiveawayPrizeStars star_count:int53 transaction_id:string boosted_chat_id
//@was_refunded True, if the gift was refunded and isn't available anymore
//@upgraded_received_gift_id Identifier of the corresponding upgraded gift; may be empty if unknown. Use getReceivedGift to get information about the gift
//@prepaid_upgrade_hash If non-empty, then the user can pay for an upgrade of the gift using buyGiftUpgrade
messageGift gift:gift sender_id:MessageSender receiver_id:MessageSender received_gift_id:string text:formattedText sell_star_count:int53 prepaid_upgrade_star_count:int53 is_private:Bool is_saved:Bool is_prepaid_upgrade:Bool can_be_upgraded:Bool was_converted:Bool was_upgraded:Bool was_refunded:Bool upgraded_received_gift_id:string prepaid_upgrade_hash:string = MessageContent;
messageGift gift:gift sender_id:MessageSender receiver_id:MessageSender received_gift_id:string text:formattedText sell_star_count:int53 prepaid_upgrade_star_count:int53 is_upgrade_separate:Bool is_private:Bool is_saved:Bool is_prepaid_upgrade:Bool can_be_upgraded:Bool was_converted:Bool was_upgraded:Bool was_refunded:Bool upgraded_received_gift_id:string prepaid_upgrade_hash:string = MessageContent;
//@description An upgraded gift was received or sent by the current user, or the current user was notified about a channel gift
//@gift The gift
@ -4628,8 +4697,8 @@ messageUpgradedGift gift:upgradedGift sender_id:MessageSender receiver_id:Messag
//@gift The gift
//@sender_id Sender of the gift
//@receiver_id Receiver of the gift
//@is_upgrade True, if the gift was obtained by upgrading of a previously received gift; otherwise, this is a transferred or resold gift
messageRefundedUpgradedGift gift:gift sender_id:MessageSender receiver_id:MessageSender is_upgrade:Bool = MessageContent;
//@origin Origin of the upgraded gift
messageRefundedUpgradedGift gift:gift sender_id:MessageSender receiver_id:MessageSender origin:UpgradedGiftOrigin = MessageContent;
//@description Paid messages were refunded @message_count The number of refunded messages @star_count The number of refunded Telegram Stars
messagePaidMessagesRefunded message_count:int32 star_count:int53 = MessageContent;
@ -6973,7 +7042,8 @@ storePaymentPurposeStarGiveaway parameters:giveawayParameters currency:string am
//@currency ISO 4217 currency code of the payment currency
//@amount Paid amount, in the smallest units of the currency
//@star_count Number of bought Telegram Stars
storePaymentPurposeStars currency:string amount:int53 star_count:int53 = StorePaymentPurpose;
//@chat_id Identifier of the chat that is supposed to receive the Telegram Stars; pass 0 if none
storePaymentPurposeStars currency:string amount:int53 star_count:int53 chat_id:int53 = StorePaymentPurpose;
//@description The user buying Telegram Stars for other users
//@user_id Identifier of the user to which Telegram Stars are gifted
@ -7026,7 +7096,8 @@ telegramPaymentPurposePremiumGiveaway parameters:giveawayParameters currency:str
//@currency ISO 4217 currency code of the payment currency
//@amount Paid amount, in the smallest units of the currency
//@star_count Number of bought Telegram Stars
telegramPaymentPurposeStars currency:string amount:int53 star_count:int53 = TelegramPaymentPurpose;
//@chat_id Identifier of the chat that is supposed to receive the Telegram Stars; pass 0 if none
telegramPaymentPurposeStars currency:string amount:int53 star_count:int53 chat_id:int53 = TelegramPaymentPurpose;
//@description The user buying Telegram Stars for other users
//@user_id Identifier of the user to which Telegram Stars are gifted
@ -7125,7 +7196,7 @@ backgroundTypePattern fill:BackgroundFill intensity:int32 is_inverted:Bool is_mo
//@description A filled background @fill The background fill
backgroundTypeFill fill:BackgroundFill = BackgroundType;
//@description A background from a chat theme; can be used only as a chat background in channels @theme_name Name of the chat theme
//@description A background from a chat theme based on an emoji; can be used only as a chat background in channels @theme_name Name of the emoji chat theme
backgroundTypeChatTheme theme_name:string = BackgroundType;
@ -7142,11 +7213,41 @@ inputBackgroundRemote background_id:int64 = InputBackground;
inputBackgroundPrevious message_id:int53 = InputBackground;
//@description Describes a chat theme
//@description Describes a chat theme based on an emoji
//@name Theme name
//@light_settings Theme settings for a light chat theme
//@dark_settings Theme settings for a dark chat theme
chatTheme name:string light_settings:themeSettings dark_settings:themeSettings = ChatTheme;
emojiChatTheme name:string light_settings:themeSettings dark_settings:themeSettings = EmojiChatTheme;
//@description Describes a chat theme based on an upgraded gift
//@gift The gift
//@light_settings Theme settings for a light chat theme
//@dark_settings Theme settings for a dark chat theme
giftChatTheme gift:upgradedGift light_settings:themeSettings dark_settings:themeSettings = GiftChatTheme;
//@description Contains a list of chat themes based on upgraded gifts
//@themes A list of chat themes
//@next_offset The offset for the next request. If empty, then there are no more results
giftChatThemes themes:vector<giftChatTheme> next_offset:string = GiftChatThemes;
//@class ChatTheme @description Describes a chat theme
//@description A chat theme based on an emoji @name Name of the theme; full theme description is received through updateEmojiChatThemes
chatThemeEmoji name:string = ChatTheme;
//@description A chat theme based on an upgraded gift @gift_theme The chat theme
chatThemeGift gift_theme:giftChatTheme = ChatTheme;
//@class InputChatTheme @description Describes a chat theme to set
//@description A theme based on an emoji @name Name of the theme
inputChatThemeEmoji name:string = InputChatTheme;
//@description A theme based on an upgraded gift @name Name of the upgraded gift. A gift can be used only in one chat in a time.
//-When the same gift is used in another chat, theme in the previous chat is reset to default
inputChatThemeGift name:string = InputChatTheme;
//@description Describes a time zone
@ -7270,8 +7371,8 @@ pushMessageContentAudio audio:audio is_pinned:Bool = PushMessageContent;
//@description A message with a user contact @name Contact's name @is_pinned True, if the message is a pinned message with the specified content
pushMessageContentContact name:string is_pinned:Bool = PushMessageContent;
//@description A contact has registered with Telegram
pushMessageContentContactRegistered = PushMessageContent;
//@description A contact has registered with Telegram @as_premium_account True, if the user joined Telegram as a Telegram Premium account
pushMessageContentContactRegistered as_premium_account:Bool = PushMessageContent;
//@description A document message (a general file) @document Message content; may be null @is_pinned True, if the message is a pinned message with the specified content
pushMessageContentDocument document:document is_pinned:Bool = PushMessageContent;
@ -7315,12 +7416,15 @@ pushMessageContentPremiumGiftCode month_count:int32 = PushMessageContent;
//@is_pinned True, if the message is a pinned message with the specified content
pushMessageContentGiveaway winner_count:int32 prize:GiveawayPrize is_pinned:Bool = PushMessageContent;
//@description A message with a gift @star_count Number of Telegram Stars that sender paid for the gift
pushMessageContentGift star_count:int53 = PushMessageContent;
//@description A message with a gift
//@star_count Number of Telegram Stars that sender paid for the gift
//@is_prepaid_upgrade True, if the message is about prepaid upgrade of the gift by another user instead of actual receiving of a new gift
pushMessageContentGift star_count:int53 is_prepaid_upgrade:Bool = PushMessageContent;
//@description A message with an upgraded gift
//@is_upgrade True, if the gift was obtained by upgrading of a previously received gift; otherwise, this is a transferred or resold gift
pushMessageContentUpgradedGift is_upgrade:Bool = PushMessageContent;
//@is_upgrade True, if the gift was obtained by upgrading of a previously received gift; otherwise, if is_prepaid_upgrade == false, then this is a transferred or resold gift
//@is_prepaid_upgrade True, if the message is about completion of prepaid upgrade of the gift instead of actual receiving of a new gift
pushMessageContentUpgradedGift is_upgrade:Bool is_prepaid_upgrade:Bool = PushMessageContent;
//@description A screenshot of a message in the chat has been taken
pushMessageContentScreenshotTaken = PushMessageContent;
@ -7383,8 +7487,8 @@ pushMessageContentChatChangeTitle title:string = PushMessageContent;
//@description A chat background was edited @is_same True, if the set background is the same as the background of the current user
pushMessageContentChatSetBackground is_same:Bool = PushMessageContent;
//@description A chat theme was edited @theme_name If non-empty, name of a new theme, set for the chat. Otherwise, the chat theme was reset to the default one
pushMessageContentChatSetTheme theme_name:string = PushMessageContent;
//@description A chat theme was edited @name If non-empty, human-readable name of the new theme. Otherwise, the chat theme was reset to the default one
pushMessageContentChatSetTheme name:string = PushMessageContent;
//@description A chat member was deleted
//@member_name Name of the deleted member
@ -8701,7 +8805,7 @@ chatRevenueTransaction cryptocurrency:string cryptocurrency_amount:int64 type:Ch
chatRevenueTransactions ton_amount:int53 transactions:vector<chatRevenueTransaction> next_offset:string = ChatRevenueTransactions;
//@description Contains information about Telegram Stars earned by a bot or a chat
//@description Contains information about Telegram Stars earned by a user or a chat
//@total_amount Total amount of Telegram Stars earned
//@current_amount The amount of Telegram Stars that aren't withdrawn yet
//@available_amount The amount of Telegram Stars that are available for withdrawal
@ -8709,12 +8813,25 @@ chatRevenueTransactions ton_amount:int53 transactions:vector<chatRevenueTransact
//@next_withdrawal_in Time left before the next withdrawal can be started, in seconds; 0 if withdrawal can be started now
starRevenueStatus total_amount:starAmount current_amount:starAmount available_amount:starAmount withdrawal_enabled:Bool next_withdrawal_in:int32 = StarRevenueStatus;
//@description A detailed statistics about Telegram Stars earned by a bot or a chat
//@description A detailed statistics about Telegram Stars earned by a user or a chat
//@revenue_by_day_graph A graph containing amount of revenue in a given day
//@status Telegram Star revenue status
//@usd_rate Current conversion rate of a Telegram Star to USD
starRevenueStatistics revenue_by_day_graph:StatisticalGraph status:starRevenueStatus usd_rate:double = StarRevenueStatistics;
//@description Contains information about Toncoins earned by the current user
//@total_amount Total amount of Toncoins earned; in the smallest units of the cryptocurrency
//@balance_amount Amount of Toncoins that aren't withdrawn yet; in the smallest units of the cryptocurrency
//@available_amount Amount of Toncoins that are available for withdrawal; in the smallest units of the cryptocurrency
//@withdrawal_enabled True, if Toncoins can be withdrawn
tonRevenueStatus total_amount:int64 balance_amount:int64 available_amount:int64 withdrawal_enabled:Bool = TonRevenueStatus;
//@description A detailed statistics about Toncoins earned by the current user
//@revenue_by_day_graph A graph containing amount of revenue in a given day
//@status Amount of earned revenue
//@usd_rate Current conversion rate of nanotoncoin to USD cents
tonRevenueStatistics revenue_by_day_graph:StatisticalGraph status:tonRevenueStatus usd_rate:double = TonRevenueStatistics;
//@description A point on a Cartesian plane @x The point's first coordinate @y The point's second coordinate
point x:double y:double = Point;
@ -8926,8 +9043,8 @@ updateChatReplyMarkup chat_id:int53 reply_markup_message_id:int53 = Update;
//@description The chat background was changed @chat_id Chat identifier @background The new chat background; may be null if background was reset to default
updateChatBackground chat_id:int53 background:chatBackground = Update;
//@description The chat theme was changed @chat_id Chat identifier @theme_name The new name of the chat theme; may be empty if theme was reset to default
updateChatTheme chat_id:int53 theme_name:string = Update;
//@description The chat theme was changed @chat_id Chat identifier @theme The new theme of the chat; may be null if theme was reset to default
updateChatTheme chat_id:int53 theme:ChatTheme = Update;
//@description The chat unread_mention_count has changed @chat_id Chat identifier @unread_mention_count The number of unread mention messages left in the chat
updateChatUnreadMentionCount chat_id:int53 unread_mention_count:int32 = Update;
@ -9235,8 +9352,8 @@ updateSavedNotificationSounds notification_sound_ids:vector<int64> = Update;
//@description The default background has changed @for_dark_theme True, if default background for dark theme has changed @background The new default background; may be null
updateDefaultBackground for_dark_theme:Bool background:background = Update;
//@description The list of available chat themes has changed @chat_themes The new list of chat themes
updateChatThemes chat_themes:vector<chatTheme> = Update;
//@description The list of available emoji chat themes has changed @chat_themes The new list of emoji chat themes
updateEmojiChatThemes chat_themes:vector<emojiChatTheme> = Update;
//@description The list of supported accent colors has changed
//@colors Information about supported colors; colors with identifiers 0 (red), 1 (orange), 2 (purple/violet), 3 (green), 4 (cyan), 5 (blue), 6 (pink) must always be supported
@ -9312,11 +9429,15 @@ updateOwnedTonCount ton_amount:int53 = Update;
//@revenue_amount New amount of earned revenue
updateChatRevenueAmount chat_id:int53 revenue_amount:chatRevenueAmount = Update;
//@description The Telegram Star revenue earned by a bot or a chat has changed. If Telegram Star transaction screen of the chat is opened, then getStarTransactions may be called to fetch new transactions
//@description The Telegram Star revenue earned by a user or a chat has changed. If Telegram Star transaction screen of the chat is opened, then getStarTransactions may be called to fetch new transactions
//@owner_id Identifier of the owner of the Telegram Stars
//@status New Telegram Star revenue status
updateStarRevenueStatus owner_id:MessageSender status:starRevenueStatus = Update;
//@description The Toncoin revenue earned by the current user has changed. If Toncoin transaction screen of the chat is opened, then getTonTransactions may be called to fetch new transactions
//@status New Toncoin revenue status
updateTonRevenueStatus status:tonRevenueStatus = Update;
//@description The parameters of speech recognition without Telegram Premium subscription has changed
//@max_media_duration The maximum allowed duration of media for speech recognition without Telegram Premium subscription, in seconds
//@weekly_count The total number of allowed speech recognitions per week; 0 if none
@ -11344,8 +11465,13 @@ setChatBackground chat_id:int53 background:InputBackground type:BackgroundType d
//-Supposed to be used from messageChatSetBackground messages with the currently set background that was set for both sides by the other user
deleteChatBackground chat_id:int53 restore_previous:Bool = Ok;
//@description Changes the chat theme. Supported only in private and secret chats @chat_id Chat identifier @theme_name Name of the new chat theme; pass an empty string to return the default theme
setChatTheme chat_id:int53 theme_name:string = Ok;
//@description Returns available to the current user gift chat themes
//@offset Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results
//@limit The maximum number of chat themes to return
getGiftChatThemes offset:string limit:int32 = GiftChatThemes;
//@description Changes the chat theme. Supported only in private and secret chats @chat_id Chat identifier @theme New chat theme; pass null to return the default theme
setChatTheme chat_id:int53 theme:InputChatTheme = Ok;
//@description Changes the draft message in a chat
//@chat_id Chat identifier
@ -12327,14 +12453,40 @@ setUserEmojiStatus user_id:int53 emoji_status:emojiStatus = Ok;
//@only_local Pass true to get only locally available information without sending network requests
searchUserByPhoneNumber phone_number:string only_local:Bool = User;
//@description Shares the phone number of the current user with a mutual contact. Supposed to be called when the user clicks on chatActionBarSharePhoneNumber @user_id Identifier of the user with whom to share the phone number. The user must be a mutual contact
//@description Shares the phone number of the current user with a mutual contact. Supposed to be called when the user clicks on chatActionBarSharePhoneNumber
//@user_id Identifier of the user with whom to share the phone number. The user must be a mutual contact
sharePhoneNumber user_id:int53 = Ok;
//@description Returns the profile photos of a user. Personal and public photo aren't returned @user_id User identifier @offset The number of photos to skip; must be non-negative @limit The maximum number of photos to be returned; up to 100
//@description Returns the profile photos of a user. Personal and public photo aren't returned
//@user_id User identifier
//@offset The number of photos to skip; must be non-negative
//@limit The maximum number of photos to be returned; up to 100
getUserProfilePhotos user_id:int53 offset:int32 limit:int32 = ChatPhotos;
//@description Returns the list of profile audio files of a user
//@user_id User identifier
//@offset The number of audio files to skip; must be non-negative
//@limit The maximum number of audio files to be returned; up to 100
getUserProfileAudios user_id:int53 offset:int32 limit:int32 = Audios;
//@description Checks whether a file is in the profile audio files of the current user. Returns a 404 error if it isn't @file_id Identifier of the audio file to check
isProfileAudio file_id:int32 = Ok;
//@description Adds an audio file to the beginning of the profile audio files of the current user
//@file_id Identifier of the audio file to be added. The file must have been uploaded to the server
addProfileAudio file_id:int32 = Ok;
//@description Changes position of an audio file in the profile audio files of the current user
//@file_id Identifier of the file from profile audio files, which position will be changed
//@after_file_id Identifier of the file from profile audio files after which the file will be positioned; pass 0 to move the file to the beginning of the list
setProfileAudioPosition file_id:int32 after_file_id:int32 = Ok;
//@description Removes an audio file from the profile audio files of the current user @file_id Identifier of the audio file to be removed
removeProfileAudio file_id:int32 = Ok;
//@description Returns outline of a sticker. This is an offline method. Returns a 404 error if the outline isn't known
//@sticker_file_id File identifier of the sticker
//@for_animated_emoji Pass true to get the outline scaled for animated emoji
@ -12553,6 +12705,9 @@ reorderActiveUsernames usernames:vector<string> = Ok;
//@description Changes the birthdate of the current user @birthdate The new value of the current user's birthdate; pass null to remove the birthdate
setBirthdate birthdate:birthdate = Ok;
//@description Changes the main profile tab of the current user @main_profile_tab The new value of the main profile tab
setMainProfileTab main_profile_tab:ProfileTab = Ok;
//@description Changes the personal chat of the current user @chat_id Identifier of the new personal chat; pass 0 to remove the chat. Use getSuitablePersonalChats to get suitable chats
setPersonalChat chat_id:int53 = Ok;
@ -12846,6 +13001,11 @@ setSupergroupCustomEmojiStickerSet supergroup_id:int53 custom_emoji_sticker_set_
//@unrestrict_boost_count New value of the unrestrict_boost_count supergroup setting; 0-8. Use 0 to remove the setting
setSupergroupUnrestrictBoostCount supergroup_id:int53 unrestrict_boost_count:int32 = Ok;
//@description Changes the main profile tab of the channel; requires can_change_info administrator right
//@supergroup_id Identifier of the channel
//@main_profile_tab The new value of the main profile tab
setSupergroupMainProfileTab supergroup_id:int53 main_profile_tab:ProfileTab = Ok;
//@description Toggles whether sender signature or link to the account is added to sent messages in a channel; requires can_change_info member right
//@supergroup_id Identifier of the channel
//@sign_messages New value of sign_messages
@ -12970,6 +13130,10 @@ setGiftSettings settings:giftSettings = Ok;
//@description Returns gifts that can be sent to other users and channel chats
getAvailableGifts = AvailableGifts;
//@description Checks whether a gift with next_send_date in the future can be sent already
//@gift_id Identifier of the gift to send
canSendGift gift_id:int64 = CanSendGiftResult;
//@description Sends a gift to another user or channel chat. May return an error with a message "STARGIFT_USAGE_LIMITED" if the gift was sold out
//@gift_id Identifier of the gift to send
//@owner_id Identifier of the user or the channel chat that will receive the gift; limited gifts can't be sent to channel chats
@ -13347,6 +13511,14 @@ getStarWithdrawalUrl owner_id:MessageSender star_count:int53 password:string = H
//@owner_id Identifier of the owner of the Telegram Stars; can be identifier of an owned bot, or identifier of an owned channel chat
getStarAdAccountUrl owner_id:MessageSender = HttpUrl;
//@description Returns detailed Toncoin revenue statistics of the current user @is_dark Pass true if a dark theme is used by the application
getTonRevenueStatistics is_dark:Bool = TonRevenueStatistics;
//@description Returns a URL for Toncoin withdrawal from the current user's account. The user must have at least 10 toncoins to withdraw
//-and can withdraw up to 100000 Toncoins in one transaction
//@password The 2-step verification password of the current user
getTonWithdrawalUrl password:string = HttpUrl;
//@description Returns detailed statistics about a chat. Currently, this method can be used only for supergroups and channels. Can be used only if supergroupFullInfo.can_get_statistics == true @chat_id Chat identifier @is_dark Pass true if a dark theme is used by the application
getChatStatistics chat_id:int53 is_dark:Bool = ChatStatistics;