astra/gotdlib
1
0
Fork 0
mirror of https://github.com/c0re100/gotdlib.git synced 2026-09-04 03:17:06 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update to TDLib 1.8.67

Browse source
This commit is contained in:
c0re100 2026-08-29 16:02:50 +08:00
parent 4dfe20c5c8
commit 4e279fb246
No known key found for this signature in database
GPG key ID: 7C3B3004FE745AAF
4 changed files with 1922 additions and 107 deletions
Download patch file Download diff file Expand all files Collapse all files

314
data/td_api.tl
View file

@ -185,7 +185,7 @@ termsOfService text:formattedText min_user_age:int32 show_popup:Bool = TermsOfSe
//@name Name of the passkey
//@addition_date Point in time (Unix timestamp) when the passkey was added
//@last_usage_date Point in time (Unix timestamp) when the passkey was used last time; 0 if never
//@software_icon_custom_emoji_id Identifier of the custom emoji that is used as the icon of the software, which created the passkey; 0 if unknown
//@software_icon_custom_emoji_id Identifier of the custom emoji that is used as the icon of the software that created the passkey; 0 if unknown
passkey id:string name:string addition_date:int32 last_usage_date:int32 software_icon_custom_emoji_id:int64 = Passkey;
//@description Contains a list of passkeys @passkeys List of passkeys
@ -458,7 +458,7 @@ pollOption id:string text:formattedText media:PollMedia voter_count:int32 vote_p
//@description Describes one answer option of a poll to be created
//@text Option text; 1-100 characters. Only custom emoji entities are allowed to be added and only by Premium users
//@media Option media; pass null if none; ignored in addPollOption. Must be one of the following types:
//@media Option media; pass null if none. Must be one of the following types:
//-inputPollMediaAnimation, inputPollMediaLink, inputPollMediaLocation, inputPollMediaPhoto, inputPollMediaSticker, inputPollMediaVenue, or inputPollMediaVideo without caption
inputPollOption text:formattedText media:InputPollMedia = InputPollOption;
@ -1091,8 +1091,9 @@ chatPermissions can_send_basic_messages:Bool can_send_audios:Bool can_send_docum
//@can_delete_stories True, if the administrator can delete stories posted by other users; applicable to supergroups and channels only
//@can_manage_direct_messages True, if the administrator can answer to channel direct messages; applicable to channels only
//@can_manage_tags True, if the administrator can change tags of other users; applicable to basic groups and supergroups only
//@can_send_welcome_messages True, if the administrator can manage and send welcome messages
//@is_anonymous True, if the administrator isn't shown in the chat member list and sends messages anonymously; applicable to supergroups only
chatAdministratorRights can_manage_chat:Bool can_change_info:Bool can_post_messages:Bool can_edit_messages:Bool can_delete_messages:Bool can_invite_users:Bool can_restrict_members:Bool can_pin_messages:Bool can_manage_topics:Bool can_promote_members:Bool can_manage_video_chats:Bool can_post_stories:Bool can_edit_stories:Bool can_delete_stories:Bool can_manage_direct_messages:Bool can_manage_tags:Bool is_anonymous:Bool = ChatAdministratorRights;
chatAdministratorRights can_manage_chat:Bool can_change_info:Bool can_post_messages:Bool can_edit_messages:Bool can_delete_messages:Bool can_invite_users:Bool can_restrict_members:Bool can_pin_messages:Bool can_manage_topics:Bool can_promote_members:Bool can_manage_video_chats:Bool can_post_stories:Bool can_edit_stories:Bool can_delete_stories:Bool can_manage_direct_messages:Bool can_manage_tags:Bool can_send_welcome_messages:Bool is_anonymous:Bool = ChatAdministratorRights;
//@description Contains parameters of the application theme
@ -1382,7 +1383,7 @@ premiumGiftPaymentOptions options:vector<premiumGiftPaymentOption> = PremiumGift
//@description Describes an option for creating of Telegram Premium giveaway or manual distribution of Telegram Premium among chat members. Use telegramPaymentPurposePremiumGiftCodes or telegramPaymentPurposePremiumGiveaway for out-of-store payments
//@currency ISO 4217 currency code for Telegram Premium gift code payment
//@amount The amount to pay, in the smallest units of the currency
//@winner_count Number of users which will be able to activate the gift codes
//@winner_count Number of users who will be able to activate the gift codes
//@month_count Number of months the Telegram Premium subscription will be active
//@store_product_id Identifier of the store product associated with the option; may be empty if none
//@store_product_quantity Number of times the store product must be paid
@ -2263,6 +2264,9 @@ profileAccentColors palette_colors:vector<int32> background_colors:vector<int32>
profileAccentColor id:int32 light_theme_colors:profileAccentColors dark_theme_colors:profileAccentColors min_supergroup_chat_boost_level:int32 min_channel_chat_boost_level:int32 = ProfileAccentColor;
//@description Contains identifier of a community @id Community identifier
communityId id:int53 = CommunityId;
//@description Describes actions that a user is allowed to take in a community
//@can_edit_chat_list True, if the user can change the chats added to the community
communityPermissions can_edit_chat_list:Bool = CommunityPermissions;
@ -2304,6 +2308,20 @@ communityMemberStatusBanned = CommunityMemberStatus;
//@permissions Actions that non-administrator community members are allowed to take in the community
community id:int53 have_access:Bool name:string photo:chatPhotoInfo date:int32 status:CommunityMemberStatus permissions:communityPermissions = Community;
//@description Describes a chat in a community
//@chat_id Identifier of the chat in the community
//@can_view_history True, if message history of the chat can be viewed
//@is_hidden True, if the chat is hidden in the list of community chats; for community administrators only
communityChat chat_id:int53 can_view_history:Bool is_hidden:Bool = CommunityChat;
//@description Contains full information about a community
//@photo Photo of the community
//@chats Chats belonging to the community
//@administrator_count Number of privileged users in the community; 0 if the current user isn't an administrator of the community
//@banned_count Number of users banned from the community; 0 if the current user isn't an administrator of the community
//@add_chat_request_count Number of pending requests for addition of chats to the community; 0 if the current user isn't an administrator of the community
communityFullInfo photo:chatPhoto chats:vector<communityChat> administrator_count:int32 banned_count:int32 add_chat_request_count:int32 = CommunityFullInfo;
//@description Contains description of user rating
//@level The level of the user; may be negative
@ -2527,7 +2545,7 @@ chatMembersFilterAdministrators = ChatMembersFilter;
//@description Returns all chat members, including restricted chat members
chatMembersFilterMembers = ChatMembersFilter;
//@description Returns users which can be mentioned in the chat @topic_id Identifier of the topic in which the users will be mentioned; pass null if none
//@description Returns users who can be mentioned in the chat @topic_id Identifier of the topic in which the users will be mentioned; pass null if none
chatMembersFilterMention topic_id:MessageTopic = ChatMembersFilter;
//@description Returns users under certain restrictions in the chat; can be used only by administrators in a supergroup
@ -2545,7 +2563,7 @@ chatMembersFilterBots = ChatMembersFilter;
//@description Returns recently active users in reverse chronological order
supergroupMembersFilterRecent = SupergroupMembersFilter;
//@description Returns contacts of the user, which are members of the supergroup or channel @query Query to search for
//@description Returns contacts of the current user who are members of the supergroup or channel @query Query to search for
supergroupMembersFilterContacts query:string = SupergroupMembersFilter;
//@description Returns the owner and administrators
@ -2560,7 +2578,7 @@ supergroupMembersFilterRestricted query:string = SupergroupMembersFilter;
//@description Returns users banned from the supergroup or channel; can be used only by administrators @query Query to search for
supergroupMembersFilterBanned query:string = SupergroupMembersFilter;
//@description Returns users which can be mentioned in the supergroup @query Query to search for @topic_id Identifier of the topic in which the users will be mentioned; pass null if none
//@description Returns users who can be mentioned in the supergroup @query Query to search for @topic_id Identifier of the topic in which the users will be mentioned; pass null if none
supergroupMembersFilterMention query:string topic_id:MessageTopic = SupergroupMembersFilter;
//@description Returns bot members of the supergroup or channel
@ -2872,7 +2890,7 @@ messageViewers viewers:vector<messageViewer> = MessageViewers;
//@description The message was originally sent by a known user @sender_user_id Identifier of the user who originally sent the message
messageOriginUser sender_user_id:int53 = MessageOrigin;
//@description The message was originally sent by a user, which is hidden by their privacy settings @sender_name Name of the sender
//@description The message was originally sent by a user who is hidden by their privacy settings @sender_name Name of the sender
messageOriginHiddenUser sender_name:string = MessageOrigin;
//@description The message was originally sent on behalf of a chat
@ -3095,6 +3113,13 @@ inputMessageReplyToEphemeralMessage ephemeral_message_id:int32 = InputMessageRep
//@country_code A two-letter ISO 3166-1 alpha-2 country code of the country for which the fact-check is shown
factCheck text:formattedText country_code:string = FactCheck;
//@description Describes an ephemeral content of a regular message, which must be shown instead of the regular content
//@can_be_saved True, if content of the message can be saved locally
//@has_timestamped_media True, if media timestamp entities refers to a media in this message as opposed to a media in the replied message
//@content Content of the message
//@reply_markup Reply markup for the message; may be null if none
ephemeralMessageContent can_be_saved:Bool has_timestamped_media:Bool content:MessageContent reply_markup:ReplyMarkup = EphemeralMessageContent;
//@description Describes a message
//@id Message identifier; unique for the chat to which the message belongs
@ -3139,9 +3164,11 @@ factCheck text:formattedText country_code:string = FactCheck;
//@restriction_info Information about the restrictions that must be applied to the message content; may be null if none
//@summary_language_code IETF language tag of the message language on which it can be summarized; empty if summary isn't available for the message
//@content Content of the message
//@ephemeral_content Content of the message, which is visible only to the current user and must be shown instead of the regular content; may be null if none
//@reply_markup Reply markup for the message; may be null if none
//@ephemeral_message_id Unique identifier of the ephemeral message if the message is ephemeral; for bots only
message id:int53 sender_id:MessageSender receiver_id:MessageSender chat_id:int53 sending_state:MessageSendingState scheduling_state:MessageSchedulingState is_outgoing:Bool is_pinned:Bool is_from_offline:Bool can_be_saved:Bool has_timestamped_media:Bool is_channel_post:Bool is_paid_star_suggested_post:Bool is_paid_gram_suggested_post:Bool contains_unread_mention:Bool contains_unread_poll_votes:Bool date:int32 edit_date:int32 forward_info:messageForwardInfo import_info:messageImportInfo interaction_info:messageInteractionInfo unread_reactions:vector<unreadReaction> fact_check:factCheck suggested_post_info:suggestedPostInfo reply_to:MessageReplyTo topic_id:MessageTopic self_destruct_type:MessageSelfDestructType self_destruct_in:double auto_delete_in:double via_bot_user_id:int53 guest_bot_caller_id:MessageSender sender_business_bot_user_id:int53 sender_boost_count:int32 sender_tag:string paid_message_star_count:int53 author_signature:string media_album_id:int64 effect_id:int64 restriction_info:restrictionInfo summary_language_code:string content:MessageContent reply_markup:ReplyMarkup ephemeral_message_id:int32 = Message;
//@chat_instance Identifier that uniquely corresponds to the chat to which the message was sent; for bots only
message id:int53 sender_id:MessageSender receiver_id:MessageSender chat_id:int53 sending_state:MessageSendingState scheduling_state:MessageSchedulingState is_outgoing:Bool is_pinned:Bool is_from_offline:Bool can_be_saved:Bool has_timestamped_media:Bool is_channel_post:Bool is_paid_star_suggested_post:Bool is_paid_gram_suggested_post:Bool contains_unread_mention:Bool contains_unread_poll_votes:Bool date:int32 edit_date:int32 forward_info:messageForwardInfo import_info:messageImportInfo interaction_info:messageInteractionInfo unread_reactions:vector<unreadReaction> fact_check:factCheck suggested_post_info:suggestedPostInfo reply_to:MessageReplyTo topic_id:MessageTopic self_destruct_type:MessageSelfDestructType self_destruct_in:double auto_delete_in:double via_bot_user_id:int53 guest_bot_caller_id:MessageSender sender_business_bot_user_id:int53 sender_boost_count:int32 sender_tag:string paid_message_star_count:int53 author_signature:string media_album_id:int64 effect_id:int64 restriction_info:restrictionInfo summary_language_code:string content:MessageContent ephemeral_content:ephemeralMessageContent reply_markup:ReplyMarkup ephemeral_message_id:int32 chat_instance:int64 = Message;
//@description Contains a list of messages @total_count Approximate total number of messages found @messages List of messages; messages may be null
@ -3382,9 +3409,12 @@ reactionNotificationSettings message_reaction_source:ReactionNotificationSource
//@link_preview_options Options to be used for generation of a link preview; may be null if none; pass null to use default link preview options
draftMessageContentText text:formattedText link_preview_options:linkPreviewOptions = DraftMessageContent;
//@description A rich message draft; not supported in setChatDraftMessage @message The rich message; the message must not have not yet uploaded media
//@description A rich message draft; not supported in setChatDraftMessage @message The rich message
draftMessageContentRichMessage message:richMessage = DraftMessageContent;
//@description A rich message draft; only for setChatDraftMessage @message The rich message
draftMessageContentInputRichMessage message:inputRichMessage = DraftMessageContent;
//@description A video note message draft
//@file_path Path to the file with the video note
//@duration Duration of the video, in seconds; 0-60
@ -3576,6 +3606,7 @@ videoChat group_call_id:int32 has_participants:Bool default_participant_id:Messa
//@is_marked_as_unread True, if the chat is marked as unread
//@view_as_topics True, if the chat is a forum supergroup that must be shown in the "View as topics" mode, or Saved Messages chat that must be shown in the "View as chats"
//@has_scheduled_messages True, if the chat has scheduled messages
//@has_welcome_messages True, if the chat has welcome messages; for chat administrators with can_change_info administrator right only
//@can_be_deleted_only_for_self True, if the chat messages can be deleted only for the current user while other users will continue to see the messages
//@can_be_deleted_for_all_users True, if the chat messages can be deleted for all users
//@can_be_reported True, if the chat can be reported to Telegram moderators through reportChat or reportChatPhoto
@ -3599,7 +3630,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 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 upgraded_gift_colors:upgradedGiftColors 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 unread_poll_vote_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;
chat id:int53 type:ChatType title:string photo:chatPhotoInfo accent_color_id:int32 background_custom_emoji_id:int64 upgraded_gift_colors:upgradedGiftColors 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 has_welcome_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 unread_poll_vote_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;
@ -3679,6 +3710,9 @@ buttonStyleDanger = ButtonStyle;
//@description The button has green color
buttonStyleSuccess = ButtonStyle;
//@description The button must be shown as a link. The style is allowed only for callback buttons in inlineButton
buttonStyleLink = ButtonStyle;
//@class KeyboardButtonType @description Describes a keyboard button type
@ -3745,7 +3779,10 @@ keyboardButton text:string icon_custom_emoji_id:int64 style:ButtonStyle type:Key
//@description A button that opens a specified URL @url HTTP or tg:// URL to open. If the link is of the type internalLinkTypeWebApp, then the button must be marked as a Web App button
inlineKeyboardButtonTypeUrl url:string = InlineKeyboardButtonType;
//@description A button that opens a specified URL and automatically authorize the current user by calling getLoginUrlInfo @url An HTTP URL to pass to getLoginUrlInfo @id Unique button identifier @forward_text If non-empty, new text of the button in forwarded messages
//@description A button that opens a specified URL and automatically authorize the current user by calling getLoginUrlInfo; not supported in ephemeral messages
//@url An HTTP URL to pass to getLoginUrlInfo
//@id Unique button identifier
//@forward_text If non-empty, new text of the button in forwarded messages
inlineKeyboardButtonTypeLoginUrl url:string id:int53 forward_text:string = InlineKeyboardButtonType;
//@description A button that opens a Web App by calling openWebApp @url An HTTP URL to pass to openWebApp
@ -3772,6 +3809,9 @@ inlineKeyboardButtonTypeUser user_id:int53 = InlineKeyboardButtonType;
//@description A button that copies specified text to clipboard @text The text to copy to clipboard
inlineKeyboardButtonTypeCopyText text:string = InlineKeyboardButtonType;
//@description A disabled button
inlineKeyboardButtonTypeDisabled = InlineKeyboardButtonType;
//@class KeyboardButtonSource @description Describes source of a keyboard button
@ -3811,12 +3851,14 @@ replyMarkupForceReply is_personal:Bool input_field_placeholder:string = ReplyMar
//@resize_keyboard True, if the application needs to resize the keyboard vertically
//@one_time True, if the application needs to hide the keyboard after use
//@is_personal True, if the keyboard must automatically be shown to the current user. For outgoing messages, specify true to show the keyboard only for the mentioned users and for the target user of a reply
//@force_reply True, if the keyboard must force reply to the message with the keyboard
//@input_field_placeholder If non-empty, the placeholder to be shown in the input field when the keyboard is active; 0-64 characters
replyMarkupShowKeyboard rows:vector<vector<keyboardButton>> is_persistent:Bool resize_keyboard:Bool one_time:Bool is_personal:Bool input_field_placeholder:string = ReplyMarkup;
replyMarkupShowKeyboard rows:vector<vector<keyboardButton>> is_persistent:Bool resize_keyboard:Bool one_time:Bool is_personal:Bool force_reply:Bool input_field_placeholder:string = ReplyMarkup;
//@description Contains an inline keyboard layout
//@rows A list of rows of inline keyboard buttons
replyMarkupInlineKeyboard rows:vector<vector<inlineKeyboardButton>> = ReplyMarkup;
//@force_reply True, if a reply to the message must be forced when the message is received
replyMarkupInlineKeyboard rows:vector<vector<inlineKeyboardButton>> force_reply:Bool = ReplyMarkup;
//@class LoginUrlInfo @description Contains information about an inline button of type inlineKeyboardButtonTypeLoginUrl or an external link
@ -3984,6 +4026,16 @@ builtInThemeArctic = BuiltInTheme;
themeSettings base_theme:BuiltInTheme accent_color:int32 background:background outgoing_message_fill:BackgroundFill animate_outgoing_message_fill:Bool outgoing_message_accent_color:int32 = ThemeSettings;
//@description Represents a button inside a rich message
//@text Text of the button; only richTexts, richTextPlain, and richTextCustomEmoji are allowed
//@style Style of the button
//@type Type of the button; must be one of inlineKeyboardButtonTypeUrl, inlineKeyboardButtonTypeLoginUrl, inlineKeyboardButtonTypeWebApp, inlineKeyboardButtonTypeCallback,
//-inlineKeyboardButtonTypeSwitchInline, inlineKeyboardButtonTypeUser, inlineKeyboardButtonTypeCopyText. Additionally,
//-inlineKeyboardButtonTypeCallbackWithPassword and inlineKeyboardButtonTypeDisabled may be received in incoming messages. Regular users may use only inlineKeyboardButtonTypeUrl,
//-inlineKeyboardButtonTypeUser and inlineKeyboardButtonTypeCopyText
inlineButton text:RichText style:ButtonStyle type:InlineKeyboardButtonType = InlineButton;
//@class RichText @description Describes a formatted text object
//@description A plain text @text Text
@ -4061,6 +4113,9 @@ richTextIcon document:document width:int32 height:int32 = RichText;
//@description A mathematical expression @expression The expression in LaTeX format
richTextMathematicalExpression expression:string = RichText;
//@description A button @button The button
richTextButton button:inlineButton = RichText;
//@description A rich text replacing another rich text; not supported in inputRichMessage @text Text @old_text The old text
richTextDiff text:RichText old_text:RichText = RichText;
@ -4195,6 +4250,11 @@ pageBlockList items:vector<pageBlockListItem> = PageBlock;
//@credit Quote credit; may be null if none
pageBlockBlockQuote blocks:vector<PageBlock> credit:RichText = PageBlock;
//@description An expandable block quote
//@text Text of the quote
//@credit Quote credit; may be null if none
pageBlockExpandableBlockQuote text:RichText credit:RichText = PageBlock;
//@description A pull quote
//@text Quote text
//@credit Quote credit; may be null if none
@ -4208,10 +4268,15 @@ pageBlockPullQuote text:RichText credit:RichText = PageBlock;
pageBlockAnimation animation:animation caption:pageBlockCaption need_autoplay:Bool has_spoiler:Bool = PageBlock;
//@description An audio file
//@audio Audio file; may be null
//@audio Audio file
//@caption Audio file caption; may be null if none
pageBlockAudio audio:audio caption:pageBlockCaption = PageBlock;
//@description A general file
//@document The file
//@caption File caption; may be null if none
pageBlockDocument document:document caption:pageBlockCaption = PageBlock;
//@description A photo
//@photo Photo file; may be null
//@caption Photo caption; may be null if none
@ -4228,7 +4293,7 @@ pageBlockPhoto photo:photo caption:pageBlockCaption url:string has_spoiler:Bool
pageBlockVideo video:video caption:pageBlockCaption need_autoplay:Bool is_looped:Bool has_spoiler:Bool = PageBlock;
//@description A voice note
//@voice_note Voice note; may be null
//@voice_note Voice note
//@caption Voice note caption; may be null if none
pageBlockVoiceNote voice_note:voiceNote caption:pageBlockCaption = PageBlock;
@ -4277,7 +4342,8 @@ pageBlockChatLink title:string photo:chatPhotoInfo accent_color_id:int32 usernam
//@cells Table cells
//@is_bordered True, if the table is bordered
//@is_striped True, if the table is striped
pageBlockTable caption:RichText cells:vector<vector<pageBlockTableCell>> is_bordered:Bool is_striped:Bool = PageBlock;
//@is_compact True, if table cells must have smaller indents
pageBlockTable caption:RichText cells:vector<vector<pageBlockTableCell>> is_bordered:Bool is_striped:Bool is_compact:Bool = PageBlock;
//@description A collapsible block
//@header Always visible heading for the block
@ -4298,6 +4364,14 @@ pageBlockRelatedArticles header:RichText articles:vector<pageBlockRelatedArticle
//@caption Block caption; may be null if none
pageBlockMap location:location zoom:int32 width:int32 height:int32 caption:pageBlockCaption = PageBlock;
//@description A list of buttons shown in a row
//@buttons The buttons
//@align Horizontal alignment of the buttons; may be null if the buttons must be shown full-width
pageBlockButtonRow buttons:vector<inlineButton> align:PageBlockHorizontalAlignment = PageBlock;
//@description Represents a block unsupported by the current application version
pageBlockUnsupported = PageBlock;
//@description Describes an instant view page for a web page
//@blocks Content of the instant view page
@ -5282,6 +5356,9 @@ messageChatJoinByLink = MessageContent;
//@description A new member was accepted to the chat by an administrator
messageChatJoinByRequest = MessageContent;
//@description A new member joined the chat from a community @community_id Identifier of the community from which the user joined the chat
messageChatJoinFromCommunity community_id:int53 = MessageContent;
//@description A chat member was deleted @user_id User identifier of the deleted chat member
messageChatDeleteMember user_id:int53 = MessageContent;
@ -5348,8 +5425,10 @@ messageCustomServiceAction text:string = MessageContent;
//@description A new high score was achieved in a game @game_message_id Identifier of the message with the game, can be an identifier of a deleted message @game_id Identifier of the game; may be different from the games presented in the message with the game @score New score
messageGameScore game_message_id:int53 game_id:int64 score:int32 = MessageContent;
//@description A bot managed by another bot was created by the user @bot_user_id User identifier of the created bot
messageManagedBotCreated bot_user_id:int53 = MessageContent;
//@description A bot managed by another bot was created by the user
//@bot_user_id User identifier of the created bot
//@manager_bot_user_id Identifier of the bot which will manage the new bot
messageManagedBotCreated bot_user_id:int53 manager_bot_user_id:int53 = MessageContent;
//@description A payment has been sent to a bot or a business account
//@invoice_chat_id Identifier of the chat, containing the corresponding invoice message
@ -5418,7 +5497,7 @@ messageGiveawayCreated star_count:int53 = MessageContent;
//@description A giveaway
//@parameters Giveaway parameters
//@winner_count Number of users which will receive Telegram Premium subscription gift codes
//@winner_count Number of users who will receive Telegram Premium subscription gift codes
//@prize Prize of the giveaway
//@sticker A sticker to be shown in the message; may be null if unknown
messageGiveaway parameters:giveawayParameters winner_count:int32 prize:GiveawayPrize sticker:sticker = MessageContent;
@ -5462,7 +5541,7 @@ messageGiftedStars gifter_user_id:int53 receiver_user_id:int53 currency:string a
//@gram_amount The received Gram amount, in the smallest units of the cryptocurrency
//@transaction_id Identifier of the transaction for Gram credit; for receiver only
//@sticker A sticker to be shown in the message; may be null if unknown
messageGiftedTon gifter_user_id:int53 receiver_user_id:int53 gram_amount:int53 transaction_id:string sticker:sticker = MessageContent;
messageGiftedGrams gifter_user_id:int53 receiver_user_id:int53 gram_amount:int53 transaction_id:string sticker:sticker = MessageContent;
//@description Telegram Stars were received by the current user from a giveaway
//@star_count Number of Telegram Stars that were received
@ -5501,6 +5580,8 @@ messageGift gift:gift sender_id:MessageSender receiver_id:MessageSender received
//@receiver_id Receiver of the gift
//@origin Origin of the upgraded gift
//@received_gift_id Unique identifier of the received gift for the current user; only for the receiver of the gift
//@text Message added to the gift
//@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
//@can_be_transferred True, if the gift can be transferred to another owner; only for the receiver of the gift
//@was_transferred True, if the gift has already been transferred to another owner; only for the receiver of the gift
@ -5510,7 +5591,7 @@ messageGift gift:gift sender_id:MessageSender receiver_id:MessageSender received
//@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 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
//@craft_date Point in time (Unix timestamp) when the gift can be used to craft another gift; can be in the past; only for the receiver of the gift
messageUpgradedGift gift:upgradedGift sender_id:MessageSender receiver_id:MessageSender origin:UpgradedGiftOrigin received_gift_id:string is_saved:Bool can_be_transferred:Bool was_transferred:Bool transfer_star_count:int53 drop_original_details_star_count:int53 next_transfer_date:int32 next_resale_date:int32 export_date:int32 craft_date:int32 = MessageContent;
messageUpgradedGift gift:upgradedGift sender_id:MessageSender receiver_id:MessageSender origin:UpgradedGiftOrigin received_gift_id:string text:formattedText is_private:Bool is_saved:Bool can_be_transferred:Bool was_transferred:Bool transfer_star_count:int53 drop_original_details_star_count:int53 next_transfer_date:int32 next_resale_date:int32 export_date:int32 craft_date:int32 = MessageContent;
//@description A gift which purchase, upgrade or transfer were refunded
//@gift The gift
@ -5586,7 +5667,7 @@ messageSuggestedPostRefunded suggested_post_message_id:int53 reason:SuggestedPos
//@description A contact has registered with Telegram
messageContactRegistered = MessageContent;
//@description The current user shared users, which were requested by the bot @users The shared users @button_id Identifier of the keyboard button with the request
//@description The current user shared users who were requested by the bot @users The shared users @button_id Identifier of the keyboard button with the request
messageUsersShared users:vector<sharedUser> button_id:int32 = MessageContent;
//@description The current user shared a chat, which was requested by the bot @chat The shared chat @button_id Identifier of the keyboard button with the request
@ -5929,6 +6010,9 @@ inputPageBlockList items:vector<inputPageBlockListItem> = InputPageBlock;
//@description A block quote @blocks Quote blocks @credit Quote credit; pass null if none
inputPageBlockBlockQuote blocks:vector<InputPageBlock> credit:RichText = InputPageBlock;
//@description An expandable block quote @text Quote text @credit Quote credit; pass null if none
inputPageBlockExpandableBlockQuote text:RichText credit:RichText = InputPageBlock;
//@description A pull quote @text Quote text @credit Quote credit; pass null if none
inputPageBlockPullQuote text:RichText credit:RichText = InputPageBlock;
@ -5941,6 +6025,9 @@ inputPageBlockAnimation animation:inputAnimation caption:pageBlockCaption has_sp
//@description An audio file @audio The audio to be sent @caption Audio file caption; pass null if none
inputPageBlockAudio audio:inputAudio caption:pageBlockCaption = InputPageBlock;
//@description A general file @document The file to be sent @caption File caption; pass null if none
inputPageBlockDocument document:inputDocument caption:pageBlockCaption = InputPageBlock;
//@description A photo
//@photo The photo to be sent
//@caption Photo caption; pass null if none
@ -5965,9 +6052,10 @@ inputPageBlockSlideshow blocks:vector<InputPageBlock> caption:pageBlockCaption =
//@description A table
//@caption Table caption
//@cells Table cells
//@is_bordered True, if the table is bordered
//@is_striped True, if the table is striped
inputPageBlockTable caption:RichText cells:vector<vector<pageBlockTableCell>> is_bordered:Bool is_striped:Bool = InputPageBlock;
//@is_bordered Pass true if the table is bordered
//@is_striped Pass true if the table is striped
//@is_compact Pass true if table cells must have smaller indents
inputPageBlockTable caption:RichText cells:vector<vector<pageBlockTableCell>> is_bordered:Bool is_striped:Bool is_compact:Bool = InputPageBlock;
//@description A collapsible block
//@header Always visible heading for the block
@ -5983,6 +6071,11 @@ inputPageBlockDetails header:RichText blocks:vector<InputPageBlock> is_open:Bool
//@caption Block caption; pass null if none
inputPageBlockMap location:location zoom:int32 width:int32 height:int32 caption:pageBlockCaption = InputPageBlock;
//@description A list of buttons shown in a row
//@buttons The buttons
//@align Horizontal alignment of the buttons; pass null if the buttons must be shown full-width
inputPageBlockButtonRow buttons:vector<inlineButton> align:PageBlockHorizontalAlignment = InputPageBlock;
//@class InputMessageContent @description The content of a message to send
@ -6253,6 +6346,9 @@ searchMessagesChatTypeFilterGroup = SearchMessagesChatTypeFilter;
//@description Returns only messages in channel chats
searchMessagesChatTypeFilterChannel = SearchMessagesChatTypeFilter;
//@description Returns only messages in the specified community @community_id Identifier of the community to search in
searchMessagesChatTypeFilterCommunity community_id:int53 = SearchMessagesChatTypeFilter;
//@class SearchChatTypeFilter @description Represents a filter for type of the chats to search for
@ -6743,6 +6839,12 @@ quickReplyMessages messages:vector<quickReplyMessage> = QuickReplyMessages;
quickReplyShortcut id:int32 name:string first_message:quickReplyMessage message_count:int32 = QuickReplyShortcut;
//@description Describes a set up welcome message
//@id Welcome message identifier; unique for the chat to which the welcome message belongs
//@content Content of the welcome message
welcomeMessage id:int32 content:MessageContent = WelcomeMessage;
//@class PublicForward @description Describes a public forward or repost of a story
//@description Contains a public forward as a message @message Information about the message
@ -6827,7 +6929,7 @@ chatBoostSourcePremium user_id:int53 = ChatBoostSource;
//@description Describes a prepaid giveaway
//@id Unique identifier of the prepaid giveaway
//@winner_count Number of users which will receive giveaway prize
//@winner_count Number of users who will receive giveaway prize
//@prize Prize of the giveaway
//@boost_count The number of boosts received by the chat from the giveaway; for Telegram Star giveaways only
//@payment_date Point in time (Unix timestamp) when the giveaway was paid
@ -8180,7 +8282,7 @@ storePaymentPurposePremiumSubscription is_restore:Bool is_upgrade:Bool = StorePa
//@description The user gifting Telegram Premium to another user
//@currency ISO 4217 currency code of the payment currency
//@amount Paid amount, in the smallest units of the currency
//@user_id Identifiers of the user which will receive Telegram Premium
//@user_id Identifier of the user who will receive Telegram Premium
//@text Text to show along with the gift codes; 0-getOption("gift_text_length_max") characters. Only Bold, Italic, Underline, Strikethrough, Spoiler, CustomEmoji, and DateTime entities are allowed
storePaymentPurposePremiumGift currency:string amount:int53 user_id:int53 text:formattedText = StorePaymentPurpose;
@ -8188,7 +8290,7 @@ storePaymentPurposePremiumGift currency:string amount:int53 user_id:int53 text:f
//@boosted_chat_id Identifier of the supergroup or channel chat, which will be automatically boosted by the users for duration of the Premium subscription and which is administered by the user
//@currency ISO 4217 currency code of the payment currency
//@amount Paid amount, in the smallest units of the currency
//@user_ids Identifiers of the users which can activate the gift codes
//@user_ids Identifiers of the users who can activate the gift codes
//@text Text to show along with the gift codes; 0-getOption("gift_text_length_max") characters. Only Bold, Italic, Underline, Strikethrough, Spoiler, CustomEmoji, and DateTime entities are allowed
storePaymentPurposePremiumGiftCodes boosted_chat_id:int53 currency:string amount:int53 user_ids:vector<int53> text:formattedText = StorePaymentPurpose;
@ -8238,7 +8340,7 @@ storeTransactionGooglePlay package_name:string store_product_id:string purchase_
//@description The user gifting Telegram Premium to another user
//@currency ISO 4217 currency code of the payment currency, or "XTR" for payments in Telegram Stars
//@amount Paid amount, in the smallest units of the currency
//@user_id Identifier of the user which will receive Telegram Premium
//@user_id Identifier of the user who will receive Telegram Premium
//@month_count Number of months the Telegram Premium subscription will be active for the user
//@text Text to show to the user receiving Telegram Premium; 0-getOption("gift_text_length_max") characters. Only Bold, Italic, Underline, Strikethrough, Spoiler, CustomEmoji, and DateTime entities are allowed
telegramPaymentPurposePremiumGift currency:string amount:int53 user_id:int53 month_count:int32 text:formattedText = TelegramPaymentPurpose;
@ -8247,7 +8349,7 @@ telegramPaymentPurposePremiumGift currency:string amount:int53 user_id:int53 mon
//@boosted_chat_id Identifier of the supergroup or channel chat, which will be automatically boosted by the users for duration of the Premium subscription and which is administered by the user
//@currency ISO 4217 currency code of the payment currency
//@amount Paid amount, in the smallest units of the currency
//@user_ids Identifiers of the users which can activate the gift codes
//@user_ids Identifiers of the users who can activate the gift codes
//@month_count Number of months the Telegram Premium subscription will be active for the users
//@text Text to show along with the gift codes; 0-getOption("gift_text_length_max") characters. Only Bold, Italic, Underline, Strikethrough, Spoiler, CustomEmoji, and DateTime entities are allowed
telegramPaymentPurposePremiumGiftCodes boosted_chat_id:int53 currency:string amount:int53 user_ids:vector<int53> month_count:int32 text:formattedText = TelegramPaymentPurpose;
@ -8256,7 +8358,7 @@ telegramPaymentPurposePremiumGiftCodes boosted_chat_id:int53 currency:string amo
//@parameters Giveaway parameters
//@currency ISO 4217 currency code of the payment currency
//@amount Paid amount, in the smallest units of the currency
//@winner_count Number of users which will be able to activate the gift codes
//@winner_count Number of users who will be able to activate the gift codes
//@month_count Number of months the Telegram Premium subscription will be active for the users
telegramPaymentPurposePremiumGiveaway parameters:giveawayParameters currency:string amount:int53 winner_count:int32 month_count:int32 = TelegramPaymentPurpose;
@ -8591,7 +8693,7 @@ pushMessageContentPoll question:string is_regular:Bool is_pinned:Bool = PushMess
pushMessageContentPremiumGiftCode month_count:int32 = PushMessageContent;
//@description A message with a giveaway
//@winner_count Number of users which will receive giveaway prizes; 0 for pinned message
//@winner_count Number of users who will receive giveaway prizes; 0 for pinned message
//@prize Prize of the giveaway; may be null for pinned message
//@is_pinned True, if the message is a pinned message with the specified content
pushMessageContentGiveaway winner_count:int32 prize:GiveawayPrize is_pinned:Bool = PushMessageContent;
@ -10323,6 +10425,9 @@ updateMessageSendFailed message:message old_message_id:int53 error:error = Updat
//@description The message content has changed @chat_id Chat identifier @message_id Message identifier @new_content New message content
updateMessageContent chat_id:int53 message_id:int53 new_content:MessageContent = Update;
//@description The message ephemeral content has changed @chat_id Chat identifier @message_id Message identifier @ephemeral_content New ephemeral content of the message; may be null if none
updateMessageEphemeralContent chat_id:int53 message_id:int53 ephemeral_content:ephemeralMessageContent = Update;
//@description A message was edited. Changes in the message content will come in a separate updateMessageContent
//@chat_id Chat identifier
//@message_id Message identifier
@ -10496,6 +10601,9 @@ updateChatBlockList chat_id:int53 block_list:BlockList = Update;
//@description A chat's has_scheduled_messages field has changed @chat_id Chat identifier @has_scheduled_messages New value of has_scheduled_messages
updateChatHasScheduledMessages chat_id:int53 has_scheduled_messages:Bool = Update;
//@description A chat's has_welcome_messages field has changed @chat_id Chat identifier @has_welcome_messages New value of has_welcome_messages
updateChatHasWelcomeMessages chat_id:int53 has_welcome_messages:Bool = Update;
//@description The list of chat folders or a chat folder has changed
//@chat_folders The new list of chat folders
//@main_chat_list_position Position of the main chat list among chat folders, 0-based
@ -10540,6 +10648,11 @@ updateQuickReplyShortcuts shortcut_ids:vector<int32> = Update;
//@messages The new list of quick reply messages for the shortcut in order from the first to the last sent
updateQuickReplyShortcutMessages shortcut_id:int32 messages:vector<quickReplyMessage> = Update;
//@description The list of welcome messages of a chat has changed
//@chat_id The identifier of the chat
//@messages The new list of welcome messages of the chat in the order from the first to the last sent
updateChatWelcomeMessages chat_id:int53 messages:vector<welcomeMessage> = Update;
//@description Basic information about a topic in a forum chat was changed @info New information about the topic
updateForumTopicInfo info:forumTopicInfo = Update;
@ -10599,12 +10712,20 @@ updateDeleteMessages chat_id:int53 message_ids:vector<int53> is_permanent:Bool f
updateChatAction chat_id:int53 topic_id:MessageTopic sender_id:MessageSender action:ChatAction = Update;
//@description A new pending text or rich message was received in a chat with a bot. The message must be shown in the chat for at most getOption("pending_text_message_period") seconds,
//-replace any other pending message with the same draft_id, and be deleted whenever any incoming message from the bot in the message thread is received
//-replace any other pending message with the same draft_id with animation, and be deleted whenever any incoming message or a pending message with another draft_id is received in the message thread
//@chat_id Chat identifier
//@forum_topic_id The forum topic identifier in which the message will be sent; 0 if none
//@draft_id Unique identifier of the message draft within the message thread
//@can_stop True, if a button that calls stopPendingMessage to stop further message generation must be shown
//@keep_on_stop True, if the pending message must not be automatically deleted when the user presses the Stop button
//@content Content of the message; always of the type messageText or messageRichMessage
updatePendingMessage chat_id:int53 forum_topic_id:int32 draft_id:int64 content:MessageContent = Update;
updatePendingMessage chat_id:int53 forum_topic_id:int32 draft_id:int64 can_stop:Bool keep_on_stop:Bool content:MessageContent = Update;
//@description A message draft generation was stopped by the user
//@chat_id Chat identifier
//@forum_topic_id The forum topic identifier of the message draft
//@draft_id Identifier of the message draft within the message thread
updateStopMessageDraft chat_id:int53 forum_topic_id:int32 draft_id:int64 = Update;
//@description Some data of a community has changed. This update is guaranteed to come before the community identifier is returned to the application @community New data about the community
updateCommunity community:community = Update;
@ -10633,6 +10754,9 @@ updateBasicGroupFullInfo basic_group_id:int53 basic_group_full_info:basicGroupFu
//@description Some data in supergroupFullInfo has been changed @supergroup_id Identifier of the supergroup or channel @supergroup_full_info New full information about the supergroup
updateSupergroupFullInfo supergroup_id:int53 supergroup_full_info:supergroupFullInfo = Update;
//@description Some data in communityFullInfo has been changed @community_id Identifier of the community @community_full_info New full information about the community
updateCommunityFullInfo community_id:int53 community_full_info:communityFullInfo = Update;
//@description A service notification from the server was received. Upon receiving this the application must show a popup with the content of the notification
//@type Notification type. If type begins with "AUTH_KEY_DROP_", then two buttons "Cancel" and "Log out" must be shown under notification; if user presses the second, all local data must be destroyed using Destroy method
//@content Notification content
@ -10652,7 +10776,7 @@ updateFile file:file = Update;
//@original_path The original path specified by the application in inputFileGenerated
//@destination_path The path to a file that must be created and where the new file must be generated by the application.
//-If the application has no access to the path, it can use writeGeneratedFilePart to generate the file
//@conversion If the conversion is "#url#" than original_path contains an HTTP/HTTPS URL of a file that must be downloaded by the application.
//@conversion If the conversion is "#url#", then original_path contains an HTTP/HTTPS URL of a file that must be downloaded by the application.
//-Otherwise, this is the conversion specified by the application in inputFileGenerated
updateFileGenerationStart generation_id:int64 original_path:string destination_path:string conversion:string = Update;
@ -11676,6 +11800,22 @@ toggleSavedMessagesTopicIsPinned saved_messages_topic_id:int53 is_pinned:Bool =
setPinnedSavedMessagesTopics saved_messages_topic_ids:vector<int53> = Ok;
//@description Returns full information about a community. The data will be sent through update. @community_id Community identifier
loadCommunityFullInfo community_id:int53 = Ok;
//@description Creates a new community for the given chat. Returns identifier of the created community
//@name Name of the new community
//@chat_id Identifier of the chat in the community; only chats with owned bots and owned basic group, supergroup and channel chats are allowed;
//-basic group chats will be automatically upgraded to supergroup chats
//@is_chat_hidden Pass true if the chat will be visible only to administrators of the community
createCommunity name:string chat_id:int53 is_chat_hidden:Bool = CommunityId;
//@description Changes name of the given community; requires can_change_info administrator right in the community
//@community_id Identifier of the community
//@name New name of the community
setCommunityName community_id:int53 name:string = Ok;
//@description Returns a list of common group chats with a given user. Chats are sorted by their type and creation date
//@user_id User identifier
//@offset_chat_id Chat identifier starting from which to return chats; use 0 for the first request
@ -12124,14 +12264,16 @@ sendChatScreenshotTakenNotification chat_id:int53 = Ok;
//@topic_id Topic in which the message will be sent; pass null if none
//@receiver_user_id Identifier of the user who will receive the message
//@callback_query_id Identifier of the callback query which triggered the message; for bots only
//@replace_callback_query_message Pass true if the ephemeral message must replace the message from which the callback query originated; for bots only
//@reply_to Information about the message to be replied; pass null if none. The message can be an incoming ephemeral message
//@protect_content Pass true if the content of the message must be protected from forwarding and saving; for bots only
//@sending_id Non-persistent identifier, which will be returned back in messageSendingStatePending object and can be used to match sent messages and corresponding updateNewMessage updates
//@only_preview Pass true to get a fake message instead of actually sending them
//@reply_markup Markup for replying to the message; pass null if none; for bots only
//@input_message_content The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageAnimation,
//-inputMessageAudio, inputMessageDocument, inputMessagePhoto, inputMessageSticker, inputMessageVideo, inputMessageVideoNote, inputMessageVoiceNote,
//-inputMessageAudio, inputMessageDocument, inputMessagePhoto, inputMessageRichMessage, inputMessageSticker, inputMessageVideo, inputMessageVideoNote, inputMessageVoiceNote,
//-inputMessageLocation, inputMessageVenue, inputMessageContact
sendEphemeralMessage chat_id:int53 topic_id:MessageTopic receiver_user_id:int53 callback_query_id:int64 reply_to:InputMessageReplyTo sending_id:int32 only_preview:Bool reply_markup:ReplyMarkup input_message_content:InputMessageContent = Message;
sendEphemeralMessage chat_id:int53 topic_id:MessageTopic receiver_user_id:int53 callback_query_id:int64 replace_callback_query_message:Bool reply_to:InputMessageReplyTo protect_content:Bool sending_id:int32 only_preview:Bool reply_markup:ReplyMarkup input_message_content:InputMessageContent = Message;
//@description Adds a local message to a chat. The message is persistent across application restarts only if the message database is used. Returns the added message
//@chat_id Target chat; channel direct messages chats aren't supported
@ -12150,7 +12292,7 @@ deleteMessages chat_id:int53 message_ids:vector<int53> revoke:Bool = Ok;
//@description Deletes an ephemeral message; for bots only
//@chat_id Chat identifier
//@receiver_user_id Identifier of the user who received the message
//@ephemeral_message_id Identifiers of the message to be deleted
//@ephemeral_message_id Identifier of the message to be deleted
deleteEphemeralMessage chat_id:int53 receiver_user_id:int53 ephemeral_message_id:int32 = Ok;
//@description Deletes all messages sent by the specified message sender in a chat. Supported only for supergroups; requires can_delete_messages administrator right @chat_id Chat identifier @sender_id Identifier of the sender of messages to delete
@ -12240,21 +12382,43 @@ editInlineMessageCaption inline_message_id:string reply_markup:ReplyMarkup capti
//@reply_markup The new message reply markup; pass null if none
editInlineMessageReplyMarkup inline_message_id:string reply_markup:ReplyMarkup = Ok;
//@description Edits the text, caption or reply markup of an ephemeral message sent by the bot; for bots only
//@description Edits the text, media, or reply markup of an ephemeral message sent by the bot; for bots only
//@chat_id The chat the message belongs to
//@receiver_user_id Identifier of the user who received the message
//@ephemeral_message_id Identifier of the ephemeral message
//@reply_markup The new message reply markup; pass null if none
//@input_message_content New content of the message; pass null to edit only reply markup. Must be one of the following types: inputMessageText, inputMessageAnimation,
//-inputMessageAudio, inputMessageDocument, inputMessagePhoto, inputMessageSticker, inputMessageVideo, inputMessageVideoNote, inputMessageVoiceNote
//-inputMessageAudio, inputMessageDocument, inputMessagePhoto, inputMessageRichMessage, inputMessageSticker, inputMessageVideo, inputMessageVideoNote, inputMessageVoiceNote
editEphemeralMessage chat_id:int53 receiver_user_id:int53 ephemeral_message_id:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = Ok;
//@description Edits the caption and reply markup of an ephemeral message sent by the bot; for bots only
//@chat_id The chat the message belongs to
//@receiver_user_id Identifier of the user who received the message
//@ephemeral_message_id Identifier of the ephemeral message
//@reply_markup The new message reply markup; pass null if none
//@caption New message content caption; pass null to remove caption; 0-getOption("message_caption_length_max") characters
//@show_caption_above_media Pass true to show the caption above the media; otherwise, the caption will be shown below the media. May be true only for animation, photo, and video messages
editEphemeralMessageCaption chat_id:int53 receiver_user_id:int53 ephemeral_message_id:int32 reply_markup:ReplyMarkup caption:formattedText show_caption_above_media:Bool = Ok;
//@description Edits the message from which a callback query has originated with an ephemeral message; for bots only
//@callback_query_id Identifier of the callback query
//@protect_content Pass true if the content of the message must be protected from forwarding and saving
//@reply_markup The new message reply markup; pass null if none
//@input_message_content New content of the message. Must be one of the following types: inputMessageText, inputMessageAnimation,
//-inputMessageAudio, inputMessageDocument, inputMessagePhoto, inputMessageRichMessage, inputMessageSticker, inputMessageVideo, inputMessageVideoNote, inputMessageVoiceNote
editCallbackQueryMessage callback_query_id:int64 protect_content:Bool reply_markup:ReplyMarkup input_message_content:InputMessageContent = Ok;
//@description Edits the time when a scheduled message will be sent. Scheduling state of all messages in the same album or forwarded together with the message will be also changed
//@chat_id The chat the message belongs to
//@message_id Identifier of the message. Use messageProperties.can_edit_scheduling_state to check whether the message is suitable
//@scheduling_state The new message scheduling state; pass null to send the message immediately. Must be null for messages in the state messageSchedulingStateSendWhenVideoProcessed
editMessageSchedulingState chat_id:int53 message_id:int53 scheduling_state:MessageSchedulingState = Ok;
//@description Removes message ephemeral content and reverts message state to the original
//@chat_id The chat the message belongs to
//@message_id Identifier of the message
deleteMessageEphemeralContent chat_id:int53 message_id:int53 = Ok;
//@description Changes the fact-check of a message. Can be only used if messageProperties.can_set_fact_check == true
//@chat_id The channel chat the message belongs to
@ -12457,7 +12621,7 @@ addQuickReplyShortcutInlineQueryResultMessage shortcut_name:string reply_to_mess
addQuickReplyShortcutMessageAlbum shortcut_name:string reply_to_message_id:int53 input_message_contents:vector<InputMessageContent> = QuickReplyMessages;
//@description Re-adds quick reply messages which failed to add. Can be called only for messages for which messageSendingStateFailed.can_retry is true and after specified in messageSendingStateFailed.retry_after time passed.
//-If a message is re-added, the corresponding failed to send message is deleted. Returns the sent messages in the same order as the message identifiers passed in message_ids. If a message can't be readded, null will be returned instead of the message
//-If a message is re-added, the corresponding failed to send message is deleted. Returns the sent messages in the same order as the message identifiers passed in message_ids. If a message can't be re-added, null will be returned instead of the message
//@shortcut_name Name of the target shortcut
//@message_ids Identifiers of the quick reply messages to re-add. Message identifiers must be in a strictly increasing order
readdQuickReplyShortcutMessages shortcut_name:string message_ids:vector<int53> = QuickReplyMessages;
@ -12471,6 +12635,33 @@ readdQuickReplyShortcutMessages shortcut_name:string message_ids:vector<int53> =
editQuickReplyMessage shortcut_id:int32 message_id:int53 input_message_content:InputMessageContent = Ok;
//@description Loads welcome messages of a chat; requires can_send_welcome_messages administrator right in the chat. The loaded messages will be sent through updateChatWelcomeMessages
//@chat_id The identifier of the chat
loadChatWelcomeMessages chat_id:int53 = Ok;
//@description Adds a message to the list of welcome messages of a chat; requires can_send_welcome_messages administrator right in the chat. There can be up to getOption("welcome_message_count_max") welcome messages in a chat
//@chat_id The identifier of the chat
//@input_message_content The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageAnimation,
//-inputMessageAudio, inputMessageDocument, inputMessagePhoto, inputMessageRichMessage, inputMessageSticker, inputMessageVideo, inputMessageVideoNote, inputMessageVoiceNote,
//-inputMessageLocation, inputMessageVenue, inputMessageContact
addChatWelcomeMessage chat_id:int53 input_message_content:InputMessageContent = Ok;
//@description Edits a welcome message of a chat; requires can_send_welcome_messages administrator right in the chat
//@chat_id The identifier of the chat
//@welcome_message_id The identifier of the welcome message
//@input_message_content New content of the message. Must be one of the following types: inputMessageText, inputMessageAnimation,
//-inputMessageAudio, inputMessageDocument, inputMessagePhoto, inputMessageRichMessage, inputMessageSticker, inputMessageVideo, inputMessageVideoNote, inputMessageVoiceNote
editChatWelcomeMessage chat_id:int53 welcome_message_id:int32 input_message_content:InputMessageContent = Ok;
//@description Deletes a welcome message of a chat; requires can_send_welcome_messages administrator right in the chat
//@chat_id The identifier of the chat
//@welcome_message_id The identifier of the welcome message
deleteChatWelcomeMessage chat_id:int53 welcome_message_id:int32 = Ok;
//@description Deletes all welcome messages of a chat; requires can_send_welcome_messages administrator right in the chat @chat_id The identifier of the chat
deleteAllChatWelcomeMessages chat_id:int53 = Ok;
//@description Returns the list of custom emoji, which can be used as forum topic icon by all users
getForumTopicDefaultIcons = Stickers;
@ -13011,15 +13202,25 @@ sendChatAction chat_id:int53 topic_id:MessageTopic business_connection_id:string
//@chat_id Chat identifier
//@forum_topic_id The forum topic identifier in which the message will be sent; pass 0 if none
//@draft_id Unique identifier of the draft
//@can_stop Pass true to show the user a button to stop further drafts
//@keep_on_stop Pass true to keep the current draft when the user stops further generation
//@text Draft text of the message; pass null to show a "Thinking..." placeholder
sendTextMessageDraft chat_id:int53 forum_topic_id:int32 draft_id:int64 text:formattedText = Ok;
sendTextMessageDraft chat_id:int53 forum_topic_id:int32 draft_id:int64 can_stop:Bool keep_on_stop:Bool text:formattedText = Ok;
//@description Sends a draft for a being generated rich message; for bots only
//@chat_id Chat identifier
//@forum_topic_id The forum topic identifier in which the message will be sent; pass 0 if none
//@draft_id Unique identifier of the draft
//@can_stop Pass true to show the user a button to stop further drafts
//@keep_on_stop Pass true to keep the current draft when the user stops further generation
//@message Draft of the message; file upload isn't supported
sendRichMessageDraft chat_id:int53 forum_topic_id:int32 draft_id:int64 message:inputRichMessage = Ok;
sendRichMessageDraft chat_id:int53 forum_topic_id:int32 draft_id:int64 can_stop:Bool keep_on_stop:Bool message:inputRichMessage = Ok;
//@description Stops a pending message generation by a bot
//@chat_id Identifier of the chat with the bot
//@topic_id Identifier of the topic in which the action is performed; pass null if none
//@draft_id Unique identifier of the message draft within the message thread
stopPendingMessage chat_id:int53 topic_id:MessageTopic draft_id:int64 = Ok;
//@description Informs TDLib that the chat is opened by the user. Many useful activities depend on the chat being opened or closed (e.g., in supergroups and channels all updates are received only for opened chats) @chat_id Chat identifier
@ -13296,7 +13497,7 @@ setChatTheme chat_id:int53 theme:InputChatTheme = Ok;
//@description Changes the draft message in a chat or a topic
//@chat_id Chat identifier
//@topic_id Topic in which the draft will be changed; pass null to change the draft for the chat itself
//@draft_message New draft message; pass null to remove the draft. All files in draft message content must be of the type inputFileLocal. Media thumbnails and captions are ignored
//@draft_message New draft message; pass null to remove the draft
setChatDraftMessage chat_id:int53 topic_id:MessageTopic draft_message:draftMessage = Ok;
//@description Changes the notification settings of a chat. Notification settings of a chat with the current user (Saved Messages) can't be changed
@ -13384,7 +13585,7 @@ leaveChat chat_id:int53 = Ok;
//@forward_limit The number of earlier messages from the chat to be forwarded to the new member; up to 100. Ignored for supergroups and channels, or if the added user is a bot
addChatMember chat_id:int53 user_id:int53 forward_limit:int32 = FailedToAddMembers;
//@description Adds multiple new members to a chat; requires can_invite_users member right. Currently, this method is only available for supergroups and channels.
//@description Adds multiple new members to a chat; requires can_invite_users member right. Currently, this method is available only in supergroups and channels.
//-This method can't be used to join a chat. Members can't be added to a channel if it has more than 200 members. Returns information about members that weren't added
//@chat_id Chat identifier
//@user_ids Identifiers of the users to be added to the chat. The maximum number of added users is 20 for supergroups and 100 for channels
@ -13400,7 +13601,7 @@ setChatMemberStatus chat_id:int53 member_id:MessageSender status:ChatMemberStatu
//@description Changes the tag or custom title of a chat member; requires can_manage_tags administrator right to change tag of other users; for basic groups and supergroups only
//@chat_id Chat identifier
//@user_id Identifier of the user, which tag is changed. Chats can't have member tags
//@user_id Identifier of the user whose tag is changed. Chats can't have member tags
//@tag The new tag of the member in the chat; 0-16 characters without emoji
setChatMemberTag chat_id:int53 user_id:int53 tag:string = Ok;
@ -13420,8 +13621,8 @@ canTransferOwnership = CanTransferOwnershipResult;
//@password The 2-step verification password of the current user
transferChatOwnership chat_id:int53 user_id:int53 password:string = Ok;
//@description Returns the user who will become the owner of the chat after 7 days if the current user does not return to the supergroup or channel during that period or immediately for basic groups; requires owner privileges in the chat.
//-Available only for basic groups, supergroups, and channel chats
//@description Returns the user who will become the owner of the chat after 7 days if the current user does not return to the supergroup or channel during that period or immediately for basic groups;
//-requires owner privileges in the chat. Available only for basic groups, supergroups, and channel chats
//@chat_id Chat identifier
getChatOwnerAfterLeaving chat_id:int53 = User;
@ -13910,7 +14111,7 @@ createChatInviteLink chat_id:int53 name:string expiration_date:int32 member_limi
//-Subscription period must be 2592000 in production environment, and 60 or 300 if Telegram test environment is used
createChatSubscriptionInviteLink chat_id:int53 name:string subscription_pricing:starSubscriptionPricing = ChatInviteLink;
//@description Edits a non-primary invite link for a chat. Available for basic groups, supergroups, and channels.
//@description Edits a non-primary invite link for a chat. Available in basic groups, supergroups, and channels.
//-If the link creates a subscription, then expiration_date, member_limit and creates_join_request must not be used.
//-Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links
//@chat_id Chat identifier
@ -13952,7 +14153,7 @@ getChatInviteLinks chat_id:int53 creator_user_id:int53 is_revoked:Bool offset_da
//@limit The maximum number of chat members to return; up to 100
getChatInviteLinkMembers chat_id:int53 invite_link:string only_with_expired_subscription:Bool offset_member:chatInviteLinkMember limit:int32 = ChatInviteLinkMembers;
//@description Revokes invite link for a chat. Available for basic groups, supergroups, and channels. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links.
//@description Revokes invite link for a chat. Available in basic groups, supergroups, and channels. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links.
//-If a primary link is revoked, then additionally to the revoked link returns new primary link
//@chat_id Chat identifier
//@invite_link Invite link to be revoked
@ -15049,7 +15250,7 @@ getSupergroupMembers supergroup_id:int53 filter:SupergroupMembersFilter offset:i
closeSecretChat secret_chat_id:int32 = Ok;
//@description Returns a list of service actions taken by chat members and administrators in the last 48 hours. Available only for supergroups and channels. Requires administrator rights. Returns results in reverse chronological order (i.e., in order of decreasing event_id)
//@description Returns a list of service actions taken by chat members and administrators in the last 48 hours. Available only in supergroups and channels. Requires administrator rights. Returns results in reverse chronological order (i.e., in order of decreasing event_id)
//@chat_id Chat identifier
//@query Search query by which to filter events
//@from_event_id Identifier of an event from which to return results. Use 0 to get results from the latest events
@ -15205,7 +15406,10 @@ dropGiftOriginalDetails received_gift_id:string star_count:int53 = Ok;
//@gift_name Name of the upgraded gift to send
//@owner_id Identifier of the user or the channel chat that will receive the gift
//@price The price that the user agreed to pay for the gift
sendResoldGift gift_name:string owner_id:MessageSender price:GiftResalePrice = GiftResaleResult;
//@text Text to show along with the gift; 0-getOption("gift_text_length_max") characters. Only Bold, Italic, Underline, Strikethrough, Spoiler, CustomEmoji, and DateTime entities are allowed.
//-Must be empty if the receiver enabled paid messages and the price of the gift is less than the price of a paid message to the user
//@is_private Pass true to show gift text and sender only to the gift receiver; otherwise, everyone will be able to see them
sendResoldGift gift_name:string owner_id:MessageSender price:GiftResalePrice text:formattedText is_private:Bool = GiftResaleResult;
//@description Sends an offer to purchase an upgraded gift
//@owner_id Identifier of the user or the channel chat that currently owns the gift and will receive the offer
@ -15264,7 +15468,7 @@ getUpgradedGiftsPromotionalAnimation = Animation;
//@received_gift_id Identifier of the unique gift
//@price The new price for the unique gift; pass null to disallow gift resale. The current user will receive
//-getOption("gift_resale_star_earnings_per_mille") Telegram Stars for each 1000 Telegram Stars paid for the gift if the gift price is in Telegram Stars or
//-getOption("gift_resale_ton_earnings_per_mille") TON Grams for each 1000 Grams paid for the gift if the gift price is in Grams
//-getOption("gift_resale_gram_earnings_per_mille") TON Grams for each 1000 Grams paid for the gift if the gift price is in Grams
setGiftResalePrice received_gift_id:string price:GiftResalePrice = Ok;
//@description Returns upgraded gifts that can be bought from other owners using sendResoldGift
@ -15837,7 +16041,7 @@ checkPremiumGiftCode code:string = PremiumGiftCodeInfo;
applyPremiumGiftCode code:string = Ok;
//@description Allows to buy a Telegram Premium subscription for another user with payment in Telegram Stars; for bots only
//@user_id Identifier of the user which will receive Telegram Premium
//@user_id Identifier of the user who will receive Telegram Premium
//@star_count The number of Telegram Stars to pay for subscription
//@month_count Number of months the Telegram Premium subscription will be active for the user
//@text Text to show to the user receiving Telegram Premium; 0-getOption("gift_text_length_max") characters. Only Bold, Italic, Underline, Strikethrough, Spoiler, CustomEmoji, and DateTime entities are allowed