From 1e67a2c70d97343fa07e507528d6ecc8b4318c9c Mon Sep 17 00:00:00 2001 From: astravexton Date: Mon, 18 Apr 2022 20:45:01 +0000 Subject: [PATCH] Update tdlib code to 1.8.3 --- Makefile | 2 +- client/function.go | 1447 +++++++++++--- client/tdjson.go | 1 + client/tdjson_dynamic.go | 1 + client/tdjson_static.go | 1 + client/type.go | 4041 ++++++++++++++++++++++++++------------ client/unmarshaler.go | 1579 ++++++++++----- data/td_api.json | 3288 ++++++++++++++++++++++--------- data/td_api.tl | 1165 +++++++---- 9 files changed, 8287 insertions(+), 3238 deletions(-) diff --git a/Makefile b/Makefile index 83428a1..b207c64 100644 --- a/Makefile +++ b/Makefile @@ -1,4 +1,4 @@ -TAG := master +TAG := 054a823c1a812ee3e038f702c6d8ba3e6974be9c schema-update: curl https://raw.githubusercontent.com/tdlib/td/${TAG}/td/generate/scheme/td_api.tl 2>/dev/null > ./data/td_api.tl diff --git a/client/function.go b/client/function.go index 2fbeb7b..01d6d02 100755 --- a/client/function.go +++ b/client/function.go @@ -525,7 +525,7 @@ type SetPasswordRequest struct { NewPassword string `json:"new_password"` // New password hint; may be empty NewHint string `json:"new_hint"` - // Pass true if the recovery email address must be changed + // Pass true to change also the recovery email address SetRecoveryEmailAddress bool `json:"set_recovery_email_address"` // New recovery email address; may be empty NewRecoveryEmailAddress string `json:"new_recovery_email_address"` @@ -1094,7 +1094,7 @@ type GetMessageLocallyRequest struct { MessageId int64 `json:"message_id"` } -// Returns information about a message, if it is available locally without sending network request. This is an offline request +// Returns information about a message, if it is available without sending network request. This is an offline request func (client *Client) GetMessageLocally(req *GetMessageLocallyRequest) (*Message, error) { result, err := client.Send(Request{ meta: meta{ @@ -1408,7 +1408,7 @@ type SearchPublicChatRequest struct { Username string `json:"username"` } -// Searches a public chat by its username. Currently only private chats, supergroups and channels can be public. Returns the chat if found; otherwise an error is returned +// Searches a public chat by its username. Currently, only private chats, supergroups and channels can be public. Returns the chat if found; otherwise an error is returned func (client *Client) SearchPublicChat(req *SearchPublicChatRequest) (*Chat, error) { result, err := client.Send(Request{ meta: meta{ @@ -1434,7 +1434,7 @@ type SearchPublicChatsRequest struct { Query string `json:"query"` } -// Searches public chats by looking for specified query in their username and title. Currently only private chats, supergroups and channels can be public. Returns a meaningful number of results. Excludes private chats with contacts and chats from the chat list from the results +// Searches public chats by looking for specified query in their username and title. Currently, only private chats, supergroups and channels can be public. Returns a meaningful number of results. Excludes private chats with contacts and chats from the chat list from the results func (client *Client) SearchPublicChats(req *SearchPublicChatsRequest) (*Chats, error) { result, err := client.Send(Request{ meta: meta{ @@ -1872,7 +1872,7 @@ type GetChatHistoryRequest struct { Offset int32 `json:"offset"` // The maximum number of messages to be returned; must be positive and can't be greater than 100. If the offset is negative, the limit must be greater than or equal to -offset. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit Limit int32 `json:"limit"` - // If true, returns only messages that are available locally without sending network requests + // Pass true to get only messages that are available without sending network requests OnlyLocal bool `json:"only_local"` } @@ -1942,9 +1942,9 @@ func (client *Client) GetMessageThreadHistory(req *GetMessageThreadHistoryReques type DeleteChatHistoryRequest struct { // Chat identifier ChatId int64 `json:"chat_id"` - // Pass true if the chat needs to be removed from the chat list + // Pass true to remove the chat from all chat lists RemoveFromChatList bool `json:"remove_from_chat_list"` - // Pass true to try to delete chat history for all users + // Pass true to delete chat history for all users Revoke bool `json:"revoke"` } @@ -1976,7 +1976,7 @@ type DeleteChatRequest struct { ChatId int64 `json:"chat_id"` } -// Deletes a chat along with all messages in the corresponding chat for all chat members; requires owner privileges. For group chats this will release the username and remove all members. Chats with more than 1000 members can't be deleted using this method +// Deletes a chat along with all messages in the corresponding chat for all chat members. For group chats this will release the username and remove all members. Use the field chat.can_be_deleted_for_all_users to find whether the method can be applied to the chat func (client *Client) DeleteChat(req *DeleteChatRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ @@ -2057,7 +2057,7 @@ type SearchMessagesRequest struct { OffsetMessageId int64 `json:"offset_message_id"` // The maximum number of messages to be returned; up to 100. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit Limit int32 `json:"limit"` - // Additional filter for messages to search; pass null to search for all messages. Filters searchMessagesFilterCall, searchMessagesFilterMissedCall, searchMessagesFilterMention, searchMessagesFilterUnreadMention, searchMessagesFilterFailedToSend and searchMessagesFilterPinned are unsupported in this function + // Additional filter for messages to search; pass null to search for all messages. Filters searchMessagesFilterMention, searchMessagesFilterUnreadMention, searchMessagesFilterUnreadReaction, searchMessagesFilterFailedToSend, and searchMessagesFilterPinned are unsupported in this function Filter SearchMessagesFilter `json:"filter"` // If not 0, the minimum date of the messages to return MinDate int32 `json:"min_date"` @@ -2099,7 +2099,7 @@ type SearchSecretMessagesRequest struct { ChatId int64 `json:"chat_id"` // Query to search for. If empty, searchChatMessages must be used instead Query string `json:"query"` - // Offset of the first entry to return as received from the previous request; use empty string to get first chunk of results + // Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results Offset string `json:"offset"` // The maximum number of messages to be returned; up to 100. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit Limit int32 `json:"limit"` @@ -2137,7 +2137,7 @@ type SearchCallMessagesRequest struct { FromMessageId int64 `json:"from_message_id"` // The maximum number of messages to be returned; up to 100. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit Limit int32 `json:"limit"` - // If true, returns only messages with missed calls + // Pass true to search only for messages with missed/declined calls OnlyMissed bool `json:"only_missed"` } @@ -2164,6 +2164,35 @@ func (client *Client) SearchCallMessages(req *SearchCallMessagesRequest) (*Messa return UnmarshalMessages(result.Data) } +type SearchOutgoingDocumentMessagesRequest struct { + // Query to search for in document file name and message caption + Query string `json:"query"` + // The maximum number of messages to be returned; up to 100 + Limit int32 `json:"limit"` +} + +// Searches for outgoing messages with content of the type messageDocument in all chats except secret chats. Returns the results in reverse chronological order +func (client *Client) SearchOutgoingDocumentMessages(req *SearchOutgoingDocumentMessagesRequest) (*FoundMessages, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "searchOutgoingDocumentMessages", + }, + Data: map[string]interface{}{ + "query": req.Query, + "limit": req.Limit, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalFoundMessages(result.Data) +} + type DeleteAllCallMessagesRequest struct { // Pass true to delete the messages for all users Revoke bool `json:"revoke"` @@ -2270,7 +2299,7 @@ func (client *Client) GetChatMessageByDate(req *GetChatMessageByDateRequest) (*M type GetChatSparseMessagePositionsRequest struct { // Identifier of the chat in which to return information about message positions ChatId int64 `json:"chat_id"` - // Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterCall, searchMessagesFilterMissedCall, searchMessagesFilterMention and searchMessagesFilterUnreadMention are unsupported in this function + // Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterMention, searchMessagesFilterUnreadMention, and searchMessagesFilterUnreadReaction are unsupported in this function Filter SearchMessagesFilter `json:"filter"` // The message identifier from which to return information about message positions FromMessageId int64 `json:"from_message_id"` @@ -2305,13 +2334,13 @@ func (client *Client) GetChatSparseMessagePositions(req *GetChatSparseMessagePos type GetChatMessageCalendarRequest struct { // Identifier of the chat in which to return information about messages ChatId int64 `json:"chat_id"` - // Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterCall, searchMessagesFilterMissedCall, searchMessagesFilterMention and searchMessagesFilterUnreadMention are unsupported in this function + // Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterMention, searchMessagesFilterUnreadMention, and searchMessagesFilterUnreadReaction are unsupported in this function Filter SearchMessagesFilter `json:"filter"` // The message identifier from which to return information about messages; use 0 to get results from the last message FromMessageId int64 `json:"from_message_id"` } -// Returns information about the next messages of the specified type in the chat splitted by days. Returns the results in reverse chronological order. Can return partial result for the last returned day. Behavior of this method depends on the value of the option "utc_time_offset" +// Returns information about the next messages of the specified type in the chat split by days. Returns the results in reverse chronological order. Can return partial result for the last returned day. Behavior of this method depends on the value of the option "utc_time_offset" func (client *Client) GetChatMessageCalendar(req *GetChatMessageCalendarRequest) (*MessageCalendar, error) { result, err := client.Send(Request{ meta: meta{ @@ -2339,7 +2368,7 @@ type GetChatMessageCountRequest struct { ChatId int64 `json:"chat_id"` // Filter for message content; searchMessagesFilterEmpty is unsupported in this function Filter SearchMessagesFilter `json:"filter"` - // If true, returns count that is available locally without sending network requests, returning -1 if the number of messages is unknown + // Pass true to get the number of messages without sending network requests, or -1 if the number of messages is unknown locally ReturnLocal bool `json:"return_local"` } @@ -2397,7 +2426,7 @@ type GetMessagePublicForwardsRequest struct { ChatId int64 `json:"chat_id"` // Message identifier MessageId int64 `json:"message_id"` - // Offset of the first entry to return as received from the previous request; use empty string to get first chunk of results + // Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results Offset string `json:"offset"` // The maximum number of messages to be returned; must be positive and can't be greater than 100. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit Limit int32 `json:"limit"` @@ -2427,16 +2456,16 @@ func (client *Client) GetMessagePublicForwards(req *GetMessagePublicForwardsRequ return UnmarshalFoundMessages(result.Data) } -type GetChatSponsoredMessagesRequest struct { +type GetChatSponsoredMessageRequest struct { // Identifier of the chat ChatId int64 `json:"chat_id"` } -// Returns sponsored messages to be shown in a chat; for channel chats only -func (client *Client) GetChatSponsoredMessages(req *GetChatSponsoredMessagesRequest) (*SponsoredMessages, error) { +// Returns sponsored message to be shown in a chat; for channel chats only. Returns a 404 error if there is no sponsored message in the chat +func (client *Client) GetChatSponsoredMessage(req *GetChatSponsoredMessageRequest) (*SponsoredMessage, error) { result, err := client.Send(Request{ meta: meta{ - Type: "getChatSponsoredMessages", + Type: "getChatSponsoredMessage", }, Data: map[string]interface{}{ "chat_id": req.ChatId, @@ -2450,36 +2479,7 @@ func (client *Client) GetChatSponsoredMessages(req *GetChatSponsoredMessagesRequ return nil, buildResponseError(result.Data) } - return UnmarshalSponsoredMessages(result.Data) -} - -type ViewSponsoredMessageRequest struct { - // Identifier of the chat with the sponsored message - ChatId int64 `json:"chat_id"` - // The identifier of the sponsored message being viewed - SponsoredMessageId int32 `json:"sponsored_message_id"` -} - -// Informs TDLib that a sponsored message was viewed by the user -func (client *Client) ViewSponsoredMessage(req *ViewSponsoredMessageRequest) (*Ok, error) { - result, err := client.Send(Request{ - meta: meta{ - Type: "viewSponsoredMessage", - }, - Data: map[string]interface{}{ - "chat_id": req.ChatId, - "sponsored_message_id": req.SponsoredMessageId, - }, - }) - if err != nil { - return nil, err - } - - if result.Type == "error" { - return nil, buildResponseError(result.Data) - } - - return UnmarshalOk(result.Data) + return UnmarshalSponsoredMessage(result.Data) } type RemoveNotificationRequest struct { @@ -2636,6 +2636,38 @@ func (client *Client) GetMessageLinkInfo(req *GetMessageLinkInfoRequest) (*Messa return UnmarshalMessageLinkInfo(result.Data) } +type TranslateTextRequest struct { + // Text to translate + Text string `json:"text"` + // A two-letter ISO 639-1 language code of the language from which the message is translated. If empty, the language will be detected automatically + FromLanguageCode string `json:"from_language_code"` + // A two-letter ISO 639-1 language code of the language to which the message is translated + ToLanguageCode string `json:"to_language_code"` +} + +// Translates a text to the given language. Returns a 404 error if the translation can't be performed +func (client *Client) TranslateText(req *TranslateTextRequest) (*Text, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "translateText", + }, + Data: map[string]interface{}{ + "text": req.Text, + "from_language_code": req.FromLanguageCode, + "to_language_code": req.ToLanguageCode, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalText(result.Data) +} + type GetChatAvailableMessageSendersRequest struct { // Chat identifier ChatId int64 `json:"chat_id"` @@ -2662,22 +2694,22 @@ func (client *Client) GetChatAvailableMessageSenders(req *GetChatAvailableMessag return UnmarshalMessageSenders(result.Data) } -type SetChatDefaultMessageSenderRequest struct { +type SetChatMessageSenderRequest struct { // Chat identifier ChatId int64 `json:"chat_id"` - // New default message sender in the chat - DefaultMessageSenderId MessageSender `json:"default_message_sender_id"` + // New message sender for the chat + MessageSenderId MessageSender `json:"message_sender_id"` } -// Changes default message sender that is chosen in a chat -func (client *Client) SetChatDefaultMessageSender(req *SetChatDefaultMessageSenderRequest) (*Ok, error) { +// Selects a message sender to send messages in a chat +func (client *Client) SetChatMessageSender(req *SetChatMessageSenderRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ - Type: "setChatDefaultMessageSender", + Type: "setChatMessageSender", }, Data: map[string]interface{}{ - "chat_id": req.ChatId, - "default_message_sender_id": req.DefaultMessageSenderId, + "chat_id": req.ChatId, + "message_sender_id": req.MessageSenderId, }, }) if err != nil { @@ -2696,7 +2728,7 @@ type SendMessageRequest struct { ChatId int64 `json:"chat_id"` // If not 0, a message thread identifier in which the message will be sent MessageThreadId int64 `json:"message_thread_id"` - // Identifier of the message to reply to or 0 + // Identifier of the replied message; 0 if none ReplyToMessageId int64 `json:"reply_to_message_id"` // Options to be used to send the message; pass null to use default options Options *MessageSendOptions `json:"options"` @@ -2737,15 +2769,17 @@ type SendMessageAlbumRequest struct { ChatId int64 `json:"chat_id"` // If not 0, a message thread identifier in which the messages will be sent MessageThreadId int64 `json:"message_thread_id"` - // Identifier of a message to reply to or 0 + // Identifier of a replied message; 0 if none ReplyToMessageId int64 `json:"reply_to_message_id"` // Options to be used to send the messages; pass null to use default options Options *MessageSendOptions `json:"options"` // Contents of messages to be sent. At most 10 messages can be added to an album InputMessageContents []InputMessageContent `json:"input_message_contents"` + // Pass true to get fake messages instead of actually sending them + OnlyPreview bool `json:"only_preview"` } -// Sends 2-10 messages grouped together into an album. Currently only audio, document, photo and video messages can be grouped into an album. Documents and audio files can be only grouped in an album with messages of the same type. Returns sent messages +// Sends 2-10 messages grouped together into an album. Currently, only audio, document, photo and video messages can be grouped into an album. Documents and audio files can be only grouped in an album with messages of the same type. Returns sent messages func (client *Client) SendMessageAlbum(req *SendMessageAlbumRequest) (*Messages, error) { result, err := client.Send(Request{ meta: meta{ @@ -2757,6 +2791,7 @@ func (client *Client) SendMessageAlbum(req *SendMessageAlbumRequest) (*Messages, "reply_to_message_id": req.ReplyToMessageId, "options": req.Options, "input_message_contents": req.InputMessageContents, + "only_preview": req.OnlyPreview, }, }) if err != nil { @@ -2807,7 +2842,7 @@ type SendInlineQueryResultMessageRequest struct { ChatId int64 `json:"chat_id"` // If not 0, a message thread identifier in which the message will be sent MessageThreadId int64 `json:"message_thread_id"` - // Identifier of a message to reply to or 0 + // Identifier of a replied message; 0 if none ReplyToMessageId int64 `json:"reply_to_message_id"` // Options to be used to send the message; pass null to use default options Options *MessageSendOptions `json:"options"` @@ -2815,7 +2850,7 @@ type SendInlineQueryResultMessageRequest struct { QueryId JsonInt64 `json:"query_id"` // Identifier of the inline result ResultId string `json:"result_id"` - // If true, there will be no mention of a bot, via which the message is sent. Can be used only for bots GetOption("animation_search_bot_username"), GetOption("photo_search_bot_username") and GetOption("venue_search_bot_username") + // Pass true to hide the bot, via which the message is sent. Can be used only for bots GetOption("animation_search_bot_username"), GetOption("photo_search_bot_username"), and GetOption("venue_search_bot_username") HideViaBot bool `json:"hide_via_bot"` } @@ -2855,11 +2890,11 @@ type ForwardMessagesRequest struct { MessageIds []int64 `json:"message_ids"` // Options to be used to send the messages; pass null to use default options Options *MessageSendOptions `json:"options"` - // If true, content of the messages will be copied without reference to the original sender. Always true if the messages are forwarded to a secret chat or are local + // Pass true to copy content of the messages without reference to the original sender. Always true if the messages are forwarded to a secret chat or are local SendCopy bool `json:"send_copy"` - // If true, media caption of message copies will be removed. Ignored if send_copy is false + // Pass true to remove media captions of message copies. Ignored if send_copy is false RemoveCaption bool `json:"remove_caption"` - // If true, messages will not be forwarded and instead fake messages will be returned + // Pass true to get fake messages instead of actually forwarding them OnlyPreview bool `json:"only_preview"` } @@ -2950,7 +2985,7 @@ type AddLocalMessageRequest struct { ChatId int64 `json:"chat_id"` // Identifier of the sender of the message SenderId MessageSender `json:"sender_id"` - // Identifier of the message to reply to or 0 + // Identifier of the replied message; 0 if none ReplyToMessageId int64 `json:"reply_to_message_id"` // Pass true to disable notification for the message DisableNotification bool `json:"disable_notification"` @@ -2988,7 +3023,7 @@ type DeleteMessagesRequest struct { ChatId int64 `json:"chat_id"` // Identifiers of the messages to be deleted MessageIds []int64 `json:"message_ids"` - // Pass true to try to delete messages for all chat members. Always true for supergroups, channels and secret chats + // Pass true to delete messages for all chat members. Always true for supergroups, channels and secret chats Revoke bool `json:"revoke"` } @@ -3051,7 +3086,7 @@ type DeleteChatMessagesByDateRequest struct { MinDate int32 `json:"min_date"` // The maximum date of the messages to delete MaxDate int32 `json:"max_date"` - // Pass true to try to delete chat messages for all users; private chats only + // Pass true to delete chat messages for all users; private chats only Revoke bool `json:"revoke"` } @@ -3452,6 +3487,108 @@ func (client *Client) EditMessageSchedulingState(req *EditMessageSchedulingState return UnmarshalOk(result.Data) } +type GetMessageAvailableReactionsRequest struct { + // Identifier of the chat to which the message belongs + ChatId int64 `json:"chat_id"` + // Identifier of the message + MessageId int64 `json:"message_id"` +} + +// Returns reactions, which can be added to a message. The list can change after updateReactions, updateChatAvailableReactions for the chat, or updateMessageInteractionInfo for the message +func (client *Client) GetMessageAvailableReactions(req *GetMessageAvailableReactionsRequest) (*AvailableReactions, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "getMessageAvailableReactions", + }, + Data: map[string]interface{}{ + "chat_id": req.ChatId, + "message_id": req.MessageId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalAvailableReactions(result.Data) +} + +type SetMessageReactionRequest struct { + // Identifier of the chat to which the message belongs + ChatId int64 `json:"chat_id"` + // Identifier of the message + MessageId int64 `json:"message_id"` + // Text representation of the new chosen reaction. Can be an empty string or the currently chosen non-big reaction to remove the reaction + Reaction string `json:"reaction"` + // Pass true if the reaction is added with a big animation + IsBig bool `json:"is_big"` +} + +// Changes chosen reaction for a message +func (client *Client) SetMessageReaction(req *SetMessageReactionRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "setMessageReaction", + }, + Data: map[string]interface{}{ + "chat_id": req.ChatId, + "message_id": req.MessageId, + "reaction": req.Reaction, + "is_big": req.IsBig, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + +type GetMessageAddedReactionsRequest struct { + // Identifier of the chat to which the message belongs + ChatId int64 `json:"chat_id"` + // Identifier of the message + MessageId int64 `json:"message_id"` + // If non-empty, only added reactions with the specified text representation will be returned + Reaction string `json:"reaction"` + // Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results + Offset string `json:"offset"` + // The maximum number of reactions to be returned; must be positive and can't be greater than 100 + Limit int32 `json:"limit"` +} + +// Returns reactions added for a message, along with their sender +func (client *Client) GetMessageAddedReactions(req *GetMessageAddedReactionsRequest) (*AddedReactions, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "getMessageAddedReactions", + }, + Data: map[string]interface{}{ + "chat_id": req.ChatId, + "message_id": req.MessageId, + "reaction": req.Reaction, + "offset": req.Offset, + "limit": req.Limit, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalAddedReactions(result.Data) +} + type GetTextEntitiesRequest struct { // The text in which to look for entites Text string `json:"text"` @@ -3485,7 +3622,7 @@ type ParseTextEntitiesRequest struct { ParseMode TextParseMode `json:"parse_mode"` } -// Parses Bold, Italic, Underline, Strikethrough, Code, Pre, PreCode, TextUrl and MentionName entities contained in the text. Can be called synchronously +// Parses Bold, Italic, Underline, Strikethrough, Spoiler, Code, Pre, PreCode, TextUrl and MentionName entities contained in the text. Can be called synchronously func (client *Client) ParseTextEntities(req *ParseTextEntitiesRequest) (*FormattedText, error) { result, err := client.jsonClient.Execute(Request{ meta: meta{ @@ -3508,7 +3645,7 @@ func (client *Client) ParseTextEntities(req *ParseTextEntitiesRequest) (*Formatt } type ParseMarkdownRequest struct { - // The text to parse. For example, "__italic__ ~~strikethrough~~ **bold** `code` ```pre``` __[italic__ text_url](telegram.org) __italic**bold italic__bold**" + // The text to parse. For example, "__italic__ ~~strikethrough~~ ||spoiler|| **bold** `code` ```pre``` __[italic__ text_url](telegram.org) __italic**bold italic__bold**" Text *FormattedText `json:"text"` } @@ -3757,6 +3894,32 @@ func (client *Client) GetJsonString(req *GetJsonStringRequest) (*Text, error) { return UnmarshalText(result.Data) } +type GetThemeParametersJsonStringRequest struct { + // Theme parameters to convert to JSON + Theme *ThemeParameters `json:"theme"` +} + +// Converts a themeParameters object to corresponding JSON-serialized string. Can be called synchronously +func (client *Client) GetThemeParametersJsonString(req *GetThemeParametersJsonStringRequest) (*Text, error) { + result, err := client.jsonClient.Execute(Request{ + meta: meta{ + Type: "getThemeParametersJsonString", + }, + Data: map[string]interface{}{ + "theme": req.Theme, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalText(result.Data) +} + type SetPollAnswerRequest struct { // Identifier of the chat to which the poll belongs ChatId int64 `json:"chat_id"` @@ -3933,7 +4096,7 @@ type GetLoginUrlRequest struct { MessageId int64 `json:"message_id"` // Button identifier ButtonId int64 `json:"button_id"` - // True, if the user allowed the bot to send them messages + // Pass true to allow the bot to send messages to the current user AllowWriteAccess bool `json:"allow_write_access"` } @@ -4002,7 +4165,7 @@ func (client *Client) GetInlineQueryResults(req *GetInlineQueryResultsRequest) ( type AnswerInlineQueryRequest struct { // Identifier of the inline query InlineQueryId JsonInt64 `json:"inline_query_id"` - // True, if the result of the query can be cached for the specified user + // Pass true if results may be cached and returned only for the user that sent the query. By default, results may be returned to any user who sends the same query IsPersonal bool `json:"is_personal"` // The results of the query Results []InputInlineQueryResult `json:"results"` @@ -4043,6 +4206,163 @@ func (client *Client) AnswerInlineQuery(req *AnswerInlineQueryRequest) (*Ok, err return UnmarshalOk(result.Data) } +type GetWebAppUrlRequest struct { + // Identifier of the target bot + BotUserId int64 `json:"bot_user_id"` + // The URL from the keyboardButtonTypeWebApp button + Url string `json:"url"` + // Preferred web app theme; pass null to use the default theme + Theme *ThemeParameters `json:"theme"` +} + +// Returns an HTTPS URL of a web app to open after keyboardButtonTypeWebApp button is pressed +func (client *Client) GetWebAppUrl(req *GetWebAppUrlRequest) (*HttpUrl, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "getWebAppUrl", + }, + Data: map[string]interface{}{ + "bot_user_id": req.BotUserId, + "url": req.Url, + "theme": req.Theme, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalHttpUrl(result.Data) +} + +type SendWebAppDataRequest struct { + // Identifier of the target bot + BotUserId int64 `json:"bot_user_id"` + // Text of the keyboardButtonTypeWebApp button, which opened the web app + ButtonText string `json:"button_text"` + // Received data + Data string `json:"data"` +} + +// Sends data received from a keyboardButtonTypeWebApp web app to a bot +func (client *Client) SendWebAppData(req *SendWebAppDataRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "sendWebAppData", + }, + Data: map[string]interface{}{ + "bot_user_id": req.BotUserId, + "button_text": req.ButtonText, + "data": req.Data, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + +type OpenWebAppRequest struct { + // Identifier of the chat in which the web app is opened. Web apps can be opened only in private chats for now + ChatId int64 `json:"chat_id"` + // Identifier of the bot, providing the web app + BotUserId int64 `json:"bot_user_id"` + // The URL from an inlineKeyboardButtonTypeWebApp button, a botMenuButton button, or an internalLinkTypeAttachmentMenuBot link, or an empty string otherwise + Url string `json:"url"` + // Preferred web app theme; pass null to use the default theme + Theme *ThemeParameters `json:"theme"` + // Identifier of the replied message for the message sent by the web app; 0 if none + ReplyToMessageId int64 `json:"reply_to_message_id"` +} + +// Informs TDLib that a web app is being opened from attachment menu, a botMenuButton button, an internalLinkTypeAttachmentMenuBot link, or an inlineKeyboardButtonTypeWebApp button. For each bot, a confirmation alert about data sent to the bot must be shown once +func (client *Client) OpenWebApp(req *OpenWebAppRequest) (*WebAppInfo, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "openWebApp", + }, + Data: map[string]interface{}{ + "chat_id": req.ChatId, + "bot_user_id": req.BotUserId, + "url": req.Url, + "theme": req.Theme, + "reply_to_message_id": req.ReplyToMessageId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalWebAppInfo(result.Data) +} + +type CloseWebAppRequest struct { + // Identifier of web app launch, received from openWebApp + WebAppLaunchId JsonInt64 `json:"web_app_launch_id"` +} + +// Informs TDLib that a previously opened web app was closed +func (client *Client) CloseWebApp(req *CloseWebAppRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "closeWebApp", + }, + Data: map[string]interface{}{ + "web_app_launch_id": req.WebAppLaunchId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + +type AnswerWebAppQueryRequest struct { + // Identifier of the web app query + WebAppQueryId string `json:"web_app_query_id"` + // The result of the query + Result InputInlineQueryResult `json:"result"` +} + +// Sets the result of interaction with a web app and sends corresponding message on behalf of the user to the chat from which the query originated; for bots only +func (client *Client) AnswerWebAppQuery(req *AnswerWebAppQueryRequest) (*SentWebAppMessage, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "answerWebAppQuery", + }, + Data: map[string]interface{}{ + "web_app_query_id": req.WebAppQueryId, + "result": req.Result, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalSentWebAppMessage(result.Data) +} + type GetCallbackQueryAnswerRequest struct { // Identifier of the chat with the message ChatId int64 `json:"chat_id"` @@ -4080,7 +4400,7 @@ type AnswerCallbackQueryRequest struct { CallbackQueryId JsonInt64 `json:"callback_query_id"` // Text of the answer Text string `json:"text"` - // If true, an alert must be shown to the user instead of a toast notification + // Pass true to show an alert to the user instead of a toast notification ShowAlert bool `json:"show_alert"` // URL to be opened Url string `json:"url"` @@ -4179,7 +4499,7 @@ type SetGameScoreRequest struct { ChatId int64 `json:"chat_id"` // Identifier of the message MessageId int64 `json:"message_id"` - // True, if the message needs to be edited + // Pass true to edit the game message to include the current scoreboard EditMessage bool `json:"edit_message"` // User identifier UserId int64 `json:"user_id"` @@ -4218,7 +4538,7 @@ func (client *Client) SetGameScore(req *SetGameScoreRequest) (*Message, error) { type SetInlineGameScoreRequest struct { // Inline message identifier InlineMessageId string `json:"inline_message_id"` - // True, if the message needs to be edited + // Pass true to edit the game message to include the current scoreboard EditMessage bool `json:"edit_message"` // User identifier UserId int64 `json:"user_id"` @@ -4434,11 +4754,11 @@ type ViewMessagesRequest struct { MessageThreadId int64 `json:"message_thread_id"` // The identifiers of the messages being viewed MessageIds []int64 `json:"message_ids"` - // True, if messages in closed chats must be marked as read by the request + // Pass true to mark as read the specified messages even the chat is closed ForceRead bool `json:"force_read"` } -// Informs TDLib that messages are being viewed by the user. Many useful activities depend on whether the messages are currently being viewed or not (e.g., marking messages as read, incrementing a view counter, updating a view counter, removing deleted messages in supergroups and channels) +// Informs TDLib that messages are being viewed by the user. Sponsored messages must be marked as viewed only when the entire text of the message is shown on the screen (excluding the button). Many useful activities depend on whether the messages are currently being viewed or not (e.g., marking messages as read, incrementing a view counter, updating a view counter, removing deleted messages in supergroups and channels) func (client *Client) ViewMessages(req *ViewMessagesRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ @@ -4547,6 +4867,9 @@ func (client *Client) GetInternalLinkType(req *GetInternalLinkTypeRequest) (Inte case TypeInternalLinkTypeActiveSessions: return UnmarshalInternalLinkTypeActiveSessions(result.Data) + case TypeInternalLinkTypeAttachmentMenuBot: + return UnmarshalInternalLinkTypeAttachmentMenuBot(result.Data) + case TypeInternalLinkTypeAuthenticationCode: return UnmarshalInternalLinkTypeAuthenticationCode(result.Data) @@ -4559,6 +4882,9 @@ func (client *Client) GetInternalLinkType(req *GetInternalLinkTypeRequest) (Inte case TypeInternalLinkTypeBotStartInGroup: return UnmarshalInternalLinkTypeBotStartInGroup(result.Data) + case TypeInternalLinkTypeBotAddToChannel: + return UnmarshalInternalLinkTypeBotAddToChannel(result.Data) + case TypeInternalLinkTypeChangePhoneNumber: return UnmarshalInternalLinkTypeChangePhoneNumber(result.Data) @@ -4574,6 +4900,9 @@ func (client *Client) GetInternalLinkType(req *GetInternalLinkTypeRequest) (Inte case TypeInternalLinkTypeLanguagePack: return UnmarshalInternalLinkTypeLanguagePack(result.Data) + case TypeInternalLinkTypeLanguageSettings: + return UnmarshalInternalLinkTypeLanguageSettings(result.Data) + case TypeInternalLinkTypeMessage: return UnmarshalInternalLinkTypeMessage(result.Data) @@ -4586,6 +4915,9 @@ func (client *Client) GetInternalLinkType(req *GetInternalLinkTypeRequest) (Inte case TypeInternalLinkTypePhoneNumberConfirmation: return UnmarshalInternalLinkTypePhoneNumberConfirmation(result.Data) + case TypeInternalLinkTypePrivacyAndSecuritySettings: + return UnmarshalInternalLinkTypePrivacyAndSecuritySettings(result.Data) + case TypeInternalLinkTypeProxy: return UnmarshalInternalLinkTypeProxy(result.Data) @@ -4613,6 +4945,9 @@ func (client *Client) GetInternalLinkType(req *GetInternalLinkTypeRequest) (Inte case TypeInternalLinkTypeUnsupportedProxy: return UnmarshalInternalLinkTypeUnsupportedProxy(result.Data) + case TypeInternalLinkTypeUserPhoneNumber: + return UnmarshalInternalLinkTypeUserPhoneNumber(result.Data) + case TypeInternalLinkTypeVideoChat: return UnmarshalInternalLinkTypeVideoChat(result.Data) @@ -4659,7 +4994,7 @@ func (client *Client) GetExternalLinkInfo(req *GetExternalLinkInfoRequest) (Logi type GetExternalLinkRequest struct { // The HTTP link Link string `json:"link"` - // True, if the current user allowed the bot, returned in getExternalLinkInfo, to send them messages + // Pass true if the current user allowed the bot, returned in getExternalLinkInfo, to send them messages AllowWriteAccess bool `json:"allow_write_access"` } @@ -4711,10 +5046,36 @@ func (client *Client) ReadAllChatMentions(req *ReadAllChatMentionsRequest) (*Ok, return UnmarshalOk(result.Data) } +type ReadAllChatReactionsRequest struct { + // Chat identifier + ChatId int64 `json:"chat_id"` +} + +// Marks all reactions in a chat as read +func (client *Client) ReadAllChatReactions(req *ReadAllChatReactionsRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "readAllChatReactions", + }, + Data: map[string]interface{}{ + "chat_id": req.ChatId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + type CreatePrivateChatRequest struct { // User identifier UserId int64 `json:"user_id"` - // If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect + // Pass true to create the chat without a network request. In this case all information about the chat except its type, title and photo can be incorrect Force bool `json:"force"` } @@ -4743,7 +5104,7 @@ func (client *Client) CreatePrivateChat(req *CreatePrivateChatRequest) (*Chat, e type CreateBasicGroupChatRequest struct { // Basic group identifier BasicGroupId int64 `json:"basic_group_id"` - // If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect + // Pass true to create the chat without a network request. In this case all information about the chat except its type, title and photo can be incorrect Force bool `json:"force"` } @@ -4772,7 +5133,7 @@ func (client *Client) CreateBasicGroupChat(req *CreateBasicGroupChatRequest) (*C type CreateSupergroupChatRequest struct { // Supergroup or channel identifier SupergroupId int64 `json:"supergroup_id"` - // If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect + // Pass true to create the chat without a network request. In this case all information about the chat except its type, title and photo can be incorrect Force bool `json:"force"` } @@ -4856,13 +5217,13 @@ func (client *Client) CreateNewBasicGroupChat(req *CreateNewBasicGroupChatReques type CreateNewSupergroupChatRequest struct { // Title of the new chat; 1-128 characters Title string `json:"title"` - // True, if a channel chat needs to be created + // Pass true to create a channel chat IsChannel bool `json:"is_channel"` // Chat description; 0-255 characters Description string `json:"description"` // Chat location if a location-based supergroup is being created; pass null to create an ordinary supergroup chat Location *ChatLocation `json:"location"` - // True, if the supergroup is created for importing messages using importMessage + // Pass true to create a supergroup for importing messages using importMessage ForImport bool `json:"for_import"` } @@ -5234,18 +5595,18 @@ func (client *Client) SetChatPhoto(req *SetChatPhotoRequest) (*Ok, error) { return UnmarshalOk(result.Data) } -type SetChatMessageTtlSettingRequest struct { +type SetChatMessageTtlRequest struct { // Chat identifier ChatId int64 `json:"chat_id"` - // New TTL value, in seconds; must be one of 0, 86400, 7 * 86400, or 31 * 86400 unless the chat is secret + // New TTL value, in seconds; unless the chat is secret, it must be from 0 up to 365 * 86400 and be divisible by 86400 Ttl int32 `json:"ttl"` } -// Changes the message TTL setting (sets a new self-destruct timer) in a chat. Requires can_delete_messages administrator right in basic groups, supergroups and channels Message TTL setting of a chat with the current user (Saved Messages) and the chat 777000 (Telegram) can't be changed -func (client *Client) SetChatMessageTtlSetting(req *SetChatMessageTtlSettingRequest) (*Ok, error) { +// Changes the message TTL in a chat. Requires can_delete_messages administrator right in basic groups, supergroups and channels Message TTL can't be changed in a chat with the current user (Saved Messages) and the chat 777000 (Telegram). +func (client *Client) SetChatMessageTtl(req *SetChatMessageTtlRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ - Type: "setChatMessageTtlSetting", + Type: "setChatMessageTtl", }, Data: map[string]interface{}{ "chat_id": req.ChatId, @@ -5385,7 +5746,7 @@ func (client *Client) SetChatNotificationSettings(req *SetChatNotificationSettin type ToggleChatHasProtectedContentRequest struct { // Chat identifier ChatId int64 `json:"chat_id"` - // True, if chat content can't be saved locally, forwarded, or copied + // New value of has_protected_content HasProtectedContent bool `json:"has_protected_content"` } @@ -5469,6 +5830,35 @@ func (client *Client) ToggleChatDefaultDisableNotification(req *ToggleChatDefaul return UnmarshalOk(result.Data) } +type SetChatAvailableReactionsRequest struct { + // Identifier of the chat + ChatId int64 `json:"chat_id"` + // New list of reactions, available in the chat. All reactions must be active + AvailableReactions []string `json:"available_reactions"` +} + +// Changes reactions, available in a chat. Available for basic groups, supergroups, and channels. Requires can_change_info administrator right +func (client *Client) SetChatAvailableReactions(req *SetChatAvailableReactionsRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "setChatAvailableReactions", + }, + Data: map[string]interface{}{ + "chat_id": req.ChatId, + "available_reactions": req.AvailableReactions, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + type SetChatClientDataRequest struct { // Chat identifier ChatId int64 `json:"chat_id"` @@ -5619,9 +6009,9 @@ type PinChatMessageRequest struct { ChatId int64 `json:"chat_id"` // Identifier of the new pinned message MessageId int64 `json:"message_id"` - // True, if there must be no notification about the pinned message. Notifications are always disabled in channels and private chats + // Pass true to disable notification about the pinned message. Notifications are always disabled in channels and private chats DisableNotification bool `json:"disable_notification"` - // True, if the message needs to be pinned for one side only; private chats only + // Pass true to pin the message only for self; private chats only OnlyForSelf bool `json:"only_for_self"` } @@ -5795,7 +6185,7 @@ type AddChatMembersRequest struct { UserIds []int64 `json:"user_ids"` } -// Adds multiple new members to a chat. Currently this method is only available for 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 +// Adds multiple new members to a chat. Currently, this method is only available for 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 func (client *Client) AddChatMembers(req *AddChatMembersRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ @@ -5854,7 +6244,7 @@ type BanChatMemberRequest struct { ChatId int64 `json:"chat_id"` // Member identifier MemberId MessageSender `json:"member_id"` - // Point in time (Unix timestamp) when the user will be unbanned; 0 if never. If the user is banned for more than 366 days or for less than 30 seconds from the current time, the user is considered to be banned forever. Ignored in basic groups + // Point in time (Unix timestamp) when the user will be unbanned; 0 if never. If the user is banned for more than 366 days or for less than 30 seconds from the current time, the user is considered to be banned forever. Ignored in basic groups and if a chat is banned BannedUntilDate int32 `json:"banned_until_date"` // Pass true to delete all messages in the chat for the user that is being removed. Always true for supergroups and channels RevokeMessages bool `json:"revoke_messages"` @@ -6041,11 +6431,11 @@ func (client *Client) GetChatAdministrators(req *GetChatAdministratorsRequest) ( } type ClearAllDraftMessagesRequest struct { - // If true, local draft messages in secret chats will not be cleared + // Pass true to keep local message drafts in secret chats ExcludeSecretChats bool `json:"exclude_secret_chats"` } -// Clears draft messages in all chats +// Clears message drafts in all chats func (client *Client) ClearAllDraftMessages(req *ClearAllDraftMessagesRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ @@ -6066,10 +6456,107 @@ func (client *Client) ClearAllDraftMessages(req *ClearAllDraftMessagesRequest) ( return UnmarshalOk(result.Data) } +type GetSavedNotificationSoundRequest struct { + // Identifier of the notification sound + NotificationSoundId JsonInt64 `json:"notification_sound_id"` +} + +// Returns saved notification sound by its identifier. Returns a 404 error if there is no saved notification sound with the specified identifier +func (client *Client) GetSavedNotificationSound(req *GetSavedNotificationSoundRequest) (*NotificationSounds, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "getSavedNotificationSound", + }, + Data: map[string]interface{}{ + "notification_sound_id": req.NotificationSoundId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalNotificationSounds(result.Data) +} + +// Returns list of saved notification sounds. If a sound isn't in the list, then default sound needs to be used +func (client *Client) GetSavedNotificationSounds() (*NotificationSounds, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "getSavedNotificationSounds", + }, + Data: map[string]interface{}{}, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalNotificationSounds(result.Data) +} + +type AddSavedNotificationSoundRequest struct { + // Notification sound file to add + Sound InputFile `json:"sound"` +} + +// Adds a new notification sound to the list of saved notification sounds. The new notification sound is added to the top of the list. If it is already in the list, it is position isn't changed +func (client *Client) AddSavedNotificationSound(req *AddSavedNotificationSoundRequest) (*NotificationSound, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "addSavedNotificationSound", + }, + Data: map[string]interface{}{ + "sound": req.Sound, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalNotificationSound(result.Data) +} + +type RemoveSavedNotificationSoundRequest struct { + // Identifier of the notification sound + NotificationSoundId JsonInt64 `json:"notification_sound_id"` +} + +// Removes a notification sound from the list of saved notification sounds +func (client *Client) RemoveSavedNotificationSound(req *RemoveSavedNotificationSoundRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "removeSavedNotificationSound", + }, + Data: map[string]interface{}{ + "notification_sound_id": req.NotificationSoundId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + type GetChatNotificationSettingsExceptionsRequest struct { // If specified, only chats from the scope will be returned; pass null to return chats from all scopes Scope NotificationSettingsScope `json:"scope"` - // If true, also chats with non-default sound will be returned + // Pass true to include in the response chats with only non-default sound CompareSound bool `json:"compare_sound"` } @@ -6150,7 +6637,7 @@ func (client *Client) SetScopeNotificationSettings(req *SetScopeNotificationSett return UnmarshalOk(result.Data) } -// Resets all notification settings to their default values. By default, all chats are unmuted, the sound is set to "default" and message previews are shown +// Resets all notification settings to their default values. By default, all chats are unmuted and message previews are shown func (client *Client) ResetAllNotificationSettings() (*Ok, error) { result, err := client.Send(Request{ meta: meta{ @@ -6174,11 +6661,11 @@ type ToggleChatIsPinnedRequest struct { ChatList ChatList `json:"chat_list"` // Chat identifier ChatId int64 `json:"chat_id"` - // True, if the chat is pinned + // Pass true to pin the chat; pass false to unpin it IsPinned bool `json:"is_pinned"` } -// Changes the pinned state of a chat. There can be up to GetOption("pinned_chat_count_max")/GetOption("pinned_archived_chat_count_max") pinned non-secret chats and the same number of secret chats in the main/arhive chat list +// Changes the pinned state of a chat. There can be up to GetOption("pinned_chat_count_max")/GetOption("pinned_archived_chat_count_max") pinned non-secret chats and the same number of secret chats in the main/archive chat list func (client *Client) ToggleChatIsPinned(req *ToggleChatIsPinnedRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ @@ -6230,16 +6717,71 @@ func (client *Client) SetPinnedChats(req *SetPinnedChatsRequest) (*Ok, error) { return UnmarshalOk(result.Data) } +type GetAttachmentMenuBotRequest struct { + // Bot's user identifier + BotUserId int64 `json:"bot_user_id"` +} + +// Returns information about a bot that can be added to attachment menu +func (client *Client) GetAttachmentMenuBot(req *GetAttachmentMenuBotRequest) (*AttachmentMenuBot, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "getAttachmentMenuBot", + }, + Data: map[string]interface{}{ + "bot_user_id": req.BotUserId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalAttachmentMenuBot(result.Data) +} + +type ToggleBotIsAddedToAttachmentMenuRequest struct { + // Bot's user identifier + BotUserId int64 `json:"bot_user_id"` + // Pass true to add the bot to attachment menu; pass false to remove the bot from attachment menu + IsAdded bool `json:"is_added"` +} + +// Adds or removes a bot to attachment menu. Bot can be added to attachment menu, only if userTypeBot.can_be_added_to_attachment_menu == true +func (client *Client) ToggleBotIsAddedToAttachmentMenu(req *ToggleBotIsAddedToAttachmentMenuRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "toggleBotIsAddedToAttachmentMenu", + }, + Data: map[string]interface{}{ + "bot_user_id": req.BotUserId, + "is_added": req.IsAdded, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + type DownloadFileRequest struct { // Identifier of the file to download FileId int32 `json:"file_id"` - // Priority of the download (1-32). The higher the priority, the earlier the file will be downloaded. If the priorities of two files are equal, then the last one for which downloadFile was called will be downloaded first + // Priority of the download (1-32). The higher the priority, the earlier the file will be downloaded. If the priorities of two files are equal, then the last one for which downloadFile/addFileToDownloads was called will be downloaded first Priority int32 `json:"priority"` // The starting position from which the file needs to be downloaded Offset int32 `json:"offset"` // Number of bytes which need to be downloaded starting from the "offset" position before the download will automatically be canceled; use 0 to download without a limit Limit int32 `json:"limit"` - // If false, this request returns file state just after the download has been started. If true, this request returns file state only after the download has succeeded, has failed, has been canceled or a new downloadFile request with different offset/limit parameters was sent + // Pass true to return response only after the file download has succeeded, has failed, has been canceled, or a new downloadFile request with different offset/limit parameters was sent; pass false to return file state immediately, just after the download has been started Synchronous bool `json:"synchronous"` } @@ -6564,6 +7106,195 @@ func (client *Client) DeleteFile(req *DeleteFileRequest) (*Ok, error) { return UnmarshalOk(result.Data) } +type AddFileToDownloadsRequest struct { + // Identifier of the file to download + FileId int32 `json:"file_id"` + // Chat identifier of the message with the file + ChatId int64 `json:"chat_id"` + // Message identifier + MessageId int64 `json:"message_id"` + // Priority of the download (1-32). The higher the priority, the earlier the file will be downloaded. If the priorities of two files are equal, then the last one for which downloadFile/addFileToDownloads was called will be downloaded first + Priority int32 `json:"priority"` +} + +// Adds a file from a message to the list of file downloads. Download progress and completion of the download will be notified through updateFile updates. If message database is used, the list of file downloads is persistent across application restarts. The downloading is independent from download using downloadFile, i.e. it continues if downloadFile is canceled or is used to download a part of the file +func (client *Client) AddFileToDownloads(req *AddFileToDownloadsRequest) (*File, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "addFileToDownloads", + }, + Data: map[string]interface{}{ + "file_id": req.FileId, + "chat_id": req.ChatId, + "message_id": req.MessageId, + "priority": req.Priority, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalFile(result.Data) +} + +type ToggleDownloadIsPausedRequest struct { + // Identifier of the downloaded file + FileId int32 `json:"file_id"` + // Pass true if the download is paused + IsPaused bool `json:"is_paused"` +} + +// Changes pause state of a file in the file download list +func (client *Client) ToggleDownloadIsPaused(req *ToggleDownloadIsPausedRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "toggleDownloadIsPaused", + }, + Data: map[string]interface{}{ + "file_id": req.FileId, + "is_paused": req.IsPaused, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + +type ToggleAllDownloadsArePausedRequest struct { + // Pass true to pause all downloads; pass false to unpause them + ArePaused bool `json:"are_paused"` +} + +// Changes pause state of all files in the file download list +func (client *Client) ToggleAllDownloadsArePaused(req *ToggleAllDownloadsArePausedRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "toggleAllDownloadsArePaused", + }, + Data: map[string]interface{}{ + "are_paused": req.ArePaused, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + +type RemoveFileFromDownloadsRequest struct { + // Identifier of the downloaded file + FileId int32 `json:"file_id"` + // Pass true to delete the file from the TDLib file cache + DeleteFromCache bool `json:"delete_from_cache"` +} + +// Removes a file from the file download list +func (client *Client) RemoveFileFromDownloads(req *RemoveFileFromDownloadsRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "removeFileFromDownloads", + }, + Data: map[string]interface{}{ + "file_id": req.FileId, + "delete_from_cache": req.DeleteFromCache, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + +type RemoveAllFilesFromDownloadsRequest struct { + // Pass true to remove only active downloads, including paused + OnlyActive bool `json:"only_active"` + // Pass true to remove only completed downloads + OnlyCompleted bool `json:"only_completed"` + // Pass true to delete the file from the TDLib file cache + DeleteFromCache bool `json:"delete_from_cache"` +} + +// Removes all files from the file download list +func (client *Client) RemoveAllFilesFromDownloads(req *RemoveAllFilesFromDownloadsRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "removeAllFilesFromDownloads", + }, + Data: map[string]interface{}{ + "only_active": req.OnlyActive, + "only_completed": req.OnlyCompleted, + "delete_from_cache": req.DeleteFromCache, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + +type SearchFileDownloadsRequest struct { + // Query to search for; may be empty to return all downloaded files + Query string `json:"query"` + // Pass true to search only for active downloads, including paused + OnlyActive bool `json:"only_active"` + // Pass true to search only for completed downloads + OnlyCompleted bool `json:"only_completed"` + // Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results + Offset string `json:"offset"` + // The maximum number of files to be returned + Limit int32 `json:"limit"` +} + +// Searches for files in the file download list or recently downloaded files from the list +func (client *Client) SearchFileDownloads(req *SearchFileDownloadsRequest) (*FoundFileDownloads, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "searchFileDownloads", + }, + Data: map[string]interface{}{ + "query": req.Query, + "only_active": req.OnlyActive, + "only_completed": req.OnlyCompleted, + "offset": req.Offset, + "limit": req.Limit, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalFoundFileDownloads(result.Data) +} + type GetMessageFileTypeRequest struct { // Beginning of the message file; up to 100 first lines MessageFileHead string `json:"message_file_head"` @@ -6692,10 +7423,10 @@ type CreateChatInviteLinkRequest struct { // Invite link name; 0-32 characters Name string `json:"name"` // Point in time (Unix timestamp) when the link will expire; pass 0 if never - ExpireDate int32 `json:"expire_date"` - // The maximum number of chat members that can join the chat by the link simultaneously; 0-99999; pass 0 if not limited + ExpirationDate int32 `json:"expiration_date"` + // The maximum number of chat members that can join the chat via the link simultaneously; 0-99999; pass 0 if not limited MemberLimit int32 `json:"member_limit"` - // True, if the link only creates join request. If true, member_limit must not be specified + // Pass true if users joining the chat via the link need to be approved by chat administrators. In this case, member_limit must be 0 CreatesJoinRequest bool `json:"creates_join_request"` } @@ -6708,7 +7439,7 @@ func (client *Client) CreateChatInviteLink(req *CreateChatInviteLinkRequest) (*C Data: map[string]interface{}{ "chat_id": req.ChatId, "name": req.Name, - "expire_date": req.ExpireDate, + "expiration_date": req.ExpirationDate, "member_limit": req.MemberLimit, "creates_join_request": req.CreatesJoinRequest, }, @@ -6732,10 +7463,10 @@ type EditChatInviteLinkRequest struct { // Invite link name; 0-32 characters Name string `json:"name"` // Point in time (Unix timestamp) when the link will expire; pass 0 if never - ExpireDate int32 `json:"expire_date"` - // The maximum number of chat members that can join the chat by the link simultaneously; 0-99999; pass 0 if not limited + ExpirationDate int32 `json:"expiration_date"` + // The maximum number of chat members that can join the chat via the link simultaneously; 0-99999; pass 0 if not limited MemberLimit int32 `json:"member_limit"` - // True, if the link only creates join request. If true, member_limit must not be specified + // Pass true if users joining the chat via the link need to be approved by chat administrators. In this case, member_limit must be 0 CreatesJoinRequest bool `json:"creates_join_request"` } @@ -6749,7 +7480,7 @@ func (client *Client) EditChatInviteLink(req *EditChatInviteLinkRequest) (*ChatI "chat_id": req.ChatId, "invite_link": req.InviteLink, "name": req.Name, - "expire_date": req.ExpireDate, + "expiration_date": req.ExpirationDate, "member_limit": req.MemberLimit, "creates_join_request": req.CreatesJoinRequest, }, @@ -6872,7 +7603,7 @@ type GetChatInviteLinkMembersRequest struct { Limit int32 `json:"limit"` } -// Returns chat members joined a chat by an invite link. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links +// Returns chat members joined a chat via an invite link. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links func (client *Client) GetChatInviteLinkMembers(req *GetChatInviteLinkMembersRequest) (*ChatInviteLinkMembers, error) { result, err := client.Send(Request{ meta: meta{ @@ -7044,7 +7775,7 @@ type GetChatJoinRequestsRequest struct { Query string `json:"query"` // A chat join request from which to return next requests; pass null to get results from the beginning OffsetRequest *ChatJoinRequest `json:"offset_request"` - // The maximum number of chat join requests to return + // The maximum number of requests to join the chat to return Limit int32 `json:"limit"` } @@ -7078,7 +7809,7 @@ type ProcessChatJoinRequestRequest struct { ChatId int64 `json:"chat_id"` // Identifier of the user that sent the request UserId int64 `json:"user_id"` - // True, if the request is approved. Otherwise the request is declived + // Pass true to approve the request; pass false to decline it Approve bool `json:"approve"` } @@ -7110,7 +7841,7 @@ type ProcessChatJoinRequestsRequest struct { ChatId int64 `json:"chat_id"` // Invite link for which to process join requests. If empty, all join requests will be processed. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links InviteLink string `json:"invite_link"` - // True, if the requests are approved. Otherwise the requests are declived + // Pass true to approve all requests; pass false to decline them Approve bool `json:"approve"` } @@ -7142,7 +7873,7 @@ type CreateCallRequest struct { UserId int64 `json:"user_id"` // The call protocols supported by the application Protocol *CallProtocol `json:"protocol"` - // True, if a video call needs to be created + // Pass true to create a video call IsVideo bool `json:"is_video"` } @@ -7230,11 +7961,11 @@ func (client *Client) SendCallSignalingData(req *SendCallSignalingDataRequest) ( type DiscardCallRequest struct { // Call identifier CallId int32 `json:"call_id"` - // True, if the user was disconnected + // Pass true if the user was disconnected IsDisconnected bool `json:"is_disconnected"` // The call duration, in seconds Duration int32 `json:"duration"` - // True, if the call was a video call + // Pass true if the call was a video call IsVideo bool `json:"is_video"` // Identifier of the connection used during the call ConnectionId JsonInt64 `json:"connection_id"` @@ -7334,7 +8065,7 @@ type GetVideoChatAvailableParticipantsRequest struct { ChatId int64 `json:"chat_id"` } -// Returns list of participant identifiers, which can be used to join video chats in a chat +// Returns list of participant identifiers, on whose behalf a video chat in the chat can be joined func (client *Client) GetVideoChatAvailableParticipants(req *GetVideoChatAvailableParticipantsRequest) (*MessageSenders, error) { result, err := client.Send(Request{ meta: meta{ @@ -7362,7 +8093,7 @@ type SetVideoChatDefaultParticipantRequest struct { DefaultParticipantId MessageSender `json:"default_participant_id"` } -// Changes default participant identifier, which can be used to join video chats in a chat +// Changes default participant identifier, on whose behalf a video chat in the chat will be joined func (client *Client) SetVideoChatDefaultParticipant(req *SetVideoChatDefaultParticipantRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ @@ -7385,12 +8116,14 @@ func (client *Client) SetVideoChatDefaultParticipant(req *SetVideoChatDefaultPar } type CreateVideoChatRequest struct { - // Chat identifier, in which the video chat will be created + // Identifier of a chat in which the video chat will be created ChatId int64 `json:"chat_id"` // Group call title; if empty, chat title will be used Title string `json:"title"` // Point in time (Unix timestamp) when the group call is supposed to be started by an administrator; 0 to start the video chat immediately. The date must be at least 10 seconds and at most 8 days in the future StartDate int32 `json:"start_date"` + // Pass true to create an RTMP stream instead of an ordinary video chat; requires creator privileges + IsRtmpStream bool `json:"is_rtmp_stream"` } // Creates a video chat (a group call bound to a chat). Available only for basic groups, supergroups and channels; requires can_manage_video_chats rights @@ -7400,9 +8133,10 @@ func (client *Client) CreateVideoChat(req *CreateVideoChatRequest) (*GroupCallId Type: "createVideoChat", }, Data: map[string]interface{}{ - "chat_id": req.ChatId, - "title": req.Title, - "start_date": req.StartDate, + "chat_id": req.ChatId, + "title": req.Title, + "start_date": req.StartDate, + "is_rtmp_stream": req.IsRtmpStream, }, }) if err != nil { @@ -7416,6 +8150,58 @@ func (client *Client) CreateVideoChat(req *CreateVideoChatRequest) (*GroupCallId return UnmarshalGroupCallId(result.Data) } +type GetVideoChatRtmpUrlRequest struct { + // Chat identifier + ChatId int64 `json:"chat_id"` +} + +// Returns RTMP URL for streaming to the chat; requires creator privileges +func (client *Client) GetVideoChatRtmpUrl(req *GetVideoChatRtmpUrlRequest) (*RtmpUrl, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "getVideoChatRtmpUrl", + }, + Data: map[string]interface{}{ + "chat_id": req.ChatId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalRtmpUrl(result.Data) +} + +type ReplaceVideoChatRtmpUrlRequest struct { + // Chat identifier + ChatId int64 `json:"chat_id"` +} + +// Replaces the current RTMP URL for streaming to the chat; requires creator privileges +func (client *Client) ReplaceVideoChatRtmpUrl(req *ReplaceVideoChatRtmpUrlRequest) (*RtmpUrl, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "replaceVideoChatRtmpUrl", + }, + Data: map[string]interface{}{ + "chat_id": req.ChatId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalRtmpUrl(result.Data) +} + type GetGroupCallRequest struct { // Group call identifier GroupCallId int32 `json:"group_call_id"` @@ -7506,9 +8292,9 @@ type JoinGroupCallRequest struct { AudioSourceId int32 `json:"audio_source_id"` // Group call join payload; received from tgcalls Payload string `json:"payload"` - // True, if the user's microphone is muted + // Pass true to join the call with muted microphone IsMuted bool `json:"is_muted"` - // True, if the user's video is enabled + // Pass true if the user's video is enabled IsMyVideoEnabled bool `json:"is_my_video_enabled"` // If non-empty, invite hash to be used to join the group call without being muted by administrators InviteHash string `json:"invite_hash"` @@ -7686,32 +8472,6 @@ func (client *Client) ToggleGroupCallMuteNewParticipants(req *ToggleGroupCallMut return UnmarshalOk(result.Data) } -type RevokeGroupCallInviteLinkRequest struct { - // Group call identifier - GroupCallId int32 `json:"group_call_id"` -} - -// Revokes invite link for a group call. Requires groupCall.can_be_managed group call flag -func (client *Client) RevokeGroupCallInviteLink(req *RevokeGroupCallInviteLinkRequest) (*Ok, error) { - result, err := client.Send(Request{ - meta: meta{ - Type: "revokeGroupCallInviteLink", - }, - Data: map[string]interface{}{ - "group_call_id": req.GroupCallId, - }, - }) - if err != nil { - return nil, err - } - - if result.Type == "error" { - return nil, buildResponseError(result.Data) - } - - return UnmarshalOk(result.Data) -} - type InviteGroupCallParticipantsRequest struct { // Group call identifier GroupCallId int32 `json:"group_call_id"` @@ -7770,6 +8530,32 @@ func (client *Client) GetGroupCallInviteLink(req *GetGroupCallInviteLinkRequest) return UnmarshalHttpUrl(result.Data) } +type RevokeGroupCallInviteLinkRequest struct { + // Group call identifier + GroupCallId int32 `json:"group_call_id"` +} + +// Revokes invite link for a group call. Requires groupCall.can_be_managed group call flag +func (client *Client) RevokeGroupCallInviteLink(req *RevokeGroupCallInviteLinkRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "revokeGroupCallInviteLink", + }, + Data: map[string]interface{}{ + "group_call_id": req.GroupCallId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + type StartGroupCallRecordingRequest struct { // Group call identifier GroupCallId int32 `json:"group_call_id"` @@ -7894,7 +8680,7 @@ type SetGroupCallParticipantIsSpeakingRequest struct { GroupCallId int32 `json:"group_call_id"` // Group call participant's synchronization audio source identifier, or 0 for the current user AudioSource int32 `json:"audio_source"` - // True, if the user is speaking + // Pass true if the user is speaking IsSpeaking bool `json:"is_speaking"` } @@ -7926,7 +8712,7 @@ type ToggleGroupCallParticipantIsMutedRequest struct { GroupCallId int32 `json:"group_call_id"` // Participant identifier ParticipantId MessageSender `json:"participant_id"` - // Pass true if the user must be muted and false otherwise + // Pass true to mute the user; pass false to unmute the them IsMuted bool `json:"is_muted"` } @@ -8072,16 +8858,16 @@ func (client *Client) LeaveGroupCall(req *LeaveGroupCallRequest) (*Ok, error) { return UnmarshalOk(result.Data) } -type DiscardGroupCallRequest struct { +type EndGroupCallRequest struct { // Group call identifier GroupCallId int32 `json:"group_call_id"` } -// Discards a group call. Requires groupCall.can_be_managed -func (client *Client) DiscardGroupCall(req *DiscardGroupCallRequest) (*Ok, error) { +// Ends a group call. Requires groupCall.can_be_managed +func (client *Client) EndGroupCall(req *EndGroupCallRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ - Type: "discardGroupCall", + Type: "endGroupCall", }, Data: map[string]interface{}{ "group_call_id": req.GroupCallId, @@ -8098,6 +8884,32 @@ func (client *Client) DiscardGroupCall(req *DiscardGroupCallRequest) (*Ok, error return UnmarshalOk(result.Data) } +type GetGroupCallStreamsRequest struct { + // Group call identifier + GroupCallId int32 `json:"group_call_id"` +} + +// Returns information about available group call streams +func (client *Client) GetGroupCallStreams(req *GetGroupCallStreamsRequest) (*GroupCallStreams, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "getGroupCallStreams", + }, + Data: map[string]interface{}{ + "group_call_id": req.GroupCallId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalGroupCallStreams(result.Data) +} + type GetGroupCallStreamSegmentRequest struct { // Group call identifier GroupCallId int32 `json:"group_call_id"` @@ -8168,11 +8980,11 @@ func (client *Client) ToggleMessageSenderIsBlocked(req *ToggleMessageSenderIsBlo type BlockMessageSenderFromRepliesRequest struct { // The identifier of an incoming message in the Replies chat MessageId int64 `json:"message_id"` - // Pass true if the message must be deleted + // Pass true to delete the message DeleteMessage bool `json:"delete_message"` - // Pass true if all messages from the same sender must be deleted + // Pass true to delete all messages from the same sender DeleteAllMessages bool `json:"delete_all_messages"` - // Pass true if the sender must be reported to the Telegram moderators + // Pass true to report the sender to the Telegram moderators ReportSpam bool `json:"report_spam"` } @@ -8230,9 +9042,9 @@ func (client *Client) GetBlockedMessageSenders(req *GetBlockedMessageSendersRequ } type AddContactRequest struct { - // The contact to add or edit; phone number can be empty and needs to be specified only if known, vCard is ignored + // The contact to add or edit; phone number may be empty and needs to be specified only if known, vCard is ignored Contact *Contact `json:"contact"` - // True, if the new contact needs to be allowed to see current user's phone number. A corresponding rule to userPrivacySettingShowPhoneNumber will be added if needed. Use the field userFullInfo.need_phone_number_privacy_exception to check whether the current user needs to be asked to share their phone number + // Pass true to share the current user's phone number with the new contact. A corresponding rule to userPrivacySettingShowPhoneNumber will be added if needed. Use the field userFullInfo.need_phone_number_privacy_exception to check whether the current user needs to be asked to share their phone number SharePhoneNumber bool `json:"share_phone_number"` } @@ -8422,6 +9234,32 @@ func (client *Client) ClearImportedContacts() (*Ok, error) { return UnmarshalOk(result.Data) } +type SearchUserByPhoneNumberRequest struct { + // Phone number to search for + PhoneNumber string `json:"phone_number"` +} + +// Searches a user by their phone number +func (client *Client) SearchUserByPhoneNumber(req *SearchUserByPhoneNumberRequest) (*User, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "searchUserByPhoneNumber", + }, + Data: map[string]interface{}{ + "phone_number": req.PhoneNumber, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalUser(result.Data) +} + type SharePhoneNumberRequest struct { // Identifier of the user with whom to share the phone number. The user must be a mutual contact UserId int64 `json:"user_id"` @@ -8630,7 +9468,7 @@ type GetAttachedStickerSetsRequest struct { FileId int32 `json:"file_id"` } -// Returns a list of sticker sets attached to a file. Currently only photos and videos can have attached sticker sets +// Returns a list of sticker sets attached to a file. Currently, only photos and videos can have attached sticker sets func (client *Client) GetAttachedStickerSets(req *GetAttachedStickerSetsRequest) (*StickerSets, error) { result, err := client.Send(Request{ meta: meta{ @@ -9058,7 +9896,7 @@ func (client *Client) GetStickerEmojis(req *GetStickerEmojisRequest) (*Emojis, e type SearchEmojisRequest struct { // Text to search for Text string `json:"text"` - // True, if only emojis, which exactly match text needs to be returned + // Pass true if only emojis, which exactly match the text, needs to be returned ExactMatch bool `json:"exact_match"` // List of possible IETF language tags of the user's input language; may be empty if unknown InputLanguageCodes []string `json:"input_language_codes"` @@ -9313,7 +10151,7 @@ func (client *Client) GetWebPagePreview(req *GetWebPagePreviewRequest) (*WebPage type GetWebPageInstantViewRequest struct { // The web page URL Url string `json:"url"` - // If true, the full instant view for the web page will be returned + // Pass true to get full instant view for the web page ForceFull bool `json:"force_full"` } @@ -9575,7 +10413,7 @@ func (client *Client) CheckChangePhoneNumberCode(req *CheckChangePhoneNumberCode type SetCommandsRequest struct { // The scope to which the commands are relevant; pass null to change commands in the default bot command scope Scope BotCommandScope `json:"scope"` - // A two-letter ISO 639-1 country code. If empty, the commands will be applied to all users from the given scope, for which language there are no dedicated commands + // A two-letter ISO 639-1 language code. If empty, the commands will be applied to all users from the given scope, for which language there are no dedicated commands LanguageCode string `json:"language_code"` // List of the bot's commands Commands []*BotCommand `json:"commands"` @@ -9607,7 +10445,7 @@ func (client *Client) SetCommands(req *SetCommandsRequest) (*Ok, error) { type DeleteCommandsRequest struct { // The scope to which the commands are relevant; pass null to delete commands in the default bot command scope Scope BotCommandScope `json:"scope"` - // A two-letter ISO 639-1 country code or an empty string + // A two-letter ISO 639-1 language code or an empty string LanguageCode string `json:"language_code"` } @@ -9636,7 +10474,7 @@ func (client *Client) DeleteCommands(req *DeleteCommandsRequest) (*Ok, error) { type GetCommandsRequest struct { // The scope to which the commands are relevant; pass null to get commands in the default bot command scope Scope BotCommandScope `json:"scope"` - // A two-letter ISO 639-1 country code or an empty string + // A two-letter ISO 639-1 language code or an empty string LanguageCode string `json:"language_code"` } @@ -9662,6 +10500,113 @@ func (client *Client) GetCommands(req *GetCommandsRequest) (*BotCommands, error) return UnmarshalBotCommands(result.Data) } +type SetMenuButtonRequest struct { + // Identifier of the user or 0 to set menu button for all users + UserId int64 `json:"user_id"` + // New menu button + MenuButton *BotMenuButton `json:"menu_button"` +} + +// Sets menu button for the given user or for all users; for bots only +func (client *Client) SetMenuButton(req *SetMenuButtonRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "setMenuButton", + }, + Data: map[string]interface{}{ + "user_id": req.UserId, + "menu_button": req.MenuButton, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + +type GetMenuButtonRequest struct { + // Identifier of the user or 0 to get the default menu button + UserId int64 `json:"user_id"` +} + +// Returns menu button set by the bot for the given user; for bots only +func (client *Client) GetMenuButton(req *GetMenuButtonRequest) (*BotMenuButton, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "getMenuButton", + }, + Data: map[string]interface{}{ + "user_id": req.UserId, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalBotMenuButton(result.Data) +} + +type SetDefaultGroupAdministratorRightsRequest struct { + // Default administrator rights for adding the bot to basic group and supergroup chats; may be null + DefaultGroupAdministratorRights *ChatAdministratorRights `json:"default_group_administrator_rights"` +} + +// Sets default administrator rights for adding the bot to basic group and supergroup chats; for bots only +func (client *Client) SetDefaultGroupAdministratorRights(req *SetDefaultGroupAdministratorRightsRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "setDefaultGroupAdministratorRights", + }, + Data: map[string]interface{}{ + "default_group_administrator_rights": req.DefaultGroupAdministratorRights, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + +type SetDefaultChannelAdministratorRightsRequest struct { + // Default administrator rights for adding the bot to channels; may be null + DefaultChannelAdministratorRights *ChatAdministratorRights `json:"default_channel_administrator_rights"` +} + +// Sets default administrator rights for adding the bot to channel chats; for bots only +func (client *Client) SetDefaultChannelAdministratorRights(req *SetDefaultChannelAdministratorRightsRequest) (*Ok, error) { + result, err := client.Send(Request{ + meta: meta{ + Type: "setDefaultChannelAdministratorRights", + }, + Data: map[string]interface{}{ + "default_channel_administrator_rights": req.DefaultChannelAdministratorRights, + }, + }) + if err != nil { + return nil, err + } + + if result.Type == "error" { + return nil, buildResponseError(result.Data) + } + + return UnmarshalOk(result.Data) +} + // Returns all active sessions of the current user func (client *Client) GetActiveSessions() (*Sessions, error) { result, err := client.Send(Request{ @@ -9729,7 +10674,7 @@ func (client *Client) TerminateAllOtherSessions() (*Ok, error) { type ToggleSessionCanAcceptCallsRequest struct { // Session identifier SessionId JsonInt64 `json:"session_id"` - // True, if incoming calls can be accepted by the session + // Pass true to allow accepting incoming calls by the session; pass false otherwise CanAcceptCalls bool `json:"can_accept_calls"` } @@ -9758,7 +10703,7 @@ func (client *Client) ToggleSessionCanAcceptCalls(req *ToggleSessionCanAcceptCal type ToggleSessionCanAcceptSecretChatsRequest struct { // Session identifier SessionId JsonInt64 `json:"session_id"` - // True, if incoming secret chats can be accepted by the session + // Pass true to allow accepring secret chats by the session; pass false otherwise CanAcceptSecretChats bool `json:"can_accept_secret_chats"` } @@ -10019,11 +10964,11 @@ func (client *Client) ToggleSupergroupIsBroadcastGroup(req *ToggleSupergroupIsBr type ReportSupergroupSpamRequest struct { // Supergroup identifier SupergroupId int64 `json:"supergroup_id"` - // Identifiers of messages sent in the supergroup. All messages must be sent by the same sender. This list must be non-empty + // Identifiers of messages to report MessageIds []int64 `json:"message_ids"` } -// Reports some messages from a message sender in a supergroup as spam; requires administrator rights in the supergroup +// Reports messages in a supergroup as spam; requires administrator rights in the supergroup func (client *Client) ReportSupergroupSpam(req *ReportSupergroupSpamRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ @@ -10153,7 +11098,7 @@ type GetPaymentFormRequest struct { // Message identifier MessageId int64 `json:"message_id"` // Preferred payment form theme; pass null to use the default theme - Theme *PaymentFormTheme `json:"theme"` + Theme *ThemeParameters `json:"theme"` } // Returns an invoice payment form. This method must be called when the user presses inlineKeyboardButtonBuy @@ -10186,7 +11131,7 @@ type ValidateOrderInfoRequest struct { MessageId int64 `json:"message_id"` // The order information, provided by the user; pass null if empty OrderInfo *OrderInfo `json:"order_info"` - // True, if the order information can be saved + // Pass true to save the order information AllowSave bool `json:"allow_save"` } @@ -10287,7 +11232,7 @@ func (client *Client) GetPaymentReceipt(req *GetPaymentReceiptRequest) (*Payment return UnmarshalPaymentReceipt(result.Data) } -// Returns saved order info, if any +// Returns saved order information. Returns a 404 error if there is no saved order information func (client *Client) GetSavedOrderInfo() (*OrderInfo, error) { result, err := client.Send(Request{ meta: meta{ @@ -10306,7 +11251,7 @@ func (client *Client) GetSavedOrderInfo() (*OrderInfo, error) { return UnmarshalOrderInfo(result.Data) } -// Deletes saved order info +// Deletes saved order information func (client *Client) DeleteSavedOrderInfo() (*Ok, error) { result, err := client.Send(Request{ meta: meta{ @@ -10364,7 +11309,7 @@ func (client *Client) GetSupportUser() (*User, error) { } type GetBackgroundsRequest struct { - // True, if the backgrounds must be ordered for dark theme + // Pass true to order returned backgrounds for a dark theme ForDarkTheme bool `json:"for_dark_theme"` } @@ -10449,7 +11394,7 @@ type SetBackgroundRequest struct { Background InputBackground `json:"background"` // Background type; pass null to use the default type of the remote background or to remove the current background Type BackgroundType `json:"type"` - // True, if the background is chosen for dark theme + // Pass true if the background is changed for a dark theme ForDarkTheme bool `json:"for_dark_theme"` } @@ -10522,7 +11467,7 @@ func (client *Client) ResetBackgrounds() (*Ok, error) { } type GetLocalizationTargetInfoRequest struct { - // If true, returns only locally available information without sending network requests + // Pass true to get only locally available information without sending network requests OnlyLocal bool `json:"only_local"` } @@ -11096,7 +12041,7 @@ func (client *Client) RemoveChatActionBar(req *RemoveChatActionBarRequest) (*Ok, type ReportChatRequest struct { // Chat identifier ChatId int64 `json:"chat_id"` - // Identifiers of reported messages, if any + // Identifiers of reported messages; may be empty to report the whole chat MessageIds []int64 `json:"message_ids"` // The reason for reporting the chat Reason ChatReportReason `json:"reason"` @@ -11104,7 +12049,7 @@ type ReportChatRequest struct { Text string `json:"text"` } -// Reports a chat to the Telegram moderators. A chat can be reported only from the chat action bar, or if this is a private chat with a bot, a private chat with a user sharing their location, a supergroup, or a channel, since other chats can't be checked by moderators +// Reports a chat to the Telegram moderators. A chat can be reported only from the chat action bar, or if chat.can_be_reported func (client *Client) ReportChat(req *ReportChatRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ @@ -11139,7 +12084,7 @@ type ReportChatPhotoRequest struct { Text string `json:"text"` } -// Reports a chat photo to the Telegram moderators. A chat photo can be reported only if this is a private chat with a bot, a private chat with a user sharing their location, a supergroup, or a channel, since other chats can't be checked by moderators +// Reports a chat photo to the Telegram moderators. A chat photo can be reported only if chat.can_be_reported func (client *Client) ReportChatPhoto(req *ReportChatPhotoRequest) (*Ok, error) { result, err := client.Send(Request{ meta: meta{ @@ -11170,7 +12115,7 @@ type GetChatStatisticsRequest struct { IsDark bool `json:"is_dark"` } -// 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 +// 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 func (client *Client) GetChatStatistics(req *GetChatStatisticsRequest) (ChatStatistics, error) { result, err := client.Send(Request{ meta: meta{ @@ -11346,7 +12291,7 @@ type OptimizeStorageRequest struct { Size int64 `json:"size"` // Limit on the time that has passed since the last time a file was accessed (or creation time for some filesystems). Pass -1 to use the default limit Ttl int32 `json:"ttl"` - // Limit on the total count of files after deletion. Pass -1 to use the default limit + // Limit on the total number of files after deletion. Pass -1 to use the default limit Count int32 `json:"count"` // The amount of time after the creation of a file during which it can't be deleted, in seconds. Pass -1 to use the default value ImmunityDelay int32 `json:"immunity_delay"` @@ -11418,7 +12363,7 @@ func (client *Client) SetNetworkType(req *SetNetworkTypeRequest) (*Ok, error) { } type GetNetworkStatisticsRequest struct { - // If true, returns only data for the current library launch + // Pass true to get statistics only for the current library launch OnlyCurrent bool `json:"only_current"` } @@ -12159,10 +13104,10 @@ type UploadStickerFileRequest struct { // Sticker file owner; ignored for regular users UserId int64 `json:"user_id"` // Sticker file to upload - Sticker InputSticker `json:"sticker"` + Sticker *InputSticker `json:"sticker"` } -// Uploads a PNG image with a sticker; returns the uploaded file +// Uploads a file with a sticker; returns the uploaded file func (client *Client) UploadStickerFile(req *UploadStickerFileRequest) (*File, error) { result, err := client.Send(Request{ meta: meta{ @@ -12255,10 +13200,8 @@ type CreateNewStickerSetRequest struct { Title string `json:"title"` // Sticker set name. Can contain only English letters, digits and underscores. Must end with *"_by_"* (** is case insensitive) for bots; 1-64 characters Name string `json:"name"` - // True, if stickers are masks. Animated stickers can't be masks - IsMasks bool `json:"is_masks"` - // List of stickers to be added to the set; must be non-empty. All stickers must be of the same type. For animated stickers, uploadStickerFile must be used before the sticker is shown - Stickers []InputSticker `json:"stickers"` + // List of stickers to be added to the set; must be non-empty. All stickers must have the same format. For TGS stickers, uploadStickerFile must be used before the sticker is shown + Stickers []*InputSticker `json:"stickers"` // Source of the sticker set; may be empty if unknown Source string `json:"source"` } @@ -12273,7 +13216,6 @@ func (client *Client) CreateNewStickerSet(req *CreateNewStickerSetRequest) (*Sti "user_id": req.UserId, "title": req.Title, "name": req.Name, - "is_masks": req.IsMasks, "stickers": req.Stickers, "source": req.Source, }, @@ -12295,7 +13237,7 @@ type AddStickerToSetRequest struct { // Sticker set name Name string `json:"name"` // Sticker to add to the set - Sticker InputSticker `json:"sticker"` + Sticker *InputSticker `json:"sticker"` } // Adds a new sticker to a set; for bots only. Returns the sticker set @@ -12326,7 +13268,7 @@ type SetStickerSetThumbnailRequest struct { UserId int64 `json:"user_id"` // Sticker set name Name string `json:"name"` - // Thumbnail to set in PNG or TGS format; pass null to remove the sticker set thumbnail. Animated thumbnail must be set for animated sticker sets and only for them + // Thumbnail to set in PNG, TGS, or WEBM format; pass null to remove the sticker set thumbnail. Thumbnail format must match the format of stickers in the set Thumbnail InputFile `json:"thumbnail"` } @@ -12419,7 +13361,7 @@ type GetMapThumbnailFileRequest struct { Height int32 `json:"height"` // Map scale; 1-3 Scale int32 `json:"scale"` - // Identifier of a chat, in which the thumbnail will be shown. Use 0 if unknown + // Identifier of a chat in which the thumbnail will be shown. Use 0 if unknown ChatId int64 `json:"chat_id"` } @@ -12624,7 +13566,7 @@ func (client *Client) GetPhoneNumberInfo(req *GetPhoneNumberInfoRequest) (*Phone } type GetPhoneNumberInfoSyncRequest struct { - // A two-letter ISO 639-1 country code for country information localization + // A two-letter ISO 639-1 language code for country information localization LanguageCode string `json:"language_code"` // The phone number prefix PhoneNumberPrefix string `json:"phone_number_prefix"` @@ -12774,7 +13716,7 @@ type AddProxyRequest struct { Server string `json:"server"` // Proxy server port Port int32 `json:"port"` - // True, if the proxy needs to be enabled + // Pass true to immediately enable the proxy Enable bool `json:"enable"` // Proxy type Type ProxyType `json:"type"` @@ -12811,7 +13753,7 @@ type EditProxyRequest struct { Server string `json:"server"` // Proxy server port Port int32 `json:"port"` - // True, if the proxy needs to be enabled + // Pass true to immediately enable the proxy Enable bool `json:"enable"` // Proxy type Type ProxyType `json:"type"` @@ -13416,7 +14358,7 @@ type TestProxyRequest struct { Port int32 `json:"port"` // Proxy type Type ProxyType `json:"type"` - // Identifier of a datacenter, with which to test connection + // Identifier of a datacenter with which to test connection DcId int32 `json:"dc_id"` // The maximum overall timeout for the request Timeout float64 `json:"timeout"` @@ -13516,6 +14458,9 @@ func (client *Client) TestUseUpdate() (Update, error) { case TypeUpdateMessageMentionRead: return UnmarshalUpdateMessageMentionRead(result.Data) + case TypeUpdateMessageUnreadReactions: + return UnmarshalUpdateMessageUnreadReactions(result.Data) + case TypeUpdateMessageLiveLocationViewed: return UnmarshalUpdateMessageLiveLocationViewed(result.Data) @@ -13537,50 +14482,29 @@ func (client *Client) TestUseUpdate() (Update, error) { case TypeUpdateChatPosition: return UnmarshalUpdateChatPosition(result.Data) - case TypeUpdateChatDefaultMessageSenderId: - return UnmarshalUpdateChatDefaultMessageSenderId(result.Data) - - case TypeUpdateChatHasProtectedContent: - return UnmarshalUpdateChatHasProtectedContent(result.Data) - - case TypeUpdateChatIsMarkedAsUnread: - return UnmarshalUpdateChatIsMarkedAsUnread(result.Data) - - case TypeUpdateChatIsBlocked: - return UnmarshalUpdateChatIsBlocked(result.Data) - - case TypeUpdateChatHasScheduledMessages: - return UnmarshalUpdateChatHasScheduledMessages(result.Data) - - case TypeUpdateChatVideoChat: - return UnmarshalUpdateChatVideoChat(result.Data) - - case TypeUpdateChatDefaultDisableNotification: - return UnmarshalUpdateChatDefaultDisableNotification(result.Data) - case TypeUpdateChatReadInbox: return UnmarshalUpdateChatReadInbox(result.Data) case TypeUpdateChatReadOutbox: return UnmarshalUpdateChatReadOutbox(result.Data) - case TypeUpdateChatUnreadMentionCount: - return UnmarshalUpdateChatUnreadMentionCount(result.Data) - - case TypeUpdateChatNotificationSettings: - return UnmarshalUpdateChatNotificationSettings(result.Data) - - case TypeUpdateScopeNotificationSettings: - return UnmarshalUpdateScopeNotificationSettings(result.Data) - - case TypeUpdateChatMessageTtlSetting: - return UnmarshalUpdateChatMessageTtlSetting(result.Data) - case TypeUpdateChatActionBar: return UnmarshalUpdateChatActionBar(result.Data) - case TypeUpdateChatTheme: - return UnmarshalUpdateChatTheme(result.Data) + case TypeUpdateChatAvailableReactions: + return UnmarshalUpdateChatAvailableReactions(result.Data) + + case TypeUpdateChatDraftMessage: + return UnmarshalUpdateChatDraftMessage(result.Data) + + case TypeUpdateChatMessageSender: + return UnmarshalUpdateChatMessageSender(result.Data) + + case TypeUpdateChatMessageTtl: + return UnmarshalUpdateChatMessageTtl(result.Data) + + case TypeUpdateChatNotificationSettings: + return UnmarshalUpdateChatNotificationSettings(result.Data) case TypeUpdateChatPendingJoinRequests: return UnmarshalUpdateChatPendingJoinRequests(result.Data) @@ -13588,8 +14512,32 @@ func (client *Client) TestUseUpdate() (Update, error) { case TypeUpdateChatReplyMarkup: return UnmarshalUpdateChatReplyMarkup(result.Data) - case TypeUpdateChatDraftMessage: - return UnmarshalUpdateChatDraftMessage(result.Data) + case TypeUpdateChatTheme: + return UnmarshalUpdateChatTheme(result.Data) + + case TypeUpdateChatUnreadMentionCount: + return UnmarshalUpdateChatUnreadMentionCount(result.Data) + + case TypeUpdateChatUnreadReactionCount: + return UnmarshalUpdateChatUnreadReactionCount(result.Data) + + case TypeUpdateChatVideoChat: + return UnmarshalUpdateChatVideoChat(result.Data) + + case TypeUpdateChatDefaultDisableNotification: + return UnmarshalUpdateChatDefaultDisableNotification(result.Data) + + case TypeUpdateChatHasProtectedContent: + return UnmarshalUpdateChatHasProtectedContent(result.Data) + + case TypeUpdateChatHasScheduledMessages: + return UnmarshalUpdateChatHasScheduledMessages(result.Data) + + case TypeUpdateChatIsBlocked: + return UnmarshalUpdateChatIsBlocked(result.Data) + + case TypeUpdateChatIsMarkedAsUnread: + return UnmarshalUpdateChatIsMarkedAsUnread(result.Data) case TypeUpdateChatFilters: return UnmarshalUpdateChatFilters(result.Data) @@ -13597,6 +14545,9 @@ func (client *Client) TestUseUpdate() (Update, error) { case TypeUpdateChatOnlineMemberCount: return UnmarshalUpdateChatOnlineMemberCount(result.Data) + case TypeUpdateScopeNotificationSettings: + return UnmarshalUpdateScopeNotificationSettings(result.Data) + case TypeUpdateNotification: return UnmarshalUpdateNotification(result.Data) @@ -13651,6 +14602,18 @@ func (client *Client) TestUseUpdate() (Update, error) { case TypeUpdateFileGenerationStop: return UnmarshalUpdateFileGenerationStop(result.Data) + case TypeUpdateFileDownloads: + return UnmarshalUpdateFileDownloads(result.Data) + + case TypeUpdateFileAddedToDownloads: + return UnmarshalUpdateFileAddedToDownloads(result.Data) + + case TypeUpdateFileDownload: + return UnmarshalUpdateFileDownload(result.Data) + + case TypeUpdateFileRemovedFromDownloads: + return UnmarshalUpdateFileRemovedFromDownloads(result.Data) + case TypeUpdateCall: return UnmarshalUpdateCall(result.Data) @@ -13693,6 +14656,9 @@ func (client *Client) TestUseUpdate() (Update, error) { case TypeUpdateSavedAnimations: return UnmarshalUpdateSavedAnimations(result.Data) + case TypeUpdateSavedNotificationSounds: + return UnmarshalUpdateSavedNotificationSounds(result.Data) + case TypeUpdateSelectedBackground: return UnmarshalUpdateSelectedBackground(result.Data) @@ -13711,6 +14677,15 @@ func (client *Client) TestUseUpdate() (Update, error) { case TypeUpdateUsersNearby: return UnmarshalUpdateUsersNearby(result.Data) + case TypeUpdateAttachmentMenuBots: + return UnmarshalUpdateAttachmentMenuBots(result.Data) + + case TypeUpdateWebAppMessageSent: + return UnmarshalUpdateWebAppMessageSent(result.Data) + + case TypeUpdateReactions: + return UnmarshalUpdateReactions(result.Data) + case TypeUpdateDiceEmojis: return UnmarshalUpdateDiceEmojis(result.Data) diff --git a/client/tdjson.go b/client/tdjson.go index a91488e..a2860a9 100644 --- a/client/tdjson.go +++ b/client/tdjson.go @@ -1,3 +1,4 @@ +//go:build darwin // +build darwin package client diff --git a/client/tdjson_dynamic.go b/client/tdjson_dynamic.go index 84aaeac..4a88485 100644 --- a/client/tdjson_dynamic.go +++ b/client/tdjson_dynamic.go @@ -1,3 +1,4 @@ +//go:build libtdjson && (linux || darwin || windows) // +build libtdjson // +build linux darwin windows diff --git a/client/tdjson_static.go b/client/tdjson_static.go index dcbb662..a486de9 100644 --- a/client/tdjson_static.go +++ b/client/tdjson_static.go @@ -1,3 +1,4 @@ +//go:build !libtdjson && (linux || darwin) // +build !libtdjson // +build linux darwin diff --git a/client/type.go b/client/type.go index 5313ac0..16ce0f0 100755 --- a/client/type.go +++ b/client/type.go @@ -12,6 +12,7 @@ const ( ClassInputFile = "InputFile" ClassThumbnailFormat = "ThumbnailFormat" ClassMaskPoint = "MaskPoint" + ClassStickerType = "StickerType" ClassPollType = "PollType" ClassUserType = "UserType" ClassInputChatPhoto = "InputChatPhoto" @@ -87,7 +88,6 @@ const ( ClassSuggestedAction = "SuggestedAction" ClassTextParseMode = "TextParseMode" ClassProxyType = "ProxyType" - ClassInputSticker = "InputSticker" ClassStatisticalGraph = "StatisticalGraph" ClassChatStatistics = "ChatStatistics" ClassVectorPathCommand = "VectorPathCommand" @@ -133,16 +133,19 @@ const ( ClassChatPhotoInfo = "ChatPhotoInfo" ClassBotCommand = "BotCommand" ClassBotCommands = "BotCommands" + ClassBotMenuButton = "BotMenuButton" ClassChatLocation = "ChatLocation" ClassAnimatedChatPhoto = "AnimatedChatPhoto" ClassChatPhoto = "ChatPhoto" ClassChatPhotos = "ChatPhotos" + ClassChatPermissions = "ChatPermissions" + ClassChatAdministratorRights = "ChatAdministratorRights" ClassUser = "User" + ClassBotInfo = "BotInfo" ClassUserFullInfo = "UserFullInfo" ClassUsers = "Users" ClassChatAdministrator = "ChatAdministrator" ClassChatAdministrators = "ChatAdministrators" - ClassChatPermissions = "ChatPermissions" ClassChatMember = "ChatMember" ClassChatMembers = "ChatMembers" ClassChatInviteLink = "ChatInviteLink" @@ -163,7 +166,9 @@ const ( ClassMessageSenders = "MessageSenders" ClassMessageForwardInfo = "MessageForwardInfo" ClassMessageReplyInfo = "MessageReplyInfo" + ClassMessageReaction = "MessageReaction" ClassMessageInteractionInfo = "MessageInteractionInfo" + ClassUnreadReaction = "UnreadReaction" ClassMessage = "Message" ClassMessages = "Messages" ClassFoundMessages = "FoundMessages" @@ -172,7 +177,9 @@ const ( ClassMessageCalendarDay = "MessageCalendarDay" ClassMessageCalendar = "MessageCalendar" ClassSponsoredMessage = "SponsoredMessage" - ClassSponsoredMessages = "SponsoredMessages" + ClassFileDownload = "FileDownload" + ClassDownloadedFileCounts = "DownloadedFileCounts" + ClassFoundFileDownloads = "FoundFileDownloads" ClassChatNotificationSettings = "ChatNotificationSettings" ClassScopeNotificationSettings = "ScopeNotificationSettings" ClassDraftMessage = "DraftMessage" @@ -189,6 +196,7 @@ const ( ClassChatsNearby = "ChatsNearby" ClassKeyboardButton = "KeyboardButton" ClassInlineKeyboardButton = "InlineKeyboardButton" + ClassWebAppInfo = "WebAppInfo" ClassMessageThreadInfo = "MessageThreadInfo" ClassPageBlockCaption = "PageBlockCaption" ClassPageBlockListItem = "PageBlockListItem" @@ -202,13 +210,13 @@ const ( ClassBankCardActionOpenUrl = "BankCardActionOpenUrl" ClassBankCardInfo = "BankCardInfo" ClassAddress = "Address" + ClassThemeParameters = "ThemeParameters" ClassLabeledPricePart = "LabeledPricePart" ClassInvoice = "Invoice" ClassOrderInfo = "OrderInfo" ClassShippingOption = "ShippingOption" ClassSavedCredentials = "SavedCredentials" ClassPaymentsProviderStripe = "PaymentsProviderStripe" - ClassPaymentFormTheme = "PaymentFormTheme" ClassPaymentForm = "PaymentForm" ClassValidatedOrderInfo = "ValidatedOrderInfo" ClassPaymentResult = "PaymentResult" @@ -241,6 +249,9 @@ const ( ClassCallServer = "CallServer" ClassCallId = "CallId" ClassGroupCallId = "GroupCallId" + ClassGroupCallStream = "GroupCallStream" + ClassGroupCallStreams = "GroupCallStreams" + ClassRtmpUrl = "RtmpUrl" ClassGroupCallRecentSpeaker = "GroupCallRecentSpeaker" ClassGroupCall = "GroupCall" ClassGroupCallVideoSourceGroup = "GroupCallVideoSourceGroup" @@ -248,8 +259,15 @@ const ( ClassGroupCallParticipant = "GroupCallParticipant" ClassCall = "Call" ClassPhoneNumberAuthenticationSettings = "PhoneNumberAuthenticationSettings" + ClassAddedReaction = "AddedReaction" + ClassAddedReactions = "AddedReactions" + ClassAvailableReactions = "AvailableReactions" + ClassReaction = "Reaction" ClassAnimations = "Animations" ClassImportedContacts = "ImportedContacts" + ClassAttachmentMenuBotColor = "AttachmentMenuBotColor" + ClassAttachmentMenuBot = "AttachmentMenuBot" + ClassSentWebAppMessage = "SentWebAppMessage" ClassHttpUrl = "HttpUrl" ClassInlineQueryResults = "InlineQueryResults" ClassCallbackQueryAnswer = "CallbackQueryAnswer" @@ -269,6 +287,8 @@ const ( ClassThemeSettings = "ThemeSettings" ClassChatTheme = "ChatTheme" ClassHashtags = "Hashtags" + ClassNotificationSound = "NotificationSound" + ClassNotificationSounds = "NotificationSounds" ClassNotification = "Notification" ClassNotificationGroup = "NotificationGroup" ClassJsonObjectMember = "JsonObjectMember" @@ -297,6 +317,7 @@ const ( ClassDeepLinkInfo = "DeepLinkInfo" ClassProxy = "Proxy" ClassProxies = "Proxies" + ClassInputSticker = "InputSticker" ClassDateRange = "DateRange" ClassStatisticalValue = "StatisticalValue" ClassChatStatisticsMessageInteractionInfo = "ChatStatisticsMessageInteractionInfo" @@ -356,17 +377,22 @@ const ( TypePhotoSize = "photoSize" TypeMinithumbnail = "minithumbnail" TypeThumbnailFormatJpeg = "thumbnailFormatJpeg" - TypeThumbnailFormatPng = "thumbnailFormatPng" - TypeThumbnailFormatWebp = "thumbnailFormatWebp" TypeThumbnailFormatGif = "thumbnailFormatGif" - TypeThumbnailFormatTgs = "thumbnailFormatTgs" TypeThumbnailFormatMpeg4 = "thumbnailFormatMpeg4" + TypeThumbnailFormatPng = "thumbnailFormatPng" + TypeThumbnailFormatTgs = "thumbnailFormatTgs" + TypeThumbnailFormatWebm = "thumbnailFormatWebm" + TypeThumbnailFormatWebp = "thumbnailFormatWebp" TypeThumbnail = "thumbnail" TypeMaskPointForehead = "maskPointForehead" TypeMaskPointEyes = "maskPointEyes" TypeMaskPointMouth = "maskPointMouth" TypeMaskPointChin = "maskPointChin" TypeMaskPosition = "maskPosition" + TypeStickerTypeStatic = "stickerTypeStatic" + TypeStickerTypeAnimated = "stickerTypeAnimated" + TypeStickerTypeVideo = "stickerTypeVideo" + TypeStickerTypeMask = "stickerTypeMask" TypeClosedVectorPath = "closedVectorPath" TypePollOption = "pollOption" TypePollTypeRegular = "pollTypeRegular" @@ -393,6 +419,7 @@ const ( TypeUserTypeUnknown = "userTypeUnknown" TypeBotCommand = "botCommand" TypeBotCommands = "botCommands" + TypeBotMenuButton = "botMenuButton" TypeChatLocation = "chatLocation" TypeAnimatedChatPhoto = "animatedChatPhoto" TypeChatPhoto = "chatPhoto" @@ -400,12 +427,14 @@ const ( TypeInputChatPhotoPrevious = "inputChatPhotoPrevious" TypeInputChatPhotoStatic = "inputChatPhotoStatic" TypeInputChatPhotoAnimation = "inputChatPhotoAnimation" + TypeChatPermissions = "chatPermissions" + TypeChatAdministratorRights = "chatAdministratorRights" TypeUser = "user" + TypeBotInfo = "botInfo" TypeUserFullInfo = "userFullInfo" TypeUsers = "users" TypeChatAdministrator = "chatAdministrator" TypeChatAdministrators = "chatAdministrators" - TypeChatPermissions = "chatPermissions" TypeChatMemberStatusCreator = "chatMemberStatusCreator" TypeChatMemberStatusAdministrator = "chatMemberStatusAdministrator" TypeChatMemberStatusMember = "chatMemberStatusMember" @@ -457,7 +486,9 @@ const ( TypeMessageForwardOriginMessageImport = "messageForwardOriginMessageImport" TypeMessageForwardInfo = "messageForwardInfo" TypeMessageReplyInfo = "messageReplyInfo" + TypeMessageReaction = "messageReaction" TypeMessageInteractionInfo = "messageInteractionInfo" + TypeUnreadReaction = "unreadReaction" TypeMessageSendingStatePending = "messageSendingStatePending" TypeMessageSendingStateFailed = "messageSendingStateFailed" TypeMessage = "message" @@ -468,7 +499,9 @@ const ( TypeMessageCalendarDay = "messageCalendarDay" TypeMessageCalendar = "messageCalendar" TypeSponsoredMessage = "sponsoredMessage" - TypeSponsoredMessages = "sponsoredMessages" + TypeFileDownload = "fileDownload" + TypeDownloadedFileCounts = "downloadedFileCounts" + TypeFoundFileDownloads = "foundFileDownloads" TypeNotificationSettingsScopePrivateChats = "notificationSettingsScopePrivateChats" TypeNotificationSettingsScopeGroupChats = "notificationSettingsScopeGroupChats" TypeNotificationSettingsScopeChannelChats = "notificationSettingsScopeChannelChats" @@ -508,9 +541,11 @@ const ( TypeKeyboardButtonTypeRequestPhoneNumber = "keyboardButtonTypeRequestPhoneNumber" TypeKeyboardButtonTypeRequestLocation = "keyboardButtonTypeRequestLocation" TypeKeyboardButtonTypeRequestPoll = "keyboardButtonTypeRequestPoll" + TypeKeyboardButtonTypeWebApp = "keyboardButtonTypeWebApp" TypeKeyboardButton = "keyboardButton" TypeInlineKeyboardButtonTypeUrl = "inlineKeyboardButtonTypeUrl" TypeInlineKeyboardButtonTypeLoginUrl = "inlineKeyboardButtonTypeLoginUrl" + TypeInlineKeyboardButtonTypeWebApp = "inlineKeyboardButtonTypeWebApp" TypeInlineKeyboardButtonTypeCallback = "inlineKeyboardButtonTypeCallback" TypeInlineKeyboardButtonTypeCallbackWithPassword = "inlineKeyboardButtonTypeCallbackWithPassword" TypeInlineKeyboardButtonTypeCallbackGame = "inlineKeyboardButtonTypeCallbackGame" @@ -524,6 +559,7 @@ const ( TypeReplyMarkupInlineKeyboard = "replyMarkupInlineKeyboard" TypeLoginUrlInfoOpen = "loginUrlInfoOpen" TypeLoginUrlInfoRequestConfirmation = "loginUrlInfoRequestConfirmation" + TypeWebAppInfo = "webAppInfo" TypeMessageThreadInfo = "messageThreadInfo" TypeRichTextPlain = "richTextPlain" TypeRichTextBold = "richTextBold" @@ -589,6 +625,7 @@ const ( TypeBankCardActionOpenUrl = "bankCardActionOpenUrl" TypeBankCardInfo = "bankCardInfo" TypeAddress = "address" + TypeThemeParameters = "themeParameters" TypeLabeledPricePart = "labeledPricePart" TypeInvoice = "invoice" TypeOrderInfo = "orderInfo" @@ -599,7 +636,6 @@ const ( TypeInputCredentialsApplePay = "inputCredentialsApplePay" TypeInputCredentialsGooglePay = "inputCredentialsGooglePay" TypePaymentsProviderStripe = "paymentsProviderStripe" - TypePaymentFormTheme = "paymentFormTheme" TypePaymentForm = "paymentForm" TypeValidatedOrderInfo = "validatedOrderInfo" TypePaymentResult = "paymentResult" @@ -722,6 +758,8 @@ const ( TypeMessagePaymentSuccessfulBot = "messagePaymentSuccessfulBot" TypeMessageContactRegistered = "messageContactRegistered" TypeMessageWebsiteConnected = "messageWebsiteConnected" + TypeMessageWebAppDataSent = "messageWebAppDataSent" + TypeMessageWebAppDataReceived = "messageWebAppDataReceived" TypeMessagePassportDataSent = "messagePassportDataSent" TypeMessagePassportDataReceived = "messagePassportDataReceived" TypeMessageProximityAlertTriggered = "messageProximityAlertTriggered" @@ -738,6 +776,7 @@ const ( TypeTextEntityTypeItalic = "textEntityTypeItalic" TypeTextEntityTypeUnderline = "textEntityTypeUnderline" TypeTextEntityTypeStrikethrough = "textEntityTypeStrikethrough" + TypeTextEntityTypeSpoiler = "textEntityTypeSpoiler" TypeTextEntityTypeCode = "textEntityTypeCode" TypeTextEntityTypePre = "textEntityTypePre" TypeTextEntityTypePreCode = "textEntityTypePreCode" @@ -776,12 +815,11 @@ const ( TypeSearchMessagesFilterPhotoAndVideo = "searchMessagesFilterPhotoAndVideo" TypeSearchMessagesFilterUrl = "searchMessagesFilterUrl" TypeSearchMessagesFilterChatPhoto = "searchMessagesFilterChatPhoto" - TypeSearchMessagesFilterCall = "searchMessagesFilterCall" - TypeSearchMessagesFilterMissedCall = "searchMessagesFilterMissedCall" TypeSearchMessagesFilterVideoNote = "searchMessagesFilterVideoNote" TypeSearchMessagesFilterVoiceAndVideoNote = "searchMessagesFilterVoiceAndVideoNote" TypeSearchMessagesFilterMention = "searchMessagesFilterMention" TypeSearchMessagesFilterUnreadMention = "searchMessagesFilterUnreadMention" + TypeSearchMessagesFilterUnreadReaction = "searchMessagesFilterUnreadReaction" TypeSearchMessagesFilterFailedToSend = "searchMessagesFilterFailedToSend" TypeSearchMessagesFilterPinned = "searchMessagesFilterPinned" TypeChatActionTyping = "chatActionTyping" @@ -830,6 +868,9 @@ const ( TypeGroupCallVideoQualityThumbnail = "groupCallVideoQualityThumbnail" TypeGroupCallVideoQualityMedium = "groupCallVideoQualityMedium" TypeGroupCallVideoQualityFull = "groupCallVideoQualityFull" + TypeGroupCallStream = "groupCallStream" + TypeGroupCallStreams = "groupCallStreams" + TypeRtmpUrl = "rtmpUrl" TypeGroupCallRecentSpeaker = "groupCallRecentSpeaker" TypeGroupCall = "groupCall" TypeGroupCallVideoSourceGroup = "groupCallVideoSourceGroup" @@ -846,10 +887,17 @@ const ( TypeCallProblemPixelatedVideo = "callProblemPixelatedVideo" TypeCall = "call" TypePhoneNumberAuthenticationSettings = "phoneNumberAuthenticationSettings" + TypeAddedReaction = "addedReaction" + TypeAddedReactions = "addedReactions" + TypeAvailableReactions = "availableReactions" + TypeReaction = "reaction" TypeAnimations = "animations" TypeDiceStickersRegular = "diceStickersRegular" TypeDiceStickersSlotMachine = "diceStickersSlotMachine" TypeImportedContacts = "importedContacts" + TypeAttachmentMenuBotColor = "attachmentMenuBotColor" + TypeAttachmentMenuBot = "attachmentMenuBot" + TypeSentWebAppMessage = "sentWebAppMessage" TypeHttpUrl = "httpUrl" TypeInputInlineQueryResultAnimation = "inputInlineQueryResultAnimation" TypeInputInlineQueryResultArticle = "inputInlineQueryResultArticle" @@ -885,38 +933,39 @@ const ( TypeGameHighScores = "gameHighScores" TypeChatEventMessageEdited = "chatEventMessageEdited" TypeChatEventMessageDeleted = "chatEventMessageDeleted" - TypeChatEventPollStopped = "chatEventPollStopped" TypeChatEventMessagePinned = "chatEventMessagePinned" TypeChatEventMessageUnpinned = "chatEventMessageUnpinned" + TypeChatEventPollStopped = "chatEventPollStopped" TypeChatEventMemberJoined = "chatEventMemberJoined" TypeChatEventMemberJoinedByInviteLink = "chatEventMemberJoinedByInviteLink" TypeChatEventMemberJoinedByRequest = "chatEventMemberJoinedByRequest" - TypeChatEventMemberLeft = "chatEventMemberLeft" TypeChatEventMemberInvited = "chatEventMemberInvited" + TypeChatEventMemberLeft = "chatEventMemberLeft" TypeChatEventMemberPromoted = "chatEventMemberPromoted" TypeChatEventMemberRestricted = "chatEventMemberRestricted" - TypeChatEventTitleChanged = "chatEventTitleChanged" - TypeChatEventPermissionsChanged = "chatEventPermissionsChanged" + TypeChatEventAvailableReactionsChanged = "chatEventAvailableReactionsChanged" TypeChatEventDescriptionChanged = "chatEventDescriptionChanged" - TypeChatEventUsernameChanged = "chatEventUsernameChanged" - TypeChatEventPhotoChanged = "chatEventPhotoChanged" - TypeChatEventInvitesToggled = "chatEventInvitesToggled" TypeChatEventLinkedChatChanged = "chatEventLinkedChatChanged" - TypeChatEventSlowModeDelayChanged = "chatEventSlowModeDelayChanged" - TypeChatEventMessageTtlSettingChanged = "chatEventMessageTtlSettingChanged" - TypeChatEventSignMessagesToggled = "chatEventSignMessagesToggled" - TypeChatEventHasProtectedContentToggled = "chatEventHasProtectedContentToggled" - TypeChatEventStickerSetChanged = "chatEventStickerSetChanged" TypeChatEventLocationChanged = "chatEventLocationChanged" + TypeChatEventMessageTtlChanged = "chatEventMessageTtlChanged" + TypeChatEventPermissionsChanged = "chatEventPermissionsChanged" + TypeChatEventPhotoChanged = "chatEventPhotoChanged" + TypeChatEventSlowModeDelayChanged = "chatEventSlowModeDelayChanged" + TypeChatEventStickerSetChanged = "chatEventStickerSetChanged" + TypeChatEventTitleChanged = "chatEventTitleChanged" + TypeChatEventUsernameChanged = "chatEventUsernameChanged" + TypeChatEventHasProtectedContentToggled = "chatEventHasProtectedContentToggled" + TypeChatEventInvitesToggled = "chatEventInvitesToggled" TypeChatEventIsAllHistoryAvailableToggled = "chatEventIsAllHistoryAvailableToggled" + TypeChatEventSignMessagesToggled = "chatEventSignMessagesToggled" TypeChatEventInviteLinkEdited = "chatEventInviteLinkEdited" TypeChatEventInviteLinkRevoked = "chatEventInviteLinkRevoked" TypeChatEventInviteLinkDeleted = "chatEventInviteLinkDeleted" TypeChatEventVideoChatCreated = "chatEventVideoChatCreated" - TypeChatEventVideoChatDiscarded = "chatEventVideoChatDiscarded" + TypeChatEventVideoChatEnded = "chatEventVideoChatEnded" + TypeChatEventVideoChatMuteNewParticipantsToggled = "chatEventVideoChatMuteNewParticipantsToggled" TypeChatEventVideoChatParticipantIsMutedToggled = "chatEventVideoChatParticipantIsMutedToggled" TypeChatEventVideoChatParticipantVolumeLevelChanged = "chatEventVideoChatParticipantVolumeLevelChanged" - TypeChatEventVideoChatMuteNewParticipantsToggled = "chatEventVideoChatMuteNewParticipantsToggled" TypeChatEvent = "chatEvent" TypeChatEvents = "chatEvents" TypeChatEventLogFilters = "chatEventLogFilters" @@ -1006,6 +1055,8 @@ const ( TypeNotificationGroupTypeMentions = "notificationGroupTypeMentions" TypeNotificationGroupTypeSecretChat = "notificationGroupTypeSecretChat" TypeNotificationGroupTypeCalls = "notificationGroupTypeCalls" + TypeNotificationSound = "notificationSound" + TypeNotificationSounds = "notificationSounds" TypeNotification = "notification" TypeNotificationGroup = "notificationGroup" TypeOptionValueBoolean = "optionValueBoolean" @@ -1048,21 +1099,27 @@ const ( TypeChatReportReasonCopyright = "chatReportReasonCopyright" TypeChatReportReasonUnrelatedLocation = "chatReportReasonUnrelatedLocation" TypeChatReportReasonFake = "chatReportReasonFake" + TypeChatReportReasonIllegalDrugs = "chatReportReasonIllegalDrugs" + TypeChatReportReasonPersonalDetails = "chatReportReasonPersonalDetails" TypeChatReportReasonCustom = "chatReportReasonCustom" TypeInternalLinkTypeActiveSessions = "internalLinkTypeActiveSessions" + TypeInternalLinkTypeAttachmentMenuBot = "internalLinkTypeAttachmentMenuBot" TypeInternalLinkTypeAuthenticationCode = "internalLinkTypeAuthenticationCode" TypeInternalLinkTypeBackground = "internalLinkTypeBackground" TypeInternalLinkTypeBotStart = "internalLinkTypeBotStart" TypeInternalLinkTypeBotStartInGroup = "internalLinkTypeBotStartInGroup" + TypeInternalLinkTypeBotAddToChannel = "internalLinkTypeBotAddToChannel" TypeInternalLinkTypeChangePhoneNumber = "internalLinkTypeChangePhoneNumber" TypeInternalLinkTypeChatInvite = "internalLinkTypeChatInvite" TypeInternalLinkTypeFilterSettings = "internalLinkTypeFilterSettings" TypeInternalLinkTypeGame = "internalLinkTypeGame" TypeInternalLinkTypeLanguagePack = "internalLinkTypeLanguagePack" + TypeInternalLinkTypeLanguageSettings = "internalLinkTypeLanguageSettings" TypeInternalLinkTypeMessage = "internalLinkTypeMessage" TypeInternalLinkTypeMessageDraft = "internalLinkTypeMessageDraft" TypeInternalLinkTypePassportDataRequest = "internalLinkTypePassportDataRequest" TypeInternalLinkTypePhoneNumberConfirmation = "internalLinkTypePhoneNumberConfirmation" + TypeInternalLinkTypePrivacyAndSecuritySettings = "internalLinkTypePrivacyAndSecuritySettings" TypeInternalLinkTypeProxy = "internalLinkTypeProxy" TypeInternalLinkTypePublicChat = "internalLinkTypePublicChat" TypeInternalLinkTypeQrCodeAuthentication = "internalLinkTypeQrCodeAuthentication" @@ -1072,6 +1129,7 @@ const ( TypeInternalLinkTypeThemeSettings = "internalLinkTypeThemeSettings" TypeInternalLinkTypeUnknownDeepLink = "internalLinkTypeUnknownDeepLink" TypeInternalLinkTypeUnsupportedProxy = "internalLinkTypeUnsupportedProxy" + TypeInternalLinkTypeUserPhoneNumber = "internalLinkTypeUserPhoneNumber" TypeInternalLinkTypeVideoChat = "internalLinkTypeVideoChat" TypeMessageLink = "messageLink" TypeMessageLinkInfo = "messageLinkInfo" @@ -1080,6 +1138,7 @@ const ( TypeFileTypeAnimation = "fileTypeAnimation" TypeFileTypeAudio = "fileTypeAudio" TypeFileTypeDocument = "fileTypeDocument" + TypeFileTypeNotificationSound = "fileTypeNotificationSound" TypeFileTypePhoto = "fileTypePhoto" TypeFileTypeProfilePhoto = "fileTypeProfilePhoto" TypeFileTypeSecret = "fileTypeSecret" @@ -1128,7 +1187,7 @@ const ( TypeSuggestedActionEnableArchiveAndMuteNewChats = "suggestedActionEnableArchiveAndMuteNewChats" TypeSuggestedActionCheckPassword = "suggestedActionCheckPassword" TypeSuggestedActionCheckPhoneNumber = "suggestedActionCheckPhoneNumber" - TypeSuggestedActionSeeTicksHint = "suggestedActionSeeTicksHint" + TypeSuggestedActionViewChecksHint = "suggestedActionViewChecksHint" TypeSuggestedActionConvertToBroadcastGroup = "suggestedActionConvertToBroadcastGroup" TypeSuggestedActionSetPassword = "suggestedActionSetPassword" TypeCount = "count" @@ -1142,8 +1201,7 @@ const ( TypeProxyTypeMtproto = "proxyTypeMtproto" TypeProxy = "proxy" TypeProxies = "proxies" - TypeInputStickerStatic = "inputStickerStatic" - TypeInputStickerAnimated = "inputStickerAnimated" + TypeInputSticker = "inputSticker" TypeDateRange = "dateRange" TypeStatisticalValue = "statisticalValue" TypeStatisticalGraphData = "statisticalGraphData" @@ -1177,6 +1235,7 @@ const ( TypeUpdateMessageInteractionInfo = "updateMessageInteractionInfo" TypeUpdateMessageContentOpened = "updateMessageContentOpened" TypeUpdateMessageMentionRead = "updateMessageMentionRead" + TypeUpdateMessageUnreadReactions = "updateMessageUnreadReactions" TypeUpdateMessageLiveLocationViewed = "updateMessageLiveLocationViewed" TypeUpdateNewChat = "updateNewChat" TypeUpdateChatTitle = "updateChatTitle" @@ -1184,26 +1243,28 @@ const ( TypeUpdateChatPermissions = "updateChatPermissions" TypeUpdateChatLastMessage = "updateChatLastMessage" TypeUpdateChatPosition = "updateChatPosition" - TypeUpdateChatDefaultMessageSenderId = "updateChatDefaultMessageSenderId" - TypeUpdateChatHasProtectedContent = "updateChatHasProtectedContent" - TypeUpdateChatIsMarkedAsUnread = "updateChatIsMarkedAsUnread" - TypeUpdateChatIsBlocked = "updateChatIsBlocked" - TypeUpdateChatHasScheduledMessages = "updateChatHasScheduledMessages" - TypeUpdateChatVideoChat = "updateChatVideoChat" - TypeUpdateChatDefaultDisableNotification = "updateChatDefaultDisableNotification" TypeUpdateChatReadInbox = "updateChatReadInbox" TypeUpdateChatReadOutbox = "updateChatReadOutbox" - TypeUpdateChatUnreadMentionCount = "updateChatUnreadMentionCount" - TypeUpdateChatNotificationSettings = "updateChatNotificationSettings" - TypeUpdateScopeNotificationSettings = "updateScopeNotificationSettings" - TypeUpdateChatMessageTtlSetting = "updateChatMessageTtlSetting" TypeUpdateChatActionBar = "updateChatActionBar" - TypeUpdateChatTheme = "updateChatTheme" + TypeUpdateChatAvailableReactions = "updateChatAvailableReactions" + TypeUpdateChatDraftMessage = "updateChatDraftMessage" + TypeUpdateChatMessageSender = "updateChatMessageSender" + TypeUpdateChatMessageTtl = "updateChatMessageTtl" + TypeUpdateChatNotificationSettings = "updateChatNotificationSettings" TypeUpdateChatPendingJoinRequests = "updateChatPendingJoinRequests" TypeUpdateChatReplyMarkup = "updateChatReplyMarkup" - TypeUpdateChatDraftMessage = "updateChatDraftMessage" + TypeUpdateChatTheme = "updateChatTheme" + TypeUpdateChatUnreadMentionCount = "updateChatUnreadMentionCount" + TypeUpdateChatUnreadReactionCount = "updateChatUnreadReactionCount" + TypeUpdateChatVideoChat = "updateChatVideoChat" + TypeUpdateChatDefaultDisableNotification = "updateChatDefaultDisableNotification" + TypeUpdateChatHasProtectedContent = "updateChatHasProtectedContent" + TypeUpdateChatHasScheduledMessages = "updateChatHasScheduledMessages" + TypeUpdateChatIsBlocked = "updateChatIsBlocked" + TypeUpdateChatIsMarkedAsUnread = "updateChatIsMarkedAsUnread" TypeUpdateChatFilters = "updateChatFilters" TypeUpdateChatOnlineMemberCount = "updateChatOnlineMemberCount" + TypeUpdateScopeNotificationSettings = "updateScopeNotificationSettings" TypeUpdateNotification = "updateNotification" TypeUpdateNotificationGroup = "updateNotificationGroup" TypeUpdateActiveNotifications = "updateActiveNotifications" @@ -1222,6 +1283,10 @@ const ( TypeUpdateFile = "updateFile" TypeUpdateFileGenerationStart = "updateFileGenerationStart" TypeUpdateFileGenerationStop = "updateFileGenerationStop" + TypeUpdateFileDownloads = "updateFileDownloads" + TypeUpdateFileAddedToDownloads = "updateFileAddedToDownloads" + TypeUpdateFileDownload = "updateFileDownload" + TypeUpdateFileRemovedFromDownloads = "updateFileRemovedFromDownloads" TypeUpdateCall = "updateCall" TypeUpdateGroupCall = "updateGroupCall" TypeUpdateGroupCallParticipant = "updateGroupCallParticipant" @@ -1236,12 +1301,16 @@ const ( TypeUpdateRecentStickers = "updateRecentStickers" TypeUpdateFavoriteStickers = "updateFavoriteStickers" TypeUpdateSavedAnimations = "updateSavedAnimations" + TypeUpdateSavedNotificationSounds = "updateSavedNotificationSounds" TypeUpdateSelectedBackground = "updateSelectedBackground" TypeUpdateChatThemes = "updateChatThemes" TypeUpdateLanguagePackStrings = "updateLanguagePackStrings" TypeUpdateConnectionState = "updateConnectionState" TypeUpdateTermsOfService = "updateTermsOfService" TypeUpdateUsersNearby = "updateUsersNearby" + TypeUpdateAttachmentMenuBots = "updateAttachmentMenuBots" + TypeUpdateWebAppMessageSent = "updateWebAppMessageSent" + TypeUpdateReactions = "updateReactions" TypeUpdateDiceEmojis = "updateDiceEmojis" TypeUpdateAnimatedEmojiMessageClicked = "updateAnimatedEmojiMessageClicked" TypeUpdateAnimationSearchParameters = "updateAnimationSearchParameters" @@ -1288,7 +1357,7 @@ type InputFile interface { InputFileType() string } -// Describes format of the thumbnail +// Describes format of a thumbnail type ThumbnailFormat interface { ThumbnailFormatType() string } @@ -1298,6 +1367,11 @@ type MaskPoint interface { MaskPointType() string } +// Describes type of a sticker +type StickerType interface { + StickerTypeType() string +} + // Describes the type of a poll type PollType interface { PollTypeType() string @@ -1673,11 +1747,6 @@ type ProxyType interface { ProxyTypeType() string } -// Describes a sticker that needs to be added to a sticker set -type InputSticker interface { - InputStickerType() string -} - // Describes a statistical graph type StatisticalGraph interface { StatisticalGraphType() string @@ -1886,7 +1955,7 @@ func (*AuthenticationCodeTypeCall) AuthenticationCodeTypeType() string { return TypeAuthenticationCodeTypeCall } -// An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number from which the call was made is the code that should be entered automatically +// An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number that calls is the code that must be entered automatically type AuthenticationCodeTypeFlashCall struct { meta // Pattern of the phone number from which the call will be made @@ -1913,7 +1982,7 @@ func (*AuthenticationCodeTypeFlashCall) AuthenticationCodeTypeType() string { return TypeAuthenticationCodeTypeFlashCall } -// An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number from which the call was made is the code that should be entered manually by the user +// An authentication code is delivered by an immediately canceled call to the specified phone number. The last digits of the phone number that calls are the code that must be entered manually by the user type AuthenticationCodeTypeMissedCall struct { meta // Prefix of the phone number from which the call will be made @@ -2097,7 +2166,7 @@ type FormattedText struct { meta // The text Text string `json:"text"` - // Entities contained in the text. Entities can be nested, but must not mutually intersect with each other. Pre, Code and PreCode entities can't contain other entities. Bold, Italic, Underline and Strikethrough entities can contain and to be contained in all other entities. All other entities can't contain each other + // Entities contained in the text. Entities can be nested, but must not mutually intersect with each other. Pre, Code and PreCode entities can't contain other entities. Bold, Italic, Underline, Strikethrough, and Spoiler entities can contain and to be contained in all other entities. All other entities can't contain each other Entities []*TextEntity `json:"entities"` } @@ -2122,7 +2191,7 @@ type TermsOfService struct { meta // Text of the terms of service Text *FormattedText `json:"text"` - // The minimum age of a user to be able to accept the terms; 0 if any + // The minimum age of a user to be able to accept the terms; 0 if age isn't restricted MinUserAge int32 `json:"min_user_age"` // True, if a blocking popup with terms of service must be shown to the user ShowPopup bool `json:"show_popup"` @@ -2519,7 +2588,7 @@ type LocalFile struct { meta // Local path to the locally available file part; may be empty Path string `json:"path"` - // True, if it is possible to try to download or generate the file + // True, if it is possible to download or generate the file CanBeDownloaded bool `json:"can_be_downloaded"` // True, if the file can be deleted CanBeDeleted bool `json:"can_be_deleted"` @@ -2554,7 +2623,7 @@ func (*LocalFile) GetType() string { // Represents a remote file type RemoteFile struct { meta - // Remote file identifier; may be empty. Can be used by the current user across application restarts or even from other devices. Uniquely identifies a file, but a file can have a lot of different valid identifiers. If the ID starts with "http://" or "https://", it represents the HTTP URL of the file. TDLib is currently unable to download files if only their URL is known. If downloadFile is called on such a file or if it is sent to a secret chat, TDLib starts a file generation process by sending updateFileGenerationStart to the application with the HTTP URL in the original_path and "#url#" as the conversion string. Application must generate the file by downloading it to the specified location + // Remote file identifier; may be empty. Can be used by the current user across application restarts or even from other devices. Uniquely identifies a file, but a file can have a lot of different valid identifiers. If the ID starts with "http://" or "https://", it represents the HTTP URL of the file. TDLib is currently unable to download files if only their URL is known. If downloadFile/addFileToDownloads is called on such a file or if it is sent to a secret chat, TDLib starts a file generation process by sending updateFileGenerationStart to the application with the HTTP URL in the original_path and "#url#" as the conversion string. Application must generate the file by downloading it to the specified location Id string `json:"id"` // Unique file identifier; may be empty if unknown. The unique file identifier which is the same for the same file even for different users and is persistent over time UniqueId string `json:"unique_id"` @@ -2808,56 +2877,6 @@ func (*ThumbnailFormatJpeg) ThumbnailFormatType() string { return TypeThumbnailFormatJpeg } -// The thumbnail is in PNG format. It will be used only for background patterns -type ThumbnailFormatPng struct { - meta -} - -func (entity *ThumbnailFormatPng) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ThumbnailFormatPng - - return json.Marshal((*stub)(entity)) -} - -func (*ThumbnailFormatPng) GetClass() string { - return ClassThumbnailFormat -} - -func (*ThumbnailFormatPng) GetType() string { - return TypeThumbnailFormatPng -} - -func (*ThumbnailFormatPng) ThumbnailFormatType() string { - return TypeThumbnailFormatPng -} - -// The thumbnail is in WEBP format. It will be used only for some stickers -type ThumbnailFormatWebp struct { - meta -} - -func (entity *ThumbnailFormatWebp) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ThumbnailFormatWebp - - return json.Marshal((*stub)(entity)) -} - -func (*ThumbnailFormatWebp) GetClass() string { - return ClassThumbnailFormat -} - -func (*ThumbnailFormatWebp) GetType() string { - return TypeThumbnailFormatWebp -} - -func (*ThumbnailFormatWebp) ThumbnailFormatType() string { - return TypeThumbnailFormatWebp -} - // The thumbnail is in static GIF format. It will be used only for some bot inline results type ThumbnailFormatGif struct { meta @@ -2883,7 +2902,57 @@ func (*ThumbnailFormatGif) ThumbnailFormatType() string { return TypeThumbnailFormatGif } -// The thumbnail is in TGS format. It will be used only for animated sticker sets +// The thumbnail is in MPEG4 format. It will be used only for some animations and videos +type ThumbnailFormatMpeg4 struct { + meta +} + +func (entity *ThumbnailFormatMpeg4) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ThumbnailFormatMpeg4 + + return json.Marshal((*stub)(entity)) +} + +func (*ThumbnailFormatMpeg4) GetClass() string { + return ClassThumbnailFormat +} + +func (*ThumbnailFormatMpeg4) GetType() string { + return TypeThumbnailFormatMpeg4 +} + +func (*ThumbnailFormatMpeg4) ThumbnailFormatType() string { + return TypeThumbnailFormatMpeg4 +} + +// The thumbnail is in PNG format. It will be used only for background patterns +type ThumbnailFormatPng struct { + meta +} + +func (entity *ThumbnailFormatPng) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ThumbnailFormatPng + + return json.Marshal((*stub)(entity)) +} + +func (*ThumbnailFormatPng) GetClass() string { + return ClassThumbnailFormat +} + +func (*ThumbnailFormatPng) GetType() string { + return TypeThumbnailFormatPng +} + +func (*ThumbnailFormatPng) ThumbnailFormatType() string { + return TypeThumbnailFormatPng +} + +// The thumbnail is in TGS format. It will be used only for TGS sticker sets type ThumbnailFormatTgs struct { meta } @@ -2908,29 +2977,54 @@ func (*ThumbnailFormatTgs) ThumbnailFormatType() string { return TypeThumbnailFormatTgs } -// The thumbnail is in MPEG4 format. It will be used only for some animations and videos -type ThumbnailFormatMpeg4 struct { +// The thumbnail is in WEBM format. It will be used only for WEBM sticker sets +type ThumbnailFormatWebm struct { meta } -func (entity *ThumbnailFormatMpeg4) MarshalJSON() ([]byte, error) { +func (entity *ThumbnailFormatWebm) MarshalJSON() ([]byte, error) { entity.meta.Type = entity.GetType() - type stub ThumbnailFormatMpeg4 + type stub ThumbnailFormatWebm return json.Marshal((*stub)(entity)) } -func (*ThumbnailFormatMpeg4) GetClass() string { +func (*ThumbnailFormatWebm) GetClass() string { return ClassThumbnailFormat } -func (*ThumbnailFormatMpeg4) GetType() string { - return TypeThumbnailFormatMpeg4 +func (*ThumbnailFormatWebm) GetType() string { + return TypeThumbnailFormatWebm } -func (*ThumbnailFormatMpeg4) ThumbnailFormatType() string { - return TypeThumbnailFormatMpeg4 +func (*ThumbnailFormatWebm) ThumbnailFormatType() string { + return TypeThumbnailFormatWebm +} + +// The thumbnail is in WEBP format. It will be used only for some stickers +type ThumbnailFormatWebp struct { + meta +} + +func (entity *ThumbnailFormatWebp) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ThumbnailFormatWebp + + return json.Marshal((*stub)(entity)) +} + +func (*ThumbnailFormatWebp) GetClass() string { + return ClassThumbnailFormat +} + +func (*ThumbnailFormatWebp) GetType() string { + return TypeThumbnailFormatWebp +} + +func (*ThumbnailFormatWebp) ThumbnailFormatType() string { + return TypeThumbnailFormatWebp } // Represents a thumbnail @@ -3137,6 +3231,108 @@ func (maskPosition *MaskPosition) UnmarshalJSON(data []byte) error { return nil } +// The sticker is an image in WEBP format +type StickerTypeStatic struct { + meta +} + +func (entity *StickerTypeStatic) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub StickerTypeStatic + + return json.Marshal((*stub)(entity)) +} + +func (*StickerTypeStatic) GetClass() string { + return ClassStickerType +} + +func (*StickerTypeStatic) GetType() string { + return TypeStickerTypeStatic +} + +func (*StickerTypeStatic) StickerTypeType() string { + return TypeStickerTypeStatic +} + +// The sticker is an animation in TGS format +type StickerTypeAnimated struct { + meta +} + +func (entity *StickerTypeAnimated) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub StickerTypeAnimated + + return json.Marshal((*stub)(entity)) +} + +func (*StickerTypeAnimated) GetClass() string { + return ClassStickerType +} + +func (*StickerTypeAnimated) GetType() string { + return TypeStickerTypeAnimated +} + +func (*StickerTypeAnimated) StickerTypeType() string { + return TypeStickerTypeAnimated +} + +// The sticker is a video in WEBM format +type StickerTypeVideo struct { + meta +} + +func (entity *StickerTypeVideo) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub StickerTypeVideo + + return json.Marshal((*stub)(entity)) +} + +func (*StickerTypeVideo) GetClass() string { + return ClassStickerType +} + +func (*StickerTypeVideo) GetType() string { + return TypeStickerTypeVideo +} + +func (*StickerTypeVideo) StickerTypeType() string { + return TypeStickerTypeVideo +} + +// The sticker is a mask in WEBP format to be placed on photos or videos +type StickerTypeMask struct { + meta + // Position where the mask is placed; may be null + MaskPosition *MaskPosition `json:"mask_position"` +} + +func (entity *StickerTypeMask) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub StickerTypeMask + + return json.Marshal((*stub)(entity)) +} + +func (*StickerTypeMask) GetClass() string { + return ClassStickerType +} + +func (*StickerTypeMask) GetType() string { + return TypeStickerTypeMask +} + +func (*StickerTypeMask) StickerTypeType() string { + return TypeStickerTypeMask +} + // Represents a closed vector path. The path begins at the end point of the last command type ClosedVectorPath struct { meta @@ -3408,12 +3604,8 @@ type Sticker struct { Height int32 `json:"height"` // Emoji corresponding to the sticker Emoji string `json:"emoji"` - // True, if the sticker is an animated sticker in TGS format - IsAnimated bool `json:"is_animated"` - // True, if the sticker is a mask - IsMask bool `json:"is_mask"` - // Position where the mask is placed; may be null - MaskPosition *MaskPosition `json:"mask_position"` + // Sticker type + Type StickerType `json:"type"` // Sticker's outline represented as a list of closed vector paths; may be empty. The coordinate system origin is in the upper-left corner Outline []*ClosedVectorPath `json:"outline"` // Sticker thumbnail in WEBP or JPEG format; may be null @@ -3438,6 +3630,37 @@ func (*Sticker) GetType() string { return TypeSticker } +func (sticker *Sticker) UnmarshalJSON(data []byte) error { + var tmp struct { + SetId JsonInt64 `json:"set_id"` + Width int32 `json:"width"` + Height int32 `json:"height"` + Emoji string `json:"emoji"` + Type json.RawMessage `json:"type"` + Outline []*ClosedVectorPath `json:"outline"` + Thumbnail *Thumbnail `json:"thumbnail"` + Sticker *File `json:"sticker"` + } + + err := json.Unmarshal(data, &tmp) + if err != nil { + return err + } + + sticker.SetId = tmp.SetId + sticker.Width = tmp.Width + sticker.Height = tmp.Height + sticker.Emoji = tmp.Emoji + sticker.Outline = tmp.Outline + sticker.Thumbnail = tmp.Thumbnail + sticker.Sticker = tmp.Sticker + + fieldType, _ := UnmarshalStickerType(tmp.Type) + sticker.Type = fieldType + + return nil +} + // Describes a video file type Video struct { meta @@ -3546,7 +3769,7 @@ type AnimatedEmoji struct { Sticker *Sticker `json:"sticker"` // Emoji modifier fitzpatrick type; 0-6; 0 if none FitzpatrickType int32 `json:"fitzpatrick_type"` - // File containing the sound to be played when the animated emoji is clicked if any; may be null. The sound is encoded with the Opus codec, and stored inside an OGG container + // File containing the sound to be played when the animated emoji is clicked; may be null. The sound is encoded with the Opus codec, and stored inside an OGG container Sound *File `json:"sound"` } @@ -3633,7 +3856,7 @@ type Venue struct { Title string `json:"title"` // Venue address; as defined by the sender Address string `json:"address"` - // Provider of the venue database; as defined by the sender. Currently only "foursquare" and "gplaces" (Google Places) need to be supported + // Provider of the venue database; as defined by the sender. Currently, only "foursquare" and "gplaces" (Google Places) need to be supported Provider string `json:"provider"` // Identifier of the venue in the provider database; as defined by the sender Id string `json:"id"` @@ -3891,6 +4114,8 @@ type UserTypeBot struct { InlineQueryPlaceholder string `json:"inline_query_placeholder"` // True, if the location of the user is expected to be sent with every inline query to this bot NeedLocation bool `json:"need_location"` + // True, if the bot can be added to attachment menu + CanBeAddedToAttachmentMenu bool `json:"can_be_added_to_attachment_menu"` } func (entity *UserTypeBot) MarshalJSON() ([]byte, error) { @@ -3988,6 +4213,31 @@ func (*BotCommands) GetType() string { return TypeBotCommands } +// Describes a button to be shown instead of bot commands menu button +type BotMenuButton struct { + meta + // Text of the button + Text string `json:"text"` + // URL to be passed to openWebApp + Url string `json:"url"` +} + +func (entity *BotMenuButton) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub BotMenuButton + + return json.Marshal((*stub)(entity)) +} + +func (*BotMenuButton) GetClass() string { + return ClassBotMenuButton +} + +func (*BotMenuButton) GetType() string { + return TypeBotMenuButton +} + // Represents a location to which a chat is connected type ChatLocation struct { meta @@ -4214,6 +4464,86 @@ func (inputChatPhotoAnimation *InputChatPhotoAnimation) UnmarshalJSON(data []byt return nil } +// Describes actions that a user is allowed to take in a chat +type ChatPermissions struct { + meta + // True, if the user can send text messages, contacts, locations, and venues + CanSendMessages bool `json:"can_send_messages"` + // True, if the user can send audio files, documents, photos, videos, video notes, and voice notes. Implies can_send_messages permissions + CanSendMediaMessages bool `json:"can_send_media_messages"` + // True, if the user can send polls. Implies can_send_messages permissions + CanSendPolls bool `json:"can_send_polls"` + // True, if the user can send animations, games, stickers, and dice and use inline bots. Implies can_send_messages permissions + CanSendOtherMessages bool `json:"can_send_other_messages"` + // True, if the user may add a web page preview to their messages. Implies can_send_messages permissions + CanAddWebPagePreviews bool `json:"can_add_web_page_previews"` + // True, if the user can change the chat title, photo, and other settings + CanChangeInfo bool `json:"can_change_info"` + // True, if the user can invite new users to the chat + CanInviteUsers bool `json:"can_invite_users"` + // True, if the user can pin messages + CanPinMessages bool `json:"can_pin_messages"` +} + +func (entity *ChatPermissions) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatPermissions + + return json.Marshal((*stub)(entity)) +} + +func (*ChatPermissions) GetClass() string { + return ClassChatPermissions +} + +func (*ChatPermissions) GetType() string { + return TypeChatPermissions +} + +// Describes rights of the administrator +type ChatAdministratorRights struct { + meta + // True, if the administrator can get chat event log, get chat statistics, get message statistics in channels, get channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other privilege; applicable to supergroups and channels only + CanManageChat bool `json:"can_manage_chat"` + // True, if the administrator can change the chat title, photo, and other settings + CanChangeInfo bool `json:"can_change_info"` + // True, if the administrator can create channel posts; applicable to channels only + CanPostMessages bool `json:"can_post_messages"` + // True, if the administrator can edit messages of other users and pin messages; applicable to channels only + CanEditMessages bool `json:"can_edit_messages"` + // True, if the administrator can delete messages of other users + CanDeleteMessages bool `json:"can_delete_messages"` + // True, if the administrator can invite new users to the chat + CanInviteUsers bool `json:"can_invite_users"` + // True, if the administrator can restrict, ban, or unban chat members; always true for channels + CanRestrictMembers bool `json:"can_restrict_members"` + // True, if the administrator can pin messages; applicable to basic groups and supergroups only + CanPinMessages bool `json:"can_pin_messages"` + // True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that were directly or indirectly promoted by them + CanPromoteMembers bool `json:"can_promote_members"` + // True, if the administrator can manage video chats + CanManageVideoChats bool `json:"can_manage_video_chats"` + // True, if the administrator isn't shown in the chat member list and sends messages anonymously; applicable to supergroups only + IsAnonymous bool `json:"is_anonymous"` +} + +func (entity *ChatAdministratorRights) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatAdministratorRights + + return json.Marshal((*stub)(entity)) +} + +func (*ChatAdministratorRights) GetClass() string { + return ClassChatAdministratorRights +} + +func (*ChatAdministratorRights) GetType() string { + return TypeChatAdministratorRights +} + // Represents a user type User struct { meta @@ -4245,7 +4575,7 @@ type User struct { IsScam bool `json:"is_scam"` // True, if many users reported this user as a fake account IsFake bool `json:"is_fake"` - // If false, the user is inaccessible, and the only information known about the user is inside this class. It can't be passed to any method except GetUser + // If false, the user is inaccessible, and the only information known about the user is inside this class. Identifier of the user can't be passed to any method except GetUser HaveAccess bool `json:"have_access"` // Type of the user Type UserType `json:"type"` @@ -4320,6 +4650,39 @@ func (user *User) UnmarshalJSON(data []byte) error { return nil } +// Contains information about a bot +type BotInfo struct { + meta + // The text that is shown on the bot's profile page and is sent together with the link when users share the bot + ShareText string `json:"share_text"` + // The text shown in the chat with the bot if the chat is empty + Description string `json:"description"` + // Information about a button to show instead of the bot commands menu button; may be null if ordinary bot commands menu must be shown + MenuButton *BotMenuButton `json:"menu_button"` + // List of the bot commands + Commands []*BotCommand `json:"commands"` + // Default administrator rights for adding the bot to basic group and supergroup chats; may be null + DefaultGroupAdministratorRights *ChatAdministratorRights `json:"default_group_administrator_rights"` + // Default administrator rights for adding the bot to channels; may be null + DefaultChannelAdministratorRights *ChatAdministratorRights `json:"default_channel_administrator_rights"` +} + +func (entity *BotInfo) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub BotInfo + + return json.Marshal((*stub)(entity)) +} + +func (*BotInfo) GetClass() string { + return ClassBotInfo +} + +func (*BotInfo) GetType() string { + return TypeBotInfo +} + // Contains full information about a user type UserFullInfo struct { meta @@ -4339,14 +4702,10 @@ type UserFullInfo struct { NeedPhoneNumberPrivacyException bool `json:"need_phone_number_privacy_exception"` // A short user bio Bio string `json:"bio"` - // For bots, the text that is shown on the bot's profile page and is sent together with the link when users share the bot - ShareText string `json:"share_text"` - // For bots, the text shown in the chat with the bot if the chat is empty - Description string `json:"description"` // Number of group chats where both the other user and the current user are a member; 0 for the current user GroupInCommonCount int32 `json:"group_in_common_count"` - // For bots, list of the bot commands - Commands []*BotCommand `json:"commands"` + // For bots, information about the bot; may be null + BotInfo *BotInfo `json:"bot_info"` } func (entity *UserFullInfo) MarshalJSON() ([]byte, error) { @@ -4368,7 +4727,7 @@ func (*UserFullInfo) GetType() string { // Represents a list of users type Users struct { meta - // Approximate total count of users found + // Approximate total number of users found TotalCount int32 `json:"total_count"` // A list of user identifiers UserIds []int64 `json:"user_ids"` @@ -4440,43 +4799,6 @@ func (*ChatAdministrators) GetType() string { return TypeChatAdministrators } -// Describes actions that a user is allowed to take in a chat -type ChatPermissions struct { - meta - // True, if the user can send text messages, contacts, locations, and venues - CanSendMessages bool `json:"can_send_messages"` - // True, if the user can send audio files, documents, photos, videos, video notes, and voice notes. Implies can_send_messages permissions - CanSendMediaMessages bool `json:"can_send_media_messages"` - // True, if the user can send polls. Implies can_send_messages permissions - CanSendPolls bool `json:"can_send_polls"` - // True, if the user can send animations, games, stickers, and dice and use inline bots. Implies can_send_messages permissions - CanSendOtherMessages bool `json:"can_send_other_messages"` - // True, if the user may add a web page preview to their messages. Implies can_send_messages permissions - CanAddWebPagePreviews bool `json:"can_add_web_page_previews"` - // True, if the user can change the chat title, photo, and other settings - CanChangeInfo bool `json:"can_change_info"` - // True, if the user can invite new users to the chat - CanInviteUsers bool `json:"can_invite_users"` - // True, if the user can pin messages - CanPinMessages bool `json:"can_pin_messages"` -} - -func (entity *ChatPermissions) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatPermissions - - return json.Marshal((*stub)(entity)) -} - -func (*ChatPermissions) GetClass() string { - return ClassChatPermissions -} - -func (*ChatPermissions) GetType() string { - return TypeChatPermissions -} - // The user is the owner of the chat and has all the administrator privileges type ChatMemberStatusCreator struct { meta @@ -4515,28 +4837,8 @@ type ChatMemberStatusAdministrator struct { CustomTitle string `json:"custom_title"` // True, if the current user can edit the administrator privileges for the called user CanBeEdited bool `json:"can_be_edited"` - // True, if the administrator can get chat event log, get chat statistics, get message statistics in channels, get channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other privilege; applicable to supergroups and channels only - CanManageChat bool `json:"can_manage_chat"` - // True, if the administrator can change the chat title, photo, and other settings - CanChangeInfo bool `json:"can_change_info"` - // True, if the administrator can create channel posts; applicable to channels only - CanPostMessages bool `json:"can_post_messages"` - // True, if the administrator can edit messages of other users and pin messages; applicable to channels only - CanEditMessages bool `json:"can_edit_messages"` - // True, if the administrator can delete messages of other users - CanDeleteMessages bool `json:"can_delete_messages"` - // True, if the administrator can invite new users to the chat - CanInviteUsers bool `json:"can_invite_users"` - // True, if the administrator can restrict, ban, or unban chat members; always true for channels - CanRestrictMembers bool `json:"can_restrict_members"` - // True, if the administrator can pin messages; applicable to basic groups and supergroups only - CanPinMessages bool `json:"can_pin_messages"` - // True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that were directly or indirectly promoted by them - CanPromoteMembers bool `json:"can_promote_members"` - // True, if the administrator can manage video chats - CanManageVideoChats bool `json:"can_manage_video_chats"` - // True, if the administrator isn't shown in the chat member list and sends messages anonymously; applicable to supergroups only - IsAnonymous bool `json:"is_anonymous"` + // Rights of the administrator + Rights *ChatAdministratorRights `json:"rights"` } func (entity *ChatMemberStatusAdministrator) MarshalJSON() ([]byte, error) { @@ -4724,7 +5026,7 @@ func (chatMember *ChatMember) UnmarshalJSON(data []byte) error { // Contains a list of chat members type ChatMembers struct { meta - // Approximate total count of chat members found + // Approximate total number of chat members found TotalCount int32 `json:"total_count"` // A list of chat members Members []*ChatMember `json:"members"` @@ -5149,7 +5451,7 @@ type ChatInviteLink struct { // Point in time (Unix timestamp) when the link was last edited; 0 if never or unknown EditDate int32 `json:"edit_date"` // Point in time (Unix timestamp) when the link will expire; 0 if never - ExpireDate int32 `json:"expire_date"` + ExpirationDate int32 `json:"expiration_date"` // The maximum number of members, which can join the chat using the link simultaneously; 0 if not limited. Always 0 if the link requires approval MemberLimit int32 `json:"member_limit"` // Number of chat members, which joined the chat using the link @@ -5158,7 +5460,7 @@ type ChatInviteLink struct { PendingJoinRequestCount int32 `json:"pending_join_request_count"` // True, if the link only creates join request. If true, total number of joining members will be unlimited CreatesJoinRequest bool `json:"creates_join_request"` - // True, if the link is primary. Primary invite link can't have name, expire date or usage limit. There is exactly one primary invite link for each administrator with can_invite_users right at a given time + // True, if the link is primary. Primary invite link can't have name, expiration date, or usage limit. There is exactly one primary invite link for each administrator with can_invite_users right at a given time IsPrimary bool `json:"is_primary"` // True, if the link was revoked IsRevoked bool `json:"is_revoked"` @@ -5183,7 +5485,7 @@ func (*ChatInviteLink) GetType() string { // Contains a list of chat invite links type ChatInviteLinks struct { meta - // Approximate total count of chat invite links found + // Approximate total number of chat invite links found TotalCount int32 `json:"total_count"` // List of invite links InviteLinks []*ChatInviteLink `json:"invite_links"` @@ -5255,7 +5557,7 @@ func (*ChatInviteLinkCounts) GetType() string { return TypeChatInviteLinkCounts } -// Describes a chat member joined a chat by an invite link +// Describes a chat member joined a chat via an invite link type ChatInviteLinkMember struct { meta // User identifier @@ -5282,12 +5584,12 @@ func (*ChatInviteLinkMember) GetType() string { return TypeChatInviteLinkMember } -// Contains a list of chat members joined a chat by an invite link +// Contains a list of chat members joined a chat via an invite link type ChatInviteLinkMembers struct { meta - // Approximate total count of chat members found + // Approximate total number of chat members found TotalCount int32 `json:"total_count"` - // List of chat members, joined a chat by an invite link + // List of chat members, joined a chat via an invite link Members []*ChatInviteLinkMember `json:"members"` } @@ -5410,10 +5712,10 @@ func (*ChatJoinRequest) GetType() string { return TypeChatJoinRequest } -// Contains a list of chat join requests +// Contains a list of requests to join a chat type ChatJoinRequests struct { meta - // Approximate total count of requests found + // Approximate total number of requests found TotalCount int32 `json:"total_count"` // List of the requests Requests []*ChatJoinRequest `json:"requests"` @@ -5435,12 +5737,12 @@ func (*ChatJoinRequests) GetType() string { return TypeChatJoinRequests } -// Contains information about pending chat join requests +// Contains information about pending join requests for a chat type ChatJoinRequestsInfo struct { meta // Total number of pending join requests TotalCount int32 `json:"total_count"` - // Identifiers of users sent the newest pending join requests + // Identifiers of at most 3 users sent the newest pending join requests UserIds []int64 `json:"user_ids"` } @@ -5560,7 +5862,7 @@ type Supergroup struct { Date int32 `json:"date"` // Status of the current user in the supergroup or channel; custom title will be always empty Status ChatMemberStatus `json:"status"` - // Number of members in the supergroup or channel; 0 if unknown. Currently it is guaranteed to be known only if the supergroup or channel was received through searchPublicChats, searchChatsNearby, getInactiveSupergroupChats, getSuitableDiscussionChats, getGroupsInCommon, or getUserPrivacySettingRules + // Number of members in the supergroup or channel; 0 if unknown. Currently, it is guaranteed to be known only if the supergroup or channel was received through searchPublicChats, searchChatsNearby, getInactiveSupergroupChats, getSuitableDiscussionChats, getGroupsInCommon, or getUserPrivacySettingRules MemberCount int32 `json:"member_count"` // True, if the channel has a discussion group, or the supergroup is the designated discussion group for a channel HasLinkedChat bool `json:"has_linked_chat"` @@ -5572,7 +5874,7 @@ type Supergroup struct { IsSlowModeEnabled bool `json:"is_slow_mode_enabled"` // True, if the supergroup is a channel IsChannel bool `json:"is_channel"` - // True, if the supergroup is a broadcast group, i.e. only administrators can send messages and there is no limit on number of members + // True, if the supergroup is a broadcast group, i.e. only administrators can send messages and there is no limit on the number of members IsBroadcastGroup bool `json:"is_broadcast_group"` // True, if the supergroup or channel is verified IsVerified bool `json:"is_verified"` @@ -5682,7 +5984,7 @@ type SupergroupFullInfo struct { StickerSetId JsonInt64 `json:"sticker_set_id"` // Location to which the supergroup is connected; may be null Location *ChatLocation `json:"location"` - // Primary invite link for this chat; may be null. For chat administrators with can_invite_users right only + // Primary invite link for the chat; may be null. For chat administrators with can_invite_users right only InviteLink *ChatInviteLink `json:"invite_link"` // List of commands of bots in the group BotCommands []*BotCommands `json:"bot_commands"` @@ -5900,7 +6202,7 @@ func (*MessageSenderChat) MessageSenderType() string { // Represents a list of message senders type MessageSenders struct { meta - // Approximate total count of messages senders found + // Approximate total number of messages senders found TotalCount int32 `json:"total_count"` // List of message senders Senders []MessageSender `json:"senders"` @@ -5968,12 +6270,12 @@ func (*MessageForwardOriginUser) MessageForwardOriginType() string { return TypeMessageForwardOriginUser } -// The message was originally sent by an anonymous chat administrator on behalf of the chat +// The message was originally sent on behalf of a chat type MessageForwardOriginChat struct { meta // Identifier of the chat that originally sent the message SenderChatId int64 `json:"sender_chat_id"` - // Original message author signature + // For messages originally sent by an anonymous chat administrator, original message author signature AuthorSignature string `json:"author_signature"` } @@ -6143,7 +6445,7 @@ type MessageReplyInfo struct { meta // Number of times the message was directly or indirectly replied ReplyCount int32 `json:"reply_count"` - // Identifiers of recent repliers to the message; available in channels with a discussion supergroup + // Identifiers of at most 3 recent repliers to the message; available in channels with a discussion supergroup. The users and chats are expected to be inaccessible: only their photo and name will be available RecentReplierIds []MessageSender `json:"recent_replier_ids"` // Identifier of the last read incoming reply to the message LastReadInboxMessageId int64 `json:"last_read_inbox_message_id"` @@ -6194,6 +6496,58 @@ func (messageReplyInfo *MessageReplyInfo) UnmarshalJSON(data []byte) error { return nil } +// Contains information about a reaction to a message +type MessageReaction struct { + meta + // Text representation of the reaction + Reaction string `json:"reaction"` + // Number of times the reaction was added + TotalCount int32 `json:"total_count"` + // True, if the reaction is chosen by the current user + IsChosen bool `json:"is_chosen"` + // Identifiers of at most 3 recent message senders, added the reaction; available in private, basic group and supergroup chats + RecentSenderIds []MessageSender `json:"recent_sender_ids"` +} + +func (entity *MessageReaction) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub MessageReaction + + return json.Marshal((*stub)(entity)) +} + +func (*MessageReaction) GetClass() string { + return ClassMessageReaction +} + +func (*MessageReaction) GetType() string { + return TypeMessageReaction +} + +func (messageReaction *MessageReaction) UnmarshalJSON(data []byte) error { + var tmp struct { + Reaction string `json:"reaction"` + TotalCount int32 `json:"total_count"` + IsChosen bool `json:"is_chosen"` + RecentSenderIds []json.RawMessage `json:"recent_sender_ids"` + } + + err := json.Unmarshal(data, &tmp) + if err != nil { + return err + } + + messageReaction.Reaction = tmp.Reaction + messageReaction.TotalCount = tmp.TotalCount + messageReaction.IsChosen = tmp.IsChosen + + fieldRecentSenderIds, _ := UnmarshalListOfMessageSender(tmp.RecentSenderIds) + messageReaction.RecentSenderIds = fieldRecentSenderIds + + return nil +} + // Contains information about interactions with a message type MessageInteractionInfo struct { meta @@ -6203,6 +6557,8 @@ type MessageInteractionInfo struct { ForwardCount int32 `json:"forward_count"` // Information about direct or indirect replies to the message; may be null. Currently, available only in channels with a discussion supergroup and discussion supergroups for messages, which are not replies itself ReplyInfo *MessageReplyInfo `json:"reply_info"` + // The list of reactions added to the message + Reactions []*MessageReaction `json:"reactions"` } func (entity *MessageInteractionInfo) MarshalJSON() ([]byte, error) { @@ -6221,6 +6577,54 @@ func (*MessageInteractionInfo) GetType() string { return TypeMessageInteractionInfo } +// Contains information about an unread reaction to a message +type UnreadReaction struct { + meta + // Text representation of the reaction + Reaction string `json:"reaction"` + // Identifier of the sender, added the reaction + SenderId MessageSender `json:"sender_id"` + // True, if the reaction was added with a big animation + IsBig bool `json:"is_big"` +} + +func (entity *UnreadReaction) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UnreadReaction + + return json.Marshal((*stub)(entity)) +} + +func (*UnreadReaction) GetClass() string { + return ClassUnreadReaction +} + +func (*UnreadReaction) GetType() string { + return TypeUnreadReaction +} + +func (unreadReaction *UnreadReaction) UnmarshalJSON(data []byte) error { + var tmp struct { + Reaction string `json:"reaction"` + SenderId json.RawMessage `json:"sender_id"` + IsBig bool `json:"is_big"` + } + + err := json.Unmarshal(data, &tmp) + if err != nil { + return err + } + + unreadReaction.Reaction = tmp.Reaction + unreadReaction.IsBig = tmp.IsBig + + fieldSenderId, _ := UnmarshalMessageSender(tmp.SenderId) + unreadReaction.SenderId = fieldSenderId + + return nil +} + // The message is being sent now, but has not yet been delivered to the server type MessageSendingStatePending struct { meta @@ -6308,13 +6712,15 @@ type Message struct { CanBeDeletedOnlyForSelf bool `json:"can_be_deleted_only_for_self"` // True, if the message can be deleted for all users CanBeDeletedForAllUsers bool `json:"can_be_deleted_for_all_users"` - // True, if the message statistics are available + // True, if the list of added reactions is available through getMessageAddedReactions + CanGetAddedReactions bool `json:"can_get_added_reactions"` + // True, if the message statistics are available through getMessageStatistics CanGetStatistics bool `json:"can_get_statistics"` - // True, if the message thread info is available + // True, if information about the message thread is available through getMessageThread CanGetMessageThread bool `json:"can_get_message_thread"` // True, if chat members already viewed the message can be received through getMessageViewers CanGetViewers bool `json:"can_get_viewers"` - // True, if media timestamp links can be generated for media timestamp entities in the message text, caption or web page description + // True, if media timestamp links can be generated for media timestamp entities in the message text, caption or web page description through getMessageLink CanGetMediaTimestampLinks bool `json:"can_get_media_timestamp_links"` // True, if media timestamp entities refers to a media in this message as opposed to a media in the replied message HasTimestampedMedia bool `json:"has_timestamped_media"` @@ -6330,6 +6736,8 @@ type Message struct { ForwardInfo *MessageForwardInfo `json:"forward_info"` // Information about interactions with the message; may be null InteractionInfo *MessageInteractionInfo `json:"interaction_info"` + // Information about unread reactions added to the message + UnreadReactions []*UnreadReaction `json:"unread_reactions"` // If non-zero, the identifier of the chat to which the replied message belongs; Currently, only messages in the Replies chat can have different reply_in_chat_id and chat_id ReplyInChatId int64 `json:"reply_in_chat_id"` // If non-zero, the identifier of the message this message is replying to; can be the identifier of a deleted message @@ -6384,6 +6792,7 @@ func (message *Message) UnmarshalJSON(data []byte) error { CanBeSaved bool `json:"can_be_saved"` CanBeDeletedOnlyForSelf bool `json:"can_be_deleted_only_for_self"` CanBeDeletedForAllUsers bool `json:"can_be_deleted_for_all_users"` + CanGetAddedReactions bool `json:"can_get_added_reactions"` CanGetStatistics bool `json:"can_get_statistics"` CanGetMessageThread bool `json:"can_get_message_thread"` CanGetViewers bool `json:"can_get_viewers"` @@ -6395,6 +6804,7 @@ func (message *Message) UnmarshalJSON(data []byte) error { EditDate int32 `json:"edit_date"` ForwardInfo *MessageForwardInfo `json:"forward_info"` InteractionInfo *MessageInteractionInfo `json:"interaction_info"` + UnreadReactions []*UnreadReaction `json:"unread_reactions"` ReplyInChatId int64 `json:"reply_in_chat_id"` ReplyToMessageId int64 `json:"reply_to_message_id"` MessageThreadId int64 `json:"message_thread_id"` @@ -6422,6 +6832,7 @@ func (message *Message) UnmarshalJSON(data []byte) error { message.CanBeSaved = tmp.CanBeSaved message.CanBeDeletedOnlyForSelf = tmp.CanBeDeletedOnlyForSelf message.CanBeDeletedForAllUsers = tmp.CanBeDeletedForAllUsers + message.CanGetAddedReactions = tmp.CanGetAddedReactions message.CanGetStatistics = tmp.CanGetStatistics message.CanGetMessageThread = tmp.CanGetMessageThread message.CanGetViewers = tmp.CanGetViewers @@ -6433,6 +6844,7 @@ func (message *Message) UnmarshalJSON(data []byte) error { message.EditDate = tmp.EditDate message.ForwardInfo = tmp.ForwardInfo message.InteractionInfo = tmp.InteractionInfo + message.UnreadReactions = tmp.UnreadReactions message.ReplyInChatId = tmp.ReplyInChatId message.ReplyToMessageId = tmp.ReplyToMessageId message.MessageThreadId = tmp.MessageThreadId @@ -6464,7 +6876,7 @@ func (message *Message) UnmarshalJSON(data []byte) error { // Contains a list of messages type Messages struct { meta - // Approximate total count of messages found + // Approximate total number of messages found TotalCount int32 `json:"total_count"` // List of messages; messages may be null Messages []*Message `json:"messages"` @@ -6489,7 +6901,7 @@ func (*Messages) GetType() string { // Contains a list of messages found by a search type FoundMessages struct { meta - // Approximate total count of messages found; -1 if unknown + // Approximate total number of messages found; -1 if unknown TotalCount int32 `json:"total_count"` // List of messages Messages []*Message `json:"messages"` @@ -6543,7 +6955,7 @@ func (*MessagePosition) GetType() string { // Contains a list of message positions type MessagePositions struct { meta - // Total count of messages found + // Total number of messages found TotalCount int32 `json:"total_count"` // List of message positions Positions []*MessagePosition `json:"positions"` @@ -6565,12 +6977,12 @@ func (*MessagePositions) GetType() string { return TypeMessagePositions } -// Contains information about found messages sent in a specific day +// Contains information about found messages sent on a specific day type MessageCalendarDay struct { meta - // Total number of found messages sent in the day + // Total number of found messages sent on the day TotalCount int32 `json:"total_count"` - // First message sent in the day + // First message sent on the day Message *Message `json:"message"` } @@ -6590,7 +7002,7 @@ func (*MessageCalendarDay) GetType() string { return TypeMessageCalendarDay } -// Contains information about found messages, splitted by days according to the option "utc_time_offset" +// Contains information about found messages, split by days according to the option "utc_time_offset" type MessageCalendar struct { meta // Total number of found messages @@ -6618,13 +7030,15 @@ func (*MessageCalendar) GetType() string { // Describes a sponsored message type SponsoredMessage struct { meta - // Unique sponsored message identifier - Id int32 `json:"id"` - // Chat identifier + // Message identifier; unique for the chat to which the sponsored message belongs among both ordinary and sponsored messages + MessageId int64 `json:"message_id"` + // Sponsor chat identifier; 0 if the sponsor chat is accessible through an invite link SponsorChatId int64 `json:"sponsor_chat_id"` - // An internal link to be opened when the sponsored message is clicked; may be null. If null, the sponsor chat needs to be opened instead + // Information about the sponsor chat; may be null unless sponsor_chat_id == 0 + SponsorChatInfo *ChatInviteLinkInfo `json:"sponsor_chat_info"` + // An internal link to be opened when the sponsored message is clicked; may be null if the sponsor chat needs to be opened instead Link InternalLinkType `json:"link"` - // Content of the message + // Content of the message. Currently, can be only of the type messageText Content MessageContent `json:"content"` } @@ -6646,10 +7060,11 @@ func (*SponsoredMessage) GetType() string { func (sponsoredMessage *SponsoredMessage) UnmarshalJSON(data []byte) error { var tmp struct { - Id int32 `json:"id"` - SponsorChatId int64 `json:"sponsor_chat_id"` - Link json.RawMessage `json:"link"` - Content json.RawMessage `json:"content"` + MessageId int64 `json:"message_id"` + SponsorChatId int64 `json:"sponsor_chat_id"` + SponsorChatInfo *ChatInviteLinkInfo `json:"sponsor_chat_info"` + Link json.RawMessage `json:"link"` + Content json.RawMessage `json:"content"` } err := json.Unmarshal(data, &tmp) @@ -6657,8 +7072,9 @@ func (sponsoredMessage *SponsoredMessage) UnmarshalJSON(data []byte) error { return err } - sponsoredMessage.Id = tmp.Id + sponsoredMessage.MessageId = tmp.MessageId sponsoredMessage.SponsorChatId = tmp.SponsorChatId + sponsoredMessage.SponsorChatInfo = tmp.SponsorChatInfo fieldLink, _ := UnmarshalInternalLinkType(tmp.Link) sponsoredMessage.Link = fieldLink @@ -6669,27 +7085,89 @@ func (sponsoredMessage *SponsoredMessage) UnmarshalJSON(data []byte) error { return nil } -// Contains a list of sponsored messages -type SponsoredMessages struct { +// Describes a file added to file download list +type FileDownload struct { meta - // List of sponsored messages - Messages []*SponsoredMessage `json:"messages"` + // File identifier + FileId int32 `json:"file_id"` + // The message with the file + Message *Message `json:"message"` + // Point in time (Unix timestamp) when the file was added to the download list + AddDate int32 `json:"add_date"` + // Point in time (Unix timestamp) when the file downloading was completed; 0 if the file downloading isn't completed + CompleteDate int32 `json:"complete_date"` + // True, if downloading of the file is paused + IsPaused bool `json:"is_paused"` } -func (entity *SponsoredMessages) MarshalJSON() ([]byte, error) { +func (entity *FileDownload) MarshalJSON() ([]byte, error) { entity.meta.Type = entity.GetType() - type stub SponsoredMessages + type stub FileDownload return json.Marshal((*stub)(entity)) } -func (*SponsoredMessages) GetClass() string { - return ClassSponsoredMessages +func (*FileDownload) GetClass() string { + return ClassFileDownload } -func (*SponsoredMessages) GetType() string { - return TypeSponsoredMessages +func (*FileDownload) GetType() string { + return TypeFileDownload +} + +// Contains number of being downloaded and recently downloaded files found +type DownloadedFileCounts struct { + meta + // Number of active file downloads found, including paused + ActiveCount int32 `json:"active_count"` + // Number of paused file downloads found + PausedCount int32 `json:"paused_count"` + // Number of completed file downloads found + CompletedCount int32 `json:"completed_count"` +} + +func (entity *DownloadedFileCounts) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub DownloadedFileCounts + + return json.Marshal((*stub)(entity)) +} + +func (*DownloadedFileCounts) GetClass() string { + return ClassDownloadedFileCounts +} + +func (*DownloadedFileCounts) GetType() string { + return TypeDownloadedFileCounts +} + +// Contains a list of downloaded files, found by a search +type FoundFileDownloads struct { + meta + // Total number of suitable files, ignoring offset + TotalCounts *DownloadedFileCounts `json:"total_counts"` + // The list of files + Files []*FileDownload `json:"files"` + // The offset for the next request. If empty, there are no more results + NextOffset string `json:"next_offset"` +} + +func (entity *FoundFileDownloads) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub FoundFileDownloads + + return json.Marshal((*stub)(entity)) +} + +func (*FoundFileDownloads) GetClass() string { + return ClassFoundFileDownloads +} + +func (*FoundFileDownloads) GetType() string { + return TypeFoundFileDownloads } // Notification settings applied to all private and secret chats when the corresponding chat setting has a default value @@ -6717,7 +7195,7 @@ func (*NotificationSettingsScopePrivateChats) NotificationSettingsScopeType() st return TypeNotificationSettingsScopePrivateChats } -// Notification settings applied to all basic groups and supergroups when the corresponding chat setting has a default value +// Notification settings applied to all basic group and supergroup chats when the corresponding chat setting has a default value type NotificationSettingsScopeGroupChats struct { meta } @@ -6742,7 +7220,7 @@ func (*NotificationSettingsScopeGroupChats) NotificationSettingsScopeType() stri return TypeNotificationSettingsScopeGroupChats } -// Notification settings applied to all channels when the corresponding chat setting has a default value +// Notification settings applied to all channel chats when the corresponding chat setting has a default value type NotificationSettingsScopeChannelChats struct { meta } @@ -6774,10 +7252,10 @@ type ChatNotificationSettings struct { UseDefaultMuteFor bool `json:"use_default_mute_for"` // Time left before notifications will be unmuted, in seconds MuteFor int32 `json:"mute_for"` - // If true, sound is ignored and the value for the relevant type of chat is used instead + // If true, the value for the relevant type of chat is used instead of sound_id UseDefaultSound bool `json:"use_default_sound"` - // The name of an audio file to be used for notification sounds; only applies to iOS applications - Sound string `json:"sound"` + // Identifier of the notification sound to be played; 0 if sound is disabled + SoundId JsonInt64 `json:"sound_id"` // If true, show_preview is ignored and the value for the relevant type of chat is used instead UseDefaultShowPreview bool `json:"use_default_show_preview"` // True, if message content must be displayed in notifications @@ -6813,8 +7291,8 @@ type ScopeNotificationSettings struct { meta // Time left before notifications will be unmuted, in seconds MuteFor int32 `json:"mute_for"` - // The name of an audio file to be used for notification sounds; only applies to iOS applications - Sound string `json:"sound"` + // Identifier of the notification sound to be played; 0 if sound is disabled + SoundId JsonInt64 `json:"sound_id"` // True, if message content must be displayed in notifications ShowPreview bool `json:"show_preview"` // True, if notifications for incoming pinned messages will be created as for an ordinary unread message @@ -6842,7 +7320,7 @@ func (*ScopeNotificationSettings) GetType() string { // Contains information about a message draft type DraftMessage struct { meta - // Identifier of the message to reply to; 0 if none + // Identifier of the replied message; 0 if none ReplyToMessageId int64 `json:"reply_to_message_id"` // Point in time (Unix timestamp) when the draft was created Date int32 `json:"date"` @@ -7004,7 +7482,7 @@ type ChatFilter struct { meta // The title of the filter; 1-12 characters without line feeds Title string `json:"title"` - // The icon name for short filter representation. If non-empty, must be one of "All", "Unread", "Unmuted", "Bots", "Channels", "Groups", "Private", "Custom", "Setup", "Cat", "Crown", "Favorite", "Flower", "Game", "Home", "Love", "Mask", "Party", "Sport", "Study", "Trade", "Travel", "Work". If empty, use getChatFilterDefaultIconName to get default icon name for the filter + // The chosen icon name for short filter representation. If non-empty, must be one of "All", "Unread", "Unmuted", "Bots", "Channels", "Groups", "Private", "Custom", "Setup", "Cat", "Crown", "Favorite", "Flower", "Game", "Home", "Love", "Mask", "Party", "Sport", "Study", "Trade", "Travel", "Work". If empty, use getChatFilterDefaultIconName to get default icon name for the filter IconName string `json:"icon_name"` // The chat identifiers of pinned chats in the filtered chat list PinnedChatIds []int64 `json:"pinned_chat_ids"` @@ -7053,7 +7531,7 @@ type ChatFilterInfo struct { Id int32 `json:"id"` // The title of the filter; 1-12 characters without line feeds Title string `json:"title"` - // The icon name for short filter representation. One of "All", "Unread", "Unmuted", "Bots", "Channels", "Groups", "Private", "Custom", "Setup", "Cat", "Crown", "Favorite", "Flower", "Game", "Home", "Love", "Mask", "Party", "Sport", "Study", "Trade", "Travel", "Work" + // The chosen or default icon name for short filter representation. One of "All", "Unread", "Unmuted", "Bots", "Channels", "Groups", "Private", "Custom", "Setup", "Cat", "Crown", "Favorite", "Flower", "Game", "Home", "Love", "Mask", "Party", "Sport", "Study", "Trade", "Travel", "Work" IconName string `json:"icon_name"` } @@ -7410,8 +7888,8 @@ type Chat struct { LastMessage *Message `json:"last_message"` // Positions of the chat in chat lists Positions []*ChatPosition `json:"positions"` - // Default identifier of a user or chat that is chosen to send messages in the chat; may be null if the user can't change message sender - DefaultMessageSenderId MessageSender `json:"default_message_sender_id"` + // Identifier of a user or chat that is selected to send messages in the chat; may be null if the user can't change message sender + MessageSenderId MessageSender `json:"message_sender_id"` // True, if chat content can't be saved locally, forwarded, or copied HasProtectedContent bool `json:"has_protected_content"` // True, if the chat is marked as unread @@ -7436,10 +7914,14 @@ type Chat struct { LastReadOutboxMessageId int64 `json:"last_read_outbox_message_id"` // Number of unread messages with a mention/reply in the chat UnreadMentionCount int32 `json:"unread_mention_count"` - // Notification settings for this chat + // Number of messages with unread reactions in the chat + UnreadReactionCount int32 `json:"unread_reaction_count"` + // Notification settings for the chat NotificationSettings *ChatNotificationSettings `json:"notification_settings"` + // List of reactions, available in the chat + AvailableReactions []string `json:"available_reactions"` // Current message Time To Live setting (self-destruct timer) for the chat; 0 if not defined. TTL is counted from the time message or its content is viewed in secret chats and from the send date in other chats - MessageTtlSetting int32 `json:"message_ttl_setting"` + MessageTtl int32 `json:"message_ttl"` // If non-empty, name of a theme, set for the chat ThemeName string `json:"theme_name"` // Information about actions which must be possible to do through the chat action bar; may be null @@ -7481,7 +7963,7 @@ func (chat *Chat) UnmarshalJSON(data []byte) error { Permissions *ChatPermissions `json:"permissions"` LastMessage *Message `json:"last_message"` Positions []*ChatPosition `json:"positions"` - DefaultMessageSenderId json.RawMessage `json:"default_message_sender_id"` + MessageSenderId json.RawMessage `json:"message_sender_id"` HasProtectedContent bool `json:"has_protected_content"` IsMarkedAsUnread bool `json:"is_marked_as_unread"` IsBlocked bool `json:"is_blocked"` @@ -7494,8 +7976,10 @@ func (chat *Chat) UnmarshalJSON(data []byte) error { LastReadInboxMessageId int64 `json:"last_read_inbox_message_id"` LastReadOutboxMessageId int64 `json:"last_read_outbox_message_id"` UnreadMentionCount int32 `json:"unread_mention_count"` + UnreadReactionCount int32 `json:"unread_reaction_count"` NotificationSettings *ChatNotificationSettings `json:"notification_settings"` - MessageTtlSetting int32 `json:"message_ttl_setting"` + AvailableReactions []string `json:"available_reactions"` + MessageTtl int32 `json:"message_ttl"` ThemeName string `json:"theme_name"` ActionBar json.RawMessage `json:"action_bar"` VideoChat *VideoChat `json:"video_chat"` @@ -7528,8 +8012,10 @@ func (chat *Chat) UnmarshalJSON(data []byte) error { chat.LastReadInboxMessageId = tmp.LastReadInboxMessageId chat.LastReadOutboxMessageId = tmp.LastReadOutboxMessageId chat.UnreadMentionCount = tmp.UnreadMentionCount + chat.UnreadReactionCount = tmp.UnreadReactionCount chat.NotificationSettings = tmp.NotificationSettings - chat.MessageTtlSetting = tmp.MessageTtlSetting + chat.AvailableReactions = tmp.AvailableReactions + chat.MessageTtl = tmp.MessageTtl chat.ThemeName = tmp.ThemeName chat.VideoChat = tmp.VideoChat chat.PendingJoinRequests = tmp.PendingJoinRequests @@ -7540,8 +8026,8 @@ func (chat *Chat) UnmarshalJSON(data []byte) error { fieldType, _ := UnmarshalChatType(tmp.Type) chat.Type = fieldType - fieldDefaultMessageSenderId, _ := UnmarshalMessageSender(tmp.DefaultMessageSenderId) - chat.DefaultMessageSenderId = fieldDefaultMessageSenderId + fieldMessageSenderId, _ := UnmarshalMessageSender(tmp.MessageSenderId) + chat.MessageSenderId = fieldMessageSenderId fieldActionBar, _ := UnmarshalChatActionBar(tmp.ActionBar) chat.ActionBar = fieldActionBar @@ -7552,7 +8038,7 @@ func (chat *Chat) UnmarshalJSON(data []byte) error { // Represents a list of chats type Chats struct { meta - // Approximate total count of chats found + // Approximate total number of chats found TotalCount int32 `json:"total_count"` // List of chat identifiers ChatIds []int64 `json:"chat_ids"` @@ -7965,6 +8451,33 @@ func (*KeyboardButtonTypeRequestPoll) KeyboardButtonTypeType() string { return TypeKeyboardButtonTypeRequestPoll } +// A button that opens a web app by calling getWebAppUrl +type KeyboardButtonTypeWebApp struct { + meta + // An HTTP URL to pass to getWebAppUrl + Url string `json:"url"` +} + +func (entity *KeyboardButtonTypeWebApp) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub KeyboardButtonTypeWebApp + + return json.Marshal((*stub)(entity)) +} + +func (*KeyboardButtonTypeWebApp) GetClass() string { + return ClassKeyboardButtonType +} + +func (*KeyboardButtonTypeWebApp) GetType() string { + return TypeKeyboardButtonTypeWebApp +} + +func (*KeyboardButtonTypeWebApp) KeyboardButtonTypeType() string { + return TypeKeyboardButtonTypeWebApp +} + // Represents a single button in a bot keyboard type KeyboardButton struct { meta @@ -8036,10 +8549,10 @@ func (*InlineKeyboardButtonTypeUrl) InlineKeyboardButtonTypeType() string { return TypeInlineKeyboardButtonTypeUrl } -// A button that opens a specified URL and automatically authorize the current user if allowed to do so +// A button that opens a specified URL and automatically authorize the current user by calling getLoginUrlInfo type InlineKeyboardButtonTypeLoginUrl struct { meta - // An HTTP URL to open + // An HTTP URL to pass to getLoginUrlInfo Url string `json:"url"` // Unique button identifier Id int64 `json:"id"` @@ -8067,6 +8580,33 @@ func (*InlineKeyboardButtonTypeLoginUrl) InlineKeyboardButtonTypeType() string { return TypeInlineKeyboardButtonTypeLoginUrl } +// A button that opens a web app by calling openWebApp +type InlineKeyboardButtonTypeWebApp struct { + meta + // An HTTP URL to pass to openWebApp + Url string `json:"url"` +} + +func (entity *InlineKeyboardButtonTypeWebApp) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub InlineKeyboardButtonTypeWebApp + + return json.Marshal((*stub)(entity)) +} + +func (*InlineKeyboardButtonTypeWebApp) GetClass() string { + return ClassInlineKeyboardButtonType +} + +func (*InlineKeyboardButtonTypeWebApp) GetType() string { + return TypeInlineKeyboardButtonTypeWebApp +} + +func (*InlineKeyboardButtonTypeWebApp) InlineKeyboardButtonTypeType() string { + return TypeInlineKeyboardButtonTypeWebApp +} + // A button that sends a callback query to a bot type InlineKeyboardButtonTypeCallback struct { meta @@ -8200,7 +8740,7 @@ func (*InlineKeyboardButtonTypeBuy) InlineKeyboardButtonTypeType() string { return TypeInlineKeyboardButtonTypeBuy } -// A button to open a chat with a user +// A button with a user reference to be handled in the same way as textEntityTypeMentionName entities type InlineKeyboardButtonTypeUser struct { meta // User identifier @@ -8451,6 +8991,31 @@ func (*LoginUrlInfoRequestConfirmation) LoginUrlInfoType() string { return TypeLoginUrlInfoRequestConfirmation } +// Contains information about a web app +type WebAppInfo struct { + meta + // Unique identifier for the web app launch + LaunchId JsonInt64 `json:"launch_id"` + // A web app URL to open in a web view + Url string `json:"url"` +} + +func (entity *WebAppInfo) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub WebAppInfo + + return json.Marshal((*stub)(entity)) +} + +func (*WebAppInfo) GetClass() string { + return ClassWebAppInfo +} + +func (*WebAppInfo) GetType() string { + return TypeWebAppInfo +} + // Contains information about a message thread type MessageThreadInfo struct { meta @@ -10522,7 +11087,7 @@ type PageBlockChatLink struct { Title string `json:"title"` // Chat photo; may be null Photo *ChatPhotoInfo `json:"photo"` - // Chat username, by which all other information about the chat can be resolved + // Chat username by which all other information about the chat can be resolved Username string `json:"username"` } @@ -10746,7 +11311,7 @@ type WebPageInstantView struct { PageBlocks []PageBlock `json:"page_blocks"` // Number of the instant view views; 0 if unknown ViewCount int32 `json:"view_count"` - // Version of the instant view, currently can be 1 or 2 + // Version of the instant view; currently, can be 1 or 2 Version int32 `json:"version"` // True, if the instant view must be shown from right to left IsRtl bool `json:"is_rtl"` @@ -10834,7 +11399,7 @@ type WebPage struct { Animation *Animation `json:"animation"` // Preview of the content as an audio file, if available; may be null Audio *Audio `json:"audio"` - // Preview of the content as a document, if available (currently only available for small PDF files and ZIP archives); may be null + // Preview of the content as a document, if available; may be null Document *Document `json:"document"` // Preview of the content as a sticker for small WEBP files, if available; may be null Sticker *Sticker `json:"sticker"` @@ -10844,7 +11409,7 @@ type WebPage struct { VideoNote *VideoNote `json:"video_note"` // Preview of the content as a voice note, if available; may be null VoiceNote *VoiceNote `json:"voice_note"` - // Version of instant view, available for the web page (currently can be 1 or 2), 0 if none + // Version of instant view, available for the web page (currently, can be 1 or 2), 0 if none InstantViewVersion int32 `json:"instant_view_version"` } @@ -11028,6 +11593,39 @@ func (*Address) GetType() string { return TypeAddress } +// Contains parameters of the app theme +type ThemeParameters struct { + meta + // A color of the background in the RGB24 format + BackgroundColor int32 `json:"background_color"` + // A color of text in the RGB24 format + TextColor int32 `json:"text_color"` + // A color of hints in the RGB24 format + HintColor int32 `json:"hint_color"` + // A color of links in the RGB24 format + LinkColor int32 `json:"link_color"` + // A color of the buttons in the RGB24 format + ButtonColor int32 `json:"button_color"` + // A color of text on the buttons in the RGB24 format + ButtonTextColor int32 `json:"button_text_color"` +} + +func (entity *ThemeParameters) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ThemeParameters + + return json.Marshal((*stub)(entity)) +} + +func (*ThemeParameters) GetClass() string { + return ClassThemeParameters +} + +func (*ThemeParameters) GetType() string { + return TypeThemeParameters +} + // Portion of the price of a product (e.g., "delivery cost", "tax amount") type LabeledPricePart struct { meta @@ -11318,39 +11916,6 @@ func (*PaymentsProviderStripe) GetType() string { return TypePaymentsProviderStripe } -// Theme colors for a payment form -type PaymentFormTheme struct { - meta - // A color of the payment form background in the RGB24 format - BackgroundColor int32 `json:"background_color"` - // A color of text in the RGB24 format - TextColor int32 `json:"text_color"` - // A color of hints in the RGB24 format - HintColor int32 `json:"hint_color"` - // A color of links in the RGB24 format - LinkColor int32 `json:"link_color"` - // A color of the buttons in the RGB24 format - ButtonColor int32 `json:"button_color"` - // A color of text on the buttons in the RGB24 format - ButtonTextColor int32 `json:"button_text_color"` -} - -func (entity *PaymentFormTheme) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub PaymentFormTheme - - return json.Marshal((*stub)(entity)) -} - -func (*PaymentFormTheme) GetClass() string { - return ClassPaymentFormTheme -} - -func (*PaymentFormTheme) GetType() string { - return TypePaymentFormTheme -} - // Contains information about an invoice payment form type PaymentForm struct { meta @@ -14556,7 +15121,7 @@ func (*MessageChatAddMembers) MessageContentType() string { return TypeMessageChatAddMembers } -// A new member joined the chat by invite link +// A new member joined the chat via an invite link type MessageChatJoinByLink struct { meta } @@ -14771,7 +15336,7 @@ func (*MessageChatSetTheme) MessageContentType() string { // The TTL (Time To Live) setting for messages in the chat has been changed type MessageChatSetTtl struct { meta - // New message TTL setting + // New message TTL Ttl int32 `json:"ttl"` } @@ -14977,7 +15542,63 @@ func (*MessageWebsiteConnected) MessageContentType() string { return TypeMessageWebsiteConnected } -// Telegram Passport data has been sent +// Data from a web app has been sent to a bot +type MessageWebAppDataSent struct { + meta + // Text of the keyboardButtonTypeWebApp button, which opened the web app + ButtonText string `json:"button_text"` +} + +func (entity *MessageWebAppDataSent) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub MessageWebAppDataSent + + return json.Marshal((*stub)(entity)) +} + +func (*MessageWebAppDataSent) GetClass() string { + return ClassMessageContent +} + +func (*MessageWebAppDataSent) GetType() string { + return TypeMessageWebAppDataSent +} + +func (*MessageWebAppDataSent) MessageContentType() string { + return TypeMessageWebAppDataSent +} + +// Data from a web app has been received; for bots only +type MessageWebAppDataReceived struct { + meta + // Text of the keyboardButtonTypeWebApp button, which opened the web app + ButtonText string `json:"button_text"` + // Received data + Data string `json:"data"` +} + +func (entity *MessageWebAppDataReceived) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub MessageWebAppDataReceived + + return json.Marshal((*stub)(entity)) +} + +func (*MessageWebAppDataReceived) GetClass() string { + return ClassMessageContent +} + +func (*MessageWebAppDataReceived) GetType() string { + return TypeMessageWebAppDataReceived +} + +func (*MessageWebAppDataReceived) MessageContentType() string { + return TypeMessageWebAppDataReceived +} + +// Telegram Passport data has been sent to a bot type MessagePassportDataSent struct { meta // List of Telegram Passport element types sent @@ -15428,6 +16049,31 @@ func (*TextEntityTypeStrikethrough) TextEntityTypeType() string { return TypeTextEntityTypeStrikethrough } +// A spoiler text. Not supported in secret chats +type TextEntityTypeSpoiler struct { + meta +} + +func (entity *TextEntityTypeSpoiler) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub TextEntityTypeSpoiler + + return json.Marshal((*stub)(entity)) +} + +func (*TextEntityTypeSpoiler) GetClass() string { + return ClassTextEntityType +} + +func (*TextEntityTypeSpoiler) GetType() string { + return TypeTextEntityTypeSpoiler +} + +func (*TextEntityTypeSpoiler) TextEntityTypeType() string { + return TypeTextEntityTypeSpoiler +} + // Text that must be formatted as if inside a code HTML tag type TextEntityTypeCode struct { meta @@ -15693,6 +16339,8 @@ type MessageSendOptions struct { DisableNotification bool `json:"disable_notification"` // Pass true if the message is sent from the background FromBackground bool `json:"from_background"` + // Pass true if the content of the message must be protected from forwarding and saving; for bots only + ProtectContent bool `json:"protect_content"` // Message scheduling state; pass null to send message immediately. Messages sent to a secret chat, live location messages and self-destructing messages can't be scheduled SchedulingState MessageSchedulingState `json:"scheduling_state"` } @@ -15717,6 +16365,7 @@ func (messageSendOptions *MessageSendOptions) UnmarshalJSON(data []byte) error { var tmp struct { DisableNotification bool `json:"disable_notification"` FromBackground bool `json:"from_background"` + ProtectContent bool `json:"protect_content"` SchedulingState json.RawMessage `json:"scheduling_state"` } @@ -15727,6 +16376,7 @@ func (messageSendOptions *MessageSendOptions) UnmarshalJSON(data []byte) error { messageSendOptions.DisableNotification = tmp.DisableNotification messageSendOptions.FromBackground = tmp.FromBackground + messageSendOptions.ProtectContent = tmp.ProtectContent fieldSchedulingState, _ := UnmarshalMessageSchedulingState(tmp.SchedulingState) messageSendOptions.SchedulingState = fieldSchedulingState @@ -15764,7 +16414,7 @@ func (*MessageCopyOptions) GetType() string { // A text message type InputMessageText struct { meta - // Formatted text to be sent; 1-GetOption("message_text_length_max") characters. Only Bold, Italic, Underline, Strikethrough, Code, Pre, PreCode, TextUrl and MentionName entities are allowed to be specified manually + // Formatted text to be sent; 1-GetOption("message_text_length_max") characters. Only Bold, Italic, Underline, Strikethrough, Spoiler, Code, Pre, PreCode, TextUrl and MentionName entities are allowed to be specified manually Text *FormattedText `json:"text"` // True, if rich web page previews for URLs in the message text must be disabled DisableWebPagePreview bool `json:"disable_web_page_preview"` @@ -16565,7 +17215,7 @@ type InputMessageForwarded struct { MessageId int64 `json:"message_id"` // True, if a game message is being shared from a launched game; applies only to game messages InGameShare bool `json:"in_game_share"` - // Options to be used to copy content of the message without reference to the original sender; pass null to try to forward the message as usual + // Options to be used to copy content of the message without reference to the original sender; pass null to forward the message as usual CopyOptions *MessageCopyOptions `json:"copy_options"` } @@ -16839,56 +17489,6 @@ func (*SearchMessagesFilterChatPhoto) SearchMessagesFilterType() string { return TypeSearchMessagesFilterChatPhoto } -// Returns only call messages -type SearchMessagesFilterCall struct { - meta -} - -func (entity *SearchMessagesFilterCall) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub SearchMessagesFilterCall - - return json.Marshal((*stub)(entity)) -} - -func (*SearchMessagesFilterCall) GetClass() string { - return ClassSearchMessagesFilter -} - -func (*SearchMessagesFilterCall) GetType() string { - return TypeSearchMessagesFilterCall -} - -func (*SearchMessagesFilterCall) SearchMessagesFilterType() string { - return TypeSearchMessagesFilterCall -} - -// Returns only incoming call messages with missed/declined discard reasons -type SearchMessagesFilterMissedCall struct { - meta -} - -func (entity *SearchMessagesFilterMissedCall) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub SearchMessagesFilterMissedCall - - return json.Marshal((*stub)(entity)) -} - -func (*SearchMessagesFilterMissedCall) GetClass() string { - return ClassSearchMessagesFilter -} - -func (*SearchMessagesFilterMissedCall) GetType() string { - return TypeSearchMessagesFilterMissedCall -} - -func (*SearchMessagesFilterMissedCall) SearchMessagesFilterType() string { - return TypeSearchMessagesFilterMissedCall -} - // Returns only video note messages type SearchMessagesFilterVideoNote struct { meta @@ -16989,6 +17589,31 @@ func (*SearchMessagesFilterUnreadMention) SearchMessagesFilterType() string { return TypeSearchMessagesFilterUnreadMention } +// Returns only messages with unread reactions for the current user. When using this filter the results can't be additionally filtered by a query, a message thread or by the sending user +type SearchMessagesFilterUnreadReaction struct { + meta +} + +func (entity *SearchMessagesFilterUnreadReaction) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub SearchMessagesFilterUnreadReaction + + return json.Marshal((*stub)(entity)) +} + +func (*SearchMessagesFilterUnreadReaction) GetClass() string { + return ClassSearchMessagesFilter +} + +func (*SearchMessagesFilterUnreadReaction) GetType() string { + return TypeSearchMessagesFilterUnreadReaction +} + +func (*SearchMessagesFilterUnreadReaction) SearchMessagesFilterType() string { + return TypeSearchMessagesFilterUnreadReaction +} + // Returns only failed to send messages. This filter can be used only if the message database is used type SearchMessagesFilterFailedToSend struct { meta @@ -17635,7 +18260,7 @@ type StickerSet struct { Title string `json:"title"` // Name of the sticker set Name string `json:"name"` - // Sticker set thumbnail in WEBP or TGS format with width and height 100; may be null. The file can be downloaded only before the thumbnail is changed + // Sticker set thumbnail in WEBP, TGS, or WEBM format with width and height 100; may be null. The file can be downloaded only before the thumbnail is changed Thumbnail *Thumbnail `json:"thumbnail"` // Sticker set thumbnail's outline represented as a list of closed vector paths; may be empty. The coordinate system origin is in the upper-left corner ThumbnailOutline []*ClosedVectorPath `json:"thumbnail_outline"` @@ -17645,10 +18270,8 @@ type StickerSet struct { IsArchived bool `json:"is_archived"` // True, if the sticker set is official IsOfficial bool `json:"is_official"` - // True, is the stickers in the set are animated - IsAnimated bool `json:"is_animated"` - // True, if the stickers in the set are masks - IsMasks bool `json:"is_masks"` + // Type of the stickers in the set + StickerType StickerType `json:"sticker_type"` // True for already viewed trending sticker sets IsViewed bool `json:"is_viewed"` // List of stickers in this set @@ -17673,6 +18296,45 @@ func (*StickerSet) GetType() string { return TypeStickerSet } +func (stickerSet *StickerSet) UnmarshalJSON(data []byte) error { + var tmp struct { + Id JsonInt64 `json:"id"` + Title string `json:"title"` + Name string `json:"name"` + Thumbnail *Thumbnail `json:"thumbnail"` + ThumbnailOutline []*ClosedVectorPath `json:"thumbnail_outline"` + IsInstalled bool `json:"is_installed"` + IsArchived bool `json:"is_archived"` + IsOfficial bool `json:"is_official"` + StickerType json.RawMessage `json:"sticker_type"` + IsViewed bool `json:"is_viewed"` + Stickers []*Sticker `json:"stickers"` + Emojis []*Emojis `json:"emojis"` + } + + err := json.Unmarshal(data, &tmp) + if err != nil { + return err + } + + stickerSet.Id = tmp.Id + stickerSet.Title = tmp.Title + stickerSet.Name = tmp.Name + stickerSet.Thumbnail = tmp.Thumbnail + stickerSet.ThumbnailOutline = tmp.ThumbnailOutline + stickerSet.IsInstalled = tmp.IsInstalled + stickerSet.IsArchived = tmp.IsArchived + stickerSet.IsOfficial = tmp.IsOfficial + stickerSet.IsViewed = tmp.IsViewed + stickerSet.Stickers = tmp.Stickers + stickerSet.Emojis = tmp.Emojis + + fieldStickerType, _ := UnmarshalStickerType(tmp.StickerType) + stickerSet.StickerType = fieldStickerType + + return nil +} + // Represents short information about a sticker set type StickerSetInfo struct { meta @@ -17682,7 +18344,7 @@ type StickerSetInfo struct { Title string `json:"title"` // Name of the sticker set Name string `json:"name"` - // Sticker set thumbnail in WEBP or TGS format with width and height 100; may be null + // Sticker set thumbnail in WEBP, TGS, or WEBM format with width and height 100; may be null Thumbnail *Thumbnail `json:"thumbnail"` // Sticker set thumbnail's outline represented as a list of closed vector paths; may be empty. The coordinate system origin is in the upper-left corner ThumbnailOutline []*ClosedVectorPath `json:"thumbnail_outline"` @@ -17692,10 +18354,8 @@ type StickerSetInfo struct { IsArchived bool `json:"is_archived"` // True, if the sticker set is official IsOfficial bool `json:"is_official"` - // True, is the stickers in the set are animated - IsAnimated bool `json:"is_animated"` - // True, if the stickers in the set are masks - IsMasks bool `json:"is_masks"` + // Type of the stickers in the set + StickerType StickerType `json:"sticker_type"` // True for already viewed trending sticker sets IsViewed bool `json:"is_viewed"` // Total number of stickers in the set @@ -17720,6 +18380,45 @@ func (*StickerSetInfo) GetType() string { return TypeStickerSetInfo } +func (stickerSetInfo *StickerSetInfo) UnmarshalJSON(data []byte) error { + var tmp struct { + Id JsonInt64 `json:"id"` + Title string `json:"title"` + Name string `json:"name"` + Thumbnail *Thumbnail `json:"thumbnail"` + ThumbnailOutline []*ClosedVectorPath `json:"thumbnail_outline"` + IsInstalled bool `json:"is_installed"` + IsArchived bool `json:"is_archived"` + IsOfficial bool `json:"is_official"` + StickerType json.RawMessage `json:"sticker_type"` + IsViewed bool `json:"is_viewed"` + Size int32 `json:"size"` + Covers []*Sticker `json:"covers"` + } + + err := json.Unmarshal(data, &tmp) + if err != nil { + return err + } + + stickerSetInfo.Id = tmp.Id + stickerSetInfo.Title = tmp.Title + stickerSetInfo.Name = tmp.Name + stickerSetInfo.Thumbnail = tmp.Thumbnail + stickerSetInfo.ThumbnailOutline = tmp.ThumbnailOutline + stickerSetInfo.IsInstalled = tmp.IsInstalled + stickerSetInfo.IsArchived = tmp.IsArchived + stickerSetInfo.IsOfficial = tmp.IsOfficial + stickerSetInfo.IsViewed = tmp.IsViewed + stickerSetInfo.Size = tmp.Size + stickerSetInfo.Covers = tmp.Covers + + fieldStickerType, _ := UnmarshalStickerType(tmp.StickerType) + stickerSetInfo.StickerType = fieldStickerType + + return nil +} + // Represents a list of sticker sets type StickerSets struct { meta @@ -18333,6 +19032,81 @@ func (*GroupCallVideoQualityFull) GroupCallVideoQualityType() string { return TypeGroupCallVideoQualityFull } +// Describes an available stream in a group call +type GroupCallStream struct { + meta + // Identifier of an audio/video channel + ChannelId int32 `json:"channel_id"` + // Scale of segment durations in the stream. The duration is 1000/(2**scale) milliseconds + Scale int32 `json:"scale"` + // Point in time when the stream currently ends; Unix timestamp in milliseconds + TimeOffset int64 `json:"time_offset"` +} + +func (entity *GroupCallStream) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub GroupCallStream + + return json.Marshal((*stub)(entity)) +} + +func (*GroupCallStream) GetClass() string { + return ClassGroupCallStream +} + +func (*GroupCallStream) GetType() string { + return TypeGroupCallStream +} + +// Represents a list of group call streams +type GroupCallStreams struct { + meta + // A list of group call streams + Streams []*GroupCallStream `json:"streams"` +} + +func (entity *GroupCallStreams) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub GroupCallStreams + + return json.Marshal((*stub)(entity)) +} + +func (*GroupCallStreams) GetClass() string { + return ClassGroupCallStreams +} + +func (*GroupCallStreams) GetType() string { + return TypeGroupCallStreams +} + +// Represents an RTMP url +type RtmpUrl struct { + meta + // The URL + Url string `json:"url"` + // Stream key + StreamKey string `json:"stream_key"` +} + +func (entity *RtmpUrl) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub RtmpUrl + + return json.Marshal((*stub)(entity)) +} + +func (*RtmpUrl) GetClass() string { + return ClassRtmpUrl +} + +func (*RtmpUrl) GetType() string { + return TypeRtmpUrl +} + // Describes a recently speaking participant in a group call type GroupCallRecentSpeaker struct { meta @@ -18390,6 +19164,8 @@ type GroupCall struct { EnabledStartNotification bool `json:"enabled_start_notification"` // True, if the call is active IsActive bool `json:"is_active"` + // True, if the chat is an RTMP stream instead of an ordinary video chat + IsRtmpStream bool `json:"is_rtmp_stream"` // True, if the call is joined IsJoined bool `json:"is_joined"` // True, if user was kicked from the call because of network loss and the call needs to be rejoined @@ -18398,9 +19174,11 @@ type GroupCall struct { CanBeManaged bool `json:"can_be_managed"` // Number of participants in the group call ParticipantCount int32 `json:"participant_count"` + // True, if group call participants, which are muted, aren't returned in participant list + HasHiddenListeners bool `json:"has_hidden_listeners"` // True, if all group call participants are loaded LoadedAllParticipants bool `json:"loaded_all_participants"` - // Recently speaking users in the group call + // At most 3 recently speaking users in the group call RecentSpeakers []*GroupCallRecentSpeaker `json:"recent_speakers"` // True, if the current user's video is enabled IsMyVideoEnabled bool `json:"is_my_video_enabled"` @@ -18888,7 +19666,7 @@ type PhoneNumberAuthenticationSettings struct { IsCurrentPhoneNumber bool `json:"is_current_phone_number"` // For official applications only. True, if the application can use Android SMS Retriever API (requires Google Play Services >= 10.2) to automatically receive the authentication code from the SMS. See https://developers.google.com/identity/sms-retriever/ for more details AllowSmsRetrieverApi bool `json:"allow_sms_retriever_api"` - // List of authentication tokens, received in updateOption("authentication_token") in previously logged out sessions + // List of up to 20 authentication tokens, recently received in updateOption("authentication_token") in previously logged out sessions AuthenticationTokens []string `json:"authentication_tokens"` } @@ -18908,6 +19686,141 @@ func (*PhoneNumberAuthenticationSettings) GetType() string { return TypePhoneNumberAuthenticationSettings } +// Represents a reaction applied to a message +type AddedReaction struct { + meta + // Text representation of the reaction + Reaction string `json:"reaction"` + // Identifier of the chat member, applied the reaction + SenderId MessageSender `json:"sender_id"` +} + +func (entity *AddedReaction) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub AddedReaction + + return json.Marshal((*stub)(entity)) +} + +func (*AddedReaction) GetClass() string { + return ClassAddedReaction +} + +func (*AddedReaction) GetType() string { + return TypeAddedReaction +} + +func (addedReaction *AddedReaction) UnmarshalJSON(data []byte) error { + var tmp struct { + Reaction string `json:"reaction"` + SenderId json.RawMessage `json:"sender_id"` + } + + err := json.Unmarshal(data, &tmp) + if err != nil { + return err + } + + addedReaction.Reaction = tmp.Reaction + + fieldSenderId, _ := UnmarshalMessageSender(tmp.SenderId) + addedReaction.SenderId = fieldSenderId + + return nil +} + +// Represents a list of reactions added to a message +type AddedReactions struct { + meta + // The total number of found reactions + TotalCount int32 `json:"total_count"` + // The list of added reactions + Reactions []*AddedReaction `json:"reactions"` + // The offset for the next request. If empty, there are no more results + NextOffset string `json:"next_offset"` +} + +func (entity *AddedReactions) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub AddedReactions + + return json.Marshal((*stub)(entity)) +} + +func (*AddedReactions) GetClass() string { + return ClassAddedReactions +} + +func (*AddedReactions) GetType() string { + return TypeAddedReactions +} + +// Represents a list of available reactions +type AvailableReactions struct { + meta + // List of reactions + Reactions []string `json:"reactions"` +} + +func (entity *AvailableReactions) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub AvailableReactions + + return json.Marshal((*stub)(entity)) +} + +func (*AvailableReactions) GetClass() string { + return ClassAvailableReactions +} + +func (*AvailableReactions) GetType() string { + return TypeAvailableReactions +} + +// Contains stickers which must be used for reaction animation rendering +type Reaction struct { + meta + // Text representation of the reaction + Reaction string `json:"reaction"` + // Reaction title + Title string `json:"title"` + // True, if the reaction can be added to new messages and enabled in chats + IsActive bool `json:"is_active"` + // Static icon for the reaction + StaticIcon *Sticker `json:"static_icon"` + // Appear animation for the reaction + AppearAnimation *Sticker `json:"appear_animation"` + // Select animation for the reaction + SelectAnimation *Sticker `json:"select_animation"` + // Activate animation for the reaction + ActivateAnimation *Sticker `json:"activate_animation"` + // Effect animation for the reaction + EffectAnimation *Sticker `json:"effect_animation"` + // Around animation for the reaction; may be null + AroundAnimation *Sticker `json:"around_animation"` + // Center animation for the reaction; may be null + CenterAnimation *Sticker `json:"center_animation"` +} + +func (entity *Reaction) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub Reaction + + return json.Marshal((*stub)(entity)) +} + +func (*Reaction) GetClass() string { + return ClassReaction +} + +func (*Reaction) GetType() string { + return TypeReaction +} + // Represents a list of animations type Animations struct { meta @@ -19018,6 +19931,93 @@ func (*ImportedContacts) GetType() string { return TypeImportedContacts } +// Describes a color to highlight a bot added to attachment menu +type AttachmentMenuBotColor struct { + meta + // Color in the RGB24 format for light themes + LightColor int32 `json:"light_color"` + // Color in the RGB24 format for dark themes + DarkColor int32 `json:"dark_color"` +} + +func (entity *AttachmentMenuBotColor) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub AttachmentMenuBotColor + + return json.Marshal((*stub)(entity)) +} + +func (*AttachmentMenuBotColor) GetClass() string { + return ClassAttachmentMenuBotColor +} + +func (*AttachmentMenuBotColor) GetType() string { + return TypeAttachmentMenuBotColor +} + +// Represents a bot added to attachment menu +type AttachmentMenuBot struct { + meta + // User identifier of the bot added to attachment menu + BotUserId int64 `json:"bot_user_id"` + // Name for the bot in attachment menu + Name string `json:"name"` + // Color to highlight selected name of the bot if appropriate; may be null + NameColor *AttachmentMenuBotColor `json:"name_color"` + // Default attachment menu icon for the bot in SVG format; may be null + DefaultIcon *File `json:"default_icon"` + // Attachment menu icon for the bot in SVG format for the official iOS app; may be null + IosStaticIcon *File `json:"ios_static_icon"` + // Attachment menu icon for the bot in TGS format for the official iOS app; may be null + IosAnimatedIcon *File `json:"ios_animated_icon"` + // Attachment menu icon for the bot in TGS format for the official Android app; may be null + AndroidIcon *File `json:"android_icon"` + // Attachment menu icon for the bot in TGS format for the official native macOS app; may be null + MacosIcon *File `json:"macos_icon"` + // Color to highlight selected icon of the bot if appropriate; may be null + IconColor *AttachmentMenuBotColor `json:"icon_color"` +} + +func (entity *AttachmentMenuBot) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub AttachmentMenuBot + + return json.Marshal((*stub)(entity)) +} + +func (*AttachmentMenuBot) GetClass() string { + return ClassAttachmentMenuBot +} + +func (*AttachmentMenuBot) GetType() string { + return TypeAttachmentMenuBot +} + +// Information about the message sent by answerWebAppQuery +type SentWebAppMessage struct { + meta + // Identifier of the sent inline message, if known + InlineMessageId string `json:"inline_message_id"` +} + +func (entity *SentWebAppMessage) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub SentWebAppMessage + + return json.Marshal((*stub)(entity)) +} + +func (*SentWebAppMessage) GetClass() string { + return ClassSentWebAppMessage +} + +func (*SentWebAppMessage) GetType() string { + return TypeSentWebAppMessage +} + // Contains an HTTP URL type HttpUrl struct { meta @@ -19639,14 +20639,14 @@ func (inputInlineQueryResultPhoto *InputInlineQueryResultPhoto) UnmarshalJSON(da return nil } -// Represents a link to a WEBP or TGS sticker +// Represents a link to a WEBP, TGS, or WEBM sticker type InputInlineQueryResultSticker struct { meta // Unique identifier of the query result Id string `json:"id"` // URL of the sticker thumbnail, if it exists ThumbnailUrl string `json:"thumbnail_url"` - // The URL of the WEBP or TGS sticker (sticker file size must not exceed 5MB) + // The URL of the WEBP, TGS, or WEBM sticker (sticker file size must not exceed 5MB) StickerUrl string `json:"sticker_url"` // Width of the sticker StickerWidth int32 `json:"sticker_width"` @@ -20606,33 +21606,6 @@ func (*ChatEventMessageDeleted) ChatEventActionType() string { return TypeChatEventMessageDeleted } -// A poll in a message was stopped -type ChatEventPollStopped struct { - meta - // The message with the poll - Message *Message `json:"message"` -} - -func (entity *ChatEventPollStopped) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventPollStopped - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventPollStopped) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventPollStopped) GetType() string { - return TypeChatEventPollStopped -} - -func (*ChatEventPollStopped) ChatEventActionType() string { - return TypeChatEventPollStopped -} - // A message was pinned type ChatEventMessagePinned struct { meta @@ -20687,6 +21660,33 @@ func (*ChatEventMessageUnpinned) ChatEventActionType() string { return TypeChatEventMessageUnpinned } +// A poll in a message was stopped +type ChatEventPollStopped struct { + meta + // The message with the poll + Message *Message `json:"message"` +} + +func (entity *ChatEventPollStopped) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventPollStopped + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventPollStopped) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventPollStopped) GetType() string { + return TypeChatEventPollStopped +} + +func (*ChatEventPollStopped) ChatEventActionType() string { + return TypeChatEventPollStopped +} + // A new member joined the chat type ChatEventMemberJoined struct { meta @@ -20712,7 +21712,7 @@ func (*ChatEventMemberJoined) ChatEventActionType() string { return TypeChatEventMemberJoined } -// A new member joined the chat by an invite link +// A new member joined the chat via an invite link type ChatEventMemberJoinedByInviteLink struct { meta // Invite link used to join the chat @@ -20768,31 +21768,6 @@ func (*ChatEventMemberJoinedByRequest) ChatEventActionType() string { return TypeChatEventMemberJoinedByRequest } -// A member left the chat -type ChatEventMemberLeft struct { - meta -} - -func (entity *ChatEventMemberLeft) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventMemberLeft - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventMemberLeft) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventMemberLeft) GetType() string { - return TypeChatEventMemberLeft -} - -func (*ChatEventMemberLeft) ChatEventActionType() string { - return TypeChatEventMemberLeft -} - // A new chat member was invited type ChatEventMemberInvited struct { meta @@ -20841,6 +21816,31 @@ func (chatEventMemberInvited *ChatEventMemberInvited) UnmarshalJSON(data []byte) return nil } +// A member left the chat +type ChatEventMemberLeft struct { + meta +} + +func (entity *ChatEventMemberLeft) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventMemberLeft + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventMemberLeft) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventMemberLeft) GetType() string { + return TypeChatEventMemberLeft +} + +func (*ChatEventMemberLeft) ChatEventActionType() string { + return TypeChatEventMemberLeft +} + // A chat member has gained/lost administrator status, or the list of their administrator privileges has changed type ChatEventMemberPromoted struct { meta @@ -20950,62 +21950,33 @@ func (chatEventMemberRestricted *ChatEventMemberRestricted) UnmarshalJSON(data [ return nil } -// The chat title was changed -type ChatEventTitleChanged struct { +// The chat available reactions were changed +type ChatEventAvailableReactionsChanged struct { meta - // Previous chat title - OldTitle string `json:"old_title"` - // New chat title - NewTitle string `json:"new_title"` + // Previous chat available reactions + OldAvailableReactions []string `json:"old_available_reactions"` + // New chat available reactions + NewAvailableReactions []string `json:"new_available_reactions"` } -func (entity *ChatEventTitleChanged) MarshalJSON() ([]byte, error) { +func (entity *ChatEventAvailableReactionsChanged) MarshalJSON() ([]byte, error) { entity.meta.Type = entity.GetType() - type stub ChatEventTitleChanged + type stub ChatEventAvailableReactionsChanged return json.Marshal((*stub)(entity)) } -func (*ChatEventTitleChanged) GetClass() string { +func (*ChatEventAvailableReactionsChanged) GetClass() string { return ClassChatEventAction } -func (*ChatEventTitleChanged) GetType() string { - return TypeChatEventTitleChanged +func (*ChatEventAvailableReactionsChanged) GetType() string { + return TypeChatEventAvailableReactionsChanged } -func (*ChatEventTitleChanged) ChatEventActionType() string { - return TypeChatEventTitleChanged -} - -// The chat permissions was changed -type ChatEventPermissionsChanged struct { - meta - // Previous chat permissions - OldPermissions *ChatPermissions `json:"old_permissions"` - // New chat permissions - NewPermissions *ChatPermissions `json:"new_permissions"` -} - -func (entity *ChatEventPermissionsChanged) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventPermissionsChanged - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventPermissionsChanged) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventPermissionsChanged) GetType() string { - return TypeChatEventPermissionsChanged -} - -func (*ChatEventPermissionsChanged) ChatEventActionType() string { - return TypeChatEventPermissionsChanged +func (*ChatEventAvailableReactionsChanged) ChatEventActionType() string { + return TypeChatEventAvailableReactionsChanged } // The chat description was changed @@ -21037,91 +22008,6 @@ func (*ChatEventDescriptionChanged) ChatEventActionType() string { return TypeChatEventDescriptionChanged } -// The chat username was changed -type ChatEventUsernameChanged struct { - meta - // Previous chat username - OldUsername string `json:"old_username"` - // New chat username - NewUsername string `json:"new_username"` -} - -func (entity *ChatEventUsernameChanged) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventUsernameChanged - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventUsernameChanged) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventUsernameChanged) GetType() string { - return TypeChatEventUsernameChanged -} - -func (*ChatEventUsernameChanged) ChatEventActionType() string { - return TypeChatEventUsernameChanged -} - -// The chat photo was changed -type ChatEventPhotoChanged struct { - meta - // Previous chat photo value; may be null - OldPhoto *ChatPhoto `json:"old_photo"` - // New chat photo value; may be null - NewPhoto *ChatPhoto `json:"new_photo"` -} - -func (entity *ChatEventPhotoChanged) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventPhotoChanged - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventPhotoChanged) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventPhotoChanged) GetType() string { - return TypeChatEventPhotoChanged -} - -func (*ChatEventPhotoChanged) ChatEventActionType() string { - return TypeChatEventPhotoChanged -} - -// The can_invite_users permission of a supergroup chat was toggled -type ChatEventInvitesToggled struct { - meta - // New value of can_invite_users permission - CanInviteUsers bool `json:"can_invite_users"` -} - -func (entity *ChatEventInvitesToggled) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventInvitesToggled - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventInvitesToggled) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventInvitesToggled) GetType() string { - return TypeChatEventInvitesToggled -} - -func (*ChatEventInvitesToggled) ChatEventActionType() string { - return TypeChatEventInvitesToggled -} - // The linked chat of a supergroup was changed type ChatEventLinkedChatChanged struct { meta @@ -21151,147 +22037,6 @@ func (*ChatEventLinkedChatChanged) ChatEventActionType() string { return TypeChatEventLinkedChatChanged } -// The slow_mode_delay setting of a supergroup was changed -type ChatEventSlowModeDelayChanged struct { - meta - // Previous value of slow_mode_delay, in seconds - OldSlowModeDelay int32 `json:"old_slow_mode_delay"` - // New value of slow_mode_delay, in seconds - NewSlowModeDelay int32 `json:"new_slow_mode_delay"` -} - -func (entity *ChatEventSlowModeDelayChanged) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventSlowModeDelayChanged - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventSlowModeDelayChanged) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventSlowModeDelayChanged) GetType() string { - return TypeChatEventSlowModeDelayChanged -} - -func (*ChatEventSlowModeDelayChanged) ChatEventActionType() string { - return TypeChatEventSlowModeDelayChanged -} - -// The message TTL setting was changed -type ChatEventMessageTtlSettingChanged struct { - meta - // Previous value of message_ttl_setting - OldMessageTtlSetting int32 `json:"old_message_ttl_setting"` - // New value of message_ttl_setting - NewMessageTtlSetting int32 `json:"new_message_ttl_setting"` -} - -func (entity *ChatEventMessageTtlSettingChanged) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventMessageTtlSettingChanged - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventMessageTtlSettingChanged) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventMessageTtlSettingChanged) GetType() string { - return TypeChatEventMessageTtlSettingChanged -} - -func (*ChatEventMessageTtlSettingChanged) ChatEventActionType() string { - return TypeChatEventMessageTtlSettingChanged -} - -// The sign_messages setting of a channel was toggled -type ChatEventSignMessagesToggled struct { - meta - // New value of sign_messages - SignMessages bool `json:"sign_messages"` -} - -func (entity *ChatEventSignMessagesToggled) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventSignMessagesToggled - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventSignMessagesToggled) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventSignMessagesToggled) GetType() string { - return TypeChatEventSignMessagesToggled -} - -func (*ChatEventSignMessagesToggled) ChatEventActionType() string { - return TypeChatEventSignMessagesToggled -} - -// The has_protected_content setting of a channel was toggled -type ChatEventHasProtectedContentToggled struct { - meta - // New value of has_protected_content - HasProtectedContent bool `json:"has_protected_content"` -} - -func (entity *ChatEventHasProtectedContentToggled) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventHasProtectedContentToggled - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventHasProtectedContentToggled) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventHasProtectedContentToggled) GetType() string { - return TypeChatEventHasProtectedContentToggled -} - -func (*ChatEventHasProtectedContentToggled) ChatEventActionType() string { - return TypeChatEventHasProtectedContentToggled -} - -// The supergroup sticker set was changed -type ChatEventStickerSetChanged struct { - meta - // Previous identifier of the chat sticker set; 0 if none - OldStickerSetId JsonInt64 `json:"old_sticker_set_id"` - // New identifier of the chat sticker set; 0 if none - NewStickerSetId JsonInt64 `json:"new_sticker_set_id"` -} - -func (entity *ChatEventStickerSetChanged) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventStickerSetChanged - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventStickerSetChanged) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventStickerSetChanged) GetType() string { - return TypeChatEventStickerSetChanged -} - -func (*ChatEventStickerSetChanged) ChatEventActionType() string { - return TypeChatEventStickerSetChanged -} - // The supergroup location was changed type ChatEventLocationChanged struct { meta @@ -21321,6 +22066,263 @@ func (*ChatEventLocationChanged) ChatEventActionType() string { return TypeChatEventLocationChanged } +// The message TTL was changed +type ChatEventMessageTtlChanged struct { + meta + // Previous value of message_ttl + OldMessageTtl int32 `json:"old_message_ttl"` + // New value of message_ttl + NewMessageTtl int32 `json:"new_message_ttl"` +} + +func (entity *ChatEventMessageTtlChanged) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventMessageTtlChanged + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventMessageTtlChanged) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventMessageTtlChanged) GetType() string { + return TypeChatEventMessageTtlChanged +} + +func (*ChatEventMessageTtlChanged) ChatEventActionType() string { + return TypeChatEventMessageTtlChanged +} + +// The chat permissions was changed +type ChatEventPermissionsChanged struct { + meta + // Previous chat permissions + OldPermissions *ChatPermissions `json:"old_permissions"` + // New chat permissions + NewPermissions *ChatPermissions `json:"new_permissions"` +} + +func (entity *ChatEventPermissionsChanged) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventPermissionsChanged + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventPermissionsChanged) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventPermissionsChanged) GetType() string { + return TypeChatEventPermissionsChanged +} + +func (*ChatEventPermissionsChanged) ChatEventActionType() string { + return TypeChatEventPermissionsChanged +} + +// The chat photo was changed +type ChatEventPhotoChanged struct { + meta + // Previous chat photo value; may be null + OldPhoto *ChatPhoto `json:"old_photo"` + // New chat photo value; may be null + NewPhoto *ChatPhoto `json:"new_photo"` +} + +func (entity *ChatEventPhotoChanged) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventPhotoChanged + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventPhotoChanged) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventPhotoChanged) GetType() string { + return TypeChatEventPhotoChanged +} + +func (*ChatEventPhotoChanged) ChatEventActionType() string { + return TypeChatEventPhotoChanged +} + +// The slow_mode_delay setting of a supergroup was changed +type ChatEventSlowModeDelayChanged struct { + meta + // Previous value of slow_mode_delay, in seconds + OldSlowModeDelay int32 `json:"old_slow_mode_delay"` + // New value of slow_mode_delay, in seconds + NewSlowModeDelay int32 `json:"new_slow_mode_delay"` +} + +func (entity *ChatEventSlowModeDelayChanged) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventSlowModeDelayChanged + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventSlowModeDelayChanged) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventSlowModeDelayChanged) GetType() string { + return TypeChatEventSlowModeDelayChanged +} + +func (*ChatEventSlowModeDelayChanged) ChatEventActionType() string { + return TypeChatEventSlowModeDelayChanged +} + +// The supergroup sticker set was changed +type ChatEventStickerSetChanged struct { + meta + // Previous identifier of the chat sticker set; 0 if none + OldStickerSetId JsonInt64 `json:"old_sticker_set_id"` + // New identifier of the chat sticker set; 0 if none + NewStickerSetId JsonInt64 `json:"new_sticker_set_id"` +} + +func (entity *ChatEventStickerSetChanged) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventStickerSetChanged + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventStickerSetChanged) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventStickerSetChanged) GetType() string { + return TypeChatEventStickerSetChanged +} + +func (*ChatEventStickerSetChanged) ChatEventActionType() string { + return TypeChatEventStickerSetChanged +} + +// The chat title was changed +type ChatEventTitleChanged struct { + meta + // Previous chat title + OldTitle string `json:"old_title"` + // New chat title + NewTitle string `json:"new_title"` +} + +func (entity *ChatEventTitleChanged) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventTitleChanged + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventTitleChanged) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventTitleChanged) GetType() string { + return TypeChatEventTitleChanged +} + +func (*ChatEventTitleChanged) ChatEventActionType() string { + return TypeChatEventTitleChanged +} + +// The chat username was changed +type ChatEventUsernameChanged struct { + meta + // Previous chat username + OldUsername string `json:"old_username"` + // New chat username + NewUsername string `json:"new_username"` +} + +func (entity *ChatEventUsernameChanged) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventUsernameChanged + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventUsernameChanged) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventUsernameChanged) GetType() string { + return TypeChatEventUsernameChanged +} + +func (*ChatEventUsernameChanged) ChatEventActionType() string { + return TypeChatEventUsernameChanged +} + +// The has_protected_content setting of a channel was toggled +type ChatEventHasProtectedContentToggled struct { + meta + // New value of has_protected_content + HasProtectedContent bool `json:"has_protected_content"` +} + +func (entity *ChatEventHasProtectedContentToggled) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventHasProtectedContentToggled + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventHasProtectedContentToggled) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventHasProtectedContentToggled) GetType() string { + return TypeChatEventHasProtectedContentToggled +} + +func (*ChatEventHasProtectedContentToggled) ChatEventActionType() string { + return TypeChatEventHasProtectedContentToggled +} + +// The can_invite_users permission of a supergroup chat was toggled +type ChatEventInvitesToggled struct { + meta + // New value of can_invite_users permission + CanInviteUsers bool `json:"can_invite_users"` +} + +func (entity *ChatEventInvitesToggled) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventInvitesToggled + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventInvitesToggled) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventInvitesToggled) GetType() string { + return TypeChatEventInvitesToggled +} + +func (*ChatEventInvitesToggled) ChatEventActionType() string { + return TypeChatEventInvitesToggled +} + // The is_all_history_available setting of a supergroup was toggled type ChatEventIsAllHistoryAvailableToggled struct { meta @@ -21348,6 +22350,33 @@ func (*ChatEventIsAllHistoryAvailableToggled) ChatEventActionType() string { return TypeChatEventIsAllHistoryAvailableToggled } +// The sign_messages setting of a channel was toggled +type ChatEventSignMessagesToggled struct { + meta + // New value of sign_messages + SignMessages bool `json:"sign_messages"` +} + +func (entity *ChatEventSignMessagesToggled) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventSignMessagesToggled + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventSignMessagesToggled) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventSignMessagesToggled) GetType() string { + return TypeChatEventSignMessagesToggled +} + +func (*ChatEventSignMessagesToggled) ChatEventActionType() string { + return TypeChatEventSignMessagesToggled +} + // A chat invite link was edited type ChatEventInviteLinkEdited struct { meta @@ -21458,31 +22487,58 @@ func (*ChatEventVideoChatCreated) ChatEventActionType() string { return TypeChatEventVideoChatCreated } -// A video chat was discarded -type ChatEventVideoChatDiscarded struct { +// A video chat was ended +type ChatEventVideoChatEnded struct { meta // Identifier of the video chat. The video chat can be received through the method getGroupCall GroupCallId int32 `json:"group_call_id"` } -func (entity *ChatEventVideoChatDiscarded) MarshalJSON() ([]byte, error) { +func (entity *ChatEventVideoChatEnded) MarshalJSON() ([]byte, error) { entity.meta.Type = entity.GetType() - type stub ChatEventVideoChatDiscarded + type stub ChatEventVideoChatEnded return json.Marshal((*stub)(entity)) } -func (*ChatEventVideoChatDiscarded) GetClass() string { +func (*ChatEventVideoChatEnded) GetClass() string { return ClassChatEventAction } -func (*ChatEventVideoChatDiscarded) GetType() string { - return TypeChatEventVideoChatDiscarded +func (*ChatEventVideoChatEnded) GetType() string { + return TypeChatEventVideoChatEnded } -func (*ChatEventVideoChatDiscarded) ChatEventActionType() string { - return TypeChatEventVideoChatDiscarded +func (*ChatEventVideoChatEnded) ChatEventActionType() string { + return TypeChatEventVideoChatEnded +} + +// The mute_new_participants setting of a video chat was toggled +type ChatEventVideoChatMuteNewParticipantsToggled struct { + meta + // New value of the mute_new_participants setting + MuteNewParticipants bool `json:"mute_new_participants"` +} + +func (entity *ChatEventVideoChatMuteNewParticipantsToggled) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatEventVideoChatMuteNewParticipantsToggled + + return json.Marshal((*stub)(entity)) +} + +func (*ChatEventVideoChatMuteNewParticipantsToggled) GetClass() string { + return ClassChatEventAction +} + +func (*ChatEventVideoChatMuteNewParticipantsToggled) GetType() string { + return TypeChatEventVideoChatMuteNewParticipantsToggled +} + +func (*ChatEventVideoChatMuteNewParticipantsToggled) ChatEventActionType() string { + return TypeChatEventVideoChatMuteNewParticipantsToggled } // A video chat participant was muted or unmuted @@ -21581,33 +22637,6 @@ func (chatEventVideoChatParticipantVolumeLevelChanged *ChatEventVideoChatPartici return nil } -// The mute_new_participants setting of a video chat was toggled -type ChatEventVideoChatMuteNewParticipantsToggled struct { - meta - // New value of the mute_new_participants setting - MuteNewParticipants bool `json:"mute_new_participants"` -} - -func (entity *ChatEventVideoChatMuteNewParticipantsToggled) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub ChatEventVideoChatMuteNewParticipantsToggled - - return json.Marshal((*stub)(entity)) -} - -func (*ChatEventVideoChatMuteNewParticipantsToggled) GetClass() string { - return ClassChatEventAction -} - -func (*ChatEventVideoChatMuteNewParticipantsToggled) GetType() string { - return TypeChatEventVideoChatMuteNewParticipantsToggled -} - -func (*ChatEventVideoChatMuteNewParticipantsToggled) ChatEventActionType() string { - return TypeChatEventVideoChatMuteNewParticipantsToggled -} - // Represents a chat event type ChatEvent struct { meta @@ -21615,9 +22644,9 @@ type ChatEvent struct { Id JsonInt64 `json:"id"` // Point in time (Unix timestamp) when the event happened Date int32 `json:"date"` - // Identifier of the user who performed the action that triggered the event - UserId int64 `json:"user_id"` - // Action performed by the user + // Identifier of the user or chat who performed the action + MemberId MessageSender `json:"member_id"` + // The action Action ChatEventAction `json:"action"` } @@ -21639,10 +22668,10 @@ func (*ChatEvent) GetType() string { func (chatEvent *ChatEvent) UnmarshalJSON(data []byte) error { var tmp struct { - Id JsonInt64 `json:"id"` - Date int32 `json:"date"` - UserId int64 `json:"user_id"` - Action json.RawMessage `json:"action"` + Id JsonInt64 `json:"id"` + Date int32 `json:"date"` + MemberId json.RawMessage `json:"member_id"` + Action json.RawMessage `json:"action"` } err := json.Unmarshal(data, &tmp) @@ -21652,7 +22681,9 @@ func (chatEvent *ChatEvent) UnmarshalJSON(data []byte) error { chatEvent.Id = tmp.Id chatEvent.Date = tmp.Date - chatEvent.UserId = tmp.UserId + + fieldMemberId, _ := UnmarshalMessageSender(tmp.MemberId) + chatEvent.MemberId = fieldMemberId fieldAction, _ := UnmarshalChatEventAction(tmp.Action) chatEvent.Action = fieldAction @@ -21755,7 +22786,7 @@ func (*LanguagePackStringValueOrdinary) LanguagePackStringValueType() string { return TypeLanguagePackStringValueOrdinary } -// A language pack string which has different forms based on the number of some object it mentions. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more info +// A language pack string which has different forms based on the number of some object it mentions. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more information type LanguagePackStringValuePluralized struct { meta // Value for zero objects @@ -21895,7 +22926,7 @@ type LanguagePackInfo struct { Name string `json:"name"` // Name of the language in that language NativeName string `json:"native_name"` - // A language code to be used to apply plural forms. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more info + // A language code to be used to apply plural forms. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more information PluralCode string `json:"plural_code"` // True, if the language pack is official IsOfficial bool `json:"is_official"` @@ -21957,7 +22988,7 @@ func (*LocalizationTargetInfo) GetType() string { // A token for Firebase Cloud Messaging type DeviceTokenFirebaseCloudMessaging struct { meta - // Device registration token; may be empty to de-register a device + // Device registration token; may be empty to deregister a device Token string `json:"token"` // True, if push notifications must be additionally encrypted Encrypt bool `json:"encrypt"` @@ -21986,7 +23017,7 @@ func (*DeviceTokenFirebaseCloudMessaging) DeviceTokenType() string { // A token for Apple Push Notification service type DeviceTokenApplePush struct { meta - // Device token; may be empty to de-register a device + // Device token; may be empty to deregister a device DeviceToken string `json:"device_token"` // True, if App Sandbox is enabled IsAppSandbox bool `json:"is_app_sandbox"` @@ -22015,7 +23046,7 @@ func (*DeviceTokenApplePush) DeviceTokenType() string { // A token for Apple Push Notification service VoIP notifications type DeviceTokenApplePushVoIP struct { meta - // Device token; may be empty to de-register a device + // Device token; may be empty to deregister a device DeviceToken string `json:"device_token"` // True, if App Sandbox is enabled IsAppSandbox bool `json:"is_app_sandbox"` @@ -22046,7 +23077,7 @@ func (*DeviceTokenApplePushVoIP) DeviceTokenType() string { // A token for Windows Push Notification Services type DeviceTokenWindowsPush struct { meta - // The access token that will be used to send notifications; may be empty to de-register a device + // The access token that will be used to send notifications; may be empty to deregister a device AccessToken string `json:"access_token"` } @@ -22073,7 +23104,7 @@ func (*DeviceTokenWindowsPush) DeviceTokenType() string { // A token for Microsoft Push Notification Service type DeviceTokenMicrosoftPush struct { meta - // Push notification channel URI; may be empty to de-register a device + // Push notification channel URI; may be empty to deregister a device ChannelUri string `json:"channel_uri"` } @@ -22100,7 +23131,7 @@ func (*DeviceTokenMicrosoftPush) DeviceTokenType() string { // A token for Microsoft Push Notification Service VoIP channel type DeviceTokenMicrosoftPushVoIP struct { meta - // Push notification channel URI; may be empty to de-register a device + // Push notification channel URI; may be empty to deregister a device ChannelUri string `json:"channel_uri"` } @@ -22127,7 +23158,7 @@ func (*DeviceTokenMicrosoftPushVoIP) DeviceTokenType() string { // A token for web Push API type DeviceTokenWebPush struct { meta - // Absolute URL exposed by the push service where the application server can send push messages; may be empty to de-register a device + // Absolute URL exposed by the push service where the application server can send push messages; may be empty to deregister a device Endpoint string `json:"endpoint"` // Base64url-encoded P-256 elliptic curve Diffie-Hellman public key P256dhBase64url string `json:"p256dh_base64url"` @@ -22158,7 +23189,7 @@ func (*DeviceTokenWebPush) DeviceTokenType() string { // A token for Simple Push API for Firefox OS type DeviceTokenSimplePush struct { meta - // Absolute URL exposed by the push service where the application server can send push messages; may be empty to de-register a device + // Absolute URL exposed by the push service where the application server can send push messages; may be empty to deregister a device Endpoint string `json:"endpoint"` } @@ -22185,7 +23216,7 @@ func (*DeviceTokenSimplePush) DeviceTokenType() string { // A token for Ubuntu Push Client service type DeviceTokenUbuntuPush struct { meta - // Token; may be empty to de-register a device + // Token; may be empty to deregister a device Token string `json:"token"` } @@ -22212,7 +23243,7 @@ func (*DeviceTokenUbuntuPush) DeviceTokenType() string { // A token for BlackBerry Push Service type DeviceTokenBlackBerryPush struct { meta - // Token; may be empty to de-register a device + // Token; may be empty to deregister a device Token string `json:"token"` } @@ -22239,7 +23270,7 @@ func (*DeviceTokenBlackBerryPush) DeviceTokenType() string { // A token for Tizen Push Service type DeviceTokenTizenPush struct { meta - // Push service registration identifier; may be empty to de-register a device + // Push service registration identifier; may be empty to deregister a device RegId string `json:"reg_id"` } @@ -22937,7 +23968,7 @@ func (*CheckChatUsernameResultUsernameOccupied) CheckChatUsernameResultType() st return TypeCheckChatUsernameResultUsernameOccupied } -// The user has too much chats with username, one of them must be made private first +// The user has too many chats with username, one of them must be made private first type CheckChatUsernameResultPublicChatsTooMuch struct { meta } @@ -23914,7 +24945,7 @@ func (*PushMessageContentChatDeleteMember) PushMessageContentType() string { return TypePushMessageContentChatDeleteMember } -// A new member joined the chat by invite link +// A new member joined the chat via an invite link type PushMessageContentChatJoinByLink struct { meta } @@ -24267,6 +25298,62 @@ func (*NotificationGroupTypeCalls) NotificationGroupTypeType() string { return TypeNotificationGroupTypeCalls } +// Describes a notification sound in MP3 format +type NotificationSound struct { + meta + // Unique identifier of the notification sound + Id JsonInt64 `json:"id"` + // Duration of the sound, in seconds + Duration int32 `json:"duration"` + // Point in time (Unix timestamp) when the sound was created + Date int32 `json:"date"` + // Title of the notification sound + Title string `json:"title"` + // Arbitrary data, defined while the sound was uploaded + Data string `json:"data"` + // File containing the sound + Sound *File `json:"sound"` +} + +func (entity *NotificationSound) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub NotificationSound + + return json.Marshal((*stub)(entity)) +} + +func (*NotificationSound) GetClass() string { + return ClassNotificationSound +} + +func (*NotificationSound) GetType() string { + return TypeNotificationSound +} + +// Contains a list of notification sounds +type NotificationSounds struct { + meta + // A list of notification sounds + NotificationSounds []*NotificationSound `json:"notification_sounds"` +} + +func (entity *NotificationSounds) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub NotificationSounds + + return json.Marshal((*stub)(entity)) +} + +func (*NotificationSounds) GetClass() string { + return ClassNotificationSounds +} + +func (*NotificationSounds) GetType() string { + return TypeNotificationSounds +} + // Contains information about a notification type Notification struct { meta @@ -24274,8 +25361,8 @@ type Notification struct { Id int32 `json:"id"` // Notification date Date int32 `json:"date"` - // True, if the notification was initially silent - IsSilent bool `json:"is_silent"` + // Identifier of the notification sound to be played; 0 if sound is disabled + SoundId JsonInt64 `json:"sound_id"` // Notification type Type NotificationType `json:"type"` } @@ -24298,10 +25385,10 @@ func (*Notification) GetType() string { func (notification *Notification) UnmarshalJSON(data []byte) error { var tmp struct { - Id int32 `json:"id"` - Date int32 `json:"date"` - IsSilent bool `json:"is_silent"` - Type json.RawMessage `json:"type"` + Id int32 `json:"id"` + Date int32 `json:"date"` + SoundId JsonInt64 `json:"sound_id"` + Type json.RawMessage `json:"type"` } err := json.Unmarshal(data, &tmp) @@ -24311,7 +25398,7 @@ func (notification *Notification) UnmarshalJSON(data []byte) error { notification.Id = tmp.Id notification.Date = tmp.Date - notification.IsSilent = tmp.IsSilent + notification.SoundId = tmp.SoundId fieldType, _ := UnmarshalNotificationType(tmp.Type) notification.Type = fieldType @@ -25270,7 +26357,7 @@ type ConnectedWebsite struct { LastActiveDate int32 `json:"last_active_date"` // IP address from which the user was logged in, in human-readable format Ip string `json:"ip"` - // Human-readable description of a country and a region, from which the user was logged in, based on the IP address + // Human-readable description of a country and a region from which the user was logged in, based on the IP address Location string `json:"location"` } @@ -25488,6 +26575,56 @@ func (*ChatReportReasonFake) ChatReportReasonType() string { return TypeChatReportReasonFake } +// The chat has illegal drugs related content +type ChatReportReasonIllegalDrugs struct { + meta +} + +func (entity *ChatReportReasonIllegalDrugs) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatReportReasonIllegalDrugs + + return json.Marshal((*stub)(entity)) +} + +func (*ChatReportReasonIllegalDrugs) GetClass() string { + return ClassChatReportReason +} + +func (*ChatReportReasonIllegalDrugs) GetType() string { + return TypeChatReportReasonIllegalDrugs +} + +func (*ChatReportReasonIllegalDrugs) ChatReportReasonType() string { + return TypeChatReportReasonIllegalDrugs +} + +// The chat contains messages with personal details +type ChatReportReasonPersonalDetails struct { + meta +} + +func (entity *ChatReportReasonPersonalDetails) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub ChatReportReasonPersonalDetails + + return json.Marshal((*stub)(entity)) +} + +func (*ChatReportReasonPersonalDetails) GetClass() string { + return ClassChatReportReason +} + +func (*ChatReportReasonPersonalDetails) GetType() string { + return TypeChatReportReasonPersonalDetails +} + +func (*ChatReportReasonPersonalDetails) ChatReportReasonType() string { + return TypeChatReportReasonPersonalDetails +} + // A custom reason provided by the user type ChatReportReasonCustom struct { meta @@ -25538,6 +26675,58 @@ func (*InternalLinkTypeActiveSessions) InternalLinkTypeType() string { return TypeInternalLinkTypeActiveSessions } +// The link is a link to an attachment menu bot to be opened in the specified chat. Process given chat_link to open corresponding chat. Then call searchPublicChat with the given bot username, check that the user is a bot and can be added to attachment menu. Then use getAttachmentMenuBot to receive information about the bot. If the bot isn't added to attachment menu, then user needs to confirm adding the bot to attachment menu. If user confirms adding, then use toggleBotIsAddedToAttachmentMenu to add it. If attachment menu bots can't be used in the current chat, show an error to the user. If the bot is added to attachment menu, then use openWebApp with the given URL +type InternalLinkTypeAttachmentMenuBot struct { + meta + // An internal link pointing to a chat; may be null if the current chat needs to be kept + ChatLink InternalLinkType `json:"chat_link"` + // Username of the bot + BotUsername string `json:"bot_username"` + // URL to be passed to openWebApp + Url string `json:"url"` +} + +func (entity *InternalLinkTypeAttachmentMenuBot) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub InternalLinkTypeAttachmentMenuBot + + return json.Marshal((*stub)(entity)) +} + +func (*InternalLinkTypeAttachmentMenuBot) GetClass() string { + return ClassInternalLinkType +} + +func (*InternalLinkTypeAttachmentMenuBot) GetType() string { + return TypeInternalLinkTypeAttachmentMenuBot +} + +func (*InternalLinkTypeAttachmentMenuBot) InternalLinkTypeType() string { + return TypeInternalLinkTypeAttachmentMenuBot +} + +func (internalLinkTypeAttachmentMenuBot *InternalLinkTypeAttachmentMenuBot) UnmarshalJSON(data []byte) error { + var tmp struct { + ChatLink json.RawMessage `json:"chat_link"` + BotUsername string `json:"bot_username"` + Url string `json:"url"` + } + + err := json.Unmarshal(data, &tmp) + if err != nil { + return err + } + + internalLinkTypeAttachmentMenuBot.BotUsername = tmp.BotUsername + internalLinkTypeAttachmentMenuBot.Url = tmp.Url + + fieldChatLink, _ := UnmarshalInternalLinkType(tmp.ChatLink) + internalLinkTypeAttachmentMenuBot.ChatLink = fieldChatLink + + return nil +} + // The link contains an authentication code. Call checkAuthenticationCode with the code if the current authorization state is authorizationStateWaitCode type InternalLinkTypeAuthenticationCode struct { meta @@ -25621,13 +26810,15 @@ func (*InternalLinkTypeBotStart) InternalLinkTypeType() string { return TypeInternalLinkTypeBotStart } -// The link is a link to a Telegram bot, which is supposed to be added to a group chat. Call searchPublicChat with the given bot username, check that the user is a bot and can be added to groups, ask the current user to select a group to add the bot to, and then call sendBotStartMessage with the given start parameter and the chosen group chat. Bots can be added to a public group only by administrators of the group +// The link is a link to a Telegram bot, which is supposed to be added to a group chat. Call searchPublicChat with the given bot username, check that the user is a bot and can be added to groups, ask the current user to select a basic group or a supergroup chat to add the bot to, taking into account that bots can be added to a public supergroup only by administrators of the supergroup. If administrator rights are provided by the link, call getChatMember to receive the current bot rights in the chat and if the bot already is an administrator, check that the current user can edit its administrator rights, combine received rights with the requested administrator rights, show confirmation box to the user, and call setChatMemberStatus with the chosen chat and confirmed administrator rights. Before call to setChatMemberStatus it may be required to upgrade the chosen basic group chat to a supergroup chat. Then if start_parameter isn't empty, call sendBotStartMessage with the given start parameter and the chosen chat, otherwise just send /start message with bot's username added to the chat. type InternalLinkTypeBotStartInGroup struct { meta // Username of the bot BotUsername string `json:"bot_username"` // The parameter to be passed to sendBotStartMessage StartParameter string `json:"start_parameter"` + // Expected administrator rights for the bot; may be null + AdministratorRights *ChatAdministratorRights `json:"administrator_rights"` } func (entity *InternalLinkTypeBotStartInGroup) MarshalJSON() ([]byte, error) { @@ -25650,6 +26841,35 @@ func (*InternalLinkTypeBotStartInGroup) InternalLinkTypeType() string { return TypeInternalLinkTypeBotStartInGroup } +// The link is a link to a Telegram bot, which is supposed to be added to a channel chat as an administrator. Call searchPublicChat with the given bot username and check that the user is a bot, ask the current user to select a channel chat to add the bot to as an administrator. Then call getChatMember to receive the current bot rights in the chat and if the bot already is an administrator, check that the current user can edit its administrator rights and combine received rights with the requested administrator rights. Then show confirmation box to the user, and call setChatMemberStatus with the chosen chat and confirmed rights +type InternalLinkTypeBotAddToChannel struct { + meta + // Username of the bot + BotUsername string `json:"bot_username"` + // Expected administrator rights for the bot + AdministratorRights *ChatAdministratorRights `json:"administrator_rights"` +} + +func (entity *InternalLinkTypeBotAddToChannel) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub InternalLinkTypeBotAddToChannel + + return json.Marshal((*stub)(entity)) +} + +func (*InternalLinkTypeBotAddToChannel) GetClass() string { + return ClassInternalLinkType +} + +func (*InternalLinkTypeBotAddToChannel) GetType() string { + return TypeInternalLinkTypeBotAddToChannel +} + +func (*InternalLinkTypeBotAddToChannel) InternalLinkTypeType() string { + return TypeInternalLinkTypeBotAddToChannel +} + // The link is a link to the change phone number section of the app type InternalLinkTypeChangePhoneNumber struct { meta @@ -25783,6 +27003,31 @@ func (*InternalLinkTypeLanguagePack) InternalLinkTypeType() string { return TypeInternalLinkTypeLanguagePack } +// The link is a link to the language settings section of the app +type InternalLinkTypeLanguageSettings struct { + meta +} + +func (entity *InternalLinkTypeLanguageSettings) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub InternalLinkTypeLanguageSettings + + return json.Marshal((*stub)(entity)) +} + +func (*InternalLinkTypeLanguageSettings) GetClass() string { + return ClassInternalLinkType +} + +func (*InternalLinkTypeLanguageSettings) GetType() string { + return TypeInternalLinkTypeLanguageSettings +} + +func (*InternalLinkTypeLanguageSettings) InternalLinkTypeType() string { + return TypeInternalLinkTypeLanguageSettings +} + // The link is a link to a Telegram message. Call getMessageLinkInfo with the given URL to process the link type InternalLinkTypeMessage struct { meta @@ -25903,6 +27148,31 @@ func (*InternalLinkTypePhoneNumberConfirmation) InternalLinkTypeType() string { return TypeInternalLinkTypePhoneNumberConfirmation } +// The link is a link to the privacy and security settings section of the app +type InternalLinkTypePrivacyAndSecuritySettings struct { + meta +} + +func (entity *InternalLinkTypePrivacyAndSecuritySettings) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub InternalLinkTypePrivacyAndSecuritySettings + + return json.Marshal((*stub)(entity)) +} + +func (*InternalLinkTypePrivacyAndSecuritySettings) GetClass() string { + return ClassInternalLinkType +} + +func (*InternalLinkTypePrivacyAndSecuritySettings) GetType() string { + return TypeInternalLinkTypePrivacyAndSecuritySettings +} + +func (*InternalLinkTypePrivacyAndSecuritySettings) InternalLinkTypeType() string { + return TypeInternalLinkTypePrivacyAndSecuritySettings +} + // The link is a link to a proxy. Call addProxy with the given parameters to process the link and add the proxy type InternalLinkTypeProxy struct { meta @@ -26163,7 +27433,34 @@ func (*InternalLinkTypeUnsupportedProxy) InternalLinkTypeType() string { return TypeInternalLinkTypeUnsupportedProxy } -// The link is a link to a video chat. Call searchPublicChat with the given chat username, and then joinGoupCall with the given invite hash to process the link +// The link is a link to a user by its phone number. Call searchUserByPhoneNumber with the given phone number to process the link +type InternalLinkTypeUserPhoneNumber struct { + meta + // Phone number of the user + PhoneNumber string `json:"phone_number"` +} + +func (entity *InternalLinkTypeUserPhoneNumber) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub InternalLinkTypeUserPhoneNumber + + return json.Marshal((*stub)(entity)) +} + +func (*InternalLinkTypeUserPhoneNumber) GetClass() string { + return ClassInternalLinkType +} + +func (*InternalLinkTypeUserPhoneNumber) GetType() string { + return TypeInternalLinkTypeUserPhoneNumber +} + +func (*InternalLinkTypeUserPhoneNumber) InternalLinkTypeType() string { + return TypeInternalLinkTypeUserPhoneNumber +} + +// The link is a link to a video chat. Call searchPublicChat with the given chat username, and then joinGroupCall with the given invite hash to process the link type InternalLinkTypeVideoChat struct { meta // Username of the chat with the video chat @@ -26375,6 +27672,31 @@ func (*FileTypeDocument) FileTypeType() string { return TypeFileTypeDocument } +// The file is a notification sound +type FileTypeNotificationSound struct { + meta +} + +func (entity *FileTypeNotificationSound) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub FileTypeNotificationSound + + return json.Marshal((*stub)(entity)) +} + +func (*FileTypeNotificationSound) GetClass() string { + return ClassFileType +} + +func (*FileTypeNotificationSound) GetType() string { + return TypeFileTypeNotificationSound +} + +func (*FileTypeNotificationSound) FileTypeType() string { + return TypeFileTypeNotificationSound +} + // The file is a photo type FileTypePhoto struct { meta @@ -27537,7 +28859,7 @@ func (*TMeUrlTypeSupergroup) TMeUrlTypeType() string { // A chat invite link type TMeUrlTypeChatInvite struct { meta - // Chat invite link info + // Information about the chat invite link Info *ChatInviteLinkInfo `json:"info"` } @@ -27680,7 +29002,7 @@ func (*SuggestedActionEnableArchiveAndMuteNewChats) SuggestedActionType() string return TypeSuggestedActionEnableArchiveAndMuteNewChats } -// Suggests the user to check whether 2-step verification password is still remembered +// Suggests the user to check whether they still remember their 2-step verification password type SuggestedActionCheckPassword struct { meta } @@ -27730,29 +29052,29 @@ func (*SuggestedActionCheckPhoneNumber) SuggestedActionType() string { return TypeSuggestedActionCheckPhoneNumber } -// Suggests the user to see a hint about meaning of one and two ticks on sent message -type SuggestedActionSeeTicksHint struct { +// Suggests the user to view a hint about the meaning of one and two check marks on sent messages +type SuggestedActionViewChecksHint struct { meta } -func (entity *SuggestedActionSeeTicksHint) MarshalJSON() ([]byte, error) { +func (entity *SuggestedActionViewChecksHint) MarshalJSON() ([]byte, error) { entity.meta.Type = entity.GetType() - type stub SuggestedActionSeeTicksHint + type stub SuggestedActionViewChecksHint return json.Marshal((*stub)(entity)) } -func (*SuggestedActionSeeTicksHint) GetClass() string { +func (*SuggestedActionViewChecksHint) GetClass() string { return ClassSuggestedAction } -func (*SuggestedActionSeeTicksHint) GetType() string { - return TypeSuggestedActionSeeTicksHint +func (*SuggestedActionViewChecksHint) GetType() string { + return TypeSuggestedActionViewChecksHint } -func (*SuggestedActionSeeTicksHint) SuggestedActionType() string { - return TypeSuggestedActionSeeTicksHint +func (*SuggestedActionViewChecksHint) SuggestedActionType() string { + return TypeSuggestedActionViewChecksHint } // Suggests the user to convert specified supergroup to a broadcast group @@ -28125,91 +29447,38 @@ func (*Proxies) GetType() string { return TypeProxies } -// A static sticker in PNG format, which will be converted to WEBP server-side -type InputStickerStatic struct { +// A sticker to be added to a sticker set +type InputSticker struct { meta - // PNG image with the sticker; must be up to 512 KB in size and fit in a 512x512 square + // File with the sticker; must fit in a 512x512 square. For WEBP stickers and masks the file must be in PNG format, which will be converted to WEBP server-side. Otherwise, the file must be local or uploaded within a week. See https://core.telegram.org/animated_stickers#technical-requirements for technical requirements Sticker InputFile `json:"sticker"` // Emojis corresponding to the sticker Emojis string `json:"emojis"` - // For masks, position where the mask is placed; pass null if unspecified - MaskPosition *MaskPosition `json:"mask_position"` + // Sticker type + Type StickerType `json:"type"` } -func (entity *InputStickerStatic) MarshalJSON() ([]byte, error) { +func (entity *InputSticker) MarshalJSON() ([]byte, error) { entity.meta.Type = entity.GetType() - type stub InputStickerStatic + type stub InputSticker return json.Marshal((*stub)(entity)) } -func (*InputStickerStatic) GetClass() string { +func (*InputSticker) GetClass() string { return ClassInputSticker } -func (*InputStickerStatic) GetType() string { - return TypeInputStickerStatic +func (*InputSticker) GetType() string { + return TypeInputSticker } -func (*InputStickerStatic) InputStickerType() string { - return TypeInputStickerStatic -} - -func (inputStickerStatic *InputStickerStatic) UnmarshalJSON(data []byte) error { - var tmp struct { - Sticker json.RawMessage `json:"sticker"` - Emojis string `json:"emojis"` - MaskPosition *MaskPosition `json:"mask_position"` - } - - err := json.Unmarshal(data, &tmp) - if err != nil { - return err - } - - inputStickerStatic.Emojis = tmp.Emojis - inputStickerStatic.MaskPosition = tmp.MaskPosition - - fieldSticker, _ := UnmarshalInputFile(tmp.Sticker) - inputStickerStatic.Sticker = fieldSticker - - return nil -} - -// An animated sticker in TGS format -type InputStickerAnimated struct { - meta - // File with the animated sticker. Only local or uploaded within a week files are supported. See https://core.telegram.org/animated_stickers#technical-requirements for technical requirements - Sticker InputFile `json:"sticker"` - // Emojis corresponding to the sticker - Emojis string `json:"emojis"` -} - -func (entity *InputStickerAnimated) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub InputStickerAnimated - - return json.Marshal((*stub)(entity)) -} - -func (*InputStickerAnimated) GetClass() string { - return ClassInputSticker -} - -func (*InputStickerAnimated) GetType() string { - return TypeInputStickerAnimated -} - -func (*InputStickerAnimated) InputStickerType() string { - return TypeInputStickerAnimated -} - -func (inputStickerAnimated *InputStickerAnimated) UnmarshalJSON(data []byte) error { +func (inputSticker *InputSticker) UnmarshalJSON(data []byte) error { var tmp struct { Sticker json.RawMessage `json:"sticker"` Emojis string `json:"emojis"` + Type json.RawMessage `json:"type"` } err := json.Unmarshal(data, &tmp) @@ -28217,10 +29486,13 @@ func (inputStickerAnimated *InputStickerAnimated) UnmarshalJSON(data []byte) err return err } - inputStickerAnimated.Emojis = tmp.Emojis + inputSticker.Emojis = tmp.Emojis fieldSticker, _ := UnmarshalInputFile(tmp.Sticker) - inputStickerAnimated.Sticker = fieldSticker + inputSticker.Sticker = fieldSticker + + fieldType, _ := UnmarshalStickerType(tmp.Type) + inputSticker.Type = fieldType return nil } @@ -29398,6 +30670,39 @@ func (*UpdateMessageMentionRead) UpdateType() string { return TypeUpdateMessageMentionRead } +// The list of unread reactions added to a message was changed +type UpdateMessageUnreadReactions struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // Message identifier + MessageId int64 `json:"message_id"` + // The new list of unread reactions + UnreadReactions []*UnreadReaction `json:"unread_reactions"` + // The new number of messages with unread reactions left in the chat + UnreadReactionCount int32 `json:"unread_reaction_count"` +} + +func (entity *UpdateMessageUnreadReactions) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateMessageUnreadReactions + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateMessageUnreadReactions) GetClass() string { + return ClassUpdate +} + +func (*UpdateMessageUnreadReactions) GetType() string { + return TypeUpdateMessageUnreadReactions +} + +func (*UpdateMessageUnreadReactions) UpdateType() string { + return TypeUpdateMessageUnreadReactions +} + // A message with a live location was viewed. When the update is received, the application is supposed to update the live location type UpdateMessageLiveLocationViewed struct { meta @@ -29601,228 +30906,6 @@ func (*UpdateChatPosition) UpdateType() string { return TypeUpdateChatPosition } -// The default message sender that is chosen to send messages in a chat has changed -type UpdateChatDefaultMessageSenderId struct { - meta - // Chat identifier - ChatId int64 `json:"chat_id"` - // New value of default_message_sender_id; may be null if the user can't change message sender - DefaultMessageSenderId MessageSender `json:"default_message_sender_id"` -} - -func (entity *UpdateChatDefaultMessageSenderId) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub UpdateChatDefaultMessageSenderId - - return json.Marshal((*stub)(entity)) -} - -func (*UpdateChatDefaultMessageSenderId) GetClass() string { - return ClassUpdate -} - -func (*UpdateChatDefaultMessageSenderId) GetType() string { - return TypeUpdateChatDefaultMessageSenderId -} - -func (*UpdateChatDefaultMessageSenderId) UpdateType() string { - return TypeUpdateChatDefaultMessageSenderId -} - -func (updateChatDefaultMessageSenderId *UpdateChatDefaultMessageSenderId) UnmarshalJSON(data []byte) error { - var tmp struct { - ChatId int64 `json:"chat_id"` - DefaultMessageSenderId json.RawMessage `json:"default_message_sender_id"` - } - - err := json.Unmarshal(data, &tmp) - if err != nil { - return err - } - - updateChatDefaultMessageSenderId.ChatId = tmp.ChatId - - fieldDefaultMessageSenderId, _ := UnmarshalMessageSender(tmp.DefaultMessageSenderId) - updateChatDefaultMessageSenderId.DefaultMessageSenderId = fieldDefaultMessageSenderId - - return nil -} - -// A chat content was allowed or restricted for saving -type UpdateChatHasProtectedContent struct { - meta - // Chat identifier - ChatId int64 `json:"chat_id"` - // New value of has_protected_content - HasProtectedContent bool `json:"has_protected_content"` -} - -func (entity *UpdateChatHasProtectedContent) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub UpdateChatHasProtectedContent - - return json.Marshal((*stub)(entity)) -} - -func (*UpdateChatHasProtectedContent) GetClass() string { - return ClassUpdate -} - -func (*UpdateChatHasProtectedContent) GetType() string { - return TypeUpdateChatHasProtectedContent -} - -func (*UpdateChatHasProtectedContent) UpdateType() string { - return TypeUpdateChatHasProtectedContent -} - -// A chat was marked as unread or was read -type UpdateChatIsMarkedAsUnread struct { - meta - // Chat identifier - ChatId int64 `json:"chat_id"` - // New value of is_marked_as_unread - IsMarkedAsUnread bool `json:"is_marked_as_unread"` -} - -func (entity *UpdateChatIsMarkedAsUnread) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub UpdateChatIsMarkedAsUnread - - return json.Marshal((*stub)(entity)) -} - -func (*UpdateChatIsMarkedAsUnread) GetClass() string { - return ClassUpdate -} - -func (*UpdateChatIsMarkedAsUnread) GetType() string { - return TypeUpdateChatIsMarkedAsUnread -} - -func (*UpdateChatIsMarkedAsUnread) UpdateType() string { - return TypeUpdateChatIsMarkedAsUnread -} - -// A chat was blocked or unblocked -type UpdateChatIsBlocked struct { - meta - // Chat identifier - ChatId int64 `json:"chat_id"` - // New value of is_blocked - IsBlocked bool `json:"is_blocked"` -} - -func (entity *UpdateChatIsBlocked) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub UpdateChatIsBlocked - - return json.Marshal((*stub)(entity)) -} - -func (*UpdateChatIsBlocked) GetClass() string { - return ClassUpdate -} - -func (*UpdateChatIsBlocked) GetType() string { - return TypeUpdateChatIsBlocked -} - -func (*UpdateChatIsBlocked) UpdateType() string { - return TypeUpdateChatIsBlocked -} - -// A chat's has_scheduled_messages field has changed -type UpdateChatHasScheduledMessages struct { - meta - // Chat identifier - ChatId int64 `json:"chat_id"` - // New value of has_scheduled_messages - HasScheduledMessages bool `json:"has_scheduled_messages"` -} - -func (entity *UpdateChatHasScheduledMessages) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub UpdateChatHasScheduledMessages - - return json.Marshal((*stub)(entity)) -} - -func (*UpdateChatHasScheduledMessages) GetClass() string { - return ClassUpdate -} - -func (*UpdateChatHasScheduledMessages) GetType() string { - return TypeUpdateChatHasScheduledMessages -} - -func (*UpdateChatHasScheduledMessages) UpdateType() string { - return TypeUpdateChatHasScheduledMessages -} - -// A chat video chat state has changed -type UpdateChatVideoChat struct { - meta - // Chat identifier - ChatId int64 `json:"chat_id"` - // New value of video_chat - VideoChat *VideoChat `json:"video_chat"` -} - -func (entity *UpdateChatVideoChat) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub UpdateChatVideoChat - - return json.Marshal((*stub)(entity)) -} - -func (*UpdateChatVideoChat) GetClass() string { - return ClassUpdate -} - -func (*UpdateChatVideoChat) GetType() string { - return TypeUpdateChatVideoChat -} - -func (*UpdateChatVideoChat) UpdateType() string { - return TypeUpdateChatVideoChat -} - -// The value of the default disable_notification parameter, used when a message is sent to the chat, was changed -type UpdateChatDefaultDisableNotification struct { - meta - // Chat identifier - ChatId int64 `json:"chat_id"` - // The new default_disable_notification value - DefaultDisableNotification bool `json:"default_disable_notification"` -} - -func (entity *UpdateChatDefaultDisableNotification) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub UpdateChatDefaultDisableNotification - - return json.Marshal((*stub)(entity)) -} - -func (*UpdateChatDefaultDisableNotification) GetClass() string { - return ClassUpdate -} - -func (*UpdateChatDefaultDisableNotification) GetType() string { - return TypeUpdateChatDefaultDisableNotification -} - -func (*UpdateChatDefaultDisableNotification) UpdateType() string { - return TypeUpdateChatDefaultDisableNotification -} - // Incoming messages were read or the number of unread messages has been changed type UpdateChatReadInbox struct { meta @@ -29883,141 +30966,6 @@ func (*UpdateChatReadOutbox) UpdateType() string { return TypeUpdateChatReadOutbox } -// The chat unread_mention_count has changed -type UpdateChatUnreadMentionCount struct { - meta - // Chat identifier - ChatId int64 `json:"chat_id"` - // The number of unread mention messages left in the chat - UnreadMentionCount int32 `json:"unread_mention_count"` -} - -func (entity *UpdateChatUnreadMentionCount) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub UpdateChatUnreadMentionCount - - return json.Marshal((*stub)(entity)) -} - -func (*UpdateChatUnreadMentionCount) GetClass() string { - return ClassUpdate -} - -func (*UpdateChatUnreadMentionCount) GetType() string { - return TypeUpdateChatUnreadMentionCount -} - -func (*UpdateChatUnreadMentionCount) UpdateType() string { - return TypeUpdateChatUnreadMentionCount -} - -// Notification settings for a chat were changed -type UpdateChatNotificationSettings struct { - meta - // Chat identifier - ChatId int64 `json:"chat_id"` - // The new notification settings - NotificationSettings *ChatNotificationSettings `json:"notification_settings"` -} - -func (entity *UpdateChatNotificationSettings) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub UpdateChatNotificationSettings - - return json.Marshal((*stub)(entity)) -} - -func (*UpdateChatNotificationSettings) GetClass() string { - return ClassUpdate -} - -func (*UpdateChatNotificationSettings) GetType() string { - return TypeUpdateChatNotificationSettings -} - -func (*UpdateChatNotificationSettings) UpdateType() string { - return TypeUpdateChatNotificationSettings -} - -// Notification settings for some type of chats were updated -type UpdateScopeNotificationSettings struct { - meta - // Types of chats for which notification settings were updated - Scope NotificationSettingsScope `json:"scope"` - // The new notification settings - NotificationSettings *ScopeNotificationSettings `json:"notification_settings"` -} - -func (entity *UpdateScopeNotificationSettings) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub UpdateScopeNotificationSettings - - return json.Marshal((*stub)(entity)) -} - -func (*UpdateScopeNotificationSettings) GetClass() string { - return ClassUpdate -} - -func (*UpdateScopeNotificationSettings) GetType() string { - return TypeUpdateScopeNotificationSettings -} - -func (*UpdateScopeNotificationSettings) UpdateType() string { - return TypeUpdateScopeNotificationSettings -} - -func (updateScopeNotificationSettings *UpdateScopeNotificationSettings) UnmarshalJSON(data []byte) error { - var tmp struct { - Scope json.RawMessage `json:"scope"` - NotificationSettings *ScopeNotificationSettings `json:"notification_settings"` - } - - err := json.Unmarshal(data, &tmp) - if err != nil { - return err - } - - updateScopeNotificationSettings.NotificationSettings = tmp.NotificationSettings - - fieldScope, _ := UnmarshalNotificationSettingsScope(tmp.Scope) - updateScopeNotificationSettings.Scope = fieldScope - - return nil -} - -// The message Time To Live setting for a chat was changed -type UpdateChatMessageTtlSetting struct { - meta - // Chat identifier - ChatId int64 `json:"chat_id"` - // New value of message_ttl_setting - MessageTtlSetting int32 `json:"message_ttl_setting"` -} - -func (entity *UpdateChatMessageTtlSetting) MarshalJSON() ([]byte, error) { - entity.meta.Type = entity.GetType() - - type stub UpdateChatMessageTtlSetting - - return json.Marshal((*stub)(entity)) -} - -func (*UpdateChatMessageTtlSetting) GetClass() string { - return ClassUpdate -} - -func (*UpdateChatMessageTtlSetting) GetType() string { - return TypeUpdateChatMessageTtlSetting -} - -func (*UpdateChatMessageTtlSetting) UpdateType() string { - return TypeUpdateChatMessageTtlSetting -} - // The chat action bar was changed type UpdateChatActionBar struct { meta @@ -30066,33 +31014,170 @@ func (updateChatActionBar *UpdateChatActionBar) UnmarshalJSON(data []byte) error return nil } -// The chat theme was changed -type UpdateChatTheme struct { +// The chat available reactions were changed +type UpdateChatAvailableReactions struct { meta // Chat identifier ChatId int64 `json:"chat_id"` - // The new name of the chat theme; may be empty if theme was reset to default - ThemeName string `json:"theme_name"` + // The new list of reactions, available in the chat + AvailableReactions []string `json:"available_reactions"` } -func (entity *UpdateChatTheme) MarshalJSON() ([]byte, error) { +func (entity *UpdateChatAvailableReactions) MarshalJSON() ([]byte, error) { entity.meta.Type = entity.GetType() - type stub UpdateChatTheme + type stub UpdateChatAvailableReactions return json.Marshal((*stub)(entity)) } -func (*UpdateChatTheme) GetClass() string { +func (*UpdateChatAvailableReactions) GetClass() string { return ClassUpdate } -func (*UpdateChatTheme) GetType() string { - return TypeUpdateChatTheme +func (*UpdateChatAvailableReactions) GetType() string { + return TypeUpdateChatAvailableReactions } -func (*UpdateChatTheme) UpdateType() string { - return TypeUpdateChatTheme +func (*UpdateChatAvailableReactions) UpdateType() string { + return TypeUpdateChatAvailableReactions +} + +// A chat draft has changed. Be aware that the update may come in the currently opened chat but with old content of the draft. If the user has changed the content of the draft, this update mustn't be applied +type UpdateChatDraftMessage struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // The new draft message; may be null + DraftMessage *DraftMessage `json:"draft_message"` + // The new chat positions in the chat lists + Positions []*ChatPosition `json:"positions"` +} + +func (entity *UpdateChatDraftMessage) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatDraftMessage + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatDraftMessage) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatDraftMessage) GetType() string { + return TypeUpdateChatDraftMessage +} + +func (*UpdateChatDraftMessage) UpdateType() string { + return TypeUpdateChatDraftMessage +} + +// The message sender that is selected to send messages in a chat has changed +type UpdateChatMessageSender struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // New value of message_sender_id; may be null if the user can't change message sender + MessageSenderId MessageSender `json:"message_sender_id"` +} + +func (entity *UpdateChatMessageSender) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatMessageSender + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatMessageSender) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatMessageSender) GetType() string { + return TypeUpdateChatMessageSender +} + +func (*UpdateChatMessageSender) UpdateType() string { + return TypeUpdateChatMessageSender +} + +func (updateChatMessageSender *UpdateChatMessageSender) UnmarshalJSON(data []byte) error { + var tmp struct { + ChatId int64 `json:"chat_id"` + MessageSenderId json.RawMessage `json:"message_sender_id"` + } + + err := json.Unmarshal(data, &tmp) + if err != nil { + return err + } + + updateChatMessageSender.ChatId = tmp.ChatId + + fieldMessageSenderId, _ := UnmarshalMessageSender(tmp.MessageSenderId) + updateChatMessageSender.MessageSenderId = fieldMessageSenderId + + return nil +} + +// The message Time To Live setting for a chat was changed +type UpdateChatMessageTtl struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // New value of message_ttl + MessageTtl int32 `json:"message_ttl"` +} + +func (entity *UpdateChatMessageTtl) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatMessageTtl + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatMessageTtl) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatMessageTtl) GetType() string { + return TypeUpdateChatMessageTtl +} + +func (*UpdateChatMessageTtl) UpdateType() string { + return TypeUpdateChatMessageTtl +} + +// Notification settings for a chat were changed +type UpdateChatNotificationSettings struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // The new notification settings + NotificationSettings *ChatNotificationSettings `json:"notification_settings"` +} + +func (entity *UpdateChatNotificationSettings) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatNotificationSettings + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatNotificationSettings) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatNotificationSettings) GetType() string { + return TypeUpdateChatNotificationSettings +} + +func (*UpdateChatNotificationSettings) UpdateType() string { + return TypeUpdateChatNotificationSettings } // The chat pending join requests were changed @@ -30153,35 +31238,265 @@ func (*UpdateChatReplyMarkup) UpdateType() string { return TypeUpdateChatReplyMarkup } -// A chat draft has changed. Be aware that the update may come in the currently opened chat but with old content of the draft. If the user has changed the content of the draft, this update mustn't be applied -type UpdateChatDraftMessage struct { +// The chat theme was changed +type UpdateChatTheme struct { meta // Chat identifier ChatId int64 `json:"chat_id"` - // The new draft message; may be null - DraftMessage *DraftMessage `json:"draft_message"` - // The new chat positions in the chat lists - Positions []*ChatPosition `json:"positions"` + // The new name of the chat theme; may be empty if theme was reset to default + ThemeName string `json:"theme_name"` } -func (entity *UpdateChatDraftMessage) MarshalJSON() ([]byte, error) { +func (entity *UpdateChatTheme) MarshalJSON() ([]byte, error) { entity.meta.Type = entity.GetType() - type stub UpdateChatDraftMessage + type stub UpdateChatTheme return json.Marshal((*stub)(entity)) } -func (*UpdateChatDraftMessage) GetClass() string { +func (*UpdateChatTheme) GetClass() string { return ClassUpdate } -func (*UpdateChatDraftMessage) GetType() string { - return TypeUpdateChatDraftMessage +func (*UpdateChatTheme) GetType() string { + return TypeUpdateChatTheme } -func (*UpdateChatDraftMessage) UpdateType() string { - return TypeUpdateChatDraftMessage +func (*UpdateChatTheme) UpdateType() string { + return TypeUpdateChatTheme +} + +// The chat unread_mention_count has changed +type UpdateChatUnreadMentionCount struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // The number of unread mention messages left in the chat + UnreadMentionCount int32 `json:"unread_mention_count"` +} + +func (entity *UpdateChatUnreadMentionCount) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatUnreadMentionCount + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatUnreadMentionCount) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatUnreadMentionCount) GetType() string { + return TypeUpdateChatUnreadMentionCount +} + +func (*UpdateChatUnreadMentionCount) UpdateType() string { + return TypeUpdateChatUnreadMentionCount +} + +// The chat unread_reaction_count has changed +type UpdateChatUnreadReactionCount struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // The number of messages with unread reactions left in the chat + UnreadReactionCount int32 `json:"unread_reaction_count"` +} + +func (entity *UpdateChatUnreadReactionCount) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatUnreadReactionCount + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatUnreadReactionCount) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatUnreadReactionCount) GetType() string { + return TypeUpdateChatUnreadReactionCount +} + +func (*UpdateChatUnreadReactionCount) UpdateType() string { + return TypeUpdateChatUnreadReactionCount +} + +// A chat video chat state has changed +type UpdateChatVideoChat struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // New value of video_chat + VideoChat *VideoChat `json:"video_chat"` +} + +func (entity *UpdateChatVideoChat) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatVideoChat + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatVideoChat) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatVideoChat) GetType() string { + return TypeUpdateChatVideoChat +} + +func (*UpdateChatVideoChat) UpdateType() string { + return TypeUpdateChatVideoChat +} + +// The value of the default disable_notification parameter, used when a message is sent to the chat, was changed +type UpdateChatDefaultDisableNotification struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // The new default_disable_notification value + DefaultDisableNotification bool `json:"default_disable_notification"` +} + +func (entity *UpdateChatDefaultDisableNotification) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatDefaultDisableNotification + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatDefaultDisableNotification) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatDefaultDisableNotification) GetType() string { + return TypeUpdateChatDefaultDisableNotification +} + +func (*UpdateChatDefaultDisableNotification) UpdateType() string { + return TypeUpdateChatDefaultDisableNotification +} + +// A chat content was allowed or restricted for saving +type UpdateChatHasProtectedContent struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // New value of has_protected_content + HasProtectedContent bool `json:"has_protected_content"` +} + +func (entity *UpdateChatHasProtectedContent) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatHasProtectedContent + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatHasProtectedContent) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatHasProtectedContent) GetType() string { + return TypeUpdateChatHasProtectedContent +} + +func (*UpdateChatHasProtectedContent) UpdateType() string { + return TypeUpdateChatHasProtectedContent +} + +// A chat's has_scheduled_messages field has changed +type UpdateChatHasScheduledMessages struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // New value of has_scheduled_messages + HasScheduledMessages bool `json:"has_scheduled_messages"` +} + +func (entity *UpdateChatHasScheduledMessages) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatHasScheduledMessages + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatHasScheduledMessages) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatHasScheduledMessages) GetType() string { + return TypeUpdateChatHasScheduledMessages +} + +func (*UpdateChatHasScheduledMessages) UpdateType() string { + return TypeUpdateChatHasScheduledMessages +} + +// A chat was blocked or unblocked +type UpdateChatIsBlocked struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // New value of is_blocked + IsBlocked bool `json:"is_blocked"` +} + +func (entity *UpdateChatIsBlocked) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatIsBlocked + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatIsBlocked) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatIsBlocked) GetType() string { + return TypeUpdateChatIsBlocked +} + +func (*UpdateChatIsBlocked) UpdateType() string { + return TypeUpdateChatIsBlocked +} + +// A chat was marked as unread or was read +type UpdateChatIsMarkedAsUnread struct { + meta + // Chat identifier + ChatId int64 `json:"chat_id"` + // New value of is_marked_as_unread + IsMarkedAsUnread bool `json:"is_marked_as_unread"` +} + +func (entity *UpdateChatIsMarkedAsUnread) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateChatIsMarkedAsUnread + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateChatIsMarkedAsUnread) GetClass() string { + return ClassUpdate +} + +func (*UpdateChatIsMarkedAsUnread) GetType() string { + return TypeUpdateChatIsMarkedAsUnread +} + +func (*UpdateChatIsMarkedAsUnread) UpdateType() string { + return TypeUpdateChatIsMarkedAsUnread } // The list of chat filters or a chat filter has changed @@ -30211,7 +31526,7 @@ func (*UpdateChatFilters) UpdateType() string { return TypeUpdateChatFilters } -// The number of online group members has changed. This update with non-zero count is sent only for currently opened chats. There is no guarantee that it will be sent just after the count has changed +// The number of online group members has changed. This update with non-zero number of online group members is sent only for currently opened chats. There is no guarantee that it will be sent just after the number of online users has changed type UpdateChatOnlineMemberCount struct { meta // Identifier of the chat @@ -30240,6 +31555,54 @@ func (*UpdateChatOnlineMemberCount) UpdateType() string { return TypeUpdateChatOnlineMemberCount } +// Notification settings for some type of chats were updated +type UpdateScopeNotificationSettings struct { + meta + // Types of chats for which notification settings were updated + Scope NotificationSettingsScope `json:"scope"` + // The new notification settings + NotificationSettings *ScopeNotificationSettings `json:"notification_settings"` +} + +func (entity *UpdateScopeNotificationSettings) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateScopeNotificationSettings + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateScopeNotificationSettings) GetClass() string { + return ClassUpdate +} + +func (*UpdateScopeNotificationSettings) GetType() string { + return TypeUpdateScopeNotificationSettings +} + +func (*UpdateScopeNotificationSettings) UpdateType() string { + return TypeUpdateScopeNotificationSettings +} + +func (updateScopeNotificationSettings *UpdateScopeNotificationSettings) UnmarshalJSON(data []byte) error { + var tmp struct { + Scope json.RawMessage `json:"scope"` + NotificationSettings *ScopeNotificationSettings `json:"notification_settings"` + } + + err := json.Unmarshal(data, &tmp) + if err != nil { + return err + } + + updateScopeNotificationSettings.NotificationSettings = tmp.NotificationSettings + + fieldScope, _ := UnmarshalNotificationSettingsScope(tmp.Scope) + updateScopeNotificationSettings.Scope = fieldScope + + return nil +} + // A notification was changed type UpdateNotification struct { meta @@ -30280,8 +31643,8 @@ type UpdateNotificationGroup struct { ChatId int64 `json:"chat_id"` // Chat identifier, which notification settings must be applied to the added notifications NotificationSettingsChatId int64 `json:"notification_settings_chat_id"` - // True, if the notifications must be shown without sound - IsSilent bool `json:"is_silent"` + // Identifier of the notification sound to be played; 0 if sound is disabled + NotificationSoundId JsonInt64 `json:"notification_sound_id"` // Total number of unread notifications in the group, can be bigger than number of active notifications TotalCount int32 `json:"total_count"` // List of added group notifications, sorted by notification ID @@ -30316,7 +31679,7 @@ func (updateNotificationGroup *UpdateNotificationGroup) UnmarshalJSON(data []byt Type json.RawMessage `json:"type"` ChatId int64 `json:"chat_id"` NotificationSettingsChatId int64 `json:"notification_settings_chat_id"` - IsSilent bool `json:"is_silent"` + NotificationSoundId JsonInt64 `json:"notification_sound_id"` TotalCount int32 `json:"total_count"` AddedNotifications []*Notification `json:"added_notifications"` RemovedNotificationIds []int32 `json:"removed_notification_ids"` @@ -30330,7 +31693,7 @@ func (updateNotificationGroup *UpdateNotificationGroup) UnmarshalJSON(data []byt updateNotificationGroup.NotificationGroupId = tmp.NotificationGroupId updateNotificationGroup.ChatId = tmp.ChatId updateNotificationGroup.NotificationSettingsChatId = tmp.NotificationSettingsChatId - updateNotificationGroup.IsSilent = tmp.IsSilent + updateNotificationGroup.NotificationSoundId = tmp.NotificationSoundId updateNotificationGroup.TotalCount = tmp.TotalCount updateNotificationGroup.AddedNotifications = tmp.AddedNotifications updateNotificationGroup.RemovedNotificationIds = tmp.RemovedNotificationIds @@ -30866,6 +32229,128 @@ func (*UpdateFileGenerationStop) UpdateType() string { return TypeUpdateFileGenerationStop } +// The state of the file download list has changed +type UpdateFileDownloads struct { + meta + // Total size of files in the file download list, in bytes + TotalSize int64 `json:"total_size"` + // Total number of files in the file download list + TotalCount int32 `json:"total_count"` + // Total downloaded size of files in the file download list, in bytes + DownloadedSize int64 `json:"downloaded_size"` +} + +func (entity *UpdateFileDownloads) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateFileDownloads + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateFileDownloads) GetClass() string { + return ClassUpdate +} + +func (*UpdateFileDownloads) GetType() string { + return TypeUpdateFileDownloads +} + +func (*UpdateFileDownloads) UpdateType() string { + return TypeUpdateFileDownloads +} + +// A file was added to the file download list. This update is sent only after file download list is loaded for the first time +type UpdateFileAddedToDownloads struct { + meta + // The added file download + FileDownload *FileDownload `json:"file_download"` + // New number of being downloaded and recently downloaded files found + Counts *DownloadedFileCounts `json:"counts"` +} + +func (entity *UpdateFileAddedToDownloads) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateFileAddedToDownloads + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateFileAddedToDownloads) GetClass() string { + return ClassUpdate +} + +func (*UpdateFileAddedToDownloads) GetType() string { + return TypeUpdateFileAddedToDownloads +} + +func (*UpdateFileAddedToDownloads) UpdateType() string { + return TypeUpdateFileAddedToDownloads +} + +// A file download was changed. This update is sent only after file download list is loaded for the first time +type UpdateFileDownload struct { + meta + // File identifier + FileId int32 `json:"file_id"` + // Point in time (Unix timestamp) when the file downloading was completed; 0 if the file downloading isn't completed + CompleteDate int32 `json:"complete_date"` + // True, if downloading of the file is paused + IsPaused bool `json:"is_paused"` + // New number of being downloaded and recently downloaded files found + Counts *DownloadedFileCounts `json:"counts"` +} + +func (entity *UpdateFileDownload) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateFileDownload + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateFileDownload) GetClass() string { + return ClassUpdate +} + +func (*UpdateFileDownload) GetType() string { + return TypeUpdateFileDownload +} + +func (*UpdateFileDownload) UpdateType() string { + return TypeUpdateFileDownload +} + +// A file was removed from the file download list. This update is sent only after file download list is loaded for the first time +type UpdateFileRemovedFromDownloads struct { + meta + // File identifier + FileId int32 `json:"file_id"` + // New number of being downloaded and recently downloaded files found + Counts *DownloadedFileCounts `json:"counts"` +} + +func (entity *UpdateFileRemovedFromDownloads) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateFileRemovedFromDownloads + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateFileRemovedFromDownloads) GetClass() string { + return ClassUpdate +} + +func (*UpdateFileRemovedFromDownloads) GetType() string { + return TypeUpdateFileRemovedFromDownloads +} + +func (*UpdateFileRemovedFromDownloads) UpdateType() string { + return TypeUpdateFileRemovedFromDownloads +} + // New call was created or information about a call was updated type UpdateCall struct { meta @@ -31356,6 +32841,33 @@ func (*UpdateSavedAnimations) UpdateType() string { return TypeUpdateSavedAnimations } +// The list of saved notifications sounds was updated. This update may not be sent until information about a notification sound was requested for the first time +type UpdateSavedNotificationSounds struct { + meta + // The new list of identifiers of saved notification sounds + NotificationSoundIds []JsonInt64 `json:"notification_sound_ids"` +} + +func (entity *UpdateSavedNotificationSounds) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateSavedNotificationSounds + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateSavedNotificationSounds) GetClass() string { + return ClassUpdate +} + +func (*UpdateSavedNotificationSounds) GetType() string { + return TypeUpdateSavedNotificationSounds +} + +func (*UpdateSavedNotificationSounds) UpdateType() string { + return TypeUpdateSavedNotificationSounds +} + // The selected background has changed type UpdateSelectedBackground struct { meta @@ -31542,6 +33054,87 @@ func (*UpdateUsersNearby) UpdateType() string { return TypeUpdateUsersNearby } +// The list of bots added to attachment menu has changed +type UpdateAttachmentMenuBots struct { + meta + // The new list of bots added to attachment menu. The bots must be shown in attachment menu only in private chats. The bots must not be shown on scheduled messages screen + Bots []*AttachmentMenuBot `json:"bots"` +} + +func (entity *UpdateAttachmentMenuBots) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateAttachmentMenuBots + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateAttachmentMenuBots) GetClass() string { + return ClassUpdate +} + +func (*UpdateAttachmentMenuBots) GetType() string { + return TypeUpdateAttachmentMenuBots +} + +func (*UpdateAttachmentMenuBots) UpdateType() string { + return TypeUpdateAttachmentMenuBots +} + +// A message was sent by an opened web app, so the web app needs to be closed +type UpdateWebAppMessageSent struct { + meta + // Identifier of web app launch + WebAppLaunchId JsonInt64 `json:"web_app_launch_id"` +} + +func (entity *UpdateWebAppMessageSent) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateWebAppMessageSent + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateWebAppMessageSent) GetClass() string { + return ClassUpdate +} + +func (*UpdateWebAppMessageSent) GetType() string { + return TypeUpdateWebAppMessageSent +} + +func (*UpdateWebAppMessageSent) UpdateType() string { + return TypeUpdateWebAppMessageSent +} + +// The list of supported reactions has changed +type UpdateReactions struct { + meta + // The new list of supported reactions + Reactions []*Reaction `json:"reactions"` +} + +func (entity *UpdateReactions) MarshalJSON() ([]byte, error) { + entity.meta.Type = entity.GetType() + + type stub UpdateReactions + + return json.Marshal((*stub)(entity)) +} + +func (*UpdateReactions) GetClass() string { + return ClassUpdate +} + +func (*UpdateReactions) GetType() string { + return TypeUpdateReactions +} + +func (*UpdateReactions) UpdateType() string { + return TypeUpdateReactions +} + // The list of supported dice emojis has changed type UpdateDiceEmojis struct { meta @@ -31687,7 +33280,7 @@ type UpdateNewInlineQuery struct { SenderUserId int64 `json:"sender_user_id"` // User location; may be null UserLocation *Location `json:"user_location"` - // The type of the chat, from which the query originated; may be null if unknown + // The type of the chat from which the query originated; may be null if unknown ChatType ChatType `json:"chat_type"` // Text of the query Query string `json:"query"` @@ -31786,7 +33379,7 @@ type UpdateNewCallbackQuery struct { SenderUserId int64 `json:"sender_user_id"` // Identifier of the chat where the query was sent ChatId int64 `json:"chat_id"` - // Identifier of the message, from which the query originated + // Identifier of the message from which the query originated MessageId int64 `json:"message_id"` // Identifier that uniquely corresponds to the chat to which the message was sent ChatInstance JsonInt64 `json:"chat_instance"` @@ -31848,7 +33441,7 @@ type UpdateNewInlineCallbackQuery struct { Id JsonInt64 `json:"id"` // Identifier of the user who sent the query SenderUserId int64 `json:"sender_user_id"` - // Identifier of the inline message, from which the query originated + // Identifier of the inline message from which the query originated InlineMessageId string `json:"inline_message_id"` // An identifier uniquely corresponding to the chat a message was sent to ChatInstance JsonInt64 `json:"chat_instance"` diff --git a/client/unmarshaler.go b/client/unmarshaler.go index 74154a4..bfefaa5 100755 --- a/client/unmarshaler.go +++ b/client/unmarshaler.go @@ -163,20 +163,23 @@ func UnmarshalThumbnailFormat(data json.RawMessage) (ThumbnailFormat, error) { case TypeThumbnailFormatJpeg: return UnmarshalThumbnailFormatJpeg(data) - case TypeThumbnailFormatPng: - return UnmarshalThumbnailFormatPng(data) - - case TypeThumbnailFormatWebp: - return UnmarshalThumbnailFormatWebp(data) - case TypeThumbnailFormatGif: return UnmarshalThumbnailFormatGif(data) + case TypeThumbnailFormatMpeg4: + return UnmarshalThumbnailFormatMpeg4(data) + + case TypeThumbnailFormatPng: + return UnmarshalThumbnailFormatPng(data) + case TypeThumbnailFormatTgs: return UnmarshalThumbnailFormatTgs(data) - case TypeThumbnailFormatMpeg4: - return UnmarshalThumbnailFormatMpeg4(data) + case TypeThumbnailFormatWebm: + return UnmarshalThumbnailFormatWebm(data) + + case TypeThumbnailFormatWebp: + return UnmarshalThumbnailFormatWebp(data) default: return nil, fmt.Errorf("Error unmarshaling. Unknown type: " + meta.Type) @@ -237,6 +240,46 @@ func UnmarshalListOfMaskPoint(dataList []json.RawMessage) ([]MaskPoint, error) { return list, nil } +func UnmarshalStickerType(data json.RawMessage) (StickerType, error) { + var meta meta + + err := json.Unmarshal(data, &meta) + if err != nil { + return nil, err + } + + switch meta.Type { + case TypeStickerTypeStatic: + return UnmarshalStickerTypeStatic(data) + + case TypeStickerTypeAnimated: + return UnmarshalStickerTypeAnimated(data) + + case TypeStickerTypeVideo: + return UnmarshalStickerTypeVideo(data) + + case TypeStickerTypeMask: + return UnmarshalStickerTypeMask(data) + + default: + return nil, fmt.Errorf("Error unmarshaling. Unknown type: " + meta.Type) + } +} + +func UnmarshalListOfStickerType(dataList []json.RawMessage) ([]StickerType, error) { + list := []StickerType{} + + for _, data := range dataList { + entity, err := UnmarshalStickerType(data) + if err != nil { + return nil, err + } + list = append(list, entity) + } + + return list, nil +} + func UnmarshalPollType(data json.RawMessage) (PollType, error) { var meta meta @@ -895,6 +938,9 @@ func UnmarshalKeyboardButtonType(data json.RawMessage) (KeyboardButtonType, erro case TypeKeyboardButtonTypeRequestPoll: return UnmarshalKeyboardButtonTypeRequestPoll(data) + case TypeKeyboardButtonTypeWebApp: + return UnmarshalKeyboardButtonTypeWebApp(data) + default: return nil, fmt.Errorf("Error unmarshaling. Unknown type: " + meta.Type) } @@ -929,6 +975,9 @@ func UnmarshalInlineKeyboardButtonType(data json.RawMessage) (InlineKeyboardButt case TypeInlineKeyboardButtonTypeLoginUrl: return UnmarshalInlineKeyboardButtonTypeLoginUrl(data) + case TypeInlineKeyboardButtonTypeWebApp: + return UnmarshalInlineKeyboardButtonTypeWebApp(data) + case TypeInlineKeyboardButtonTypeCallback: return UnmarshalInlineKeyboardButtonTypeCallback(data) @@ -1803,6 +1852,12 @@ func UnmarshalMessageContent(data json.RawMessage) (MessageContent, error) { case TypeMessageWebsiteConnected: return UnmarshalMessageWebsiteConnected(data) + case TypeMessageWebAppDataSent: + return UnmarshalMessageWebAppDataSent(data) + + case TypeMessageWebAppDataReceived: + return UnmarshalMessageWebAppDataReceived(data) + case TypeMessagePassportDataSent: return UnmarshalMessagePassportDataSent(data) @@ -1879,6 +1934,9 @@ func UnmarshalTextEntityType(data json.RawMessage) (TextEntityType, error) { case TypeTextEntityTypeStrikethrough: return UnmarshalTextEntityTypeStrikethrough(data) + case TypeTextEntityTypeSpoiler: + return UnmarshalTextEntityTypeSpoiler(data) + case TypeTextEntityTypeCode: return UnmarshalTextEntityTypeCode(data) @@ -2068,12 +2126,6 @@ func UnmarshalSearchMessagesFilter(data json.RawMessage) (SearchMessagesFilter, case TypeSearchMessagesFilterChatPhoto: return UnmarshalSearchMessagesFilterChatPhoto(data) - case TypeSearchMessagesFilterCall: - return UnmarshalSearchMessagesFilterCall(data) - - case TypeSearchMessagesFilterMissedCall: - return UnmarshalSearchMessagesFilterMissedCall(data) - case TypeSearchMessagesFilterVideoNote: return UnmarshalSearchMessagesFilterVideoNote(data) @@ -2086,6 +2138,9 @@ func UnmarshalSearchMessagesFilter(data json.RawMessage) (SearchMessagesFilter, case TypeSearchMessagesFilterUnreadMention: return UnmarshalSearchMessagesFilterUnreadMention(data) + case TypeSearchMessagesFilterUnreadReaction: + return UnmarshalSearchMessagesFilterUnreadReaction(data) + case TypeSearchMessagesFilterFailedToSend: return UnmarshalSearchMessagesFilterFailedToSend(data) @@ -2659,15 +2714,15 @@ func UnmarshalChatEventAction(data json.RawMessage) (ChatEventAction, error) { case TypeChatEventMessageDeleted: return UnmarshalChatEventMessageDeleted(data) - case TypeChatEventPollStopped: - return UnmarshalChatEventPollStopped(data) - case TypeChatEventMessagePinned: return UnmarshalChatEventMessagePinned(data) case TypeChatEventMessageUnpinned: return UnmarshalChatEventMessageUnpinned(data) + case TypeChatEventPollStopped: + return UnmarshalChatEventPollStopped(data) + case TypeChatEventMemberJoined: return UnmarshalChatEventMemberJoined(data) @@ -2677,60 +2732,63 @@ func UnmarshalChatEventAction(data json.RawMessage) (ChatEventAction, error) { case TypeChatEventMemberJoinedByRequest: return UnmarshalChatEventMemberJoinedByRequest(data) - case TypeChatEventMemberLeft: - return UnmarshalChatEventMemberLeft(data) - case TypeChatEventMemberInvited: return UnmarshalChatEventMemberInvited(data) + case TypeChatEventMemberLeft: + return UnmarshalChatEventMemberLeft(data) + case TypeChatEventMemberPromoted: return UnmarshalChatEventMemberPromoted(data) case TypeChatEventMemberRestricted: return UnmarshalChatEventMemberRestricted(data) - case TypeChatEventTitleChanged: - return UnmarshalChatEventTitleChanged(data) - - case TypeChatEventPermissionsChanged: - return UnmarshalChatEventPermissionsChanged(data) + case TypeChatEventAvailableReactionsChanged: + return UnmarshalChatEventAvailableReactionsChanged(data) case TypeChatEventDescriptionChanged: return UnmarshalChatEventDescriptionChanged(data) - case TypeChatEventUsernameChanged: - return UnmarshalChatEventUsernameChanged(data) - - case TypeChatEventPhotoChanged: - return UnmarshalChatEventPhotoChanged(data) - - case TypeChatEventInvitesToggled: - return UnmarshalChatEventInvitesToggled(data) - case TypeChatEventLinkedChatChanged: return UnmarshalChatEventLinkedChatChanged(data) - case TypeChatEventSlowModeDelayChanged: - return UnmarshalChatEventSlowModeDelayChanged(data) - - case TypeChatEventMessageTtlSettingChanged: - return UnmarshalChatEventMessageTtlSettingChanged(data) - - case TypeChatEventSignMessagesToggled: - return UnmarshalChatEventSignMessagesToggled(data) - - case TypeChatEventHasProtectedContentToggled: - return UnmarshalChatEventHasProtectedContentToggled(data) - - case TypeChatEventStickerSetChanged: - return UnmarshalChatEventStickerSetChanged(data) - case TypeChatEventLocationChanged: return UnmarshalChatEventLocationChanged(data) + case TypeChatEventMessageTtlChanged: + return UnmarshalChatEventMessageTtlChanged(data) + + case TypeChatEventPermissionsChanged: + return UnmarshalChatEventPermissionsChanged(data) + + case TypeChatEventPhotoChanged: + return UnmarshalChatEventPhotoChanged(data) + + case TypeChatEventSlowModeDelayChanged: + return UnmarshalChatEventSlowModeDelayChanged(data) + + case TypeChatEventStickerSetChanged: + return UnmarshalChatEventStickerSetChanged(data) + + case TypeChatEventTitleChanged: + return UnmarshalChatEventTitleChanged(data) + + case TypeChatEventUsernameChanged: + return UnmarshalChatEventUsernameChanged(data) + + case TypeChatEventHasProtectedContentToggled: + return UnmarshalChatEventHasProtectedContentToggled(data) + + case TypeChatEventInvitesToggled: + return UnmarshalChatEventInvitesToggled(data) + case TypeChatEventIsAllHistoryAvailableToggled: return UnmarshalChatEventIsAllHistoryAvailableToggled(data) + case TypeChatEventSignMessagesToggled: + return UnmarshalChatEventSignMessagesToggled(data) + case TypeChatEventInviteLinkEdited: return UnmarshalChatEventInviteLinkEdited(data) @@ -2743,8 +2801,11 @@ func UnmarshalChatEventAction(data json.RawMessage) (ChatEventAction, error) { case TypeChatEventVideoChatCreated: return UnmarshalChatEventVideoChatCreated(data) - case TypeChatEventVideoChatDiscarded: - return UnmarshalChatEventVideoChatDiscarded(data) + case TypeChatEventVideoChatEnded: + return UnmarshalChatEventVideoChatEnded(data) + + case TypeChatEventVideoChatMuteNewParticipantsToggled: + return UnmarshalChatEventVideoChatMuteNewParticipantsToggled(data) case TypeChatEventVideoChatParticipantIsMutedToggled: return UnmarshalChatEventVideoChatParticipantIsMutedToggled(data) @@ -2752,9 +2813,6 @@ func UnmarshalChatEventAction(data json.RawMessage) (ChatEventAction, error) { case TypeChatEventVideoChatParticipantVolumeLevelChanged: return UnmarshalChatEventVideoChatParticipantVolumeLevelChanged(data) - case TypeChatEventVideoChatMuteNewParticipantsToggled: - return UnmarshalChatEventVideoChatMuteNewParticipantsToggled(data) - default: return nil, fmt.Errorf("Error unmarshaling. Unknown type: " + meta.Type) } @@ -3586,6 +3644,12 @@ func UnmarshalChatReportReason(data json.RawMessage) (ChatReportReason, error) { case TypeChatReportReasonFake: return UnmarshalChatReportReasonFake(data) + case TypeChatReportReasonIllegalDrugs: + return UnmarshalChatReportReasonIllegalDrugs(data) + + case TypeChatReportReasonPersonalDetails: + return UnmarshalChatReportReasonPersonalDetails(data) + case TypeChatReportReasonCustom: return UnmarshalChatReportReasonCustom(data) @@ -3620,6 +3684,9 @@ func UnmarshalInternalLinkType(data json.RawMessage) (InternalLinkType, error) { case TypeInternalLinkTypeActiveSessions: return UnmarshalInternalLinkTypeActiveSessions(data) + case TypeInternalLinkTypeAttachmentMenuBot: + return UnmarshalInternalLinkTypeAttachmentMenuBot(data) + case TypeInternalLinkTypeAuthenticationCode: return UnmarshalInternalLinkTypeAuthenticationCode(data) @@ -3632,6 +3699,9 @@ func UnmarshalInternalLinkType(data json.RawMessage) (InternalLinkType, error) { case TypeInternalLinkTypeBotStartInGroup: return UnmarshalInternalLinkTypeBotStartInGroup(data) + case TypeInternalLinkTypeBotAddToChannel: + return UnmarshalInternalLinkTypeBotAddToChannel(data) + case TypeInternalLinkTypeChangePhoneNumber: return UnmarshalInternalLinkTypeChangePhoneNumber(data) @@ -3647,6 +3717,9 @@ func UnmarshalInternalLinkType(data json.RawMessage) (InternalLinkType, error) { case TypeInternalLinkTypeLanguagePack: return UnmarshalInternalLinkTypeLanguagePack(data) + case TypeInternalLinkTypeLanguageSettings: + return UnmarshalInternalLinkTypeLanguageSettings(data) + case TypeInternalLinkTypeMessage: return UnmarshalInternalLinkTypeMessage(data) @@ -3659,6 +3732,9 @@ func UnmarshalInternalLinkType(data json.RawMessage) (InternalLinkType, error) { case TypeInternalLinkTypePhoneNumberConfirmation: return UnmarshalInternalLinkTypePhoneNumberConfirmation(data) + case TypeInternalLinkTypePrivacyAndSecuritySettings: + return UnmarshalInternalLinkTypePrivacyAndSecuritySettings(data) + case TypeInternalLinkTypeProxy: return UnmarshalInternalLinkTypeProxy(data) @@ -3686,6 +3762,9 @@ func UnmarshalInternalLinkType(data json.RawMessage) (InternalLinkType, error) { case TypeInternalLinkTypeUnsupportedProxy: return UnmarshalInternalLinkTypeUnsupportedProxy(data) + case TypeInternalLinkTypeUserPhoneNumber: + return UnmarshalInternalLinkTypeUserPhoneNumber(data) + case TypeInternalLinkTypeVideoChat: return UnmarshalInternalLinkTypeVideoChat(data) @@ -3729,6 +3808,9 @@ func UnmarshalFileType(data json.RawMessage) (FileType, error) { case TypeFileTypeDocument: return UnmarshalFileTypeDocument(data) + case TypeFileTypeNotificationSound: + return UnmarshalFileTypeNotificationSound(data) + case TypeFileTypePhoto: return UnmarshalFileTypePhoto(data) @@ -4011,8 +4093,8 @@ func UnmarshalSuggestedAction(data json.RawMessage) (SuggestedAction, error) { case TypeSuggestedActionCheckPhoneNumber: return UnmarshalSuggestedActionCheckPhoneNumber(data) - case TypeSuggestedActionSeeTicksHint: - return UnmarshalSuggestedActionSeeTicksHint(data) + case TypeSuggestedActionViewChecksHint: + return UnmarshalSuggestedActionViewChecksHint(data) case TypeSuggestedActionConvertToBroadcastGroup: return UnmarshalSuggestedActionConvertToBroadcastGroup(data) @@ -4110,40 +4192,6 @@ func UnmarshalListOfProxyType(dataList []json.RawMessage) ([]ProxyType, error) { return list, nil } -func UnmarshalInputSticker(data json.RawMessage) (InputSticker, error) { - var meta meta - - err := json.Unmarshal(data, &meta) - if err != nil { - return nil, err - } - - switch meta.Type { - case TypeInputStickerStatic: - return UnmarshalInputStickerStatic(data) - - case TypeInputStickerAnimated: - return UnmarshalInputStickerAnimated(data) - - default: - return nil, fmt.Errorf("Error unmarshaling. Unknown type: " + meta.Type) - } -} - -func UnmarshalListOfInputSticker(dataList []json.RawMessage) ([]InputSticker, error) { - list := []InputSticker{} - - for _, data := range dataList { - entity, err := UnmarshalInputSticker(data) - if err != nil { - return nil, err - } - list = append(list, entity) - } - - return list, nil -} - func UnmarshalStatisticalGraph(data json.RawMessage) (StatisticalGraph, error) { var meta meta @@ -4340,6 +4388,9 @@ func UnmarshalUpdate(data json.RawMessage) (Update, error) { case TypeUpdateMessageMentionRead: return UnmarshalUpdateMessageMentionRead(data) + case TypeUpdateMessageUnreadReactions: + return UnmarshalUpdateMessageUnreadReactions(data) + case TypeUpdateMessageLiveLocationViewed: return UnmarshalUpdateMessageLiveLocationViewed(data) @@ -4361,50 +4412,29 @@ func UnmarshalUpdate(data json.RawMessage) (Update, error) { case TypeUpdateChatPosition: return UnmarshalUpdateChatPosition(data) - case TypeUpdateChatDefaultMessageSenderId: - return UnmarshalUpdateChatDefaultMessageSenderId(data) - - case TypeUpdateChatHasProtectedContent: - return UnmarshalUpdateChatHasProtectedContent(data) - - case TypeUpdateChatIsMarkedAsUnread: - return UnmarshalUpdateChatIsMarkedAsUnread(data) - - case TypeUpdateChatIsBlocked: - return UnmarshalUpdateChatIsBlocked(data) - - case TypeUpdateChatHasScheduledMessages: - return UnmarshalUpdateChatHasScheduledMessages(data) - - case TypeUpdateChatVideoChat: - return UnmarshalUpdateChatVideoChat(data) - - case TypeUpdateChatDefaultDisableNotification: - return UnmarshalUpdateChatDefaultDisableNotification(data) - case TypeUpdateChatReadInbox: return UnmarshalUpdateChatReadInbox(data) case TypeUpdateChatReadOutbox: return UnmarshalUpdateChatReadOutbox(data) - case TypeUpdateChatUnreadMentionCount: - return UnmarshalUpdateChatUnreadMentionCount(data) - - case TypeUpdateChatNotificationSettings: - return UnmarshalUpdateChatNotificationSettings(data) - - case TypeUpdateScopeNotificationSettings: - return UnmarshalUpdateScopeNotificationSettings(data) - - case TypeUpdateChatMessageTtlSetting: - return UnmarshalUpdateChatMessageTtlSetting(data) - case TypeUpdateChatActionBar: return UnmarshalUpdateChatActionBar(data) - case TypeUpdateChatTheme: - return UnmarshalUpdateChatTheme(data) + case TypeUpdateChatAvailableReactions: + return UnmarshalUpdateChatAvailableReactions(data) + + case TypeUpdateChatDraftMessage: + return UnmarshalUpdateChatDraftMessage(data) + + case TypeUpdateChatMessageSender: + return UnmarshalUpdateChatMessageSender(data) + + case TypeUpdateChatMessageTtl: + return UnmarshalUpdateChatMessageTtl(data) + + case TypeUpdateChatNotificationSettings: + return UnmarshalUpdateChatNotificationSettings(data) case TypeUpdateChatPendingJoinRequests: return UnmarshalUpdateChatPendingJoinRequests(data) @@ -4412,8 +4442,32 @@ func UnmarshalUpdate(data json.RawMessage) (Update, error) { case TypeUpdateChatReplyMarkup: return UnmarshalUpdateChatReplyMarkup(data) - case TypeUpdateChatDraftMessage: - return UnmarshalUpdateChatDraftMessage(data) + case TypeUpdateChatTheme: + return UnmarshalUpdateChatTheme(data) + + case TypeUpdateChatUnreadMentionCount: + return UnmarshalUpdateChatUnreadMentionCount(data) + + case TypeUpdateChatUnreadReactionCount: + return UnmarshalUpdateChatUnreadReactionCount(data) + + case TypeUpdateChatVideoChat: + return UnmarshalUpdateChatVideoChat(data) + + case TypeUpdateChatDefaultDisableNotification: + return UnmarshalUpdateChatDefaultDisableNotification(data) + + case TypeUpdateChatHasProtectedContent: + return UnmarshalUpdateChatHasProtectedContent(data) + + case TypeUpdateChatHasScheduledMessages: + return UnmarshalUpdateChatHasScheduledMessages(data) + + case TypeUpdateChatIsBlocked: + return UnmarshalUpdateChatIsBlocked(data) + + case TypeUpdateChatIsMarkedAsUnread: + return UnmarshalUpdateChatIsMarkedAsUnread(data) case TypeUpdateChatFilters: return UnmarshalUpdateChatFilters(data) @@ -4421,6 +4475,9 @@ func UnmarshalUpdate(data json.RawMessage) (Update, error) { case TypeUpdateChatOnlineMemberCount: return UnmarshalUpdateChatOnlineMemberCount(data) + case TypeUpdateScopeNotificationSettings: + return UnmarshalUpdateScopeNotificationSettings(data) + case TypeUpdateNotification: return UnmarshalUpdateNotification(data) @@ -4475,6 +4532,18 @@ func UnmarshalUpdate(data json.RawMessage) (Update, error) { case TypeUpdateFileGenerationStop: return UnmarshalUpdateFileGenerationStop(data) + case TypeUpdateFileDownloads: + return UnmarshalUpdateFileDownloads(data) + + case TypeUpdateFileAddedToDownloads: + return UnmarshalUpdateFileAddedToDownloads(data) + + case TypeUpdateFileDownload: + return UnmarshalUpdateFileDownload(data) + + case TypeUpdateFileRemovedFromDownloads: + return UnmarshalUpdateFileRemovedFromDownloads(data) + case TypeUpdateCall: return UnmarshalUpdateCall(data) @@ -4517,6 +4586,9 @@ func UnmarshalUpdate(data json.RawMessage) (Update, error) { case TypeUpdateSavedAnimations: return UnmarshalUpdateSavedAnimations(data) + case TypeUpdateSavedNotificationSounds: + return UnmarshalUpdateSavedNotificationSounds(data) + case TypeUpdateSelectedBackground: return UnmarshalUpdateSelectedBackground(data) @@ -4535,6 +4607,15 @@ func UnmarshalUpdate(data json.RawMessage) (Update, error) { case TypeUpdateUsersNearby: return UnmarshalUpdateUsersNearby(data) + case TypeUpdateAttachmentMenuBots: + return UnmarshalUpdateAttachmentMenuBots(data) + + case TypeUpdateWebAppMessageSent: + return UnmarshalUpdateWebAppMessageSent(data) + + case TypeUpdateReactions: + return UnmarshalUpdateReactions(data) + case TypeUpdateDiceEmojis: return UnmarshalUpdateDiceEmojis(data) @@ -4943,22 +5024,6 @@ func UnmarshalThumbnailFormatJpeg(data json.RawMessage) (*ThumbnailFormatJpeg, e return &resp, err } -func UnmarshalThumbnailFormatPng(data json.RawMessage) (*ThumbnailFormatPng, error) { - var resp ThumbnailFormatPng - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalThumbnailFormatWebp(data json.RawMessage) (*ThumbnailFormatWebp, error) { - var resp ThumbnailFormatWebp - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - func UnmarshalThumbnailFormatGif(data json.RawMessage) (*ThumbnailFormatGif, error) { var resp ThumbnailFormatGif @@ -4967,6 +5032,22 @@ func UnmarshalThumbnailFormatGif(data json.RawMessage) (*ThumbnailFormatGif, err return &resp, err } +func UnmarshalThumbnailFormatMpeg4(data json.RawMessage) (*ThumbnailFormatMpeg4, error) { + var resp ThumbnailFormatMpeg4 + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalThumbnailFormatPng(data json.RawMessage) (*ThumbnailFormatPng, error) { + var resp ThumbnailFormatPng + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalThumbnailFormatTgs(data json.RawMessage) (*ThumbnailFormatTgs, error) { var resp ThumbnailFormatTgs @@ -4975,8 +5056,16 @@ func UnmarshalThumbnailFormatTgs(data json.RawMessage) (*ThumbnailFormatTgs, err return &resp, err } -func UnmarshalThumbnailFormatMpeg4(data json.RawMessage) (*ThumbnailFormatMpeg4, error) { - var resp ThumbnailFormatMpeg4 +func UnmarshalThumbnailFormatWebm(data json.RawMessage) (*ThumbnailFormatWebm, error) { + var resp ThumbnailFormatWebm + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalThumbnailFormatWebp(data json.RawMessage) (*ThumbnailFormatWebp, error) { + var resp ThumbnailFormatWebp err := json.Unmarshal(data, &resp) @@ -5031,6 +5120,38 @@ func UnmarshalMaskPosition(data json.RawMessage) (*MaskPosition, error) { return &resp, err } +func UnmarshalStickerTypeStatic(data json.RawMessage) (*StickerTypeStatic, error) { + var resp StickerTypeStatic + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalStickerTypeAnimated(data json.RawMessage) (*StickerTypeAnimated, error) { + var resp StickerTypeAnimated + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalStickerTypeVideo(data json.RawMessage) (*StickerTypeVideo, error) { + var resp StickerTypeVideo + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalStickerTypeMask(data json.RawMessage) (*StickerTypeMask, error) { + var resp StickerTypeMask + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalClosedVectorPath(data json.RawMessage) (*ClosedVectorPath, error) { var resp ClosedVectorPath @@ -5239,6 +5360,14 @@ func UnmarshalBotCommands(data json.RawMessage) (*BotCommands, error) { return &resp, err } +func UnmarshalBotMenuButton(data json.RawMessage) (*BotMenuButton, error) { + var resp BotMenuButton + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalChatLocation(data json.RawMessage) (*ChatLocation, error) { var resp ChatLocation @@ -5295,6 +5424,22 @@ func UnmarshalInputChatPhotoAnimation(data json.RawMessage) (*InputChatPhotoAnim return &resp, err } +func UnmarshalChatPermissions(data json.RawMessage) (*ChatPermissions, error) { + var resp ChatPermissions + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalChatAdministratorRights(data json.RawMessage) (*ChatAdministratorRights, error) { + var resp ChatAdministratorRights + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalUser(data json.RawMessage) (*User, error) { var resp User @@ -5303,6 +5448,14 @@ func UnmarshalUser(data json.RawMessage) (*User, error) { return &resp, err } +func UnmarshalBotInfo(data json.RawMessage) (*BotInfo, error) { + var resp BotInfo + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalUserFullInfo(data json.RawMessage) (*UserFullInfo, error) { var resp UserFullInfo @@ -5335,14 +5488,6 @@ func UnmarshalChatAdministrators(data json.RawMessage) (*ChatAdministrators, err return &resp, err } -func UnmarshalChatPermissions(data json.RawMessage) (*ChatPermissions, error) { - var resp ChatPermissions - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - func UnmarshalChatMemberStatusCreator(data json.RawMessage) (*ChatMemberStatusCreator, error) { var resp ChatMemberStatusCreator @@ -5751,6 +5896,14 @@ func UnmarshalMessageReplyInfo(data json.RawMessage) (*MessageReplyInfo, error) return &resp, err } +func UnmarshalMessageReaction(data json.RawMessage) (*MessageReaction, error) { + var resp MessageReaction + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalMessageInteractionInfo(data json.RawMessage) (*MessageInteractionInfo, error) { var resp MessageInteractionInfo @@ -5759,6 +5912,14 @@ func UnmarshalMessageInteractionInfo(data json.RawMessage) (*MessageInteractionI return &resp, err } +func UnmarshalUnreadReaction(data json.RawMessage) (*UnreadReaction, error) { + var resp UnreadReaction + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalMessageSendingStatePending(data json.RawMessage) (*MessageSendingStatePending, error) { var resp MessageSendingStatePending @@ -5839,8 +6000,24 @@ func UnmarshalSponsoredMessage(data json.RawMessage) (*SponsoredMessage, error) return &resp, err } -func UnmarshalSponsoredMessages(data json.RawMessage) (*SponsoredMessages, error) { - var resp SponsoredMessages +func UnmarshalFileDownload(data json.RawMessage) (*FileDownload, error) { + var resp FileDownload + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalDownloadedFileCounts(data json.RawMessage) (*DownloadedFileCounts, error) { + var resp DownloadedFileCounts + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalFoundFileDownloads(data json.RawMessage) (*FoundFileDownloads, error) { + var resp FoundFileDownloads err := json.Unmarshal(data, &resp) @@ -6159,6 +6336,14 @@ func UnmarshalKeyboardButtonTypeRequestPoll(data json.RawMessage) (*KeyboardButt return &resp, err } +func UnmarshalKeyboardButtonTypeWebApp(data json.RawMessage) (*KeyboardButtonTypeWebApp, error) { + var resp KeyboardButtonTypeWebApp + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalKeyboardButton(data json.RawMessage) (*KeyboardButton, error) { var resp KeyboardButton @@ -6183,6 +6368,14 @@ func UnmarshalInlineKeyboardButtonTypeLoginUrl(data json.RawMessage) (*InlineKey return &resp, err } +func UnmarshalInlineKeyboardButtonTypeWebApp(data json.RawMessage) (*InlineKeyboardButtonTypeWebApp, error) { + var resp InlineKeyboardButtonTypeWebApp + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalInlineKeyboardButtonTypeCallback(data json.RawMessage) (*InlineKeyboardButtonTypeCallback, error) { var resp InlineKeyboardButtonTypeCallback @@ -6287,6 +6480,14 @@ func UnmarshalLoginUrlInfoRequestConfirmation(data json.RawMessage) (*LoginUrlIn return &resp, err } +func UnmarshalWebAppInfo(data json.RawMessage) (*WebAppInfo, error) { + var resp WebAppInfo + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalMessageThreadInfo(data json.RawMessage) (*MessageThreadInfo, error) { var resp MessageThreadInfo @@ -6807,6 +7008,14 @@ func UnmarshalAddress(data json.RawMessage) (*Address, error) { return &resp, err } +func UnmarshalThemeParameters(data json.RawMessage) (*ThemeParameters, error) { + var resp ThemeParameters + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalLabeledPricePart(data json.RawMessage) (*LabeledPricePart, error) { var resp LabeledPricePart @@ -6887,14 +7096,6 @@ func UnmarshalPaymentsProviderStripe(data json.RawMessage) (*PaymentsProviderStr return &resp, err } -func UnmarshalPaymentFormTheme(data json.RawMessage) (*PaymentFormTheme, error) { - var resp PaymentFormTheme - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - func UnmarshalPaymentForm(data json.RawMessage) (*PaymentForm, error) { var resp PaymentForm @@ -7871,6 +8072,22 @@ func UnmarshalMessageWebsiteConnected(data json.RawMessage) (*MessageWebsiteConn return &resp, err } +func UnmarshalMessageWebAppDataSent(data json.RawMessage) (*MessageWebAppDataSent, error) { + var resp MessageWebAppDataSent + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalMessageWebAppDataReceived(data json.RawMessage) (*MessageWebAppDataReceived, error) { + var resp MessageWebAppDataReceived + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalMessagePassportDataSent(data json.RawMessage) (*MessagePassportDataSent, error) { var resp MessagePassportDataSent @@ -7999,6 +8216,14 @@ func UnmarshalTextEntityTypeStrikethrough(data json.RawMessage) (*TextEntityType return &resp, err } +func UnmarshalTextEntityTypeSpoiler(data json.RawMessage) (*TextEntityTypeSpoiler, error) { + var resp TextEntityTypeSpoiler + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalTextEntityTypeCode(data json.RawMessage) (*TextEntityTypeCode, error) { var resp TextEntityTypeCode @@ -8303,22 +8528,6 @@ func UnmarshalSearchMessagesFilterChatPhoto(data json.RawMessage) (*SearchMessag return &resp, err } -func UnmarshalSearchMessagesFilterCall(data json.RawMessage) (*SearchMessagesFilterCall, error) { - var resp SearchMessagesFilterCall - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalSearchMessagesFilterMissedCall(data json.RawMessage) (*SearchMessagesFilterMissedCall, error) { - var resp SearchMessagesFilterMissedCall - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - func UnmarshalSearchMessagesFilterVideoNote(data json.RawMessage) (*SearchMessagesFilterVideoNote, error) { var resp SearchMessagesFilterVideoNote @@ -8351,6 +8560,14 @@ func UnmarshalSearchMessagesFilterUnreadMention(data json.RawMessage) (*SearchMe return &resp, err } +func UnmarshalSearchMessagesFilterUnreadReaction(data json.RawMessage) (*SearchMessagesFilterUnreadReaction, error) { + var resp SearchMessagesFilterUnreadReaction + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalSearchMessagesFilterFailedToSend(data json.RawMessage) (*SearchMessagesFilterFailedToSend, error) { var resp SearchMessagesFilterFailedToSend @@ -8735,6 +8952,30 @@ func UnmarshalGroupCallVideoQualityFull(data json.RawMessage) (*GroupCallVideoQu return &resp, err } +func UnmarshalGroupCallStream(data json.RawMessage) (*GroupCallStream, error) { + var resp GroupCallStream + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalGroupCallStreams(data json.RawMessage) (*GroupCallStreams, error) { + var resp GroupCallStreams + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalRtmpUrl(data json.RawMessage) (*RtmpUrl, error) { + var resp RtmpUrl + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalGroupCallRecentSpeaker(data json.RawMessage) (*GroupCallRecentSpeaker, error) { var resp GroupCallRecentSpeaker @@ -8863,6 +9104,38 @@ func UnmarshalPhoneNumberAuthenticationSettings(data json.RawMessage) (*PhoneNum return &resp, err } +func UnmarshalAddedReaction(data json.RawMessage) (*AddedReaction, error) { + var resp AddedReaction + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalAddedReactions(data json.RawMessage) (*AddedReactions, error) { + var resp AddedReactions + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalAvailableReactions(data json.RawMessage) (*AvailableReactions, error) { + var resp AvailableReactions + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalReaction(data json.RawMessage) (*Reaction, error) { + var resp Reaction + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalAnimations(data json.RawMessage) (*Animations, error) { var resp Animations @@ -8895,6 +9168,30 @@ func UnmarshalImportedContacts(data json.RawMessage) (*ImportedContacts, error) return &resp, err } +func UnmarshalAttachmentMenuBotColor(data json.RawMessage) (*AttachmentMenuBotColor, error) { + var resp AttachmentMenuBotColor + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalAttachmentMenuBot(data json.RawMessage) (*AttachmentMenuBot, error) { + var resp AttachmentMenuBot + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalSentWebAppMessage(data json.RawMessage) (*SentWebAppMessage, error) { + var resp SentWebAppMessage + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalHttpUrl(data json.RawMessage) (*HttpUrl, error) { var resp HttpUrl @@ -9175,14 +9472,6 @@ func UnmarshalChatEventMessageDeleted(data json.RawMessage) (*ChatEventMessageDe return &resp, err } -func UnmarshalChatEventPollStopped(data json.RawMessage) (*ChatEventPollStopped, error) { - var resp ChatEventPollStopped - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - func UnmarshalChatEventMessagePinned(data json.RawMessage) (*ChatEventMessagePinned, error) { var resp ChatEventMessagePinned @@ -9199,6 +9488,14 @@ func UnmarshalChatEventMessageUnpinned(data json.RawMessage) (*ChatEventMessageU return &resp, err } +func UnmarshalChatEventPollStopped(data json.RawMessage) (*ChatEventPollStopped, error) { + var resp ChatEventPollStopped + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalChatEventMemberJoined(data json.RawMessage) (*ChatEventMemberJoined, error) { var resp ChatEventMemberJoined @@ -9223,16 +9520,16 @@ func UnmarshalChatEventMemberJoinedByRequest(data json.RawMessage) (*ChatEventMe return &resp, err } -func UnmarshalChatEventMemberLeft(data json.RawMessage) (*ChatEventMemberLeft, error) { - var resp ChatEventMemberLeft +func UnmarshalChatEventMemberInvited(data json.RawMessage) (*ChatEventMemberInvited, error) { + var resp ChatEventMemberInvited err := json.Unmarshal(data, &resp) return &resp, err } -func UnmarshalChatEventMemberInvited(data json.RawMessage) (*ChatEventMemberInvited, error) { - var resp ChatEventMemberInvited +func UnmarshalChatEventMemberLeft(data json.RawMessage) (*ChatEventMemberLeft, error) { + var resp ChatEventMemberLeft err := json.Unmarshal(data, &resp) @@ -9255,16 +9552,8 @@ func UnmarshalChatEventMemberRestricted(data json.RawMessage) (*ChatEventMemberR return &resp, err } -func UnmarshalChatEventTitleChanged(data json.RawMessage) (*ChatEventTitleChanged, error) { - var resp ChatEventTitleChanged - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalChatEventPermissionsChanged(data json.RawMessage) (*ChatEventPermissionsChanged, error) { - var resp ChatEventPermissionsChanged +func UnmarshalChatEventAvailableReactionsChanged(data json.RawMessage) (*ChatEventAvailableReactionsChanged, error) { + var resp ChatEventAvailableReactionsChanged err := json.Unmarshal(data, &resp) @@ -9279,30 +9568,6 @@ func UnmarshalChatEventDescriptionChanged(data json.RawMessage) (*ChatEventDescr return &resp, err } -func UnmarshalChatEventUsernameChanged(data json.RawMessage) (*ChatEventUsernameChanged, error) { - var resp ChatEventUsernameChanged - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalChatEventPhotoChanged(data json.RawMessage) (*ChatEventPhotoChanged, error) { - var resp ChatEventPhotoChanged - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalChatEventInvitesToggled(data json.RawMessage) (*ChatEventInvitesToggled, error) { - var resp ChatEventInvitesToggled - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - func UnmarshalChatEventLinkedChatChanged(data json.RawMessage) (*ChatEventLinkedChatChanged, error) { var resp ChatEventLinkedChatChanged @@ -9311,46 +9576,6 @@ func UnmarshalChatEventLinkedChatChanged(data json.RawMessage) (*ChatEventLinked return &resp, err } -func UnmarshalChatEventSlowModeDelayChanged(data json.RawMessage) (*ChatEventSlowModeDelayChanged, error) { - var resp ChatEventSlowModeDelayChanged - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalChatEventMessageTtlSettingChanged(data json.RawMessage) (*ChatEventMessageTtlSettingChanged, error) { - var resp ChatEventMessageTtlSettingChanged - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalChatEventSignMessagesToggled(data json.RawMessage) (*ChatEventSignMessagesToggled, error) { - var resp ChatEventSignMessagesToggled - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalChatEventHasProtectedContentToggled(data json.RawMessage) (*ChatEventHasProtectedContentToggled, error) { - var resp ChatEventHasProtectedContentToggled - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalChatEventStickerSetChanged(data json.RawMessage) (*ChatEventStickerSetChanged, error) { - var resp ChatEventStickerSetChanged - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - func UnmarshalChatEventLocationChanged(data json.RawMessage) (*ChatEventLocationChanged, error) { var resp ChatEventLocationChanged @@ -9359,6 +9584,78 @@ func UnmarshalChatEventLocationChanged(data json.RawMessage) (*ChatEventLocation return &resp, err } +func UnmarshalChatEventMessageTtlChanged(data json.RawMessage) (*ChatEventMessageTtlChanged, error) { + var resp ChatEventMessageTtlChanged + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalChatEventPermissionsChanged(data json.RawMessage) (*ChatEventPermissionsChanged, error) { + var resp ChatEventPermissionsChanged + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalChatEventPhotoChanged(data json.RawMessage) (*ChatEventPhotoChanged, error) { + var resp ChatEventPhotoChanged + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalChatEventSlowModeDelayChanged(data json.RawMessage) (*ChatEventSlowModeDelayChanged, error) { + var resp ChatEventSlowModeDelayChanged + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalChatEventStickerSetChanged(data json.RawMessage) (*ChatEventStickerSetChanged, error) { + var resp ChatEventStickerSetChanged + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalChatEventTitleChanged(data json.RawMessage) (*ChatEventTitleChanged, error) { + var resp ChatEventTitleChanged + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalChatEventUsernameChanged(data json.RawMessage) (*ChatEventUsernameChanged, error) { + var resp ChatEventUsernameChanged + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalChatEventHasProtectedContentToggled(data json.RawMessage) (*ChatEventHasProtectedContentToggled, error) { + var resp ChatEventHasProtectedContentToggled + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalChatEventInvitesToggled(data json.RawMessage) (*ChatEventInvitesToggled, error) { + var resp ChatEventInvitesToggled + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalChatEventIsAllHistoryAvailableToggled(data json.RawMessage) (*ChatEventIsAllHistoryAvailableToggled, error) { var resp ChatEventIsAllHistoryAvailableToggled @@ -9367,6 +9664,14 @@ func UnmarshalChatEventIsAllHistoryAvailableToggled(data json.RawMessage) (*Chat return &resp, err } +func UnmarshalChatEventSignMessagesToggled(data json.RawMessage) (*ChatEventSignMessagesToggled, error) { + var resp ChatEventSignMessagesToggled + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalChatEventInviteLinkEdited(data json.RawMessage) (*ChatEventInviteLinkEdited, error) { var resp ChatEventInviteLinkEdited @@ -9399,8 +9704,16 @@ func UnmarshalChatEventVideoChatCreated(data json.RawMessage) (*ChatEventVideoCh return &resp, err } -func UnmarshalChatEventVideoChatDiscarded(data json.RawMessage) (*ChatEventVideoChatDiscarded, error) { - var resp ChatEventVideoChatDiscarded +func UnmarshalChatEventVideoChatEnded(data json.RawMessage) (*ChatEventVideoChatEnded, error) { + var resp ChatEventVideoChatEnded + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalChatEventVideoChatMuteNewParticipantsToggled(data json.RawMessage) (*ChatEventVideoChatMuteNewParticipantsToggled, error) { + var resp ChatEventVideoChatMuteNewParticipantsToggled err := json.Unmarshal(data, &resp) @@ -9423,14 +9736,6 @@ func UnmarshalChatEventVideoChatParticipantVolumeLevelChanged(data json.RawMessa return &resp, err } -func UnmarshalChatEventVideoChatMuteNewParticipantsToggled(data json.RawMessage) (*ChatEventVideoChatMuteNewParticipantsToggled, error) { - var resp ChatEventVideoChatMuteNewParticipantsToggled - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - func UnmarshalChatEvent(data json.RawMessage) (*ChatEvent, error) { var resp ChatEvent @@ -10143,6 +10448,22 @@ func UnmarshalNotificationGroupTypeCalls(data json.RawMessage) (*NotificationGro return &resp, err } +func UnmarshalNotificationSound(data json.RawMessage) (*NotificationSound, error) { + var resp NotificationSound + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalNotificationSounds(data json.RawMessage) (*NotificationSounds, error) { + var resp NotificationSounds + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalNotification(data json.RawMessage) (*Notification, error) { var resp Notification @@ -10479,6 +10800,22 @@ func UnmarshalChatReportReasonFake(data json.RawMessage) (*ChatReportReasonFake, return &resp, err } +func UnmarshalChatReportReasonIllegalDrugs(data json.RawMessage) (*ChatReportReasonIllegalDrugs, error) { + var resp ChatReportReasonIllegalDrugs + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalChatReportReasonPersonalDetails(data json.RawMessage) (*ChatReportReasonPersonalDetails, error) { + var resp ChatReportReasonPersonalDetails + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalChatReportReasonCustom(data json.RawMessage) (*ChatReportReasonCustom, error) { var resp ChatReportReasonCustom @@ -10495,6 +10832,14 @@ func UnmarshalInternalLinkTypeActiveSessions(data json.RawMessage) (*InternalLin return &resp, err } +func UnmarshalInternalLinkTypeAttachmentMenuBot(data json.RawMessage) (*InternalLinkTypeAttachmentMenuBot, error) { + var resp InternalLinkTypeAttachmentMenuBot + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalInternalLinkTypeAuthenticationCode(data json.RawMessage) (*InternalLinkTypeAuthenticationCode, error) { var resp InternalLinkTypeAuthenticationCode @@ -10527,6 +10872,14 @@ func UnmarshalInternalLinkTypeBotStartInGroup(data json.RawMessage) (*InternalLi return &resp, err } +func UnmarshalInternalLinkTypeBotAddToChannel(data json.RawMessage) (*InternalLinkTypeBotAddToChannel, error) { + var resp InternalLinkTypeBotAddToChannel + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalInternalLinkTypeChangePhoneNumber(data json.RawMessage) (*InternalLinkTypeChangePhoneNumber, error) { var resp InternalLinkTypeChangePhoneNumber @@ -10567,6 +10920,14 @@ func UnmarshalInternalLinkTypeLanguagePack(data json.RawMessage) (*InternalLinkT return &resp, err } +func UnmarshalInternalLinkTypeLanguageSettings(data json.RawMessage) (*InternalLinkTypeLanguageSettings, error) { + var resp InternalLinkTypeLanguageSettings + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalInternalLinkTypeMessage(data json.RawMessage) (*InternalLinkTypeMessage, error) { var resp InternalLinkTypeMessage @@ -10599,6 +10960,14 @@ func UnmarshalInternalLinkTypePhoneNumberConfirmation(data json.RawMessage) (*In return &resp, err } +func UnmarshalInternalLinkTypePrivacyAndSecuritySettings(data json.RawMessage) (*InternalLinkTypePrivacyAndSecuritySettings, error) { + var resp InternalLinkTypePrivacyAndSecuritySettings + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalInternalLinkTypeProxy(data json.RawMessage) (*InternalLinkTypeProxy, error) { var resp InternalLinkTypeProxy @@ -10671,6 +11040,14 @@ func UnmarshalInternalLinkTypeUnsupportedProxy(data json.RawMessage) (*InternalL return &resp, err } +func UnmarshalInternalLinkTypeUserPhoneNumber(data json.RawMessage) (*InternalLinkTypeUserPhoneNumber, error) { + var resp InternalLinkTypeUserPhoneNumber + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalInternalLinkTypeVideoChat(data json.RawMessage) (*InternalLinkTypeVideoChat, error) { var resp InternalLinkTypeVideoChat @@ -10735,6 +11112,14 @@ func UnmarshalFileTypeDocument(data json.RawMessage) (*FileTypeDocument, error) return &resp, err } +func UnmarshalFileTypeNotificationSound(data json.RawMessage) (*FileTypeNotificationSound, error) { + var resp FileTypeNotificationSound + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalFileTypePhoto(data json.RawMessage) (*FileTypePhoto, error) { var resp FileTypePhoto @@ -11119,8 +11504,8 @@ func UnmarshalSuggestedActionCheckPhoneNumber(data json.RawMessage) (*SuggestedA return &resp, err } -func UnmarshalSuggestedActionSeeTicksHint(data json.RawMessage) (*SuggestedActionSeeTicksHint, error) { - var resp SuggestedActionSeeTicksHint +func UnmarshalSuggestedActionViewChecksHint(data json.RawMessage) (*SuggestedActionViewChecksHint, error) { + var resp SuggestedActionViewChecksHint err := json.Unmarshal(data, &resp) @@ -11231,16 +11616,8 @@ func UnmarshalProxies(data json.RawMessage) (*Proxies, error) { return &resp, err } -func UnmarshalInputStickerStatic(data json.RawMessage) (*InputStickerStatic, error) { - var resp InputStickerStatic - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalInputStickerAnimated(data json.RawMessage) (*InputStickerAnimated, error) { - var resp InputStickerAnimated +func UnmarshalInputSticker(data json.RawMessage) (*InputSticker, error) { + var resp InputSticker err := json.Unmarshal(data, &resp) @@ -11511,6 +11888,14 @@ func UnmarshalUpdateMessageMentionRead(data json.RawMessage) (*UpdateMessageMent return &resp, err } +func UnmarshalUpdateMessageUnreadReactions(data json.RawMessage) (*UpdateMessageUnreadReactions, error) { + var resp UpdateMessageUnreadReactions + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalUpdateMessageLiveLocationViewed(data json.RawMessage) (*UpdateMessageLiveLocationViewed, error) { var resp UpdateMessageLiveLocationViewed @@ -11567,62 +11952,6 @@ func UnmarshalUpdateChatPosition(data json.RawMessage) (*UpdateChatPosition, err return &resp, err } -func UnmarshalUpdateChatDefaultMessageSenderId(data json.RawMessage) (*UpdateChatDefaultMessageSenderId, error) { - var resp UpdateChatDefaultMessageSenderId - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalUpdateChatHasProtectedContent(data json.RawMessage) (*UpdateChatHasProtectedContent, error) { - var resp UpdateChatHasProtectedContent - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalUpdateChatIsMarkedAsUnread(data json.RawMessage) (*UpdateChatIsMarkedAsUnread, error) { - var resp UpdateChatIsMarkedAsUnread - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalUpdateChatIsBlocked(data json.RawMessage) (*UpdateChatIsBlocked, error) { - var resp UpdateChatIsBlocked - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalUpdateChatHasScheduledMessages(data json.RawMessage) (*UpdateChatHasScheduledMessages, error) { - var resp UpdateChatHasScheduledMessages - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalUpdateChatVideoChat(data json.RawMessage) (*UpdateChatVideoChat, error) { - var resp UpdateChatVideoChat - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalUpdateChatDefaultDisableNotification(data json.RawMessage) (*UpdateChatDefaultDisableNotification, error) { - var resp UpdateChatDefaultDisableNotification - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - func UnmarshalUpdateChatReadInbox(data json.RawMessage) (*UpdateChatReadInbox, error) { var resp UpdateChatReadInbox @@ -11639,38 +11968,6 @@ func UnmarshalUpdateChatReadOutbox(data json.RawMessage) (*UpdateChatReadOutbox, return &resp, err } -func UnmarshalUpdateChatUnreadMentionCount(data json.RawMessage) (*UpdateChatUnreadMentionCount, error) { - var resp UpdateChatUnreadMentionCount - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalUpdateChatNotificationSettings(data json.RawMessage) (*UpdateChatNotificationSettings, error) { - var resp UpdateChatNotificationSettings - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalUpdateScopeNotificationSettings(data json.RawMessage) (*UpdateScopeNotificationSettings, error) { - var resp UpdateScopeNotificationSettings - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - -func UnmarshalUpdateChatMessageTtlSetting(data json.RawMessage) (*UpdateChatMessageTtlSetting, error) { - var resp UpdateChatMessageTtlSetting - - err := json.Unmarshal(data, &resp) - - return &resp, err -} - func UnmarshalUpdateChatActionBar(data json.RawMessage) (*UpdateChatActionBar, error) { var resp UpdateChatActionBar @@ -11679,8 +11976,40 @@ func UnmarshalUpdateChatActionBar(data json.RawMessage) (*UpdateChatActionBar, e return &resp, err } -func UnmarshalUpdateChatTheme(data json.RawMessage) (*UpdateChatTheme, error) { - var resp UpdateChatTheme +func UnmarshalUpdateChatAvailableReactions(data json.RawMessage) (*UpdateChatAvailableReactions, error) { + var resp UpdateChatAvailableReactions + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatDraftMessage(data json.RawMessage) (*UpdateChatDraftMessage, error) { + var resp UpdateChatDraftMessage + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatMessageSender(data json.RawMessage) (*UpdateChatMessageSender, error) { + var resp UpdateChatMessageSender + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatMessageTtl(data json.RawMessage) (*UpdateChatMessageTtl, error) { + var resp UpdateChatMessageTtl + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatNotificationSettings(data json.RawMessage) (*UpdateChatNotificationSettings, error) { + var resp UpdateChatNotificationSettings err := json.Unmarshal(data, &resp) @@ -11703,8 +12032,72 @@ func UnmarshalUpdateChatReplyMarkup(data json.RawMessage) (*UpdateChatReplyMarku return &resp, err } -func UnmarshalUpdateChatDraftMessage(data json.RawMessage) (*UpdateChatDraftMessage, error) { - var resp UpdateChatDraftMessage +func UnmarshalUpdateChatTheme(data json.RawMessage) (*UpdateChatTheme, error) { + var resp UpdateChatTheme + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatUnreadMentionCount(data json.RawMessage) (*UpdateChatUnreadMentionCount, error) { + var resp UpdateChatUnreadMentionCount + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatUnreadReactionCount(data json.RawMessage) (*UpdateChatUnreadReactionCount, error) { + var resp UpdateChatUnreadReactionCount + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatVideoChat(data json.RawMessage) (*UpdateChatVideoChat, error) { + var resp UpdateChatVideoChat + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatDefaultDisableNotification(data json.RawMessage) (*UpdateChatDefaultDisableNotification, error) { + var resp UpdateChatDefaultDisableNotification + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatHasProtectedContent(data json.RawMessage) (*UpdateChatHasProtectedContent, error) { + var resp UpdateChatHasProtectedContent + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatHasScheduledMessages(data json.RawMessage) (*UpdateChatHasScheduledMessages, error) { + var resp UpdateChatHasScheduledMessages + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatIsBlocked(data json.RawMessage) (*UpdateChatIsBlocked, error) { + var resp UpdateChatIsBlocked + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateChatIsMarkedAsUnread(data json.RawMessage) (*UpdateChatIsMarkedAsUnread, error) { + var resp UpdateChatIsMarkedAsUnread err := json.Unmarshal(data, &resp) @@ -11727,6 +12120,14 @@ func UnmarshalUpdateChatOnlineMemberCount(data json.RawMessage) (*UpdateChatOnli return &resp, err } +func UnmarshalUpdateScopeNotificationSettings(data json.RawMessage) (*UpdateScopeNotificationSettings, error) { + var resp UpdateScopeNotificationSettings + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalUpdateNotification(data json.RawMessage) (*UpdateNotification, error) { var resp UpdateNotification @@ -11871,6 +12272,38 @@ func UnmarshalUpdateFileGenerationStop(data json.RawMessage) (*UpdateFileGenerat return &resp, err } +func UnmarshalUpdateFileDownloads(data json.RawMessage) (*UpdateFileDownloads, error) { + var resp UpdateFileDownloads + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateFileAddedToDownloads(data json.RawMessage) (*UpdateFileAddedToDownloads, error) { + var resp UpdateFileAddedToDownloads + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateFileDownload(data json.RawMessage) (*UpdateFileDownload, error) { + var resp UpdateFileDownload + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateFileRemovedFromDownloads(data json.RawMessage) (*UpdateFileRemovedFromDownloads, error) { + var resp UpdateFileRemovedFromDownloads + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalUpdateCall(data json.RawMessage) (*UpdateCall, error) { var resp UpdateCall @@ -11983,6 +12416,14 @@ func UnmarshalUpdateSavedAnimations(data json.RawMessage) (*UpdateSavedAnimation return &resp, err } +func UnmarshalUpdateSavedNotificationSounds(data json.RawMessage) (*UpdateSavedNotificationSounds, error) { + var resp UpdateSavedNotificationSounds + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalUpdateSelectedBackground(data json.RawMessage) (*UpdateSelectedBackground, error) { var resp UpdateSelectedBackground @@ -12031,6 +12472,30 @@ func UnmarshalUpdateUsersNearby(data json.RawMessage) (*UpdateUsersNearby, error return &resp, err } +func UnmarshalUpdateAttachmentMenuBots(data json.RawMessage) (*UpdateAttachmentMenuBots, error) { + var resp UpdateAttachmentMenuBots + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateWebAppMessageSent(data json.RawMessage) (*UpdateWebAppMessageSent, error) { + var resp UpdateWebAppMessageSent + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + +func UnmarshalUpdateReactions(data json.RawMessage) (*UpdateReactions, error) { + var resp UpdateReactions + + err := json.Unmarshal(data, &resp) + + return &resp, err +} + func UnmarshalUpdateDiceEmojis(data json.RawMessage) (*UpdateDiceEmojis, error) { var resp UpdateDiceEmojis @@ -12386,20 +12851,23 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeThumbnailFormatJpeg: return UnmarshalThumbnailFormatJpeg(data) - case TypeThumbnailFormatPng: - return UnmarshalThumbnailFormatPng(data) - - case TypeThumbnailFormatWebp: - return UnmarshalThumbnailFormatWebp(data) - case TypeThumbnailFormatGif: return UnmarshalThumbnailFormatGif(data) + case TypeThumbnailFormatMpeg4: + return UnmarshalThumbnailFormatMpeg4(data) + + case TypeThumbnailFormatPng: + return UnmarshalThumbnailFormatPng(data) + case TypeThumbnailFormatTgs: return UnmarshalThumbnailFormatTgs(data) - case TypeThumbnailFormatMpeg4: - return UnmarshalThumbnailFormatMpeg4(data) + case TypeThumbnailFormatWebm: + return UnmarshalThumbnailFormatWebm(data) + + case TypeThumbnailFormatWebp: + return UnmarshalThumbnailFormatWebp(data) case TypeThumbnail: return UnmarshalThumbnail(data) @@ -12419,6 +12887,18 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeMaskPosition: return UnmarshalMaskPosition(data) + case TypeStickerTypeStatic: + return UnmarshalStickerTypeStatic(data) + + case TypeStickerTypeAnimated: + return UnmarshalStickerTypeAnimated(data) + + case TypeStickerTypeVideo: + return UnmarshalStickerTypeVideo(data) + + case TypeStickerTypeMask: + return UnmarshalStickerTypeMask(data) + case TypeClosedVectorPath: return UnmarshalClosedVectorPath(data) @@ -12497,6 +12977,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeBotCommands: return UnmarshalBotCommands(data) + case TypeBotMenuButton: + return UnmarshalBotMenuButton(data) + case TypeChatLocation: return UnmarshalChatLocation(data) @@ -12518,9 +13001,18 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeInputChatPhotoAnimation: return UnmarshalInputChatPhotoAnimation(data) + case TypeChatPermissions: + return UnmarshalChatPermissions(data) + + case TypeChatAdministratorRights: + return UnmarshalChatAdministratorRights(data) + case TypeUser: return UnmarshalUser(data) + case TypeBotInfo: + return UnmarshalBotInfo(data) + case TypeUserFullInfo: return UnmarshalUserFullInfo(data) @@ -12533,9 +13025,6 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeChatAdministrators: return UnmarshalChatAdministrators(data) - case TypeChatPermissions: - return UnmarshalChatPermissions(data) - case TypeChatMemberStatusCreator: return UnmarshalChatMemberStatusCreator(data) @@ -12689,9 +13178,15 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeMessageReplyInfo: return UnmarshalMessageReplyInfo(data) + case TypeMessageReaction: + return UnmarshalMessageReaction(data) + case TypeMessageInteractionInfo: return UnmarshalMessageInteractionInfo(data) + case TypeUnreadReaction: + return UnmarshalUnreadReaction(data) + case TypeMessageSendingStatePending: return UnmarshalMessageSendingStatePending(data) @@ -12722,8 +13217,14 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeSponsoredMessage: return UnmarshalSponsoredMessage(data) - case TypeSponsoredMessages: - return UnmarshalSponsoredMessages(data) + case TypeFileDownload: + return UnmarshalFileDownload(data) + + case TypeDownloadedFileCounts: + return UnmarshalDownloadedFileCounts(data) + + case TypeFoundFileDownloads: + return UnmarshalFoundFileDownloads(data) case TypeNotificationSettingsScopePrivateChats: return UnmarshalNotificationSettingsScopePrivateChats(data) @@ -12842,6 +13343,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeKeyboardButtonTypeRequestPoll: return UnmarshalKeyboardButtonTypeRequestPoll(data) + case TypeKeyboardButtonTypeWebApp: + return UnmarshalKeyboardButtonTypeWebApp(data) + case TypeKeyboardButton: return UnmarshalKeyboardButton(data) @@ -12851,6 +13355,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeInlineKeyboardButtonTypeLoginUrl: return UnmarshalInlineKeyboardButtonTypeLoginUrl(data) + case TypeInlineKeyboardButtonTypeWebApp: + return UnmarshalInlineKeyboardButtonTypeWebApp(data) + case TypeInlineKeyboardButtonTypeCallback: return UnmarshalInlineKeyboardButtonTypeCallback(data) @@ -12890,6 +13397,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeLoginUrlInfoRequestConfirmation: return UnmarshalLoginUrlInfoRequestConfirmation(data) + case TypeWebAppInfo: + return UnmarshalWebAppInfo(data) + case TypeMessageThreadInfo: return UnmarshalMessageThreadInfo(data) @@ -13085,6 +13595,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeAddress: return UnmarshalAddress(data) + case TypeThemeParameters: + return UnmarshalThemeParameters(data) + case TypeLabeledPricePart: return UnmarshalLabeledPricePart(data) @@ -13115,9 +13628,6 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypePaymentsProviderStripe: return UnmarshalPaymentsProviderStripe(data) - case TypePaymentFormTheme: - return UnmarshalPaymentFormTheme(data) - case TypePaymentForm: return UnmarshalPaymentForm(data) @@ -13484,6 +13994,12 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeMessageWebsiteConnected: return UnmarshalMessageWebsiteConnected(data) + case TypeMessageWebAppDataSent: + return UnmarshalMessageWebAppDataSent(data) + + case TypeMessageWebAppDataReceived: + return UnmarshalMessageWebAppDataReceived(data) + case TypeMessagePassportDataSent: return UnmarshalMessagePassportDataSent(data) @@ -13532,6 +14048,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeTextEntityTypeStrikethrough: return UnmarshalTextEntityTypeStrikethrough(data) + case TypeTextEntityTypeSpoiler: + return UnmarshalTextEntityTypeSpoiler(data) + case TypeTextEntityTypeCode: return UnmarshalTextEntityTypeCode(data) @@ -13646,12 +14165,6 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeSearchMessagesFilterChatPhoto: return UnmarshalSearchMessagesFilterChatPhoto(data) - case TypeSearchMessagesFilterCall: - return UnmarshalSearchMessagesFilterCall(data) - - case TypeSearchMessagesFilterMissedCall: - return UnmarshalSearchMessagesFilterMissedCall(data) - case TypeSearchMessagesFilterVideoNote: return UnmarshalSearchMessagesFilterVideoNote(data) @@ -13664,6 +14177,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeSearchMessagesFilterUnreadMention: return UnmarshalSearchMessagesFilterUnreadMention(data) + case TypeSearchMessagesFilterUnreadReaction: + return UnmarshalSearchMessagesFilterUnreadReaction(data) + case TypeSearchMessagesFilterFailedToSend: return UnmarshalSearchMessagesFilterFailedToSend(data) @@ -13808,6 +14324,15 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeGroupCallVideoQualityFull: return UnmarshalGroupCallVideoQualityFull(data) + case TypeGroupCallStream: + return UnmarshalGroupCallStream(data) + + case TypeGroupCallStreams: + return UnmarshalGroupCallStreams(data) + + case TypeRtmpUrl: + return UnmarshalRtmpUrl(data) + case TypeGroupCallRecentSpeaker: return UnmarshalGroupCallRecentSpeaker(data) @@ -13856,6 +14381,18 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypePhoneNumberAuthenticationSettings: return UnmarshalPhoneNumberAuthenticationSettings(data) + case TypeAddedReaction: + return UnmarshalAddedReaction(data) + + case TypeAddedReactions: + return UnmarshalAddedReactions(data) + + case TypeAvailableReactions: + return UnmarshalAvailableReactions(data) + + case TypeReaction: + return UnmarshalReaction(data) + case TypeAnimations: return UnmarshalAnimations(data) @@ -13868,6 +14405,15 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeImportedContacts: return UnmarshalImportedContacts(data) + case TypeAttachmentMenuBotColor: + return UnmarshalAttachmentMenuBotColor(data) + + case TypeAttachmentMenuBot: + return UnmarshalAttachmentMenuBot(data) + + case TypeSentWebAppMessage: + return UnmarshalSentWebAppMessage(data) + case TypeHttpUrl: return UnmarshalHttpUrl(data) @@ -13973,15 +14519,15 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeChatEventMessageDeleted: return UnmarshalChatEventMessageDeleted(data) - case TypeChatEventPollStopped: - return UnmarshalChatEventPollStopped(data) - case TypeChatEventMessagePinned: return UnmarshalChatEventMessagePinned(data) case TypeChatEventMessageUnpinned: return UnmarshalChatEventMessageUnpinned(data) + case TypeChatEventPollStopped: + return UnmarshalChatEventPollStopped(data) + case TypeChatEventMemberJoined: return UnmarshalChatEventMemberJoined(data) @@ -13991,60 +14537,63 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeChatEventMemberJoinedByRequest: return UnmarshalChatEventMemberJoinedByRequest(data) - case TypeChatEventMemberLeft: - return UnmarshalChatEventMemberLeft(data) - case TypeChatEventMemberInvited: return UnmarshalChatEventMemberInvited(data) + case TypeChatEventMemberLeft: + return UnmarshalChatEventMemberLeft(data) + case TypeChatEventMemberPromoted: return UnmarshalChatEventMemberPromoted(data) case TypeChatEventMemberRestricted: return UnmarshalChatEventMemberRestricted(data) - case TypeChatEventTitleChanged: - return UnmarshalChatEventTitleChanged(data) - - case TypeChatEventPermissionsChanged: - return UnmarshalChatEventPermissionsChanged(data) + case TypeChatEventAvailableReactionsChanged: + return UnmarshalChatEventAvailableReactionsChanged(data) case TypeChatEventDescriptionChanged: return UnmarshalChatEventDescriptionChanged(data) - case TypeChatEventUsernameChanged: - return UnmarshalChatEventUsernameChanged(data) - - case TypeChatEventPhotoChanged: - return UnmarshalChatEventPhotoChanged(data) - - case TypeChatEventInvitesToggled: - return UnmarshalChatEventInvitesToggled(data) - case TypeChatEventLinkedChatChanged: return UnmarshalChatEventLinkedChatChanged(data) - case TypeChatEventSlowModeDelayChanged: - return UnmarshalChatEventSlowModeDelayChanged(data) - - case TypeChatEventMessageTtlSettingChanged: - return UnmarshalChatEventMessageTtlSettingChanged(data) - - case TypeChatEventSignMessagesToggled: - return UnmarshalChatEventSignMessagesToggled(data) - - case TypeChatEventHasProtectedContentToggled: - return UnmarshalChatEventHasProtectedContentToggled(data) - - case TypeChatEventStickerSetChanged: - return UnmarshalChatEventStickerSetChanged(data) - case TypeChatEventLocationChanged: return UnmarshalChatEventLocationChanged(data) + case TypeChatEventMessageTtlChanged: + return UnmarshalChatEventMessageTtlChanged(data) + + case TypeChatEventPermissionsChanged: + return UnmarshalChatEventPermissionsChanged(data) + + case TypeChatEventPhotoChanged: + return UnmarshalChatEventPhotoChanged(data) + + case TypeChatEventSlowModeDelayChanged: + return UnmarshalChatEventSlowModeDelayChanged(data) + + case TypeChatEventStickerSetChanged: + return UnmarshalChatEventStickerSetChanged(data) + + case TypeChatEventTitleChanged: + return UnmarshalChatEventTitleChanged(data) + + case TypeChatEventUsernameChanged: + return UnmarshalChatEventUsernameChanged(data) + + case TypeChatEventHasProtectedContentToggled: + return UnmarshalChatEventHasProtectedContentToggled(data) + + case TypeChatEventInvitesToggled: + return UnmarshalChatEventInvitesToggled(data) + case TypeChatEventIsAllHistoryAvailableToggled: return UnmarshalChatEventIsAllHistoryAvailableToggled(data) + case TypeChatEventSignMessagesToggled: + return UnmarshalChatEventSignMessagesToggled(data) + case TypeChatEventInviteLinkEdited: return UnmarshalChatEventInviteLinkEdited(data) @@ -14057,8 +14606,11 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeChatEventVideoChatCreated: return UnmarshalChatEventVideoChatCreated(data) - case TypeChatEventVideoChatDiscarded: - return UnmarshalChatEventVideoChatDiscarded(data) + case TypeChatEventVideoChatEnded: + return UnmarshalChatEventVideoChatEnded(data) + + case TypeChatEventVideoChatMuteNewParticipantsToggled: + return UnmarshalChatEventVideoChatMuteNewParticipantsToggled(data) case TypeChatEventVideoChatParticipantIsMutedToggled: return UnmarshalChatEventVideoChatParticipantIsMutedToggled(data) @@ -14066,9 +14618,6 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeChatEventVideoChatParticipantVolumeLevelChanged: return UnmarshalChatEventVideoChatParticipantVolumeLevelChanged(data) - case TypeChatEventVideoChatMuteNewParticipantsToggled: - return UnmarshalChatEventVideoChatMuteNewParticipantsToggled(data) - case TypeChatEvent: return UnmarshalChatEvent(data) @@ -14336,6 +14885,12 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeNotificationGroupTypeCalls: return UnmarshalNotificationGroupTypeCalls(data) + case TypeNotificationSound: + return UnmarshalNotificationSound(data) + + case TypeNotificationSounds: + return UnmarshalNotificationSounds(data) + case TypeNotification: return UnmarshalNotification(data) @@ -14462,12 +15017,21 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeChatReportReasonFake: return UnmarshalChatReportReasonFake(data) + case TypeChatReportReasonIllegalDrugs: + return UnmarshalChatReportReasonIllegalDrugs(data) + + case TypeChatReportReasonPersonalDetails: + return UnmarshalChatReportReasonPersonalDetails(data) + case TypeChatReportReasonCustom: return UnmarshalChatReportReasonCustom(data) case TypeInternalLinkTypeActiveSessions: return UnmarshalInternalLinkTypeActiveSessions(data) + case TypeInternalLinkTypeAttachmentMenuBot: + return UnmarshalInternalLinkTypeAttachmentMenuBot(data) + case TypeInternalLinkTypeAuthenticationCode: return UnmarshalInternalLinkTypeAuthenticationCode(data) @@ -14480,6 +15044,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeInternalLinkTypeBotStartInGroup: return UnmarshalInternalLinkTypeBotStartInGroup(data) + case TypeInternalLinkTypeBotAddToChannel: + return UnmarshalInternalLinkTypeBotAddToChannel(data) + case TypeInternalLinkTypeChangePhoneNumber: return UnmarshalInternalLinkTypeChangePhoneNumber(data) @@ -14495,6 +15062,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeInternalLinkTypeLanguagePack: return UnmarshalInternalLinkTypeLanguagePack(data) + case TypeInternalLinkTypeLanguageSettings: + return UnmarshalInternalLinkTypeLanguageSettings(data) + case TypeInternalLinkTypeMessage: return UnmarshalInternalLinkTypeMessage(data) @@ -14507,6 +15077,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeInternalLinkTypePhoneNumberConfirmation: return UnmarshalInternalLinkTypePhoneNumberConfirmation(data) + case TypeInternalLinkTypePrivacyAndSecuritySettings: + return UnmarshalInternalLinkTypePrivacyAndSecuritySettings(data) + case TypeInternalLinkTypeProxy: return UnmarshalInternalLinkTypeProxy(data) @@ -14534,6 +15107,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeInternalLinkTypeUnsupportedProxy: return UnmarshalInternalLinkTypeUnsupportedProxy(data) + case TypeInternalLinkTypeUserPhoneNumber: + return UnmarshalInternalLinkTypeUserPhoneNumber(data) + case TypeInternalLinkTypeVideoChat: return UnmarshalInternalLinkTypeVideoChat(data) @@ -14558,6 +15134,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeFileTypeDocument: return UnmarshalFileTypeDocument(data) + case TypeFileTypeNotificationSound: + return UnmarshalFileTypeNotificationSound(data) + case TypeFileTypePhoto: return UnmarshalFileTypePhoto(data) @@ -14702,8 +15281,8 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeSuggestedActionCheckPhoneNumber: return UnmarshalSuggestedActionCheckPhoneNumber(data) - case TypeSuggestedActionSeeTicksHint: - return UnmarshalSuggestedActionSeeTicksHint(data) + case TypeSuggestedActionViewChecksHint: + return UnmarshalSuggestedActionViewChecksHint(data) case TypeSuggestedActionConvertToBroadcastGroup: return UnmarshalSuggestedActionConvertToBroadcastGroup(data) @@ -14744,11 +15323,8 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeProxies: return UnmarshalProxies(data) - case TypeInputStickerStatic: - return UnmarshalInputStickerStatic(data) - - case TypeInputStickerAnimated: - return UnmarshalInputStickerAnimated(data) + case TypeInputSticker: + return UnmarshalInputSticker(data) case TypeDateRange: return UnmarshalDateRange(data) @@ -14849,6 +15425,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeUpdateMessageMentionRead: return UnmarshalUpdateMessageMentionRead(data) + case TypeUpdateMessageUnreadReactions: + return UnmarshalUpdateMessageUnreadReactions(data) + case TypeUpdateMessageLiveLocationViewed: return UnmarshalUpdateMessageLiveLocationViewed(data) @@ -14870,50 +15449,29 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeUpdateChatPosition: return UnmarshalUpdateChatPosition(data) - case TypeUpdateChatDefaultMessageSenderId: - return UnmarshalUpdateChatDefaultMessageSenderId(data) - - case TypeUpdateChatHasProtectedContent: - return UnmarshalUpdateChatHasProtectedContent(data) - - case TypeUpdateChatIsMarkedAsUnread: - return UnmarshalUpdateChatIsMarkedAsUnread(data) - - case TypeUpdateChatIsBlocked: - return UnmarshalUpdateChatIsBlocked(data) - - case TypeUpdateChatHasScheduledMessages: - return UnmarshalUpdateChatHasScheduledMessages(data) - - case TypeUpdateChatVideoChat: - return UnmarshalUpdateChatVideoChat(data) - - case TypeUpdateChatDefaultDisableNotification: - return UnmarshalUpdateChatDefaultDisableNotification(data) - case TypeUpdateChatReadInbox: return UnmarshalUpdateChatReadInbox(data) case TypeUpdateChatReadOutbox: return UnmarshalUpdateChatReadOutbox(data) - case TypeUpdateChatUnreadMentionCount: - return UnmarshalUpdateChatUnreadMentionCount(data) - - case TypeUpdateChatNotificationSettings: - return UnmarshalUpdateChatNotificationSettings(data) - - case TypeUpdateScopeNotificationSettings: - return UnmarshalUpdateScopeNotificationSettings(data) - - case TypeUpdateChatMessageTtlSetting: - return UnmarshalUpdateChatMessageTtlSetting(data) - case TypeUpdateChatActionBar: return UnmarshalUpdateChatActionBar(data) - case TypeUpdateChatTheme: - return UnmarshalUpdateChatTheme(data) + case TypeUpdateChatAvailableReactions: + return UnmarshalUpdateChatAvailableReactions(data) + + case TypeUpdateChatDraftMessage: + return UnmarshalUpdateChatDraftMessage(data) + + case TypeUpdateChatMessageSender: + return UnmarshalUpdateChatMessageSender(data) + + case TypeUpdateChatMessageTtl: + return UnmarshalUpdateChatMessageTtl(data) + + case TypeUpdateChatNotificationSettings: + return UnmarshalUpdateChatNotificationSettings(data) case TypeUpdateChatPendingJoinRequests: return UnmarshalUpdateChatPendingJoinRequests(data) @@ -14921,8 +15479,32 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeUpdateChatReplyMarkup: return UnmarshalUpdateChatReplyMarkup(data) - case TypeUpdateChatDraftMessage: - return UnmarshalUpdateChatDraftMessage(data) + case TypeUpdateChatTheme: + return UnmarshalUpdateChatTheme(data) + + case TypeUpdateChatUnreadMentionCount: + return UnmarshalUpdateChatUnreadMentionCount(data) + + case TypeUpdateChatUnreadReactionCount: + return UnmarshalUpdateChatUnreadReactionCount(data) + + case TypeUpdateChatVideoChat: + return UnmarshalUpdateChatVideoChat(data) + + case TypeUpdateChatDefaultDisableNotification: + return UnmarshalUpdateChatDefaultDisableNotification(data) + + case TypeUpdateChatHasProtectedContent: + return UnmarshalUpdateChatHasProtectedContent(data) + + case TypeUpdateChatHasScheduledMessages: + return UnmarshalUpdateChatHasScheduledMessages(data) + + case TypeUpdateChatIsBlocked: + return UnmarshalUpdateChatIsBlocked(data) + + case TypeUpdateChatIsMarkedAsUnread: + return UnmarshalUpdateChatIsMarkedAsUnread(data) case TypeUpdateChatFilters: return UnmarshalUpdateChatFilters(data) @@ -14930,6 +15512,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeUpdateChatOnlineMemberCount: return UnmarshalUpdateChatOnlineMemberCount(data) + case TypeUpdateScopeNotificationSettings: + return UnmarshalUpdateScopeNotificationSettings(data) + case TypeUpdateNotification: return UnmarshalUpdateNotification(data) @@ -14984,6 +15569,18 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeUpdateFileGenerationStop: return UnmarshalUpdateFileGenerationStop(data) + case TypeUpdateFileDownloads: + return UnmarshalUpdateFileDownloads(data) + + case TypeUpdateFileAddedToDownloads: + return UnmarshalUpdateFileAddedToDownloads(data) + + case TypeUpdateFileDownload: + return UnmarshalUpdateFileDownload(data) + + case TypeUpdateFileRemovedFromDownloads: + return UnmarshalUpdateFileRemovedFromDownloads(data) + case TypeUpdateCall: return UnmarshalUpdateCall(data) @@ -15026,6 +15623,9 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeUpdateSavedAnimations: return UnmarshalUpdateSavedAnimations(data) + case TypeUpdateSavedNotificationSounds: + return UnmarshalUpdateSavedNotificationSounds(data) + case TypeUpdateSelectedBackground: return UnmarshalUpdateSelectedBackground(data) @@ -15044,6 +15644,15 @@ func UnmarshalType(data json.RawMessage) (Type, error) { case TypeUpdateUsersNearby: return UnmarshalUpdateUsersNearby(data) + case TypeUpdateAttachmentMenuBots: + return UnmarshalUpdateAttachmentMenuBots(data) + + case TypeUpdateWebAppMessageSent: + return UnmarshalUpdateWebAppMessageSent(data) + + case TypeUpdateReactions: + return UnmarshalUpdateReactions(data) + case TypeUpdateDiceEmojis: return UnmarshalUpdateDiceEmojis(data) diff --git a/data/td_api.json b/data/td_api.json index 1e27587..2d04387 100755 --- a/data/td_api.json +++ b/data/td_api.json @@ -197,7 +197,7 @@ }, { "name": "authenticationCodeTypeFlashCall", - "description": "An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number from which the call was made is the code that should be entered automatically", + "description": "An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number that calls is the code that must be entered automatically", "class": "AuthenticationCodeType", "properties": [ { @@ -209,7 +209,7 @@ }, { "name": "authenticationCodeTypeMissedCall", - "description": "An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number from which the call was made is the code that should be entered manually by the user", + "description": "An authentication code is delivered by an immediately canceled call to the specified phone number. The last digits of the phone number that calls are the code that must be entered manually by the user", "class": "AuthenticationCodeType", "properties": [ { @@ -315,7 +315,7 @@ { "name": "entities", "type": "vector\u003ctextEntity\u003e", - "description": "Entities contained in the text. Entities can be nested, but must not mutually intersect with each other. Pre, Code and PreCode entities can't contain other entities. Bold, Italic, Underline and Strikethrough entities can contain and to be contained in all other entities. All other entities can't contain each other" + "description": "Entities contained in the text. Entities can be nested, but must not mutually intersect with each other. Pre, Code and PreCode entities can't contain other entities. Bold, Italic, Underline, Strikethrough, and Spoiler entities can contain and to be contained in all other entities. All other entities can't contain each other" } ] }, @@ -332,7 +332,7 @@ { "name": "min_user_age", "type": "int32", - "description": "The minimum age of a user to be able to accept the terms; 0 if any" + "description": "The minimum age of a user to be able to accept the terms; 0 if age isn't restricted" }, { "name": "show_popup", @@ -526,7 +526,7 @@ { "name": "can_be_downloaded", "type": "Bool", - "description": "True, if it is possible to try to download or generate the file" + "description": "True, if it is possible to download or generate the file" }, { "name": "can_be_deleted", @@ -568,7 +568,7 @@ { "name": "id", "type": "string", - "description": "Remote file identifier; may be empty. Can be used by the current user across application restarts or even from other devices. Uniquely identifies a file, but a file can have a lot of different valid identifiers. If the ID starts with \"http://\" or \"https://\", it represents the HTTP URL of the file. TDLib is currently unable to download files if only their URL is known. If downloadFile is called on such a file or if it is sent to a secret chat, TDLib starts a file generation process by sending updateFileGenerationStart to the application with the HTTP URL in the original_path and \"#url#\" as the conversion string. Application must generate the file by downloading it to the specified location" + "description": "Remote file identifier; may be empty. Can be used by the current user across application restarts or even from other devices. Uniquely identifies a file, but a file can have a lot of different valid identifiers. If the ID starts with \"http://\" or \"https://\", it represents the HTTP URL of the file. TDLib is currently unable to download files if only their URL is known. If downloadFile/addFileToDownloads is called on such a file or if it is sent to a secret chat, TDLib starts a file generation process by sending updateFileGenerationStart to the application with the HTTP URL in the original_path and \"#url#\" as the conversion string. Application must generate the file by downloading it to the specified location" }, { "name": "unique_id", @@ -742,18 +742,6 @@ "class": "ThumbnailFormat", "properties": [] }, - { - "name": "thumbnailFormatPng", - "description": "The thumbnail is in PNG format. It will be used only for background patterns", - "class": "ThumbnailFormat", - "properties": [] - }, - { - "name": "thumbnailFormatWebp", - "description": "The thumbnail is in WEBP format. It will be used only for some stickers", - "class": "ThumbnailFormat", - "properties": [] - }, { "name": "thumbnailFormatGif", "description": "The thumbnail is in static GIF format. It will be used only for some bot inline results", @@ -761,14 +749,32 @@ "properties": [] }, { - "name": "thumbnailFormatTgs", - "description": "The thumbnail is in TGS format. It will be used only for animated sticker sets", + "name": "thumbnailFormatMpeg4", + "description": "The thumbnail is in MPEG4 format. It will be used only for some animations and videos", "class": "ThumbnailFormat", "properties": [] }, { - "name": "thumbnailFormatMpeg4", - "description": "The thumbnail is in MPEG4 format. It will be used only for some animations and videos", + "name": "thumbnailFormatPng", + "description": "The thumbnail is in PNG format. It will be used only for background patterns", + "class": "ThumbnailFormat", + "properties": [] + }, + { + "name": "thumbnailFormatTgs", + "description": "The thumbnail is in TGS format. It will be used only for TGS sticker sets", + "class": "ThumbnailFormat", + "properties": [] + }, + { + "name": "thumbnailFormatWebm", + "description": "The thumbnail is in WEBM format. It will be used only for WEBM sticker sets", + "class": "ThumbnailFormat", + "properties": [] + }, + { + "name": "thumbnailFormatWebp", + "description": "The thumbnail is in WEBP format. It will be used only for some stickers", "class": "ThumbnailFormat", "properties": [] }, @@ -850,6 +856,36 @@ } ] }, + { + "name": "stickerTypeStatic", + "description": "The sticker is an image in WEBP format", + "class": "StickerType", + "properties": [] + }, + { + "name": "stickerTypeAnimated", + "description": "The sticker is an animation in TGS format", + "class": "StickerType", + "properties": [] + }, + { + "name": "stickerTypeVideo", + "description": "The sticker is a video in WEBM format", + "class": "StickerType", + "properties": [] + }, + { + "name": "stickerTypeMask", + "description": "The sticker is a mask in WEBP format to be placed on photos or videos", + "class": "StickerType", + "properties": [ + { + "name": "mask_position", + "type": "maskPosition", + "description": "Position where the mask is placed; may be null" + } + ] + }, { "name": "closedVectorPath", "description": "Represents a closed vector path. The path begins at the end point of the last command", @@ -1102,19 +1138,9 @@ "description": "Emoji corresponding to the sticker" }, { - "name": "is_animated", - "type": "Bool", - "description": "True, if the sticker is an animated sticker in TGS format" - }, - { - "name": "is_mask", - "type": "Bool", - "description": "True, if the sticker is a mask" - }, - { - "name": "mask_position", - "type": "maskPosition", - "description": "Position where the mask is placed; may be null" + "name": "type", + "type": "StickerType", + "description": "Sticker type" }, { "name": "outline", @@ -1267,7 +1293,7 @@ { "name": "sound", "type": "file", - "description": "File containing the sound to be played when the animated emoji is clicked if any; may be null. The sound is encoded with the Opus codec, and stored inside an OGG container" + "description": "File containing the sound to be played when the animated emoji is clicked; may be null. The sound is encoded with the Opus codec, and stored inside an OGG container" } ] }, @@ -1348,7 +1374,7 @@ { "name": "provider", "type": "string", - "description": "Provider of the venue database; as defined by the sender. Currently only \"foursquare\" and \"gplaces\" (Google Places) need to be supported" + "description": "Provider of the venue database; as defined by the sender. Currently, only \"foursquare\" and \"gplaces\" (Google Places) need to be supported" }, { "name": "id", @@ -1561,6 +1587,11 @@ "name": "need_location", "type": "Bool", "description": "True, if the location of the user is expected to be sent with every inline query to this bot" + }, + { + "name": "can_be_added_to_attachment_menu", + "type": "Bool", + "description": "True, if the bot can be added to attachment menu" } ] }, @@ -1604,6 +1635,23 @@ } ] }, + { + "name": "botMenuButton", + "description": "Describes a button to be shown instead of bot commands menu button", + "class": "BotMenuButton", + "properties": [ + { + "name": "text", + "type": "string", + "description": "Text of the button" + }, + { + "name": "url", + "type": "string", + "description": "URL to be passed to openWebApp" + } + ] + }, { "name": "chatLocation", "description": "Represents a location to which a chat is connected", @@ -1733,6 +1781,115 @@ } ] }, + { + "name": "chatPermissions", + "description": "Describes actions that a user is allowed to take in a chat", + "class": "ChatPermissions", + "properties": [ + { + "name": "can_send_messages", + "type": "Bool", + "description": "True, if the user can send text messages, contacts, locations, and venues" + }, + { + "name": "can_send_media_messages", + "type": "Bool", + "description": "True, if the user can send audio files, documents, photos, videos, video notes, and voice notes. Implies can_send_messages permissions" + }, + { + "name": "can_send_polls", + "type": "Bool", + "description": "True, if the user can send polls. Implies can_send_messages permissions" + }, + { + "name": "can_send_other_messages", + "type": "Bool", + "description": "True, if the user can send animations, games, stickers, and dice and use inline bots. Implies can_send_messages permissions" + }, + { + "name": "can_add_web_page_previews", + "type": "Bool", + "description": "True, if the user may add a web page preview to their messages. Implies can_send_messages permissions" + }, + { + "name": "can_change_info", + "type": "Bool", + "description": "True, if the user can change the chat title, photo, and other settings" + }, + { + "name": "can_invite_users", + "type": "Bool", + "description": "True, if the user can invite new users to the chat" + }, + { + "name": "can_pin_messages", + "type": "Bool", + "description": "True, if the user can pin messages" + } + ] + }, + { + "name": "chatAdministratorRights", + "description": "Describes rights of the administrator", + "class": "ChatAdministratorRights", + "properties": [ + { + "name": "can_manage_chat", + "type": "Bool", + "description": "True, if the administrator can get chat event log, get chat statistics, get message statistics in channels, get channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other privilege; applicable to supergroups and channels only" + }, + { + "name": "can_change_info", + "type": "Bool", + "description": "True, if the administrator can change the chat title, photo, and other settings" + }, + { + "name": "can_post_messages", + "type": "Bool", + "description": "True, if the administrator can create channel posts; applicable to channels only" + }, + { + "name": "can_edit_messages", + "type": "Bool", + "description": "True, if the administrator can edit messages of other users and pin messages; applicable to channels only" + }, + { + "name": "can_delete_messages", + "type": "Bool", + "description": "True, if the administrator can delete messages of other users" + }, + { + "name": "can_invite_users", + "type": "Bool", + "description": "True, if the administrator can invite new users to the chat" + }, + { + "name": "can_restrict_members", + "type": "Bool", + "description": "True, if the administrator can restrict, ban, or unban chat members; always true for channels" + }, + { + "name": "can_pin_messages", + "type": "Bool", + "description": "True, if the administrator can pin messages; applicable to basic groups and supergroups only" + }, + { + "name": "can_promote_members", + "type": "Bool", + "description": "True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that were directly or indirectly promoted by them" + }, + { + "name": "can_manage_video_chats", + "type": "Bool", + "description": "True, if the administrator can manage video chats" + }, + { + "name": "is_anonymous", + "type": "Bool", + "description": "True, if the administrator isn't shown in the chat member list and sends messages anonymously; applicable to supergroups only" + } + ] + }, { "name": "user", "description": "Represents a user", @@ -1811,7 +1968,7 @@ { "name": "have_access", "type": "Bool", - "description": "If false, the user is inaccessible, and the only information known about the user is inside this class. It can't be passed to any method except GetUser" + "description": "If false, the user is inaccessible, and the only information known about the user is inside this class. Identifier of the user can't be passed to any method except GetUser" }, { "name": "type", @@ -1825,6 +1982,43 @@ } ] }, + { + "name": "botInfo", + "description": "Contains information about a bot", + "class": "BotInfo", + "properties": [ + { + "name": "share_text", + "type": "string", + "description": "The text that is shown on the bot's profile page and is sent together with the link when users share the bot" + }, + { + "name": "description", + "type": "string", + "description": "The text shown in the chat with the bot if the chat is empty" + }, + { + "name": "menu_button", + "type": "botMenuButton", + "description": "Information about a button to show instead of the bot commands menu button; may be null if ordinary bot commands menu must be shown" + }, + { + "name": "commands", + "type": "vector\u003cbotCommand\u003e", + "description": "List of the bot commands" + }, + { + "name": "default_group_administrator_rights", + "type": "chatAdministratorRights", + "description": "Default administrator rights for adding the bot to basic group and supergroup chats; may be null" + }, + { + "name": "default_channel_administrator_rights", + "type": "chatAdministratorRights", + "description": "Default administrator rights for adding the bot to channels; may be null" + } + ] + }, { "name": "userFullInfo", "description": "Contains full information about a user", @@ -1870,25 +2064,15 @@ "type": "string", "description": "A short user bio" }, - { - "name": "share_text", - "type": "string", - "description": "For bots, the text that is shown on the bot's profile page and is sent together with the link when users share the bot" - }, - { - "name": "description", - "type": "string", - "description": "For bots, the text shown in the chat with the bot if the chat is empty" - }, { "name": "group_in_common_count", "type": "int32", "description": "Number of group chats where both the other user and the current user are a member; 0 for the current user" }, { - "name": "commands", - "type": "vector\u003cbotCommand\u003e", - "description": "For bots, list of the bot commands" + "name": "bot_info", + "type": "botInfo", + "description": "For bots, information about the bot; may be null" } ] }, @@ -1900,7 +2084,7 @@ { "name": "total_count", "type": "int32", - "description": "Approximate total count of users found" + "description": "Approximate total number of users found" }, { "name": "user_ids", @@ -1943,53 +2127,6 @@ } ] }, - { - "name": "chatPermissions", - "description": "Describes actions that a user is allowed to take in a chat", - "class": "ChatPermissions", - "properties": [ - { - "name": "can_send_messages", - "type": "Bool", - "description": "True, if the user can send text messages, contacts, locations, and venues" - }, - { - "name": "can_send_media_messages", - "type": "Bool", - "description": "True, if the user can send audio files, documents, photos, videos, video notes, and voice notes. Implies can_send_messages permissions" - }, - { - "name": "can_send_polls", - "type": "Bool", - "description": "True, if the user can send polls. Implies can_send_messages permissions" - }, - { - "name": "can_send_other_messages", - "type": "Bool", - "description": "True, if the user can send animations, games, stickers, and dice and use inline bots. Implies can_send_messages permissions" - }, - { - "name": "can_add_web_page_previews", - "type": "Bool", - "description": "True, if the user may add a web page preview to their messages. Implies can_send_messages permissions" - }, - { - "name": "can_change_info", - "type": "Bool", - "description": "True, if the user can change the chat title, photo, and other settings" - }, - { - "name": "can_invite_users", - "type": "Bool", - "description": "True, if the user can invite new users to the chat" - }, - { - "name": "can_pin_messages", - "type": "Bool", - "description": "True, if the user can pin messages" - } - ] - }, { "name": "chatMemberStatusCreator", "description": "The user is the owner of the chat and has all the administrator privileges", @@ -2028,59 +2165,9 @@ "description": "True, if the current user can edit the administrator privileges for the called user" }, { - "name": "can_manage_chat", - "type": "Bool", - "description": "True, if the administrator can get chat event log, get chat statistics, get message statistics in channels, get channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other privilege; applicable to supergroups and channels only" - }, - { - "name": "can_change_info", - "type": "Bool", - "description": "True, if the administrator can change the chat title, photo, and other settings" - }, - { - "name": "can_post_messages", - "type": "Bool", - "description": "True, if the administrator can create channel posts; applicable to channels only" - }, - { - "name": "can_edit_messages", - "type": "Bool", - "description": "True, if the administrator can edit messages of other users and pin messages; applicable to channels only" - }, - { - "name": "can_delete_messages", - "type": "Bool", - "description": "True, if the administrator can delete messages of other users" - }, - { - "name": "can_invite_users", - "type": "Bool", - "description": "True, if the administrator can invite new users to the chat" - }, - { - "name": "can_restrict_members", - "type": "Bool", - "description": "True, if the administrator can restrict, ban, or unban chat members; always true for channels" - }, - { - "name": "can_pin_messages", - "type": "Bool", - "description": "True, if the administrator can pin messages; applicable to basic groups and supergroups only" - }, - { - "name": "can_promote_members", - "type": "Bool", - "description": "True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that were directly or indirectly promoted by them" - }, - { - "name": "can_manage_video_chats", - "type": "Bool", - "description": "True, if the administrator can manage video chats" - }, - { - "name": "is_anonymous", - "type": "Bool", - "description": "True, if the administrator isn't shown in the chat member list and sends messages anonymously; applicable to supergroups only" + "name": "rights", + "type": "chatAdministratorRights", + "description": "Rights of the administrator" } ] }, @@ -2165,7 +2252,7 @@ { "name": "total_count", "type": "int32", - "description": "Approximate total count of chat members found" + "description": "Approximate total number of chat members found" }, { "name": "members", @@ -2336,7 +2423,7 @@ "description": "Point in time (Unix timestamp) when the link was last edited; 0 if never or unknown" }, { - "name": "expire_date", + "name": "expiration_date", "type": "int32", "description": "Point in time (Unix timestamp) when the link will expire; 0 if never" }, @@ -2363,7 +2450,7 @@ { "name": "is_primary", "type": "Bool", - "description": "True, if the link is primary. Primary invite link can't have name, expire date or usage limit. There is exactly one primary invite link for each administrator with can_invite_users right at a given time" + "description": "True, if the link is primary. Primary invite link can't have name, expiration date, or usage limit. There is exactly one primary invite link for each administrator with can_invite_users right at a given time" }, { "name": "is_revoked", @@ -2380,7 +2467,7 @@ { "name": "total_count", "type": "int32", - "description": "Approximate total count of chat invite links found" + "description": "Approximate total number of chat invite links found" }, { "name": "invite_links", @@ -2425,7 +2512,7 @@ }, { "name": "chatInviteLinkMember", - "description": "Describes a chat member joined a chat by an invite link", + "description": "Describes a chat member joined a chat via an invite link", "class": "ChatInviteLinkMember", "properties": [ { @@ -2447,18 +2534,18 @@ }, { "name": "chatInviteLinkMembers", - "description": "Contains a list of chat members joined a chat by an invite link", + "description": "Contains a list of chat members joined a chat via an invite link", "class": "ChatInviteLinkMembers", "properties": [ { "name": "total_count", "type": "int32", - "description": "Approximate total count of chat members found" + "description": "Approximate total number of chat members found" }, { "name": "members", "type": "vector\u003cchatInviteLinkMember\u003e", - "description": "List of chat members, joined a chat by an invite link" + "description": "List of chat members, joined a chat via an invite link" } ] }, @@ -2543,13 +2630,13 @@ }, { "name": "chatJoinRequests", - "description": "Contains a list of chat join requests", + "description": "Contains a list of requests to join a chat", "class": "ChatJoinRequests", "properties": [ { "name": "total_count", "type": "int32", - "description": "Approximate total count of requests found" + "description": "Approximate total number of requests found" }, { "name": "requests", @@ -2560,7 +2647,7 @@ }, { "name": "chatJoinRequestsInfo", - "description": "Contains information about pending chat join requests", + "description": "Contains information about pending join requests for a chat", "class": "ChatJoinRequestsInfo", "properties": [ { @@ -2571,7 +2658,7 @@ { "name": "user_ids", "type": "vector\u003cint53\u003e", - "description": "Identifiers of users sent the newest pending join requests" + "description": "Identifiers of at most 3 users sent the newest pending join requests" } ] }, @@ -2672,7 +2759,7 @@ { "name": "member_count", "type": "int32", - "description": "Number of members in the supergroup or channel; 0 if unknown. Currently it is guaranteed to be known only if the supergroup or channel was received through searchPublicChats, searchChatsNearby, getInactiveSupergroupChats, getSuitableDiscussionChats, getGroupsInCommon, or getUserPrivacySettingRules" + "description": "Number of members in the supergroup or channel; 0 if unknown. Currently, it is guaranteed to be known only if the supergroup or channel was received through searchPublicChats, searchChatsNearby, getInactiveSupergroupChats, getSuitableDiscussionChats, getGroupsInCommon, or getUserPrivacySettingRules" }, { "name": "has_linked_chat", @@ -2702,7 +2789,7 @@ { "name": "is_broadcast_group", "type": "Bool", - "description": "True, if the supergroup is a broadcast group, i.e. only administrators can send messages and there is no limit on number of members" + "description": "True, if the supergroup is a broadcast group, i.e. only administrators can send messages and there is no limit on the number of members" }, { "name": "is_verified", @@ -2819,7 +2906,7 @@ { "name": "invite_link", "type": "chatInviteLink", - "description": "Primary invite link for this chat; may be null. For chat administrators with can_invite_users right only" + "description": "Primary invite link for the chat; may be null. For chat administrators with can_invite_users right only" }, { "name": "bot_commands", @@ -2925,7 +3012,7 @@ { "name": "total_count", "type": "int32", - "description": "Approximate total count of messages senders found" + "description": "Approximate total number of messages senders found" }, { "name": "senders", @@ -2948,7 +3035,7 @@ }, { "name": "messageForwardOriginChat", - "description": "The message was originally sent by an anonymous chat administrator on behalf of the chat", + "description": "The message was originally sent on behalf of a chat", "class": "MessageForwardOrigin", "properties": [ { @@ -2959,7 +3046,7 @@ { "name": "author_signature", "type": "string", - "description": "Original message author signature" + "description": "For messages originally sent by an anonymous chat administrator, original message author signature" } ] }, @@ -3054,7 +3141,7 @@ { "name": "recent_replier_ids", "type": "vector\u003cMessageSender\u003e", - "description": "Identifiers of recent repliers to the message; available in channels with a discussion supergroup" + "description": "Identifiers of at most 3 recent repliers to the message; available in channels with a discussion supergroup. The users and chats are expected to be inaccessible: only their photo and name will be available" }, { "name": "last_read_inbox_message_id", @@ -3073,6 +3160,33 @@ } ] }, + { + "name": "messageReaction", + "description": "Contains information about a reaction to a message", + "class": "MessageReaction", + "properties": [ + { + "name": "reaction", + "type": "string", + "description": "Text representation of the reaction" + }, + { + "name": "total_count", + "type": "int32", + "description": "Number of times the reaction was added" + }, + { + "name": "is_chosen", + "type": "Bool", + "description": "True, if the reaction is chosen by the current user" + }, + { + "name": "recent_sender_ids", + "type": "vector\u003cMessageSender\u003e", + "description": "Identifiers of at most 3 recent message senders, added the reaction; available in private, basic group and supergroup chats" + } + ] + }, { "name": "messageInteractionInfo", "description": "Contains information about interactions with a message", @@ -3092,6 +3206,33 @@ "name": "reply_info", "type": "messageReplyInfo", "description": "Information about direct or indirect replies to the message; may be null. Currently, available only in channels with a discussion supergroup and discussion supergroups for messages, which are not replies itself" + }, + { + "name": "reactions", + "type": "vector\u003cmessageReaction\u003e", + "description": "The list of reactions added to the message" + } + ] + }, + { + "name": "unreadReaction", + "description": "Contains information about an unread reaction to a message", + "class": "UnreadReaction", + "properties": [ + { + "name": "reaction", + "type": "string", + "description": "Text representation of the reaction" + }, + { + "name": "sender_id", + "type": "MessageSender", + "description": "Identifier of the sender, added the reaction" + }, + { + "name": "is_big", + "type": "Bool", + "description": "True, if the reaction was added with a big animation" } ] }, @@ -3198,15 +3339,20 @@ "type": "Bool", "description": "True, if the message can be deleted for all users" }, + { + "name": "can_get_added_reactions", + "type": "Bool", + "description": "True, if the list of added reactions is available through getMessageAddedReactions" + }, { "name": "can_get_statistics", "type": "Bool", - "description": "True, if the message statistics are available" + "description": "True, if the message statistics are available through getMessageStatistics" }, { "name": "can_get_message_thread", "type": "Bool", - "description": "True, if the message thread info is available" + "description": "True, if information about the message thread is available through getMessageThread" }, { "name": "can_get_viewers", @@ -3216,7 +3362,7 @@ { "name": "can_get_media_timestamp_links", "type": "Bool", - "description": "True, if media timestamp links can be generated for media timestamp entities in the message text, caption or web page description" + "description": "True, if media timestamp links can be generated for media timestamp entities in the message text, caption or web page description through getMessageLink" }, { "name": "has_timestamped_media", @@ -3253,6 +3399,11 @@ "type": "messageInteractionInfo", "description": "Information about interactions with the message; may be null" }, + { + "name": "unread_reactions", + "type": "vector\u003cunreadReaction\u003e", + "description": "Information about unread reactions added to the message" + }, { "name": "reply_in_chat_id", "type": "int53", @@ -3318,7 +3469,7 @@ { "name": "total_count", "type": "int32", - "description": "Approximate total count of messages found" + "description": "Approximate total number of messages found" }, { "name": "messages", @@ -3335,7 +3486,7 @@ { "name": "total_count", "type": "int32", - "description": "Approximate total count of messages found; -1 if unknown" + "description": "Approximate total number of messages found; -1 if unknown" }, { "name": "messages", @@ -3379,7 +3530,7 @@ { "name": "total_count", "type": "int32", - "description": "Total count of messages found" + "description": "Total number of messages found" }, { "name": "positions", @@ -3390,24 +3541,24 @@ }, { "name": "messageCalendarDay", - "description": "Contains information about found messages sent in a specific day", + "description": "Contains information about found messages sent on a specific day", "class": "MessageCalendarDay", "properties": [ { "name": "total_count", "type": "int32", - "description": "Total number of found messages sent in the day" + "description": "Total number of found messages sent on the day" }, { "name": "message", "type": "message", - "description": "First message sent in the day" + "description": "First message sent on the day" } ] }, { "name": "messageCalendar", - "description": "Contains information about found messages, splitted by days according to the option \"utc_time_offset\"", + "description": "Contains information about found messages, split by days according to the option \"utc_time_offset\"", "class": "MessageCalendar", "properties": [ { @@ -3428,36 +3579,105 @@ "class": "SponsoredMessage", "properties": [ { - "name": "id", - "type": "int32", - "description": "Unique sponsored message identifier" + "name": "message_id", + "type": "int53", + "description": "Message identifier; unique for the chat to which the sponsored message belongs among both ordinary and sponsored messages" }, { "name": "sponsor_chat_id", "type": "int53", - "description": "Chat identifier" + "description": "Sponsor chat identifier; 0 if the sponsor chat is accessible through an invite link" + }, + { + "name": "sponsor_chat_info", + "type": "chatInviteLinkInfo", + "description": "Information about the sponsor chat; may be null unless sponsor_chat_id == 0" }, { "name": "link", "type": "InternalLinkType", - "description": "An internal link to be opened when the sponsored message is clicked; may be null. If null, the sponsor chat needs to be opened instead" + "description": "An internal link to be opened when the sponsored message is clicked; may be null if the sponsor chat needs to be opened instead" }, { "name": "content", "type": "MessageContent", - "description": "Content of the message" + "description": "Content of the message. Currently, can be only of the type messageText" } ] }, { - "name": "sponsoredMessages", - "description": "Contains a list of sponsored messages", - "class": "SponsoredMessages", + "name": "fileDownload", + "description": "Describes a file added to file download list", + "class": "FileDownload", "properties": [ { - "name": "messages", - "type": "vector\u003csponsoredMessage\u003e", - "description": "List of sponsored messages" + "name": "file_id", + "type": "int32", + "description": "File identifier" + }, + { + "name": "message", + "type": "message", + "description": "The message with the file" + }, + { + "name": "add_date", + "type": "int32", + "description": "Point in time (Unix timestamp) when the file was added to the download list" + }, + { + "name": "complete_date", + "type": "int32", + "description": "Point in time (Unix timestamp) when the file downloading was completed; 0 if the file downloading isn't completed" + }, + { + "name": "is_paused", + "type": "Bool", + "description": "True, if downloading of the file is paused" + } + ] + }, + { + "name": "downloadedFileCounts", + "description": "Contains number of being downloaded and recently downloaded files found", + "class": "DownloadedFileCounts", + "properties": [ + { + "name": "active_count", + "type": "int32", + "description": "Number of active file downloads found, including paused" + }, + { + "name": "paused_count", + "type": "int32", + "description": "Number of paused file downloads found" + }, + { + "name": "completed_count", + "type": "int32", + "description": "Number of completed file downloads found" + } + ] + }, + { + "name": "foundFileDownloads", + "description": "Contains a list of downloaded files, found by a search", + "class": "FoundFileDownloads", + "properties": [ + { + "name": "total_counts", + "type": "downloadedFileCounts", + "description": "Total number of suitable files, ignoring offset" + }, + { + "name": "files", + "type": "vector\u003cfileDownload\u003e", + "description": "The list of files" + }, + { + "name": "next_offset", + "type": "string", + "description": "The offset for the next request. If empty, there are no more results" } ] }, @@ -3469,13 +3689,13 @@ }, { "name": "notificationSettingsScopeGroupChats", - "description": "Notification settings applied to all basic groups and supergroups when the corresponding chat setting has a default value", + "description": "Notification settings applied to all basic group and supergroup chats when the corresponding chat setting has a default value", "class": "NotificationSettingsScope", "properties": [] }, { "name": "notificationSettingsScopeChannelChats", - "description": "Notification settings applied to all channels when the corresponding chat setting has a default value", + "description": "Notification settings applied to all channel chats when the corresponding chat setting has a default value", "class": "NotificationSettingsScope", "properties": [] }, @@ -3497,12 +3717,12 @@ { "name": "use_default_sound", "type": "Bool", - "description": "If true, sound is ignored and the value for the relevant type of chat is used instead" + "description": "If true, the value for the relevant type of chat is used instead of sound_id" }, { - "name": "sound", - "type": "string", - "description": "The name of an audio file to be used for notification sounds; only applies to iOS applications" + "name": "sound_id", + "type": "int64", + "description": "Identifier of the notification sound to be played; 0 if sound is disabled" }, { "name": "use_default_show_preview", @@ -3547,9 +3767,9 @@ "description": "Time left before notifications will be unmuted, in seconds" }, { - "name": "sound", - "type": "string", - "description": "The name of an audio file to be used for notification sounds; only applies to iOS applications" + "name": "sound_id", + "type": "int64", + "description": "Identifier of the notification sound to be played; 0 if sound is disabled" }, { "name": "show_preview", @@ -3576,7 +3796,7 @@ { "name": "reply_to_message_id", "type": "int53", - "description": "Identifier of the message to reply to; 0 if none" + "description": "Identifier of the replied message; 0 if none" }, { "name": "date", @@ -3661,7 +3881,7 @@ { "name": "icon_name", "type": "string", - "description": "The icon name for short filter representation. If non-empty, must be one of \"All\", \"Unread\", \"Unmuted\", \"Bots\", \"Channels\", \"Groups\", \"Private\", \"Custom\", \"Setup\", \"Cat\", \"Crown\", \"Favorite\", \"Flower\", \"Game\", \"Home\", \"Love\", \"Mask\", \"Party\", \"Sport\", \"Study\", \"Trade\", \"Travel\", \"Work\". If empty, use getChatFilterDefaultIconName to get default icon name for the filter" + "description": "The chosen icon name for short filter representation. If non-empty, must be one of \"All\", \"Unread\", \"Unmuted\", \"Bots\", \"Channels\", \"Groups\", \"Private\", \"Custom\", \"Setup\", \"Cat\", \"Crown\", \"Favorite\", \"Flower\", \"Game\", \"Home\", \"Love\", \"Mask\", \"Party\", \"Sport\", \"Study\", \"Trade\", \"Travel\", \"Work\". If empty, use getChatFilterDefaultIconName to get default icon name for the filter" }, { "name": "pinned_chat_ids", @@ -3738,7 +3958,7 @@ { "name": "icon_name", "type": "string", - "description": "The icon name for short filter representation. One of \"All\", \"Unread\", \"Unmuted\", \"Bots\", \"Channels\", \"Groups\", \"Private\", \"Custom\", \"Setup\", \"Cat\", \"Crown\", \"Favorite\", \"Flower\", \"Game\", \"Home\", \"Love\", \"Mask\", \"Party\", \"Sport\", \"Study\", \"Trade\", \"Travel\", \"Work\"" + "description": "The chosen or default icon name for short filter representation. One of \"All\", \"Unread\", \"Unmuted\", \"Bots\", \"Channels\", \"Groups\", \"Private\", \"Custom\", \"Setup\", \"Cat\", \"Crown\", \"Favorite\", \"Flower\", \"Game\", \"Home\", \"Love\", \"Mask\", \"Party\", \"Sport\", \"Study\", \"Trade\", \"Travel\", \"Work\"" } ] }, @@ -3920,9 +4140,9 @@ "description": "Positions of the chat in chat lists" }, { - "name": "default_message_sender_id", + "name": "message_sender_id", "type": "MessageSender", - "description": "Default identifier of a user or chat that is chosen to send messages in the chat; may be null if the user can't change message sender" + "description": "Identifier of a user or chat that is selected to send messages in the chat; may be null if the user can't change message sender" }, { "name": "has_protected_content", @@ -3985,12 +4205,22 @@ "description": "Number of unread messages with a mention/reply in the chat" }, { - "name": "notification_settings", - "type": "chatNotificationSettings", - "description": "Notification settings for this chat" + "name": "unread_reaction_count", + "type": "int32", + "description": "Number of messages with unread reactions in the chat" }, { - "name": "message_ttl_setting", + "name": "notification_settings", + "type": "chatNotificationSettings", + "description": "Notification settings for the chat" + }, + { + "name": "available_reactions", + "type": "vector\u003cstring\u003e", + "description": "List of reactions, available in the chat" + }, + { + "name": "message_ttl", "type": "int32", "description": "Current message Time To Live setting (self-destruct timer) for the chat; 0 if not defined. TTL is counted from the time message or its content is viewed in secret chats and from the send date in other chats" }, @@ -4039,7 +4269,7 @@ { "name": "total_count", "type": "int32", - "description": "Approximate total count of chats found" + "description": "Approximate total number of chats found" }, { "name": "chat_ids", @@ -4204,6 +4434,18 @@ } ] }, + { + "name": "keyboardButtonTypeWebApp", + "description": "A button that opens a web app by calling getWebAppUrl", + "class": "KeyboardButtonType", + "properties": [ + { + "name": "url", + "type": "string", + "description": "An HTTP URL to pass to getWebAppUrl" + } + ] + }, { "name": "keyboardButton", "description": "Represents a single button in a bot keyboard", @@ -4235,13 +4477,13 @@ }, { "name": "inlineKeyboardButtonTypeLoginUrl", - "description": "A button that opens a specified URL and automatically authorize the current user if allowed to do so", + "description": "A button that opens a specified URL and automatically authorize the current user by calling getLoginUrlInfo", "class": "InlineKeyboardButtonType", "properties": [ { "name": "url", "type": "string", - "description": "An HTTP URL to open" + "description": "An HTTP URL to pass to getLoginUrlInfo" }, { "name": "id", @@ -4255,6 +4497,18 @@ } ] }, + { + "name": "inlineKeyboardButtonTypeWebApp", + "description": "A button that opens a web app by calling openWebApp", + "class": "InlineKeyboardButtonType", + "properties": [ + { + "name": "url", + "type": "string", + "description": "An HTTP URL to pass to openWebApp" + } + ] + }, { "name": "inlineKeyboardButtonTypeCallback", "description": "A button that sends a callback query to a bot", @@ -4310,7 +4564,7 @@ }, { "name": "inlineKeyboardButtonTypeUser", - "description": "A button to open a chat with a user", + "description": "A button with a user reference to be handled in the same way as textEntityTypeMentionName entities", "class": "InlineKeyboardButtonType", "properties": [ { @@ -4454,6 +4708,23 @@ } ] }, + { + "name": "webAppInfo", + "description": "Contains information about a web app", + "class": "WebAppInfo", + "properties": [ + { + "name": "launch_id", + "type": "int64", + "description": "Unique identifier for the web app launch" + }, + { + "name": "url", + "type": "string", + "description": "A web app URL to open in a web view" + } + ] + }, { "name": "messageThreadInfo", "description": "Contains information about a message thread", @@ -5324,7 +5595,7 @@ { "name": "username", "type": "string", - "description": "Chat username, by which all other information about the chat can be resolved" + "description": "Chat username by which all other information about the chat can be resolved" } ] }, @@ -5444,7 +5715,7 @@ { "name": "version", "type": "int32", - "description": "Version of the instant view, currently can be 1 or 2" + "description": "Version of the instant view; currently, can be 1 or 2" }, { "name": "is_rtl", @@ -5546,7 +5817,7 @@ { "name": "document", "type": "document", - "description": "Preview of the content as a document, if available (currently only available for small PDF files and ZIP archives); may be null" + "description": "Preview of the content as a document, if available; may be null" }, { "name": "sticker", @@ -5571,7 +5842,7 @@ { "name": "instant_view_version", "type": "int32", - "description": "Version of instant view, available for the web page (currently can be 1 or 2), 0 if none" + "description": "Version of instant view, available for the web page (currently, can be 1 or 2), 0 if none" } ] }, @@ -5712,6 +5983,43 @@ } ] }, + { + "name": "themeParameters", + "description": "Contains parameters of the app theme", + "class": "ThemeParameters", + "properties": [ + { + "name": "background_color", + "type": "int32", + "description": "A color of the background in the RGB24 format" + }, + { + "name": "text_color", + "type": "int32", + "description": "A color of text in the RGB24 format" + }, + { + "name": "hint_color", + "type": "int32", + "description": "A color of hints in the RGB24 format" + }, + { + "name": "link_color", + "type": "int32", + "description": "A color of links in the RGB24 format" + }, + { + "name": "button_color", + "type": "int32", + "description": "A color of the buttons in the RGB24 format" + }, + { + "name": "button_text_color", + "type": "int32", + "description": "A color of text on the buttons in the RGB24 format" + } + ] + }, { "name": "labeledPricePart", "description": "Portion of the price of a product (e.g., \"delivery cost\", \"tax amount\")", @@ -5942,43 +6250,6 @@ } ] }, - { - "name": "paymentFormTheme", - "description": "Theme colors for a payment form", - "class": "PaymentFormTheme", - "properties": [ - { - "name": "background_color", - "type": "int32", - "description": "A color of the payment form background in the RGB24 format" - }, - { - "name": "text_color", - "type": "int32", - "description": "A color of text in the RGB24 format" - }, - { - "name": "hint_color", - "type": "int32", - "description": "A color of hints in the RGB24 format" - }, - { - "name": "link_color", - "type": "int32", - "description": "A color of links in the RGB24 format" - }, - { - "name": "button_color", - "type": "int32", - "description": "A color of the buttons in the RGB24 format" - }, - { - "name": "button_text_color", - "type": "int32", - "description": "A color of text on the buttons in the RGB24 format" - } - ] - }, { "name": "paymentForm", "description": "Contains information about an invoice payment form", @@ -7638,7 +7909,7 @@ }, { "name": "messageChatJoinByLink", - "description": "A new member joined the chat by invite link", + "description": "A new member joined the chat via an invite link", "class": "MessageContent", "properties": [] }, @@ -7727,7 +7998,7 @@ { "name": "ttl", "type": "int32", - "description": "New message TTL setting" + "description": "New message TTL" } ] }, @@ -7852,9 +8123,38 @@ } ] }, + { + "name": "messageWebAppDataSent", + "description": "Data from a web app has been sent to a bot", + "class": "MessageContent", + "properties": [ + { + "name": "button_text", + "type": "string", + "description": "Text of the keyboardButtonTypeWebApp button, which opened the web app" + } + ] + }, + { + "name": "messageWebAppDataReceived", + "description": "Data from a web app has been received; for bots only", + "class": "MessageContent", + "properties": [ + { + "name": "button_text", + "type": "string", + "description": "Text of the keyboardButtonTypeWebApp button, which opened the web app" + }, + { + "name": "data", + "type": "string", + "description": "Received data" + } + ] + }, { "name": "messagePassportDataSent", - "description": "Telegram Passport data has been sent", + "description": "Telegram Passport data has been sent to a bot", "class": "MessageContent", "properties": [ { @@ -7981,6 +8281,12 @@ "class": "TextEntityType", "properties": [] }, + { + "name": "textEntityTypeSpoiler", + "description": "A spoiler text. Not supported in secret chats", + "class": "TextEntityType", + "properties": [] + }, { "name": "textEntityTypeCode", "description": "Text that must be formatted as if inside a code HTML tag", @@ -8096,6 +8402,11 @@ "type": "Bool", "description": "Pass true if the message is sent from the background" }, + { + "name": "protect_content", + "type": "Bool", + "description": "Pass true if the content of the message must be protected from forwarding and saving; for bots only" + }, { "name": "scheduling_state", "type": "MessageSchedulingState", @@ -8133,7 +8444,7 @@ { "name": "text", "type": "formattedText", - "description": "Formatted text to be sent; 1-GetOption(\"message_text_length_max\") characters. Only Bold, Italic, Underline, Strikethrough, Code, Pre, PreCode, TextUrl and MentionName entities are allowed to be specified manually" + "description": "Formatted text to be sent; 1-GetOption(\"message_text_length_max\") characters. Only Bold, Italic, Underline, Strikethrough, Spoiler, Code, Pre, PreCode, TextUrl and MentionName entities are allowed to be specified manually" }, { "name": "disable_web_page_preview", @@ -8645,7 +8956,7 @@ { "name": "copy_options", "type": "messageCopyOptions", - "description": "Options to be used to copy content of the message without reference to the original sender; pass null to try to forward the message as usual" + "description": "Options to be used to copy content of the message without reference to the original sender; pass null to forward the message as usual" } ] }, @@ -8709,18 +9020,6 @@ "class": "SearchMessagesFilter", "properties": [] }, - { - "name": "searchMessagesFilterCall", - "description": "Returns only call messages", - "class": "SearchMessagesFilter", - "properties": [] - }, - { - "name": "searchMessagesFilterMissedCall", - "description": "Returns only incoming call messages with missed/declined discard reasons", - "class": "SearchMessagesFilter", - "properties": [] - }, { "name": "searchMessagesFilterVideoNote", "description": "Returns only video note messages", @@ -8745,6 +9044,12 @@ "class": "SearchMessagesFilter", "properties": [] }, + { + "name": "searchMessagesFilterUnreadReaction", + "description": "Returns only messages with unread reactions for the current user. When using this filter the results can't be additionally filtered by a query, a message thread or by the sending user", + "class": "SearchMessagesFilter", + "properties": [] + }, { "name": "searchMessagesFilterFailedToSend", "description": "Returns only failed to send messages. This filter can be used only if the message database is used", @@ -8978,7 +9283,7 @@ { "name": "thumbnail", "type": "thumbnail", - "description": "Sticker set thumbnail in WEBP or TGS format with width and height 100; may be null. The file can be downloaded only before the thumbnail is changed" + "description": "Sticker set thumbnail in WEBP, TGS, or WEBM format with width and height 100; may be null. The file can be downloaded only before the thumbnail is changed" }, { "name": "thumbnail_outline", @@ -9001,14 +9306,9 @@ "description": "True, if the sticker set is official" }, { - "name": "is_animated", - "type": "Bool", - "description": "True, is the stickers in the set are animated" - }, - { - "name": "is_masks", - "type": "Bool", - "description": "True, if the stickers in the set are masks" + "name": "sticker_type", + "type": "StickerType", + "description": "Type of the stickers in the set" }, { "name": "is_viewed", @@ -9050,7 +9350,7 @@ { "name": "thumbnail", "type": "thumbnail", - "description": "Sticker set thumbnail in WEBP or TGS format with width and height 100; may be null" + "description": "Sticker set thumbnail in WEBP, TGS, or WEBM format with width and height 100; may be null" }, { "name": "thumbnail_outline", @@ -9073,14 +9373,9 @@ "description": "True, if the sticker set is official" }, { - "name": "is_animated", - "type": "Bool", - "description": "True, is the stickers in the set are animated" - }, - { - "name": "is_masks", - "type": "Bool", - "description": "True, if the stickers in the set are masks" + "name": "sticker_type", + "type": "StickerType", + "description": "Type of the stickers in the set" }, { "name": "is_viewed", @@ -9391,6 +9686,57 @@ "class": "GroupCallVideoQuality", "properties": [] }, + { + "name": "groupCallStream", + "description": "Describes an available stream in a group call", + "class": "GroupCallStream", + "properties": [ + { + "name": "channel_id", + "type": "int32", + "description": "Identifier of an audio/video channel" + }, + { + "name": "scale", + "type": "int32", + "description": "Scale of segment durations in the stream. The duration is 1000/(2**scale) milliseconds" + }, + { + "name": "time_offset", + "type": "int53", + "description": "Point in time when the stream currently ends; Unix timestamp in milliseconds" + } + ] + }, + { + "name": "groupCallStreams", + "description": "Represents a list of group call streams", + "class": "GroupCallStreams", + "properties": [ + { + "name": "streams", + "type": "vector\u003cgroupCallStream\u003e", + "description": "A list of group call streams" + } + ] + }, + { + "name": "rtmpUrl", + "description": "Represents an RTMP url", + "class": "RtmpUrl", + "properties": [ + { + "name": "url", + "type": "string", + "description": "The URL" + }, + { + "name": "stream_key", + "type": "string", + "description": "Stream key" + } + ] + }, { "name": "groupCallRecentSpeaker", "description": "Describes a recently speaking participant in a group call", @@ -9438,6 +9784,11 @@ "type": "Bool", "description": "True, if the call is active" }, + { + "name": "is_rtmp_stream", + "type": "Bool", + "description": "True, if the chat is an RTMP stream instead of an ordinary video chat" + }, { "name": "is_joined", "type": "Bool", @@ -9458,6 +9809,11 @@ "type": "int32", "description": "Number of participants in the group call" }, + { + "name": "has_hidden_listeners", + "type": "Bool", + "description": "True, if group call participants, which are muted, aren't returned in participant list" + }, { "name": "loaded_all_participants", "type": "Bool", @@ -9466,7 +9822,7 @@ { "name": "recent_speakers", "type": "vector\u003cgroupCallRecentSpeaker\u003e", - "description": "Recently speaking users in the group call" + "description": "At most 3 recently speaking users in the group call" }, { "name": "is_my_video_enabled", @@ -9760,7 +10116,115 @@ { "name": "authentication_tokens", "type": "vector\u003cstring\u003e", - "description": "List of authentication tokens, received in updateOption(\"authentication_token\") in previously logged out sessions" + "description": "List of up to 20 authentication tokens, recently received in updateOption(\"authentication_token\") in previously logged out sessions" + } + ] + }, + { + "name": "addedReaction", + "description": "Represents a reaction applied to a message", + "class": "AddedReaction", + "properties": [ + { + "name": "reaction", + "type": "string", + "description": "Text representation of the reaction" + }, + { + "name": "sender_id", + "type": "MessageSender", + "description": "Identifier of the chat member, applied the reaction" + } + ] + }, + { + "name": "addedReactions", + "description": "Represents a list of reactions added to a message", + "class": "AddedReactions", + "properties": [ + { + "name": "total_count", + "type": "int32", + "description": "The total number of found reactions" + }, + { + "name": "reactions", + "type": "vector\u003caddedReaction\u003e", + "description": "The list of added reactions" + }, + { + "name": "next_offset", + "type": "string", + "description": "The offset for the next request. If empty, there are no more results" + } + ] + }, + { + "name": "availableReactions", + "description": "Represents a list of available reactions", + "class": "AvailableReactions", + "properties": [ + { + "name": "reactions", + "type": "vector\u003cstring\u003e", + "description": "List of reactions" + } + ] + }, + { + "name": "reaction", + "description": "Contains stickers which must be used for reaction animation rendering", + "class": "Reaction", + "properties": [ + { + "name": "reaction", + "type": "string", + "description": "Text representation of the reaction" + }, + { + "name": "title", + "type": "string", + "description": "Reaction title" + }, + { + "name": "is_active", + "type": "Bool", + "description": "True, if the reaction can be added to new messages and enabled in chats" + }, + { + "name": "static_icon", + "type": "sticker", + "description": "Static icon for the reaction" + }, + { + "name": "appear_animation", + "type": "sticker", + "description": "Appear animation for the reaction" + }, + { + "name": "select_animation", + "type": "sticker", + "description": "Select animation for the reaction" + }, + { + "name": "activate_animation", + "type": "sticker", + "description": "Activate animation for the reaction" + }, + { + "name": "effect_animation", + "type": "sticker", + "description": "Effect animation for the reaction" + }, + { + "name": "around_animation", + "type": "sticker", + "description": "Around animation for the reaction; may be null" + }, + { + "name": "center_animation", + "type": "sticker", + "description": "Center animation for the reaction; may be null" } ] }, @@ -9837,6 +10301,87 @@ } ] }, + { + "name": "attachmentMenuBotColor", + "description": "Describes a color to highlight a bot added to attachment menu", + "class": "AttachmentMenuBotColor", + "properties": [ + { + "name": "light_color", + "type": "int32", + "description": "Color in the RGB24 format for light themes" + }, + { + "name": "dark_color", + "type": "int32", + "description": "Color in the RGB24 format for dark themes" + } + ] + }, + { + "name": "attachmentMenuBot", + "description": "Represents a bot added to attachment menu", + "class": "AttachmentMenuBot", + "properties": [ + { + "name": "bot_user_id", + "type": "int53", + "description": "User identifier of the bot added to attachment menu" + }, + { + "name": "name", + "type": "string", + "description": "Name for the bot in attachment menu" + }, + { + "name": "name_color", + "type": "attachmentMenuBotColor", + "description": "Color to highlight selected name of the bot if appropriate; may be null" + }, + { + "name": "default_icon", + "type": "file", + "description": "Default attachment menu icon for the bot in SVG format; may be null" + }, + { + "name": "ios_static_icon", + "type": "file", + "description": "Attachment menu icon for the bot in SVG format for the official iOS app; may be null" + }, + { + "name": "ios_animated_icon", + "type": "file", + "description": "Attachment menu icon for the bot in TGS format for the official iOS app; may be null" + }, + { + "name": "android_icon", + "type": "file", + "description": "Attachment menu icon for the bot in TGS format for the official Android app; may be null" + }, + { + "name": "macos_icon", + "type": "file", + "description": "Attachment menu icon for the bot in TGS format for the official native macOS app; may be null" + }, + { + "name": "icon_color", + "type": "attachmentMenuBotColor", + "description": "Color to highlight selected icon of the bot if appropriate; may be null" + } + ] + }, + { + "name": "sentWebAppMessage", + "description": "Information about the message sent by answerWebAppQuery", + "class": "SentWebAppMessage", + "properties": [ + { + "name": "inline_message_id", + "type": "string", + "description": "Identifier of the sent inline message, if known" + } + ] + }, { "name": "httpUrl", "description": "Contains an HTTP URL", @@ -10237,7 +10782,7 @@ }, { "name": "inputInlineQueryResultSticker", - "description": "Represents a link to a WEBP or TGS sticker", + "description": "Represents a link to a WEBP, TGS, or WEBM sticker", "class": "InputInlineQueryResult", "properties": [ { @@ -10253,7 +10798,7 @@ { "name": "sticker_url", "type": "string", - "description": "The URL of the WEBP or TGS sticker (sticker file size must not exceed 5MB)" + "description": "The URL of the WEBP, TGS, or WEBM sticker (sticker file size must not exceed 5MB)" }, { "name": "sticker_width", @@ -10872,18 +11417,6 @@ } ] }, - { - "name": "chatEventPollStopped", - "description": "A poll in a message was stopped", - "class": "ChatEventAction", - "properties": [ - { - "name": "message", - "type": "message", - "description": "The message with the poll" - } - ] - }, { "name": "chatEventMessagePinned", "description": "A message was pinned", @@ -10908,6 +11441,18 @@ } ] }, + { + "name": "chatEventPollStopped", + "description": "A poll in a message was stopped", + "class": "ChatEventAction", + "properties": [ + { + "name": "message", + "type": "message", + "description": "The message with the poll" + } + ] + }, { "name": "chatEventMemberJoined", "description": "A new member joined the chat", @@ -10916,7 +11461,7 @@ }, { "name": "chatEventMemberJoinedByInviteLink", - "description": "A new member joined the chat by an invite link", + "description": "A new member joined the chat via an invite link", "class": "ChatEventAction", "properties": [ { @@ -10943,12 +11488,6 @@ } ] }, - { - "name": "chatEventMemberLeft", - "description": "A member left the chat", - "class": "ChatEventAction", - "properties": [] - }, { "name": "chatEventMemberInvited", "description": "A new chat member was invited", @@ -10966,6 +11505,12 @@ } ] }, + { + "name": "chatEventMemberLeft", + "description": "A member left the chat", + "class": "ChatEventAction", + "properties": [] + }, { "name": "chatEventMemberPromoted", "description": "A chat member has gained/lost administrator status, or the list of their administrator privileges has changed", @@ -11011,36 +11556,19 @@ ] }, { - "name": "chatEventTitleChanged", - "description": "The chat title was changed", + "name": "chatEventAvailableReactionsChanged", + "description": "The chat available reactions were changed", "class": "ChatEventAction", "properties": [ { - "name": "old_title", - "type": "string", - "description": "Previous chat title" + "name": "old_available_reactions", + "type": "vector\u003cstring\u003e", + "description": "Previous chat available reactions" }, { - "name": "new_title", - "type": "string", - "description": "New chat title" - } - ] - }, - { - "name": "chatEventPermissionsChanged", - "description": "The chat permissions was changed", - "class": "ChatEventAction", - "properties": [ - { - "name": "old_permissions", - "type": "chatPermissions", - "description": "Previous chat permissions" - }, - { - "name": "new_permissions", - "type": "chatPermissions", - "description": "New chat permissions" + "name": "new_available_reactions", + "type": "vector\u003cstring\u003e", + "description": "New chat available reactions" } ] }, @@ -11061,52 +11589,6 @@ } ] }, - { - "name": "chatEventUsernameChanged", - "description": "The chat username was changed", - "class": "ChatEventAction", - "properties": [ - { - "name": "old_username", - "type": "string", - "description": "Previous chat username" - }, - { - "name": "new_username", - "type": "string", - "description": "New chat username" - } - ] - }, - { - "name": "chatEventPhotoChanged", - "description": "The chat photo was changed", - "class": "ChatEventAction", - "properties": [ - { - "name": "old_photo", - "type": "chatPhoto", - "description": "Previous chat photo value; may be null" - }, - { - "name": "new_photo", - "type": "chatPhoto", - "description": "New chat photo value; may be null" - } - ] - }, - { - "name": "chatEventInvitesToggled", - "description": "The can_invite_users permission of a supergroup chat was toggled", - "class": "ChatEventAction", - "properties": [ - { - "name": "can_invite_users", - "type": "Bool", - "description": "New value of can_invite_users permission" - } - ] - }, { "name": "chatEventLinkedChatChanged", "description": "The linked chat of a supergroup was changed", @@ -11124,81 +11606,6 @@ } ] }, - { - "name": "chatEventSlowModeDelayChanged", - "description": "The slow_mode_delay setting of a supergroup was changed", - "class": "ChatEventAction", - "properties": [ - { - "name": "old_slow_mode_delay", - "type": "int32", - "description": "Previous value of slow_mode_delay, in seconds" - }, - { - "name": "new_slow_mode_delay", - "type": "int32", - "description": "New value of slow_mode_delay, in seconds" - } - ] - }, - { - "name": "chatEventMessageTtlSettingChanged", - "description": "The message TTL setting was changed", - "class": "ChatEventAction", - "properties": [ - { - "name": "old_message_ttl_setting", - "type": "int32", - "description": "Previous value of message_ttl_setting" - }, - { - "name": "new_message_ttl_setting", - "type": "int32", - "description": "New value of message_ttl_setting" - } - ] - }, - { - "name": "chatEventSignMessagesToggled", - "description": "The sign_messages setting of a channel was toggled", - "class": "ChatEventAction", - "properties": [ - { - "name": "sign_messages", - "type": "Bool", - "description": "New value of sign_messages" - } - ] - }, - { - "name": "chatEventHasProtectedContentToggled", - "description": "The has_protected_content setting of a channel was toggled", - "class": "ChatEventAction", - "properties": [ - { - "name": "has_protected_content", - "type": "Bool", - "description": "New value of has_protected_content" - } - ] - }, - { - "name": "chatEventStickerSetChanged", - "description": "The supergroup sticker set was changed", - "class": "ChatEventAction", - "properties": [ - { - "name": "old_sticker_set_id", - "type": "int64", - "description": "Previous identifier of the chat sticker set; 0 if none" - }, - { - "name": "new_sticker_set_id", - "type": "int64", - "description": "New identifier of the chat sticker set; 0 if none" - } - ] - }, { "name": "chatEventLocationChanged", "description": "The supergroup location was changed", @@ -11216,6 +11623,149 @@ } ] }, + { + "name": "chatEventMessageTtlChanged", + "description": "The message TTL was changed", + "class": "ChatEventAction", + "properties": [ + { + "name": "old_message_ttl", + "type": "int32", + "description": "Previous value of message_ttl" + }, + { + "name": "new_message_ttl", + "type": "int32", + "description": "New value of message_ttl" + } + ] + }, + { + "name": "chatEventPermissionsChanged", + "description": "The chat permissions was changed", + "class": "ChatEventAction", + "properties": [ + { + "name": "old_permissions", + "type": "chatPermissions", + "description": "Previous chat permissions" + }, + { + "name": "new_permissions", + "type": "chatPermissions", + "description": "New chat permissions" + } + ] + }, + { + "name": "chatEventPhotoChanged", + "description": "The chat photo was changed", + "class": "ChatEventAction", + "properties": [ + { + "name": "old_photo", + "type": "chatPhoto", + "description": "Previous chat photo value; may be null" + }, + { + "name": "new_photo", + "type": "chatPhoto", + "description": "New chat photo value; may be null" + } + ] + }, + { + "name": "chatEventSlowModeDelayChanged", + "description": "The slow_mode_delay setting of a supergroup was changed", + "class": "ChatEventAction", + "properties": [ + { + "name": "old_slow_mode_delay", + "type": "int32", + "description": "Previous value of slow_mode_delay, in seconds" + }, + { + "name": "new_slow_mode_delay", + "type": "int32", + "description": "New value of slow_mode_delay, in seconds" + } + ] + }, + { + "name": "chatEventStickerSetChanged", + "description": "The supergroup sticker set was changed", + "class": "ChatEventAction", + "properties": [ + { + "name": "old_sticker_set_id", + "type": "int64", + "description": "Previous identifier of the chat sticker set; 0 if none" + }, + { + "name": "new_sticker_set_id", + "type": "int64", + "description": "New identifier of the chat sticker set; 0 if none" + } + ] + }, + { + "name": "chatEventTitleChanged", + "description": "The chat title was changed", + "class": "ChatEventAction", + "properties": [ + { + "name": "old_title", + "type": "string", + "description": "Previous chat title" + }, + { + "name": "new_title", + "type": "string", + "description": "New chat title" + } + ] + }, + { + "name": "chatEventUsernameChanged", + "description": "The chat username was changed", + "class": "ChatEventAction", + "properties": [ + { + "name": "old_username", + "type": "string", + "description": "Previous chat username" + }, + { + "name": "new_username", + "type": "string", + "description": "New chat username" + } + ] + }, + { + "name": "chatEventHasProtectedContentToggled", + "description": "The has_protected_content setting of a channel was toggled", + "class": "ChatEventAction", + "properties": [ + { + "name": "has_protected_content", + "type": "Bool", + "description": "New value of has_protected_content" + } + ] + }, + { + "name": "chatEventInvitesToggled", + "description": "The can_invite_users permission of a supergroup chat was toggled", + "class": "ChatEventAction", + "properties": [ + { + "name": "can_invite_users", + "type": "Bool", + "description": "New value of can_invite_users permission" + } + ] + }, { "name": "chatEventIsAllHistoryAvailableToggled", "description": "The is_all_history_available setting of a supergroup was toggled", @@ -11228,6 +11778,18 @@ } ] }, + { + "name": "chatEventSignMessagesToggled", + "description": "The sign_messages setting of a channel was toggled", + "class": "ChatEventAction", + "properties": [ + { + "name": "sign_messages", + "type": "Bool", + "description": "New value of sign_messages" + } + ] + }, { "name": "chatEventInviteLinkEdited", "description": "A chat invite link was edited", @@ -11282,8 +11844,8 @@ ] }, { - "name": "chatEventVideoChatDiscarded", - "description": "A video chat was discarded", + "name": "chatEventVideoChatEnded", + "description": "A video chat was ended", "class": "ChatEventAction", "properties": [ { @@ -11293,6 +11855,18 @@ } ] }, + { + "name": "chatEventVideoChatMuteNewParticipantsToggled", + "description": "The mute_new_participants setting of a video chat was toggled", + "class": "ChatEventAction", + "properties": [ + { + "name": "mute_new_participants", + "type": "Bool", + "description": "New value of the mute_new_participants setting" + } + ] + }, { "name": "chatEventVideoChatParticipantIsMutedToggled", "description": "A video chat participant was muted or unmuted", @@ -11327,18 +11901,6 @@ } ] }, - { - "name": "chatEventVideoChatMuteNewParticipantsToggled", - "description": "The mute_new_participants setting of a video chat was toggled", - "class": "ChatEventAction", - "properties": [ - { - "name": "mute_new_participants", - "type": "Bool", - "description": "New value of the mute_new_participants setting" - } - ] - }, { "name": "chatEvent", "description": "Represents a chat event", @@ -11355,14 +11917,14 @@ "description": "Point in time (Unix timestamp) when the event happened" }, { - "name": "user_id", - "type": "int53", - "description": "Identifier of the user who performed the action that triggered the event" + "name": "member_id", + "type": "MessageSender", + "description": "Identifier of the user or chat who performed the action" }, { "name": "action", "type": "ChatEventAction", - "description": "Action performed by the user" + "description": "The action" } ] }, @@ -11459,7 +12021,7 @@ }, { "name": "languagePackStringValuePluralized", - "description": "A language pack string which has different forms based on the number of some object it mentions. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more info", + "description": "A language pack string which has different forms based on the number of some object it mentions. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more information", "class": "LanguagePackStringValue", "properties": [ { @@ -11557,7 +12119,7 @@ { "name": "plural_code", "type": "string", - "description": "A language code to be used to apply plural forms. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more info" + "description": "A language code to be used to apply plural forms. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more information" }, { "name": "is_official", @@ -11621,7 +12183,7 @@ { "name": "token", "type": "string", - "description": "Device registration token; may be empty to de-register a device" + "description": "Device registration token; may be empty to deregister a device" }, { "name": "encrypt", @@ -11638,7 +12200,7 @@ { "name": "device_token", "type": "string", - "description": "Device token; may be empty to de-register a device" + "description": "Device token; may be empty to deregister a device" }, { "name": "is_app_sandbox", @@ -11655,7 +12217,7 @@ { "name": "device_token", "type": "string", - "description": "Device token; may be empty to de-register a device" + "description": "Device token; may be empty to deregister a device" }, { "name": "is_app_sandbox", @@ -11677,7 +12239,7 @@ { "name": "access_token", "type": "string", - "description": "The access token that will be used to send notifications; may be empty to de-register a device" + "description": "The access token that will be used to send notifications; may be empty to deregister a device" } ] }, @@ -11689,7 +12251,7 @@ { "name": "channel_uri", "type": "string", - "description": "Push notification channel URI; may be empty to de-register a device" + "description": "Push notification channel URI; may be empty to deregister a device" } ] }, @@ -11701,7 +12263,7 @@ { "name": "channel_uri", "type": "string", - "description": "Push notification channel URI; may be empty to de-register a device" + "description": "Push notification channel URI; may be empty to deregister a device" } ] }, @@ -11713,7 +12275,7 @@ { "name": "endpoint", "type": "string", - "description": "Absolute URL exposed by the push service where the application server can send push messages; may be empty to de-register a device" + "description": "Absolute URL exposed by the push service where the application server can send push messages; may be empty to deregister a device" }, { "name": "p256dh_base64url", @@ -11735,7 +12297,7 @@ { "name": "endpoint", "type": "string", - "description": "Absolute URL exposed by the push service where the application server can send push messages; may be empty to de-register a device" + "description": "Absolute URL exposed by the push service where the application server can send push messages; may be empty to deregister a device" } ] }, @@ -11747,7 +12309,7 @@ { "name": "token", "type": "string", - "description": "Token; may be empty to de-register a device" + "description": "Token; may be empty to deregister a device" } ] }, @@ -11759,7 +12321,7 @@ { "name": "token", "type": "string", - "description": "Token; may be empty to de-register a device" + "description": "Token; may be empty to deregister a device" } ] }, @@ -11771,7 +12333,7 @@ { "name": "reg_id", "type": "string", - "description": "Push service registration identifier; may be empty to de-register a device" + "description": "Push service registration identifier; may be empty to deregister a device" } ] }, @@ -12084,7 +12646,7 @@ }, { "name": "checkChatUsernameResultPublicChatsTooMuch", - "description": "The user has too much chats with username, one of them must be made private first", + "description": "The user has too many chats with username, one of them must be made private first", "class": "CheckChatUsernameResult", "properties": [] }, @@ -12573,7 +13135,7 @@ }, { "name": "pushMessageContentChatJoinByLink", - "description": "A new member joined the chat by invite link", + "description": "A new member joined the chat via an invite link", "class": "PushMessageContent", "properties": [] }, @@ -12713,6 +13275,55 @@ "class": "NotificationGroupType", "properties": [] }, + { + "name": "notificationSound", + "description": "Describes a notification sound in MP3 format", + "class": "NotificationSound", + "properties": [ + { + "name": "id", + "type": "int64", + "description": "Unique identifier of the notification sound" + }, + { + "name": "duration", + "type": "int32", + "description": "Duration of the sound, in seconds" + }, + { + "name": "date", + "type": "int32", + "description": "Point in time (Unix timestamp) when the sound was created" + }, + { + "name": "title", + "type": "string", + "description": "Title of the notification sound" + }, + { + "name": "data", + "type": "string", + "description": "Arbitrary data, defined while the sound was uploaded" + }, + { + "name": "sound", + "type": "file", + "description": "File containing the sound" + } + ] + }, + { + "name": "notificationSounds", + "description": "Contains a list of notification sounds", + "class": "NotificationSounds", + "properties": [ + { + "name": "notification_sounds", + "type": "vector\u003cnotificationSound\u003e", + "description": "A list of notification sounds" + } + ] + }, { "name": "notification", "description": "Contains information about a notification", @@ -12729,9 +13340,9 @@ "description": "Notification date" }, { - "name": "is_silent", - "type": "Bool", - "description": "True, if the notification was initially silent" + "name": "sound_id", + "type": "int64", + "description": "Identifier of the notification sound to be played; 0 if sound is disabled" }, { "name": "type", @@ -13198,7 +13809,7 @@ { "name": "location", "type": "string", - "description": "Human-readable description of a country and a region, from which the user was logged in, based on the IP address" + "description": "Human-readable description of a country and a region from which the user was logged in, based on the IP address" } ] }, @@ -13256,6 +13867,18 @@ "class": "ChatReportReason", "properties": [] }, + { + "name": "chatReportReasonIllegalDrugs", + "description": "The chat has illegal drugs related content", + "class": "ChatReportReason", + "properties": [] + }, + { + "name": "chatReportReasonPersonalDetails", + "description": "The chat contains messages with personal details", + "class": "ChatReportReason", + "properties": [] + }, { "name": "chatReportReasonCustom", "description": "A custom reason provided by the user", @@ -13268,6 +13891,28 @@ "class": "InternalLinkType", "properties": [] }, + { + "name": "internalLinkTypeAttachmentMenuBot", + "description": "The link is a link to an attachment menu bot to be opened in the specified chat. Process given chat_link to open corresponding chat. Then call searchPublicChat with the given bot username, check that the user is a bot and can be added to attachment menu. Then use getAttachmentMenuBot to receive information about the bot. If the bot isn't added to attachment menu, then user needs to confirm adding the bot to attachment menu. If user confirms adding, then use toggleBotIsAddedToAttachmentMenu to add it. If attachment menu bots can't be used in the current chat, show an error to the user. If the bot is added to attachment menu, then use openWebApp with the given URL", + "class": "InternalLinkType", + "properties": [ + { + "name": "chat_link", + "type": "InternalLinkType", + "description": "An internal link pointing to a chat; may be null if the current chat needs to be kept" + }, + { + "name": "bot_username", + "type": "string", + "description": "Username of the bot" + }, + { + "name": "url", + "type": "string", + "description": "URL to be passed to openWebApp" + } + ] + }, { "name": "internalLinkTypeAuthenticationCode", "description": "The link contains an authentication code. Call checkAuthenticationCode with the code if the current authorization state is authorizationStateWaitCode", @@ -13311,7 +13956,7 @@ }, { "name": "internalLinkTypeBotStartInGroup", - "description": "The link is a link to a Telegram bot, which is supposed to be added to a group chat. Call searchPublicChat with the given bot username, check that the user is a bot and can be added to groups, ask the current user to select a group to add the bot to, and then call sendBotStartMessage with the given start parameter and the chosen group chat. Bots can be added to a public group only by administrators of the group", + "description": "The link is a link to a Telegram bot, which is supposed to be added to a group chat. Call searchPublicChat with the given bot username, check that the user is a bot and can be added to groups, ask the current user to select a basic group or a supergroup chat to add the bot to, taking into account that bots can be added to a public supergroup only by administrators of the supergroup. If administrator rights are provided by the link, call getChatMember to receive the current bot rights in the chat and if the bot already is an administrator, check that the current user can edit its administrator rights, combine received rights with the requested administrator rights, show confirmation box to the user, and call setChatMemberStatus with the chosen chat and confirmed administrator rights. Before call to setChatMemberStatus it may be required to upgrade the chosen basic group chat to a supergroup chat. Then if start_parameter isn't empty, call sendBotStartMessage with the given start parameter and the chosen chat, otherwise just send /start message with bot's username added to the chat.", "class": "InternalLinkType", "properties": [ { @@ -13323,6 +13968,28 @@ "name": "start_parameter", "type": "string", "description": "The parameter to be passed to sendBotStartMessage" + }, + { + "name": "administrator_rights", + "type": "chatAdministratorRights", + "description": "Expected administrator rights for the bot; may be null" + } + ] + }, + { + "name": "internalLinkTypeBotAddToChannel", + "description": "The link is a link to a Telegram bot, which is supposed to be added to a channel chat as an administrator. Call searchPublicChat with the given bot username and check that the user is a bot, ask the current user to select a channel chat to add the bot to as an administrator. Then call getChatMember to receive the current bot rights in the chat and if the bot already is an administrator, check that the current user can edit its administrator rights and combine received rights with the requested administrator rights. Then show confirmation box to the user, and call setChatMemberStatus with the chosen chat and confirmed rights", + "class": "InternalLinkType", + "properties": [ + { + "name": "bot_username", + "type": "string", + "description": "Username of the bot" + }, + { + "name": "administrator_rights", + "type": "chatAdministratorRights", + "description": "Expected administrator rights for the bot" } ] }, @@ -13379,6 +14046,12 @@ } ] }, + { + "name": "internalLinkTypeLanguageSettings", + "description": "The link is a link to the language settings section of the app", + "class": "InternalLinkType", + "properties": [] + }, { "name": "internalLinkTypeMessage", "description": "The link is a link to a Telegram message. Call getMessageLinkInfo with the given URL to process the link", @@ -13457,6 +14130,12 @@ } ] }, + { + "name": "internalLinkTypePrivacyAndSecuritySettings", + "description": "The link is a link to the privacy and security settings section of the app", + "class": "InternalLinkType", + "properties": [] + }, { "name": "internalLinkTypeProxy", "description": "The link is a link to a proxy. Call addProxy with the given parameters to process the link and add the proxy", @@ -13551,9 +14230,21 @@ "class": "InternalLinkType", "properties": [] }, + { + "name": "internalLinkTypeUserPhoneNumber", + "description": "The link is a link to a user by its phone number. Call searchUserByPhoneNumber with the given phone number to process the link", + "class": "InternalLinkType", + "properties": [ + { + "name": "phone_number", + "type": "string", + "description": "Phone number of the user" + } + ] + }, { "name": "internalLinkTypeVideoChat", - "description": "The link is a link to a video chat. Call searchPublicChat with the given chat username, and then joinGoupCall with the given invite hash to process the link", + "description": "The link is a link to a video chat. Call searchPublicChat with the given chat username, and then joinGroupCall with the given invite hash to process the link", "class": "InternalLinkType", "properties": [ { @@ -13663,6 +14354,12 @@ "class": "FileType", "properties": [] }, + { + "name": "fileTypeNotificationSound", + "description": "The file is a notification sound", + "class": "FileType", + "properties": [] + }, { "name": "fileTypePhoto", "description": "The file is a photo", @@ -14124,7 +14821,7 @@ { "name": "info", "type": "chatInviteLinkInfo", - "description": "Chat invite link info" + "description": "Information about the chat invite link" } ] }, @@ -14177,7 +14874,7 @@ }, { "name": "suggestedActionCheckPassword", - "description": "Suggests the user to check whether 2-step verification password is still remembered", + "description": "Suggests the user to check whether they still remember their 2-step verification password", "class": "SuggestedAction", "properties": [] }, @@ -14188,8 +14885,8 @@ "properties": [] }, { - "name": "suggestedActionSeeTicksHint", - "description": "Suggests the user to see a hint about meaning of one and two ticks on sent message", + "name": "suggestedActionViewChecksHint", + "description": "Suggests the user to view a hint about the meaning of one and two check marks on sent messages", "class": "SuggestedAction", "properties": [] }, @@ -14389,14 +15086,14 @@ ] }, { - "name": "inputStickerStatic", - "description": "A static sticker in PNG format, which will be converted to WEBP server-side", + "name": "inputSticker", + "description": "A sticker to be added to a sticker set", "class": "InputSticker", "properties": [ { "name": "sticker", "type": "InputFile", - "description": "PNG image with the sticker; must be up to 512 KB in size and fit in a 512x512 square" + "description": "File with the sticker; must fit in a 512x512 square. For WEBP stickers and masks the file must be in PNG format, which will be converted to WEBP server-side. Otherwise, the file must be local or uploaded within a week. See https://core.telegram.org/animated_stickers#technical-requirements for technical requirements" }, { "name": "emojis", @@ -14404,26 +15101,9 @@ "description": "Emojis corresponding to the sticker" }, { - "name": "mask_position", - "type": "maskPosition", - "description": "For masks, position where the mask is placed; pass null if unspecified" - } - ] - }, - { - "name": "inputStickerAnimated", - "description": "An animated sticker in TGS format", - "class": "InputSticker", - "properties": [ - { - "name": "sticker", - "type": "InputFile", - "description": "File with the animated sticker. Only local or uploaded within a week files are supported. See https://core.telegram.org/animated_stickers#technical-requirements for technical requirements" - }, - { - "name": "emojis", - "type": "string", - "description": "Emojis corresponding to the sticker" + "name": "type", + "type": "StickerType", + "description": "Sticker type" } ] }, @@ -15109,6 +15789,33 @@ } ] }, + { + "name": "updateMessageUnreadReactions", + "description": "The list of unread reactions added to a message was changed", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "message_id", + "type": "int53", + "description": "Message identifier" + }, + { + "name": "unread_reactions", + "type": "vector\u003cunreadReaction\u003e", + "description": "The new list of unread reactions" + }, + { + "name": "unread_reaction_count", + "type": "int32", + "description": "The new number of messages with unread reactions left in the chat" + } + ] + }, { "name": "updateMessageLiveLocationViewed", "description": "A message with a live location was viewed. When the update is received, the application is supposed to update the live location", @@ -15228,125 +15935,6 @@ } ] }, - { - "name": "updateChatDefaultMessageSenderId", - "description": "The default message sender that is chosen to send messages in a chat has changed", - "class": "Update", - "properties": [ - { - "name": "chat_id", - "type": "int53", - "description": "Chat identifier" - }, - { - "name": "default_message_sender_id", - "type": "MessageSender", - "description": "New value of default_message_sender_id; may be null if the user can't change message sender" - } - ] - }, - { - "name": "updateChatHasProtectedContent", - "description": "A chat content was allowed or restricted for saving", - "class": "Update", - "properties": [ - { - "name": "chat_id", - "type": "int53", - "description": "Chat identifier" - }, - { - "name": "has_protected_content", - "type": "Bool", - "description": "New value of has_protected_content" - } - ] - }, - { - "name": "updateChatIsMarkedAsUnread", - "description": "A chat was marked as unread or was read", - "class": "Update", - "properties": [ - { - "name": "chat_id", - "type": "int53", - "description": "Chat identifier" - }, - { - "name": "is_marked_as_unread", - "type": "Bool", - "description": "New value of is_marked_as_unread" - } - ] - }, - { - "name": "updateChatIsBlocked", - "description": "A chat was blocked or unblocked", - "class": "Update", - "properties": [ - { - "name": "chat_id", - "type": "int53", - "description": "Chat identifier" - }, - { - "name": "is_blocked", - "type": "Bool", - "description": "New value of is_blocked" - } - ] - }, - { - "name": "updateChatHasScheduledMessages", - "description": "A chat's has_scheduled_messages field has changed", - "class": "Update", - "properties": [ - { - "name": "chat_id", - "type": "int53", - "description": "Chat identifier" - }, - { - "name": "has_scheduled_messages", - "type": "Bool", - "description": "New value of has_scheduled_messages" - } - ] - }, - { - "name": "updateChatVideoChat", - "description": "A chat video chat state has changed", - "class": "Update", - "properties": [ - { - "name": "chat_id", - "type": "int53", - "description": "Chat identifier" - }, - { - "name": "video_chat", - "type": "videoChat", - "description": "New value of video_chat" - } - ] - }, - { - "name": "updateChatDefaultDisableNotification", - "description": "The value of the default disable_notification parameter, used when a message is sent to the chat, was changed", - "class": "Update", - "properties": [ - { - "name": "chat_id", - "type": "int53", - "description": "Chat identifier" - }, - { - "name": "default_disable_notification", - "type": "Bool", - "description": "The new default_disable_notification value" - } - ] - }, { "name": "updateChatReadInbox", "description": "Incoming messages were read or the number of unread messages has been changed", @@ -15386,74 +15974,6 @@ } ] }, - { - "name": "updateChatUnreadMentionCount", - "description": "The chat unread_mention_count has changed", - "class": "Update", - "properties": [ - { - "name": "chat_id", - "type": "int53", - "description": "Chat identifier" - }, - { - "name": "unread_mention_count", - "type": "int32", - "description": "The number of unread mention messages left in the chat" - } - ] - }, - { - "name": "updateChatNotificationSettings", - "description": "Notification settings for a chat were changed", - "class": "Update", - "properties": [ - { - "name": "chat_id", - "type": "int53", - "description": "Chat identifier" - }, - { - "name": "notification_settings", - "type": "chatNotificationSettings", - "description": "The new notification settings" - } - ] - }, - { - "name": "updateScopeNotificationSettings", - "description": "Notification settings for some type of chats were updated", - "class": "Update", - "properties": [ - { - "name": "scope", - "type": "NotificationSettingsScope", - "description": "Types of chats for which notification settings were updated" - }, - { - "name": "notification_settings", - "type": "scopeNotificationSettings", - "description": "The new notification settings" - } - ] - }, - { - "name": "updateChatMessageTtlSetting", - "description": "The message Time To Live setting for a chat was changed", - "class": "Update", - "properties": [ - { - "name": "chat_id", - "type": "int53", - "description": "Chat identifier" - }, - { - "name": "message_ttl_setting", - "type": "int32", - "description": "New value of message_ttl_setting" - } - ] - }, { "name": "updateChatActionBar", "description": "The chat action bar was changed", @@ -15472,8 +15992,8 @@ ] }, { - "name": "updateChatTheme", - "description": "The chat theme was changed", + "name": "updateChatAvailableReactions", + "description": "The chat available reactions were changed", "class": "Update", "properties": [ { @@ -15482,9 +16002,82 @@ "description": "Chat identifier" }, { - "name": "theme_name", - "type": "string", - "description": "The new name of the chat theme; may be empty if theme was reset to default" + "name": "available_reactions", + "type": "vector\u003cstring\u003e", + "description": "The new list of reactions, available in the chat" + } + ] + }, + { + "name": "updateChatDraftMessage", + "description": "A chat draft has changed. Be aware that the update may come in the currently opened chat but with old content of the draft. If the user has changed the content of the draft, this update mustn't be applied", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "draft_message", + "type": "draftMessage", + "description": "The new draft message; may be null" + }, + { + "name": "positions", + "type": "vector\u003cchatPosition\u003e", + "description": "The new chat positions in the chat lists" + } + ] + }, + { + "name": "updateChatMessageSender", + "description": "The message sender that is selected to send messages in a chat has changed", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "message_sender_id", + "type": "MessageSender", + "description": "New value of message_sender_id; may be null if the user can't change message sender" + } + ] + }, + { + "name": "updateChatMessageTtl", + "description": "The message Time To Live setting for a chat was changed", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "message_ttl", + "type": "int32", + "description": "New value of message_ttl" + } + ] + }, + { + "name": "updateChatNotificationSettings", + "description": "Notification settings for a chat were changed", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "notification_settings", + "type": "chatNotificationSettings", + "description": "The new notification settings" } ] }, @@ -15523,8 +16116,8 @@ ] }, { - "name": "updateChatDraftMessage", - "description": "A chat draft has changed. Be aware that the update may come in the currently opened chat but with old content of the draft. If the user has changed the content of the draft, this update mustn't be applied", + "name": "updateChatTheme", + "description": "The chat theme was changed", "class": "Update", "properties": [ { @@ -15533,14 +16126,145 @@ "description": "Chat identifier" }, { - "name": "draft_message", - "type": "draftMessage", - "description": "The new draft message; may be null" + "name": "theme_name", + "type": "string", + "description": "The new name of the chat theme; may be empty if theme was reset to default" + } + ] + }, + { + "name": "updateChatUnreadMentionCount", + "description": "The chat unread_mention_count has changed", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" }, { - "name": "positions", - "type": "vector\u003cchatPosition\u003e", - "description": "The new chat positions in the chat lists" + "name": "unread_mention_count", + "type": "int32", + "description": "The number of unread mention messages left in the chat" + } + ] + }, + { + "name": "updateChatUnreadReactionCount", + "description": "The chat unread_reaction_count has changed", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "unread_reaction_count", + "type": "int32", + "description": "The number of messages with unread reactions left in the chat" + } + ] + }, + { + "name": "updateChatVideoChat", + "description": "A chat video chat state has changed", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "video_chat", + "type": "videoChat", + "description": "New value of video_chat" + } + ] + }, + { + "name": "updateChatDefaultDisableNotification", + "description": "The value of the default disable_notification parameter, used when a message is sent to the chat, was changed", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "default_disable_notification", + "type": "Bool", + "description": "The new default_disable_notification value" + } + ] + }, + { + "name": "updateChatHasProtectedContent", + "description": "A chat content was allowed or restricted for saving", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "has_protected_content", + "type": "Bool", + "description": "New value of has_protected_content" + } + ] + }, + { + "name": "updateChatHasScheduledMessages", + "description": "A chat's has_scheduled_messages field has changed", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "has_scheduled_messages", + "type": "Bool", + "description": "New value of has_scheduled_messages" + } + ] + }, + { + "name": "updateChatIsBlocked", + "description": "A chat was blocked or unblocked", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "is_blocked", + "type": "Bool", + "description": "New value of is_blocked" + } + ] + }, + { + "name": "updateChatIsMarkedAsUnread", + "description": "A chat was marked as unread or was read", + "class": "Update", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + }, + { + "name": "is_marked_as_unread", + "type": "Bool", + "description": "New value of is_marked_as_unread" } ] }, @@ -15558,7 +16282,7 @@ }, { "name": "updateChatOnlineMemberCount", - "description": "The number of online group members has changed. This update with non-zero count is sent only for currently opened chats. There is no guarantee that it will be sent just after the count has changed", + "description": "The number of online group members has changed. This update with non-zero number of online group members is sent only for currently opened chats. There is no guarantee that it will be sent just after the number of online users has changed", "class": "Update", "properties": [ { @@ -15573,6 +16297,23 @@ } ] }, + { + "name": "updateScopeNotificationSettings", + "description": "Notification settings for some type of chats were updated", + "class": "Update", + "properties": [ + { + "name": "scope", + "type": "NotificationSettingsScope", + "description": "Types of chats for which notification settings were updated" + }, + { + "name": "notification_settings", + "type": "scopeNotificationSettings", + "description": "The new notification settings" + } + ] + }, { "name": "updateNotification", "description": "A notification was changed", @@ -15616,9 +16357,9 @@ "description": "Chat identifier, which notification settings must be applied to the added notifications" }, { - "name": "is_silent", - "type": "Bool", - "description": "True, if the notifications must be shown without sound" + "name": "notification_sound_id", + "type": "int64", + "description": "Identifier of the notification sound to be played; 0 if sound is disabled" }, { "name": "total_count", @@ -15904,6 +16645,89 @@ } ] }, + { + "name": "updateFileDownloads", + "description": "The state of the file download list has changed", + "class": "Update", + "properties": [ + { + "name": "total_size", + "type": "int53", + "description": "Total size of files in the file download list, in bytes" + }, + { + "name": "total_count", + "type": "int32", + "description": "Total number of files in the file download list" + }, + { + "name": "downloaded_size", + "type": "int53", + "description": "Total downloaded size of files in the file download list, in bytes" + } + ] + }, + { + "name": "updateFileAddedToDownloads", + "description": "A file was added to the file download list. This update is sent only after file download list is loaded for the first time", + "class": "Update", + "properties": [ + { + "name": "file_download", + "type": "fileDownload", + "description": "The added file download" + }, + { + "name": "counts", + "type": "downloadedFileCounts", + "description": "New number of being downloaded and recently downloaded files found" + } + ] + }, + { + "name": "updateFileDownload", + "description": "A file download was changed. This update is sent only after file download list is loaded for the first time", + "class": "Update", + "properties": [ + { + "name": "file_id", + "type": "int32", + "description": "File identifier" + }, + { + "name": "complete_date", + "type": "int32", + "description": "Point in time (Unix timestamp) when the file downloading was completed; 0 if the file downloading isn't completed" + }, + { + "name": "is_paused", + "type": "Bool", + "description": "True, if downloading of the file is paused" + }, + { + "name": "counts", + "type": "downloadedFileCounts", + "description": "New number of being downloaded and recently downloaded files found" + } + ] + }, + { + "name": "updateFileRemovedFromDownloads", + "description": "A file was removed from the file download list. This update is sent only after file download list is loaded for the first time", + "class": "Update", + "properties": [ + { + "name": "file_id", + "type": "int32", + "description": "File identifier" + }, + { + "name": "counts", + "type": "downloadedFileCounts", + "description": "New number of being downloaded and recently downloaded files found" + } + ] + }, { "name": "updateCall", "description": "New call was created or information about a call was updated", @@ -16137,6 +16961,18 @@ } ] }, + { + "name": "updateSavedNotificationSounds", + "description": "The list of saved notifications sounds was updated. This update may not be sent until information about a notification sound was requested for the first time", + "class": "Update", + "properties": [ + { + "name": "notification_sound_ids", + "type": "vector\u003cint64\u003e", + "description": "The new list of identifiers of saved notification sounds" + } + ] + }, { "name": "updateSelectedBackground", "description": "The selected background has changed", @@ -16229,6 +17065,42 @@ } ] }, + { + "name": "updateAttachmentMenuBots", + "description": "The list of bots added to attachment menu has changed", + "class": "Update", + "properties": [ + { + "name": "bots", + "type": "vector\u003cattachmentMenuBot\u003e", + "description": "The new list of bots added to attachment menu. The bots must be shown in attachment menu only in private chats. The bots must not be shown on scheduled messages screen" + } + ] + }, + { + "name": "updateWebAppMessageSent", + "description": "A message was sent by an opened web app, so the web app needs to be closed", + "class": "Update", + "properties": [ + { + "name": "web_app_launch_id", + "type": "int64", + "description": "Identifier of web app launch" + } + ] + }, + { + "name": "updateReactions", + "description": "The list of supported reactions has changed", + "class": "Update", + "properties": [ + { + "name": "reactions", + "type": "vector\u003creaction\u003e", + "description": "The new list of supported reactions" + } + ] + }, { "name": "updateDiceEmojis", "description": "The list of supported dice emojis has changed", @@ -16320,7 +17192,7 @@ { "name": "chat_type", "type": "ChatType", - "description": "The type of the chat, from which the query originated; may be null if unknown" + "description": "The type of the chat from which the query originated; may be null if unknown" }, { "name": "query", @@ -16389,7 +17261,7 @@ { "name": "message_id", "type": "int53", - "description": "Identifier of the message, from which the query originated" + "description": "Identifier of the message from which the query originated" }, { "name": "chat_instance", @@ -16421,7 +17293,7 @@ { "name": "inline_message_id", "type": "string", - "description": "Identifier of the inline message, from which the query originated" + "description": "Identifier of the inline message from which the query originated" }, { "name": "chat_instance", @@ -16801,12 +17673,16 @@ }, { "name": "ThumbnailFormat", - "description": "Describes format of the thumbnail" + "description": "Describes format of a thumbnail" }, { "name": "MaskPoint", "description": "Part of the face, relative to which a mask is placed" }, + { + "name": "StickerType", + "description": "Describes type of a sticker" + }, { "name": "PollType", "description": "Describes the type of a poll" @@ -17107,10 +17983,6 @@ "name": "ProxyType", "description": "Describes the type of a proxy server" }, - { - "name": "InputSticker", - "description": "Describes a sticker that needs to be added to a sticker set" - }, { "name": "StatisticalGraph", "description": "Describes a statistical graph" @@ -17412,7 +18284,7 @@ { "name": "set_recovery_email_address", "type": "Bool", - "description": "Pass true if the recovery email address must be changed" + "description": "Pass true to change also the recovery email address" }, { "name": "new_recovery_email_address", @@ -17708,7 +18580,7 @@ }, { "name": "getMessageLocally", - "description": "Returns information about a message, if it is available locally without sending network request. This is an offline request", + "description": "Returns information about a message, if it is available without sending network request. This is an offline request", "class": "Message", "properties": [ { @@ -17912,7 +18784,7 @@ }, { "name": "searchPublicChat", - "description": "Searches a public chat by its username. Currently only private chats, supergroups and channels can be public. Returns the chat if found; otherwise an error is returned", + "description": "Searches a public chat by its username. Currently, only private chats, supergroups and channels can be public. Returns the chat if found; otherwise an error is returned", "class": "Chat", "properties": [ { @@ -17926,7 +18798,7 @@ }, { "name": "searchPublicChats", - "description": "Searches public chats by looking for specified query in their username and title. Currently only private chats, supergroups and channels can be public. Returns a meaningful number of results. Excludes private chats with contacts and chats from the chat list from the results", + "description": "Searches public chats by looking for specified query in their username and title. Currently, only private chats, supergroups and channels can be public. Returns a meaningful number of results. Excludes private chats with contacts and chats from the chat list from the results", "class": "Chats", "properties": [ { @@ -18193,7 +19065,7 @@ { "name": "only_local", "type": "Bool", - "description": "If true, returns only messages that are available locally without sending network requests" + "description": "Pass true to get only messages that are available without sending network requests" } ], "is_synchronous": false, @@ -18246,12 +19118,12 @@ { "name": "remove_from_chat_list", "type": "Bool", - "description": "Pass true if the chat needs to be removed from the chat list" + "description": "Pass true to remove the chat from all chat lists" }, { "name": "revoke", "type": "Bool", - "description": "Pass true to try to delete chat history for all users" + "description": "Pass true to delete chat history for all users" } ], "is_synchronous": false, @@ -18259,7 +19131,7 @@ }, { "name": "deleteChat", - "description": "Deletes a chat along with all messages in the corresponding chat for all chat members; requires owner privileges. For group chats this will release the username and remove all members. Chats with more than 1000 members can't be deleted using this method", + "description": "Deletes a chat along with all messages in the corresponding chat for all chat members. For group chats this will release the username and remove all members. Use the field chat.can_be_deleted_for_all_users to find whether the method can be applied to the chat", "class": "Ok", "properties": [ { @@ -18358,7 +19230,7 @@ { "name": "filter", "type": "SearchMessagesFilter", - "description": "Additional filter for messages to search; pass null to search for all messages. Filters searchMessagesFilterCall, searchMessagesFilterMissedCall, searchMessagesFilterMention, searchMessagesFilterUnreadMention, searchMessagesFilterFailedToSend and searchMessagesFilterPinned are unsupported in this function" + "description": "Additional filter for messages to search; pass null to search for all messages. Filters searchMessagesFilterMention, searchMessagesFilterUnreadMention, searchMessagesFilterUnreadReaction, searchMessagesFilterFailedToSend, and searchMessagesFilterPinned are unsupported in this function" }, { "name": "min_date", @@ -18392,7 +19264,7 @@ { "name": "offset", "type": "string", - "description": "Offset of the first entry to return as received from the previous request; use empty string to get first chunk of results" + "description": "Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results" }, { "name": "limit", @@ -18426,7 +19298,26 @@ { "name": "only_missed", "type": "Bool", - "description": "If true, returns only messages with missed calls" + "description": "Pass true to search only for messages with missed/declined calls" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "searchOutgoingDocumentMessages", + "description": "Searches for outgoing messages with content of the type messageDocument in all chats except secret chats. Returns the results in reverse chronological order", + "class": "FoundMessages", + "properties": [ + { + "name": "query", + "type": "string", + "description": "Query to search for in document file name and message caption" + }, + { + "name": "limit", + "type": "int32", + "description": "The maximum number of messages to be returned; up to 100" } ], "is_synchronous": false, @@ -18505,7 +19396,7 @@ { "name": "filter", "type": "SearchMessagesFilter", - "description": "Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterCall, searchMessagesFilterMissedCall, searchMessagesFilterMention and searchMessagesFilterUnreadMention are unsupported in this function" + "description": "Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterMention, searchMessagesFilterUnreadMention, and searchMessagesFilterUnreadReaction are unsupported in this function" }, { "name": "from_message_id", @@ -18523,7 +19414,7 @@ }, { "name": "getChatMessageCalendar", - "description": "Returns information about the next messages of the specified type in the chat splitted by days. Returns the results in reverse chronological order. Can return partial result for the last returned day. Behavior of this method depends on the value of the option \"utc_time_offset\"", + "description": "Returns information about the next messages of the specified type in the chat split by days. Returns the results in reverse chronological order. Can return partial result for the last returned day. Behavior of this method depends on the value of the option \"utc_time_offset\"", "class": "MessageCalendar", "properties": [ { @@ -18534,7 +19425,7 @@ { "name": "filter", "type": "SearchMessagesFilter", - "description": "Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterCall, searchMessagesFilterMissedCall, searchMessagesFilterMention and searchMessagesFilterUnreadMention are unsupported in this function" + "description": "Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterMention, searchMessagesFilterUnreadMention, and searchMessagesFilterUnreadReaction are unsupported in this function" }, { "name": "from_message_id", @@ -18563,7 +19454,7 @@ { "name": "return_local", "type": "Bool", - "description": "If true, returns count that is available locally without sending network requests, returning -1 if the number of messages is unknown" + "description": "Pass true to get the number of messages without sending network requests, or -1 if the number of messages is unknown locally" } ], "is_synchronous": false, @@ -18601,7 +19492,7 @@ { "name": "offset", "type": "string", - "description": "Offset of the first entry to return as received from the previous request; use empty string to get first chunk of results" + "description": "Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results" }, { "name": "limit", @@ -18613,9 +19504,9 @@ "type": 2 }, { - "name": "getChatSponsoredMessages", - "description": "Returns sponsored messages to be shown in a chat; for channel chats only", - "class": "SponsoredMessages", + "name": "getChatSponsoredMessage", + "description": "Returns sponsored message to be shown in a chat; for channel chats only. Returns a 404 error if there is no sponsored message in the chat", + "class": "SponsoredMessage", "properties": [ { "name": "chat_id", @@ -18626,25 +19517,6 @@ "is_synchronous": false, "type": 2 }, - { - "name": "viewSponsoredMessage", - "description": "Informs TDLib that a sponsored message was viewed by the user", - "class": "Ok", - "properties": [ - { - "name": "chat_id", - "type": "int53", - "description": "Identifier of the chat with the sponsored message" - }, - { - "name": "sponsored_message_id", - "type": "int32", - "description": "The identifier of the sponsored message being viewed" - } - ], - "is_synchronous": false, - "type": 2 - }, { "name": "removeNotification", "description": "Removes an active notification from notification list. Needs to be called only if the notification is removed by the current user", @@ -18755,6 +19627,30 @@ "is_synchronous": false, "type": 1 }, + { + "name": "translateText", + "description": "Translates a text to the given language. Returns a 404 error if the translation can't be performed", + "class": "Text", + "properties": [ + { + "name": "text", + "type": "string", + "description": "Text to translate" + }, + { + "name": "from_language_code", + "type": "string", + "description": "A two-letter ISO 639-1 language code of the language from which the message is translated. If empty, the language will be detected automatically" + }, + { + "name": "to_language_code", + "type": "string", + "description": "A two-letter ISO 639-1 language code of the language to which the message is translated" + } + ], + "is_synchronous": false, + "type": 2 + }, { "name": "getChatAvailableMessageSenders", "description": "Returns list of message sender identifiers, which can be used to send messages in a chat", @@ -18770,8 +19666,8 @@ "type": 2 }, { - "name": "setChatDefaultMessageSender", - "description": "Changes default message sender that is chosen in a chat", + "name": "setChatMessageSender", + "description": "Selects a message sender to send messages in a chat", "class": "Ok", "properties": [ { @@ -18780,9 +19676,9 @@ "description": "Chat identifier" }, { - "name": "default_message_sender_id", + "name": "message_sender_id", "type": "MessageSender", - "description": "New default message sender in the chat" + "description": "New message sender for the chat" } ], "is_synchronous": false, @@ -18806,7 +19702,7 @@ { "name": "reply_to_message_id", "type": "int53", - "description": "Identifier of the message to reply to or 0" + "description": "Identifier of the replied message; 0 if none" }, { "name": "options", @@ -18829,7 +19725,7 @@ }, { "name": "sendMessageAlbum", - "description": "Sends 2-10 messages grouped together into an album. Currently only audio, document, photo and video messages can be grouped into an album. Documents and audio files can be only grouped in an album with messages of the same type. Returns sent messages", + "description": "Sends 2-10 messages grouped together into an album. Currently, only audio, document, photo and video messages can be grouped into an album. Documents and audio files can be only grouped in an album with messages of the same type. Returns sent messages", "class": "Messages", "properties": [ { @@ -18845,7 +19741,7 @@ { "name": "reply_to_message_id", "type": "int53", - "description": "Identifier of a message to reply to or 0" + "description": "Identifier of a replied message; 0 if none" }, { "name": "options", @@ -18856,6 +19752,11 @@ "name": "input_message_contents", "type": "vector\u003cInputMessageContent\u003e", "description": "Contents of messages to be sent. At most 10 messages can be added to an album" + }, + { + "name": "only_preview", + "type": "Bool", + "description": "Pass true to get fake messages instead of actually sending them" } ], "is_synchronous": false, @@ -18903,7 +19804,7 @@ { "name": "reply_to_message_id", "type": "int53", - "description": "Identifier of a message to reply to or 0" + "description": "Identifier of a replied message; 0 if none" }, { "name": "options", @@ -18923,7 +19824,7 @@ { "name": "hide_via_bot", "type": "Bool", - "description": "If true, there will be no mention of a bot, via which the message is sent. Can be used only for bots GetOption(\"animation_search_bot_username\"), GetOption(\"photo_search_bot_username\") and GetOption(\"venue_search_bot_username\")" + "description": "Pass true to hide the bot, via which the message is sent. Can be used only for bots GetOption(\"animation_search_bot_username\"), GetOption(\"photo_search_bot_username\"), and GetOption(\"venue_search_bot_username\")" } ], "is_synchronous": false, @@ -18957,17 +19858,17 @@ { "name": "send_copy", "type": "Bool", - "description": "If true, content of the messages will be copied without reference to the original sender. Always true if the messages are forwarded to a secret chat or are local" + "description": "Pass true to copy content of the messages without reference to the original sender. Always true if the messages are forwarded to a secret chat or are local" }, { "name": "remove_caption", "type": "Bool", - "description": "If true, media caption of message copies will be removed. Ignored if send_copy is false" + "description": "Pass true to remove media captions of message copies. Ignored if send_copy is false" }, { "name": "only_preview", "type": "Bool", - "description": "If true, messages will not be forwarded and instead fake messages will be returned" + "description": "Pass true to get fake messages instead of actually forwarding them" } ], "is_synchronous": false, @@ -19024,7 +19925,7 @@ { "name": "reply_to_message_id", "type": "int53", - "description": "Identifier of the message to reply to or 0" + "description": "Identifier of the replied message; 0 if none" }, { "name": "disable_notification", @@ -19058,7 +19959,7 @@ { "name": "revoke", "type": "Bool", - "description": "Pass true to try to delete messages for all chat members. Always true for supergroups, channels and secret chats" + "description": "Pass true to delete messages for all chat members. Always true for supergroups, channels and secret chats" } ], "is_synchronous": false, @@ -19106,7 +20007,7 @@ { "name": "revoke", "type": "Bool", - "description": "Pass true to try to delete chat messages for all users; private chats only" + "description": "Pass true to delete chat messages for all users; private chats only" } ], "is_synchronous": false, @@ -19411,6 +20312,88 @@ "is_synchronous": false, "type": 2 }, + { + "name": "getMessageAvailableReactions", + "description": "Returns reactions, which can be added to a message. The list can change after updateReactions, updateChatAvailableReactions for the chat, or updateMessageInteractionInfo for the message", + "class": "AvailableReactions", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Identifier of the chat to which the message belongs" + }, + { + "name": "message_id", + "type": "int53", + "description": "Identifier of the message" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "setMessageReaction", + "description": "Changes chosen reaction for a message", + "class": "Ok", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Identifier of the chat to which the message belongs" + }, + { + "name": "message_id", + "type": "int53", + "description": "Identifier of the message" + }, + { + "name": "reaction", + "type": "string", + "description": "Text representation of the new chosen reaction. Can be an empty string or the currently chosen non-big reaction to remove the reaction" + }, + { + "name": "is_big", + "type": "Bool", + "description": "Pass true if the reaction is added with a big animation" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "getMessageAddedReactions", + "description": "Returns reactions added for a message, along with their sender", + "class": "AddedReactions", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Identifier of the chat to which the message belongs" + }, + { + "name": "message_id", + "type": "int53", + "description": "Identifier of the message" + }, + { + "name": "reaction", + "type": "string", + "description": "If non-empty, only added reactions with the specified text representation will be returned" + }, + { + "name": "offset", + "type": "string", + "description": "Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results" + }, + { + "name": "limit", + "type": "int32", + "description": "The maximum number of reactions to be returned; must be positive and can't be greater than 100" + } + ], + "is_synchronous": false, + "type": 2 + }, { "name": "getTextEntities", "description": "Returns all entities (mentions, hashtags, cashtags, bot commands, bank card numbers, URLs, and email addresses) contained in the text. Can be called synchronously", @@ -19427,7 +20410,7 @@ }, { "name": "parseTextEntities", - "description": "Parses Bold, Italic, Underline, Strikethrough, Code, Pre, PreCode, TextUrl and MentionName entities contained in the text. Can be called synchronously", + "description": "Parses Bold, Italic, Underline, Strikethrough, Spoiler, Code, Pre, PreCode, TextUrl and MentionName entities contained in the text. Can be called synchronously", "class": "FormattedText", "properties": [ { @@ -19452,7 +20435,7 @@ { "name": "text", "type": "formattedText", - "description": "The text to parse. For example, \"__italic__ ~~strikethrough~~ **bold** `code` ```pre``` __[italic__ text_url](telegram.org) __italic**bold italic__bold**\"" + "description": "The text to parse. For example, \"__italic__ ~~strikethrough~~ ||spoiler|| **bold** `code` ```pre``` __[italic__ text_url](telegram.org) __italic**bold italic__bold**\"" } ], "is_synchronous": true, @@ -19571,6 +20554,20 @@ "is_synchronous": true, "type": 1 }, + { + "name": "getThemeParametersJsonString", + "description": "Converts a themeParameters object to corresponding JSON-serialized string. Can be called synchronously", + "class": "Text", + "properties": [ + { + "name": "theme", + "type": "themeParameters", + "description": "Theme parameters to convert to JSON" + } + ], + "is_synchronous": true, + "type": 1 + }, { "name": "setPollAnswer", "description": "Changes the user answer to a poll. A poll in quiz mode can be answered only once", @@ -19714,7 +20711,7 @@ { "name": "allow_write_access", "type": "Bool", - "description": "True, if the user allowed the bot to send them messages" + "description": "Pass true to allow the bot to send messages to the current user" } ], "is_synchronous": false, @@ -19767,7 +20764,7 @@ { "name": "is_personal", "type": "Bool", - "description": "True, if the result of the query can be cached for the specified user" + "description": "Pass true if results may be cached and returned only for the user that sent the query. By default, results may be returned to any user who sends the same query" }, { "name": "results", @@ -19798,6 +20795,121 @@ "is_synchronous": false, "type": 3 }, + { + "name": "getWebAppUrl", + "description": "Returns an HTTPS URL of a web app to open after keyboardButtonTypeWebApp button is pressed", + "class": "HttpUrl", + "properties": [ + { + "name": "bot_user_id", + "type": "int53", + "description": "Identifier of the target bot" + }, + { + "name": "url", + "type": "string", + "description": "The URL from the keyboardButtonTypeWebApp button" + }, + { + "name": "theme", + "type": "themeParameters", + "description": "Preferred web app theme; pass null to use the default theme" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "sendWebAppData", + "description": "Sends data received from a keyboardButtonTypeWebApp web app to a bot", + "class": "Ok", + "properties": [ + { + "name": "bot_user_id", + "type": "int53", + "description": "Identifier of the target bot" + }, + { + "name": "button_text", + "type": "string", + "description": "Text of the keyboardButtonTypeWebApp button, which opened the web app" + }, + { + "name": "data", + "type": "string", + "description": "Received data" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "openWebApp", + "description": "Informs TDLib that a web app is being opened from attachment menu, a botMenuButton button, an internalLinkTypeAttachmentMenuBot link, or an inlineKeyboardButtonTypeWebApp button. For each bot, a confirmation alert about data sent to the bot must be shown once", + "class": "WebAppInfo", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Identifier of the chat in which the web app is opened. Web apps can be opened only in private chats for now" + }, + { + "name": "bot_user_id", + "type": "int53", + "description": "Identifier of the bot, providing the web app" + }, + { + "name": "url", + "type": "string", + "description": "The URL from an inlineKeyboardButtonTypeWebApp button, a botMenuButton button, or an internalLinkTypeAttachmentMenuBot link, or an empty string otherwise" + }, + { + "name": "theme", + "type": "themeParameters", + "description": "Preferred web app theme; pass null to use the default theme" + }, + { + "name": "reply_to_message_id", + "type": "int53", + "description": "Identifier of the replied message for the message sent by the web app; 0 if none" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "closeWebApp", + "description": "Informs TDLib that a previously opened web app was closed", + "class": "Ok", + "properties": [ + { + "name": "web_app_launch_id", + "type": "int64", + "description": "Identifier of web app launch, received from openWebApp" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "answerWebAppQuery", + "description": "Sets the result of interaction with a web app and sends corresponding message on behalf of the user to the chat from which the query originated; for bots only", + "class": "SentWebAppMessage", + "properties": [ + { + "name": "web_app_query_id", + "type": "string", + "description": "Identifier of the web app query" + }, + { + "name": "result", + "type": "InputInlineQueryResult", + "description": "The result of the query" + } + ], + "is_synchronous": false, + "type": 3 + }, { "name": "getCallbackQueryAnswer", "description": "Sends a callback query to a bot and returns an answer. Returns an error with code 502 if the bot fails to answer the query before the query timeout expires", @@ -19840,7 +20952,7 @@ { "name": "show_alert", "type": "Bool", - "description": "If true, an alert must be shown to the user instead of a toast notification" + "description": "Pass true to show an alert to the user instead of a toast notification" }, { "name": "url", @@ -19917,7 +21029,7 @@ { "name": "edit_message", "type": "Bool", - "description": "True, if the message needs to be edited" + "description": "Pass true to edit the game message to include the current scoreboard" }, { "name": "user_id", @@ -19951,7 +21063,7 @@ { "name": "edit_message", "type": "Bool", - "description": "True, if the message needs to be edited" + "description": "Pass true to edit the game message to include the current scoreboard" }, { "name": "user_id", @@ -20088,7 +21200,7 @@ }, { "name": "viewMessages", - "description": "Informs TDLib that messages are being viewed by the user. Many useful activities depend on whether the messages are currently being viewed or not (e.g., marking messages as read, incrementing a view counter, updating a view counter, removing deleted messages in supergroups and channels)", + "description": "Informs TDLib that messages are being viewed by the user. Sponsored messages must be marked as viewed only when the entire text of the message is shown on the screen (excluding the button). Many useful activities depend on whether the messages are currently being viewed or not (e.g., marking messages as read, incrementing a view counter, updating a view counter, removing deleted messages in supergroups and channels)", "class": "Ok", "properties": [ { @@ -20109,7 +21221,7 @@ { "name": "force_read", "type": "Bool", - "description": "True, if messages in closed chats must be marked as read by the request" + "description": "Pass true to mark as read the specified messages even the chat is closed" } ], "is_synchronous": false, @@ -20194,7 +21306,7 @@ { "name": "allow_write_access", "type": "Bool", - "description": "True, if the current user allowed the bot, returned in getExternalLinkInfo, to send them messages" + "description": "Pass true if the current user allowed the bot, returned in getExternalLinkInfo, to send them messages" } ], "is_synchronous": false, @@ -20214,6 +21326,20 @@ "is_synchronous": false, "type": 2 }, + { + "name": "readAllChatReactions", + "description": "Marks all reactions in a chat as read", + "class": "Ok", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + } + ], + "is_synchronous": false, + "type": 2 + }, { "name": "createPrivateChat", "description": "Returns an existing chat corresponding to a given user", @@ -20227,7 +21353,7 @@ { "name": "force", "type": "Bool", - "description": "If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect" + "description": "Pass true to create the chat without a network request. In this case all information about the chat except its type, title and photo can be incorrect" } ], "is_synchronous": false, @@ -20246,7 +21372,7 @@ { "name": "force", "type": "Bool", - "description": "If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect" + "description": "Pass true to create the chat without a network request. In this case all information about the chat except its type, title and photo can be incorrect" } ], "is_synchronous": false, @@ -20265,7 +21391,7 @@ { "name": "force", "type": "Bool", - "description": "If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect" + "description": "Pass true to create the chat without a network request. In this case all information about the chat except its type, title and photo can be incorrect" } ], "is_synchronous": false, @@ -20317,7 +21443,7 @@ { "name": "is_channel", "type": "Bool", - "description": "True, if a channel chat needs to be created" + "description": "Pass true to create a channel chat" }, { "name": "description", @@ -20332,7 +21458,7 @@ { "name": "for_import", "type": "Bool", - "description": "True, if the supergroup is created for importing messages using importMessage" + "description": "Pass true to create a supergroup for importing messages using importMessage" } ], "is_synchronous": false, @@ -20535,8 +21661,8 @@ "type": 1 }, { - "name": "setChatMessageTtlSetting", - "description": "Changes the message TTL setting (sets a new self-destruct timer) in a chat. Requires can_delete_messages administrator right in basic groups, supergroups and channels Message TTL setting of a chat with the current user (Saved Messages) and the chat 777000 (Telegram) can't be changed", + "name": "setChatMessageTtl", + "description": "Changes the message TTL in a chat. Requires can_delete_messages administrator right in basic groups, supergroups and channels Message TTL can't be changed in a chat with the current user (Saved Messages) and the chat 777000 (Telegram).", "class": "Ok", "properties": [ { @@ -20547,7 +21673,7 @@ { "name": "ttl", "type": "int32", - "description": "New TTL value, in seconds; must be one of 0, 86400, 7 * 86400, or 31 * 86400 unless the chat is secret" + "description": "New TTL value, in seconds; unless the chat is secret, it must be from 0 up to 365 * 86400 and be divisible by 86400" } ], "is_synchronous": false, @@ -20647,7 +21773,7 @@ { "name": "has_protected_content", "type": "Bool", - "description": "True, if chat content can't be saved locally, forwarded, or copied" + "description": "New value of has_protected_content" } ], "is_synchronous": false, @@ -20691,6 +21817,25 @@ "is_synchronous": false, "type": 2 }, + { + "name": "setChatAvailableReactions", + "description": "Changes reactions, available in a chat. Available for basic groups, supergroups, and channels. Requires can_change_info administrator right", + "class": "Ok", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Identifier of the chat" + }, + { + "name": "available_reactions", + "type": "vector\u003cstring\u003e", + "description": "New list of reactions, available in the chat. All reactions must be active" + } + ], + "is_synchronous": false, + "type": 1 + }, { "name": "setChatClientData", "description": "Changes application-specific data associated with a chat", @@ -20804,12 +21949,12 @@ { "name": "disable_notification", "type": "Bool", - "description": "True, if there must be no notification about the pinned message. Notifications are always disabled in channels and private chats" + "description": "Pass true to disable notification about the pinned message. Notifications are always disabled in channels and private chats" }, { "name": "only_for_self", "type": "Bool", - "description": "True, if the message needs to be pinned for one side only; private chats only" + "description": "Pass true to pin the message only for self; private chats only" } ], "is_synchronous": false, @@ -20902,7 +22047,7 @@ }, { "name": "addChatMembers", - "description": "Adds multiple new members to a chat. Currently this method is only available for 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", + "description": "Adds multiple new members to a chat. Currently, this method is only available for 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", "class": "Ok", "properties": [ { @@ -20961,7 +22106,7 @@ { "name": "banned_until_date", "type": "int32", - "description": "Point in time (Unix timestamp) when the user will be unbanned; 0 if never. If the user is banned for more than 366 days or for less than 30 seconds from the current time, the user is considered to be banned forever. Ignored in basic groups" + "description": "Point in time (Unix timestamp) when the user will be unbanned; 0 if never. If the user is banned for more than 366 days or for less than 30 seconds from the current time, the user is considered to be banned forever. Ignored in basic groups and if a chat is banned" }, { "name": "revoke_messages", @@ -21068,13 +22213,63 @@ }, { "name": "clearAllDraftMessages", - "description": "Clears draft messages in all chats", + "description": "Clears message drafts in all chats", "class": "Ok", "properties": [ { "name": "exclude_secret_chats", "type": "Bool", - "description": "If true, local draft messages in secret chats will not be cleared" + "description": "Pass true to keep local message drafts in secret chats" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "getSavedNotificationSound", + "description": "Returns saved notification sound by its identifier. Returns a 404 error if there is no saved notification sound with the specified identifier", + "class": "NotificationSounds", + "properties": [ + { + "name": "notification_sound_id", + "type": "int64", + "description": "Identifier of the notification sound" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "getSavedNotificationSounds", + "description": "Returns list of saved notification sounds. If a sound isn't in the list, then default sound needs to be used", + "class": "NotificationSounds", + "properties": [], + "is_synchronous": false, + "type": 2 + }, + { + "name": "addSavedNotificationSound", + "description": "Adds a new notification sound to the list of saved notification sounds. The new notification sound is added to the top of the list. If it is already in the list, it is position isn't changed", + "class": "NotificationSound", + "properties": [ + { + "name": "sound", + "type": "InputFile", + "description": "Notification sound file to add" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "removeSavedNotificationSound", + "description": "Removes a notification sound from the list of saved notification sounds", + "class": "Ok", + "properties": [ + { + "name": "notification_sound_id", + "type": "int64", + "description": "Identifier of the notification sound" } ], "is_synchronous": false, @@ -21093,7 +22288,7 @@ { "name": "compare_sound", "type": "Bool", - "description": "If true, also chats with non-default sound will be returned" + "description": "Pass true to include in the response chats with only non-default sound" } ], "is_synchronous": false, @@ -21134,7 +22329,7 @@ }, { "name": "resetAllNotificationSettings", - "description": "Resets all notification settings to their default values. By default, all chats are unmuted, the sound is set to \"default\" and message previews are shown", + "description": "Resets all notification settings to their default values. By default, all chats are unmuted and message previews are shown", "class": "Ok", "properties": [], "is_synchronous": false, @@ -21142,7 +22337,7 @@ }, { "name": "toggleChatIsPinned", - "description": "Changes the pinned state of a chat. There can be up to GetOption(\"pinned_chat_count_max\")/GetOption(\"pinned_archived_chat_count_max\") pinned non-secret chats and the same number of secret chats in the main/arhive chat list", + "description": "Changes the pinned state of a chat. There can be up to GetOption(\"pinned_chat_count_max\")/GetOption(\"pinned_archived_chat_count_max\") pinned non-secret chats and the same number of secret chats in the main/archive chat list", "class": "Ok", "properties": [ { @@ -21158,7 +22353,7 @@ { "name": "is_pinned", "type": "Bool", - "description": "True, if the chat is pinned" + "description": "Pass true to pin the chat; pass false to unpin it" } ], "is_synchronous": false, @@ -21183,6 +22378,39 @@ "is_synchronous": false, "type": 2 }, + { + "name": "getAttachmentMenuBot", + "description": "Returns information about a bot that can be added to attachment menu", + "class": "AttachmentMenuBot", + "properties": [ + { + "name": "bot_user_id", + "type": "int53", + "description": "Bot's user identifier" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "toggleBotIsAddedToAttachmentMenu", + "description": "Adds or removes a bot to attachment menu. Bot can be added to attachment menu, only if userTypeBot.can_be_added_to_attachment_menu == true", + "class": "Ok", + "properties": [ + { + "name": "bot_user_id", + "type": "int53", + "description": "Bot's user identifier" + }, + { + "name": "is_added", + "type": "Bool", + "description": "Pass true to add the bot to attachment menu; pass false to remove the bot from attachment menu" + } + ], + "is_synchronous": false, + "type": 2 + }, { "name": "downloadFile", "description": "Downloads a file from the cloud. Download progress and completion of the download will be notified through updateFile updates", @@ -21196,7 +22424,7 @@ { "name": "priority", "type": "int32", - "description": "Priority of the download (1-32). The higher the priority, the earlier the file will be downloaded. If the priorities of two files are equal, then the last one for which downloadFile was called will be downloaded first" + "description": "Priority of the download (1-32). The higher the priority, the earlier the file will be downloaded. If the priorities of two files are equal, then the last one for which downloadFile/addFileToDownloads was called will be downloaded first" }, { "name": "offset", @@ -21211,7 +22439,7 @@ { "name": "synchronous", "type": "Bool", - "description": "If false, this request returns file state just after the download has been started. If true, this request returns file state only after the download has succeeded, has failed, has been canceled or a new downloadFile request with different offset/limit parameters was sent" + "description": "Pass true to return response only after the file download has succeeded, has failed, has been canceled, or a new downloadFile request with different offset/limit parameters was sent; pass false to return file state immediately, just after the download has been started" } ], "is_synchronous": false, @@ -21417,6 +22645,145 @@ "is_synchronous": false, "type": 1 }, + { + "name": "addFileToDownloads", + "description": "Adds a file from a message to the list of file downloads. Download progress and completion of the download will be notified through updateFile updates. If message database is used, the list of file downloads is persistent across application restarts. The downloading is independent from download using downloadFile, i.e. it continues if downloadFile is canceled or is used to download a part of the file", + "class": "File", + "properties": [ + { + "name": "file_id", + "type": "int32", + "description": "Identifier of the file to download" + }, + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier of the message with the file" + }, + { + "name": "message_id", + "type": "int53", + "description": "Message identifier" + }, + { + "name": "priority", + "type": "int32", + "description": "Priority of the download (1-32). The higher the priority, the earlier the file will be downloaded. If the priorities of two files are equal, then the last one for which downloadFile/addFileToDownloads was called will be downloaded first" + } + ], + "is_synchronous": false, + "type": 1 + }, + { + "name": "toggleDownloadIsPaused", + "description": "Changes pause state of a file in the file download list", + "class": "Ok", + "properties": [ + { + "name": "file_id", + "type": "int32", + "description": "Identifier of the downloaded file" + }, + { + "name": "is_paused", + "type": "Bool", + "description": "Pass true if the download is paused" + } + ], + "is_synchronous": false, + "type": 1 + }, + { + "name": "toggleAllDownloadsArePaused", + "description": "Changes pause state of all files in the file download list", + "class": "Ok", + "properties": [ + { + "name": "are_paused", + "type": "Bool", + "description": "Pass true to pause all downloads; pass false to unpause them" + } + ], + "is_synchronous": false, + "type": 1 + }, + { + "name": "removeFileFromDownloads", + "description": "Removes a file from the file download list", + "class": "Ok", + "properties": [ + { + "name": "file_id", + "type": "int32", + "description": "Identifier of the downloaded file" + }, + { + "name": "delete_from_cache", + "type": "Bool", + "description": "Pass true to delete the file from the TDLib file cache" + } + ], + "is_synchronous": false, + "type": 1 + }, + { + "name": "removeAllFilesFromDownloads", + "description": "Removes all files from the file download list", + "class": "Ok", + "properties": [ + { + "name": "only_active", + "type": "Bool", + "description": "Pass true to remove only active downloads, including paused" + }, + { + "name": "only_completed", + "type": "Bool", + "description": "Pass true to remove only completed downloads" + }, + { + "name": "delete_from_cache", + "type": "Bool", + "description": "Pass true to delete the file from the TDLib file cache" + } + ], + "is_synchronous": false, + "type": 1 + }, + { + "name": "searchFileDownloads", + "description": "Searches for files in the file download list or recently downloaded files from the list", + "class": "FoundFileDownloads", + "properties": [ + { + "name": "query", + "type": "string", + "description": "Query to search for; may be empty to return all downloaded files" + }, + { + "name": "only_active", + "type": "Bool", + "description": "Pass true to search only for active downloads, including paused" + }, + { + "name": "only_completed", + "type": "Bool", + "description": "Pass true to search only for completed downloads" + }, + { + "name": "offset", + "type": "string", + "description": "Offset of the first entry to return as received from the previous request; use empty string to get the first chunk of results" + }, + { + "name": "limit", + "type": "int32", + "description": "The maximum number of files to be returned" + } + ], + "is_synchronous": false, + "type": 1 + }, { "name": "getMessageFileType", "description": "Returns information about a file with messages exported from another app", @@ -21499,19 +22866,19 @@ "description": "Invite link name; 0-32 characters" }, { - "name": "expire_date", + "name": "expiration_date", "type": "int32", "description": "Point in time (Unix timestamp) when the link will expire; pass 0 if never" }, { "name": "member_limit", "type": "int32", - "description": "The maximum number of chat members that can join the chat by the link simultaneously; 0-99999; pass 0 if not limited" + "description": "The maximum number of chat members that can join the chat via the link simultaneously; 0-99999; pass 0 if not limited" }, { "name": "creates_join_request", "type": "Bool", - "description": "True, if the link only creates join request. If true, member_limit must not be specified" + "description": "Pass true if users joining the chat via the link need to be approved by chat administrators. In this case, member_limit must be 0" } ], "is_synchronous": false, @@ -21538,19 +22905,19 @@ "description": "Invite link name; 0-32 characters" }, { - "name": "expire_date", + "name": "expiration_date", "type": "int32", "description": "Point in time (Unix timestamp) when the link will expire; pass 0 if never" }, { "name": "member_limit", "type": "int32", - "description": "The maximum number of chat members that can join the chat by the link simultaneously; 0-99999; pass 0 if not limited" + "description": "The maximum number of chat members that can join the chat via the link simultaneously; 0-99999; pass 0 if not limited" }, { "name": "creates_join_request", "type": "Bool", - "description": "True, if the link only creates join request. If true, member_limit must not be specified" + "description": "Pass true if users joining the chat via the link need to be approved by chat administrators. In this case, member_limit must be 0" } ], "is_synchronous": false, @@ -21630,7 +22997,7 @@ }, { "name": "getChatInviteLinkMembers", - "description": "Returns chat members joined a chat by an invite link. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links", + "description": "Returns chat members joined a chat via an invite link. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links", "class": "ChatInviteLinkMembers", "properties": [ { @@ -21770,7 +23137,7 @@ { "name": "limit", "type": "int32", - "description": "The maximum number of chat join requests to return" + "description": "The maximum number of requests to join the chat to return" } ], "is_synchronous": false, @@ -21794,7 +23161,7 @@ { "name": "approve", "type": "Bool", - "description": "True, if the request is approved. Otherwise the request is declived" + "description": "Pass true to approve the request; pass false to decline it" } ], "is_synchronous": false, @@ -21818,7 +23185,7 @@ { "name": "approve", "type": "Bool", - "description": "True, if the requests are approved. Otherwise the requests are declived" + "description": "Pass true to approve all requests; pass false to decline them" } ], "is_synchronous": false, @@ -21842,7 +23209,7 @@ { "name": "is_video", "type": "Bool", - "description": "True, if a video call needs to be created" + "description": "Pass true to create a video call" } ], "is_synchronous": false, @@ -21899,7 +23266,7 @@ { "name": "is_disconnected", "type": "Bool", - "description": "True, if the user was disconnected" + "description": "Pass true if the user was disconnected" }, { "name": "duration", @@ -21909,7 +23276,7 @@ { "name": "is_video", "type": "Bool", - "description": "True, if the call was a video call" + "description": "Pass true if the call was a video call" }, { "name": "connection_id", @@ -21970,7 +23337,7 @@ }, { "name": "getVideoChatAvailableParticipants", - "description": "Returns list of participant identifiers, which can be used to join video chats in a chat", + "description": "Returns list of participant identifiers, on whose behalf a video chat in the chat can be joined", "class": "MessageSenders", "properties": [ { @@ -21984,7 +23351,7 @@ }, { "name": "setVideoChatDefaultParticipant", - "description": "Changes default participant identifier, which can be used to join video chats in a chat", + "description": "Changes default participant identifier, on whose behalf a video chat in the chat will be joined", "class": "Ok", "properties": [ { @@ -22009,7 +23376,7 @@ { "name": "chat_id", "type": "int53", - "description": "Chat identifier, in which the video chat will be created" + "description": "Identifier of a chat in which the video chat will be created" }, { "name": "title", @@ -22020,6 +23387,39 @@ "name": "start_date", "type": "int32", "description": "Point in time (Unix timestamp) when the group call is supposed to be started by an administrator; 0 to start the video chat immediately. The date must be at least 10 seconds and at most 8 days in the future" + }, + { + "name": "is_rtmp_stream", + "type": "Bool", + "description": "Pass true to create an RTMP stream instead of an ordinary video chat; requires creator privileges" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "getVideoChatRtmpUrl", + "description": "Returns RTMP URL for streaming to the chat; requires creator privileges", + "class": "RtmpUrl", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" + } + ], + "is_synchronous": false, + "type": 2 + }, + { + "name": "replaceVideoChatRtmpUrl", + "description": "Replaces the current RTMP URL for streaming to the chat; requires creator privileges", + "class": "RtmpUrl", + "properties": [ + { + "name": "chat_id", + "type": "int53", + "description": "Chat identifier" } ], "is_synchronous": false, @@ -22100,12 +23500,12 @@ { "name": "is_muted", "type": "Bool", - "description": "True, if the user's microphone is muted" + "description": "Pass true to join the call with muted microphone" }, { "name": "is_my_video_enabled", "type": "Bool", - "description": "True, if the user's video is enabled" + "description": "Pass true if the user's video is enabled" }, { "name": "invite_hash", @@ -22211,20 +23611,6 @@ "is_synchronous": false, "type": 2 }, - { - "name": "revokeGroupCallInviteLink", - "description": "Revokes invite link for a group call. Requires groupCall.can_be_managed group call flag", - "class": "Ok", - "properties": [ - { - "name": "group_call_id", - "type": "int32", - "description": "Group call identifier" - } - ], - "is_synchronous": false, - "type": 2 - }, { "name": "inviteGroupCallParticipants", "description": "Invites users to an active group call. Sends a service message of type messageInviteToGroupCall for video chats", @@ -22263,6 +23649,20 @@ "is_synchronous": false, "type": 2 }, + { + "name": "revokeGroupCallInviteLink", + "description": "Revokes invite link for a group call. Requires groupCall.can_be_managed group call flag", + "class": "Ok", + "properties": [ + { + "name": "group_call_id", + "type": "int32", + "description": "Group call identifier" + } + ], + "is_synchronous": false, + "type": 2 + }, { "name": "startGroupCallRecording", "description": "Starts recording of an active group call. Requires groupCall.can_be_managed group call flag", @@ -22362,7 +23762,7 @@ { "name": "is_speaking", "type": "Bool", - "description": "True, if the user is speaking" + "description": "Pass true if the user is speaking" } ], "is_synchronous": false, @@ -22386,7 +23786,7 @@ { "name": "is_muted", "type": "Bool", - "description": "Pass true if the user must be muted and false otherwise" + "description": "Pass true to mute the user; pass false to unmute the them" } ], "is_synchronous": false, @@ -22474,8 +23874,8 @@ "type": 2 }, { - "name": "discardGroupCall", - "description": "Discards a group call. Requires groupCall.can_be_managed", + "name": "endGroupCall", + "description": "Ends a group call. Requires groupCall.can_be_managed", "class": "Ok", "properties": [ { @@ -22487,6 +23887,20 @@ "is_synchronous": false, "type": 2 }, + { + "name": "getGroupCallStreams", + "description": "Returns information about available group call streams", + "class": "GroupCallStreams", + "properties": [ + { + "name": "group_call_id", + "type": "int32", + "description": "Group call identifier" + } + ], + "is_synchronous": false, + "type": 2 + }, { "name": "getGroupCallStreamSegment", "description": "Returns a file with a segment of a group call stream in a modified OGG format for audio or MPEG-4 format for video", @@ -22553,17 +23967,17 @@ { "name": "delete_message", "type": "Bool", - "description": "Pass true if the message must be deleted" + "description": "Pass true to delete the message" }, { "name": "delete_all_messages", "type": "Bool", - "description": "Pass true if all messages from the same sender must be deleted" + "description": "Pass true to delete all messages from the same sender" }, { "name": "report_spam", "type": "Bool", - "description": "Pass true if the sender must be reported to the Telegram moderators" + "description": "Pass true to report the sender to the Telegram moderators" } ], "is_synchronous": false, @@ -22596,12 +24010,12 @@ { "name": "contact", "type": "contact", - "description": "The contact to add or edit; phone number can be empty and needs to be specified only if known, vCard is ignored" + "description": "The contact to add or edit; phone number may be empty and needs to be specified only if known, vCard is ignored" }, { "name": "share_phone_number", "type": "Bool", - "description": "True, if the new contact needs to be allowed to see current user's phone number. A corresponding rule to userPrivacySettingShowPhoneNumber will be added if needed. Use the field userFullInfo.need_phone_number_privacy_exception to check whether the current user needs to be asked to share their phone number" + "description": "Pass true to share the current user's phone number with the new contact. A corresponding rule to userPrivacySettingShowPhoneNumber will be added if needed. Use the field userFullInfo.need_phone_number_privacy_exception to check whether the current user needs to be asked to share their phone number" } ], "is_synchronous": false, @@ -22692,6 +24106,20 @@ "is_synchronous": false, "type": 2 }, + { + "name": "searchUserByPhoneNumber", + "description": "Searches a user by their phone number", + "class": "User", + "properties": [ + { + "name": "phone_number", + "type": "string", + "description": "Phone number to search for" + } + ], + "is_synchronous": false, + "type": 2 + }, { "name": "sharePhoneNumber", "description": "Shares the phone number of the current user with a mutual contact. Supposed to be called when the user clicks on chatActionBarSharePhoneNumber", @@ -22827,7 +24255,7 @@ }, { "name": "getAttachedStickerSets", - "description": "Returns a list of sticker sets attached to a file. Currently only photos and videos can have attached sticker sets", + "description": "Returns a list of sticker sets attached to a file. Currently, only photos and videos can have attached sticker sets", "class": "StickerSets", "properties": [ { @@ -23091,7 +24519,7 @@ { "name": "exact_match", "type": "Bool", - "description": "True, if only emojis, which exactly match text needs to be returned" + "description": "Pass true if only emojis, which exactly match the text, needs to be returned" }, { "name": "input_language_codes", @@ -23234,7 +24662,7 @@ { "name": "force_full", "type": "Bool", - "description": "If true, the full instant view for the web page will be returned" + "description": "Pass true to get full instant view for the web page" } ], "is_synchronous": false, @@ -23383,7 +24811,7 @@ { "name": "language_code", "type": "string", - "description": "A two-letter ISO 639-1 country code. If empty, the commands will be applied to all users from the given scope, for which language there are no dedicated commands" + "description": "A two-letter ISO 639-1 language code. If empty, the commands will be applied to all users from the given scope, for which language there are no dedicated commands" }, { "name": "commands", @@ -23407,7 +24835,7 @@ { "name": "language_code", "type": "string", - "description": "A two-letter ISO 639-1 country code or an empty string" + "description": "A two-letter ISO 639-1 language code or an empty string" } ], "is_synchronous": false, @@ -23426,7 +24854,68 @@ { "name": "language_code", "type": "string", - "description": "A two-letter ISO 639-1 country code or an empty string" + "description": "A two-letter ISO 639-1 language code or an empty string" + } + ], + "is_synchronous": false, + "type": 3 + }, + { + "name": "setMenuButton", + "description": "Sets menu button for the given user or for all users; for bots only", + "class": "Ok", + "properties": [ + { + "name": "user_id", + "type": "int53", + "description": "Identifier of the user or 0 to set menu button for all users" + }, + { + "name": "menu_button", + "type": "botMenuButton", + "description": "New menu button" + } + ], + "is_synchronous": false, + "type": 3 + }, + { + "name": "getMenuButton", + "description": "Returns menu button set by the bot for the given user; for bots only", + "class": "BotMenuButton", + "properties": [ + { + "name": "user_id", + "type": "int53", + "description": "Identifier of the user or 0 to get the default menu button" + } + ], + "is_synchronous": false, + "type": 3 + }, + { + "name": "setDefaultGroupAdministratorRights", + "description": "Sets default administrator rights for adding the bot to basic group and supergroup chats; for bots only", + "class": "Ok", + "properties": [ + { + "name": "default_group_administrator_rights", + "type": "chatAdministratorRights", + "description": "Default administrator rights for adding the bot to basic group and supergroup chats; may be null" + } + ], + "is_synchronous": false, + "type": 3 + }, + { + "name": "setDefaultChannelAdministratorRights", + "description": "Sets default administrator rights for adding the bot to channel chats; for bots only", + "class": "Ok", + "properties": [ + { + "name": "default_channel_administrator_rights", + "type": "chatAdministratorRights", + "description": "Default administrator rights for adding the bot to channels; may be null" } ], "is_synchronous": false, @@ -23475,7 +24964,7 @@ { "name": "can_accept_calls", "type": "Bool", - "description": "True, if incoming calls can be accepted by the session" + "description": "Pass true to allow accepting incoming calls by the session; pass false otherwise" } ], "is_synchronous": false, @@ -23494,7 +24983,7 @@ { "name": "can_accept_secret_chats", "type": "Bool", - "description": "True, if incoming secret chats can be accepted by the session" + "description": "Pass true to allow accepring secret chats by the session; pass false otherwise" } ], "is_synchronous": false, @@ -23636,7 +25125,7 @@ }, { "name": "reportSupergroupSpam", - "description": "Reports some messages from a message sender in a supergroup as spam; requires administrator rights in the supergroup", + "description": "Reports messages in a supergroup as spam; requires administrator rights in the supergroup", "class": "Ok", "properties": [ { @@ -23647,7 +25136,7 @@ { "name": "message_ids", "type": "vector\u003cint53\u003e", - "description": "Identifiers of messages sent in the supergroup. All messages must be sent by the same sender. This list must be non-empty" + "description": "Identifiers of messages to report" } ], "is_synchronous": false, @@ -23752,7 +25241,7 @@ }, { "name": "theme", - "type": "paymentFormTheme", + "type": "themeParameters", "description": "Preferred payment form theme; pass null to use the default theme" } ], @@ -23782,7 +25271,7 @@ { "name": "allow_save", "type": "Bool", - "description": "True, if the order information can be saved" + "description": "Pass true to save the order information" } ], "is_synchronous": false, @@ -23853,7 +25342,7 @@ }, { "name": "getSavedOrderInfo", - "description": "Returns saved order info, if any", + "description": "Returns saved order information. Returns a 404 error if there is no saved order information", "class": "OrderInfo", "properties": [], "is_synchronous": false, @@ -23861,7 +25350,7 @@ }, { "name": "deleteSavedOrderInfo", - "description": "Deletes saved order info", + "description": "Deletes saved order information", "class": "Ok", "properties": [], "is_synchronous": false, @@ -23891,7 +25380,7 @@ { "name": "for_dark_theme", "type": "Bool", - "description": "True, if the backgrounds must be ordered for dark theme" + "description": "Pass true to order returned backgrounds for a dark theme" } ], "is_synchronous": false, @@ -23948,7 +25437,7 @@ { "name": "for_dark_theme", "type": "Bool", - "description": "True, if the background is chosen for dark theme" + "description": "Pass true if the background is changed for a dark theme" } ], "is_synchronous": false, @@ -23984,7 +25473,7 @@ { "name": "only_local", "type": "Bool", - "description": "If true, returns only locally available information without sending network requests" + "description": "Pass true to get only locally available information without sending network requests" } ], "is_synchronous": false, @@ -24296,7 +25785,7 @@ }, { "name": "reportChat", - "description": "Reports a chat to the Telegram moderators. A chat can be reported only from the chat action bar, or if this is a private chat with a bot, a private chat with a user sharing their location, a supergroup, or a channel, since other chats can't be checked by moderators", + "description": "Reports a chat to the Telegram moderators. A chat can be reported only from the chat action bar, or if chat.can_be_reported", "class": "Ok", "properties": [ { @@ -24307,7 +25796,7 @@ { "name": "message_ids", "type": "vector\u003cint53\u003e", - "description": "Identifiers of reported messages, if any" + "description": "Identifiers of reported messages; may be empty to report the whole chat" }, { "name": "reason", @@ -24325,7 +25814,7 @@ }, { "name": "reportChatPhoto", - "description": "Reports a chat photo to the Telegram moderators. A chat photo can be reported only if this is a private chat with a bot, a private chat with a user sharing their location, a supergroup, or a channel, since other chats can't be checked by moderators", + "description": "Reports a chat photo to the Telegram moderators. A chat photo can be reported only if chat.can_be_reported", "class": "Ok", "properties": [ { @@ -24354,7 +25843,7 @@ }, { "name": "getChatStatistics", - "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", + "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", "class": "ChatStatistics", "properties": [ { @@ -24467,7 +25956,7 @@ { "name": "count", "type": "int32", - "description": "Limit on the total count of files after deletion. Pass -1 to use the default limit" + "description": "Limit on the total number of files after deletion. Pass -1 to use the default limit" }, { "name": "immunity_delay", @@ -24525,7 +26014,7 @@ { "name": "only_current", "type": "Bool", - "description": "If true, returns only data for the current library launch" + "description": "Pass true to get statistics only for the current library launch" } ], "is_synchronous": false, @@ -24904,7 +26393,7 @@ }, { "name": "uploadStickerFile", - "description": "Uploads a PNG image with a sticker; returns the uploaded file", + "description": "Uploads a file with a sticker; returns the uploaded file", "class": "File", "properties": [ { @@ -24914,7 +26403,7 @@ }, { "name": "sticker", - "type": "InputSticker", + "type": "inputSticker", "description": "Sticker file to upload" } ], @@ -24969,15 +26458,10 @@ "type": "string", "description": "Sticker set name. Can contain only English letters, digits and underscores. Must end with *\"_by_\u003cbot username\u003e\"* (*\u003cbot_username\u003e* is case insensitive) for bots; 1-64 characters" }, - { - "name": "is_masks", - "type": "Bool", - "description": "True, if stickers are masks. Animated stickers can't be masks" - }, { "name": "stickers", - "type": "vector\u003cInputSticker\u003e", - "description": "List of stickers to be added to the set; must be non-empty. All stickers must be of the same type. For animated stickers, uploadStickerFile must be used before the sticker is shown" + "type": "vector\u003cinputSticker\u003e", + "description": "List of stickers to be added to the set; must be non-empty. All stickers must have the same format. For TGS stickers, uploadStickerFile must be used before the sticker is shown" }, { "name": "source", @@ -25005,7 +26489,7 @@ }, { "name": "sticker", - "type": "InputSticker", + "type": "inputSticker", "description": "Sticker to add to the set" } ], @@ -25030,7 +26514,7 @@ { "name": "thumbnail", "type": "InputFile", - "description": "Thumbnail to set in PNG or TGS format; pass null to remove the sticker set thumbnail. Animated thumbnail must be set for animated sticker sets and only for them" + "description": "Thumbnail to set in PNG, TGS, or WEBM format; pass null to remove the sticker set thumbnail. Thumbnail format must match the format of stickers in the set" } ], "is_synchronous": false, @@ -25102,7 +26586,7 @@ { "name": "chat_id", "type": "int53", - "description": "Identifier of a chat, in which the thumbnail will be shown. Use 0 if unknown" + "description": "Identifier of a chat in which the thumbnail will be shown. Use 0 if unknown" } ], "is_synchronous": false, @@ -25212,7 +26696,7 @@ { "name": "language_code", "type": "string", - "description": "A two-letter ISO 639-1 country code for country information localization" + "description": "A two-letter ISO 639-1 language code for country information localization" }, { "name": "phone_number_prefix", @@ -25295,7 +26779,7 @@ { "name": "enable", "type": "Bool", - "description": "True, if the proxy needs to be enabled" + "description": "Pass true to immediately enable the proxy" }, { "name": "type", @@ -25329,7 +26813,7 @@ { "name": "enable", "type": "Bool", - "description": "True, if the proxy needs to be enabled" + "description": "Pass true to immediately enable the proxy" }, { "name": "type", @@ -25653,7 +27137,7 @@ { "name": "dc_id", "type": "int32", - "description": "Identifier of a datacenter, with which to test connection" + "description": "Identifier of a datacenter with which to test connection" }, { "name": "timeout", diff --git a/data/td_api.tl b/data/td_api.tl index 370e193..0621bb6 100644 --- a/data/td_api.tl +++ b/data/td_api.tl @@ -52,10 +52,10 @@ authenticationCodeTypeSms length:int32 = AuthenticationCodeType; //@description An authentication code is delivered via a phone call to the specified phone number @length Length of the code authenticationCodeTypeCall length:int32 = AuthenticationCodeType; -//@description An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number from which the call was made is the code that should be entered automatically @pattern Pattern of the phone number from which the call will be made +//@description An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number that calls is the code that must be entered automatically @pattern Pattern of the phone number from which the call will be made authenticationCodeTypeFlashCall pattern:string = AuthenticationCodeType; -//@description An authentication code is delivered by an immediately canceled call to the specified phone number. The phone number from which the call was made is the code that should be entered manually by the user @phone_number_prefix Prefix of the phone number from which the call will be made @length Number of digits in the code, excluding the prefix +//@description An authentication code is delivered by an immediately canceled call to the specified phone number. The last digits of the phone number that calls are the code that must be entered manually by the user @phone_number_prefix Prefix of the phone number from which the call will be made @length Number of digits in the code, excluding the prefix authenticationCodeTypeMissedCall phone_number_prefix:string length:int32 = AuthenticationCodeType; @@ -73,11 +73,11 @@ textEntity offset:int32 length:int32 type:TextEntityType = TextEntity; textEntities entities:vector = TextEntities; //@description A text with some entities @text The text @entities Entities contained in the text. Entities can be nested, but must not mutually intersect with each other. -//-Pre, Code and PreCode entities can't contain other entities. Bold, Italic, Underline and Strikethrough entities can contain and to be contained in all other entities. All other entities can't contain each other +//-Pre, Code and PreCode entities can't contain other entities. Bold, Italic, Underline, Strikethrough, and Spoiler entities can contain and to be contained in all other entities. All other entities can't contain each other formattedText text:string entities:vector = FormattedText; -//@description Contains Telegram terms of service @text Text of the terms of service @min_user_age The minimum age of a user to be able to accept the terms; 0 if any @show_popup True, if a blocking popup with terms of service must be shown to the user +//@description Contains Telegram terms of service @text Text of the terms of service @min_user_age The minimum age of a user to be able to accept the terms; 0 if age isn't restricted @show_popup True, if a blocking popup with terms of service must be shown to the user termsOfService text:formattedText min_user_age:int32 show_popup:Bool = TermsOfService; @@ -135,7 +135,7 @@ temporaryPasswordState has_password:Bool valid_for:int32 = TemporaryPasswordStat //@description Represents a local file //@path Local path to the locally available file part; may be empty -//@can_be_downloaded True, if it is possible to try to download or generate the file +//@can_be_downloaded True, if it is possible to download or generate the file //@can_be_deleted True, if the file can be deleted //@is_downloading_active True, if the file is currently being downloaded (or a local copy is being generated by some other means) //@is_downloading_completed True, if the local copy is fully available @@ -147,7 +147,7 @@ localFile path:string can_be_downloaded:Bool can_be_deleted:Bool is_downloading_ //@description Represents a remote file //@id Remote file identifier; may be empty. Can be used by the current user across application restarts or even from other devices. Uniquely identifies a file, but a file can have a lot of different valid identifiers. //-If the ID starts with "http://" or "https://", it represents the HTTP URL of the file. TDLib is currently unable to download files if only their URL is known. -//-If downloadFile is called on such a file or if it is sent to a secret chat, TDLib starts a file generation process by sending updateFileGenerationStart to the application with the HTTP URL in the original_path and "#url#" as the conversion string. Application must generate the file by downloading it to the specified location +//-If downloadFile/addFileToDownloads is called on such a file or if it is sent to a secret chat, TDLib starts a file generation process by sending updateFileGenerationStart to the application with the HTTP URL in the original_path and "#url#" as the conversion string. Application must generate the file by downloading it to the specified location //@unique_id Unique file identifier; may be empty if unknown. The unique file identifier which is the same for the same file even for different users and is persistent over time //@is_uploading_active True, if the file is currently being uploaded (or a remote copy is being generated by some other means) //@is_uploading_completed True, if a remote copy is fully available @@ -191,26 +191,29 @@ photoSize type:string photo:file width:int32 height:int32 progressive_sizes:vect minithumbnail width:int32 height:int32 data:bytes = Minithumbnail; -//@class ThumbnailFormat @description Describes format of the thumbnail +//@class ThumbnailFormat @description Describes format of a thumbnail //@description The thumbnail is in JPEG format thumbnailFormatJpeg = ThumbnailFormat; -//@description The thumbnail is in PNG format. It will be used only for background patterns -thumbnailFormatPng = ThumbnailFormat; - -//@description The thumbnail is in WEBP format. It will be used only for some stickers -thumbnailFormatWebp = ThumbnailFormat; - //@description The thumbnail is in static GIF format. It will be used only for some bot inline results thumbnailFormatGif = ThumbnailFormat; -//@description The thumbnail is in TGS format. It will be used only for animated sticker sets -thumbnailFormatTgs = ThumbnailFormat; - //@description The thumbnail is in MPEG4 format. It will be used only for some animations and videos thumbnailFormatMpeg4 = ThumbnailFormat; +//@description The thumbnail is in PNG format. It will be used only for background patterns +thumbnailFormatPng = ThumbnailFormat; + +//@description The thumbnail is in TGS format. It will be used only for TGS sticker sets +thumbnailFormatTgs = ThumbnailFormat; + +//@description The thumbnail is in WEBM format. It will be used only for WEBM sticker sets +thumbnailFormatWebm = ThumbnailFormat; + +//@description The thumbnail is in WEBP format. It will be used only for some stickers +thumbnailFormatWebp = ThumbnailFormat; + //@description Represents a thumbnail @format Thumbnail format @width Thumbnail width @height Thumbnail height @file The thumbnail thumbnail format:ThumbnailFormat width:int32 height:int32 file:file = Thumbnail; @@ -237,6 +240,21 @@ maskPointChin = MaskPoint; maskPosition point:MaskPoint x_shift:double y_shift:double scale:double = MaskPosition; +//@class StickerType @description Describes type of a sticker + +//@description The sticker is an image in WEBP format +stickerTypeStatic = StickerType; + +//@description The sticker is an animation in TGS format +stickerTypeAnimated = StickerType; + +//@description The sticker is a video in WEBM format +stickerTypeVideo = StickerType; + +//@description The sticker is a mask in WEBP format to be placed on photos or videos @mask_position Position where the mask is placed; may be null +stickerTypeMask mask_position:maskPosition = StickerType; + + //@description Represents a closed vector path. The path begins at the end point of the last command @commands List of vector path commands closedVectorPath commands:vector = ClosedVectorPath; @@ -277,9 +295,9 @@ document file_name:string mime_type:string minithumbnail:minithumbnail thumbnail photo has_stickers:Bool minithumbnail:minithumbnail sizes:vector = Photo; //@description Describes a sticker @set_id The identifier of the sticker set to which the sticker belongs; 0 if none @width Sticker width; as defined by the sender @height Sticker height; as defined by the sender -//@emoji Emoji corresponding to the sticker @is_animated True, if the sticker is an animated sticker in TGS format @is_mask True, if the sticker is a mask @mask_position Position where the mask is placed; may be null -//@outline Sticker's outline represented as a list of closed vector paths; may be empty. The coordinate system origin is in the upper-left corner @thumbnail Sticker thumbnail in WEBP or JPEG format; may be null @sticker File containing the sticker -sticker set_id:int64 width:int32 height:int32 emoji:string is_animated:Bool is_mask:Bool mask_position:maskPosition outline:vector thumbnail:thumbnail sticker:file = Sticker; +//@emoji Emoji corresponding to the sticker @type Sticker type @outline Sticker's outline represented as a list of closed vector paths; may be empty. The coordinate system origin is in the upper-left corner +//@thumbnail Sticker thumbnail in WEBP or JPEG format; may be null @sticker File containing the sticker +sticker set_id:int64 width:int32 height:int32 emoji:string type:StickerType outline:vector thumbnail:thumbnail sticker:file = Sticker; //@description Describes a video file @duration Duration of the video, in seconds; as defined by the sender @width Video width; as defined by the sender @height Video height; as defined by the sender //@file_name Original name of the file; as defined by the sender @mime_type MIME type of the file; as defined by the sender @@ -300,7 +318,7 @@ voiceNote duration:int32 waveform:bytes mime_type:string voice:file = VoiceNote; //@description Describes an animated representation of an emoji //@sticker Animated sticker for the emoji //@fitzpatrick_type Emoji modifier fitzpatrick type; 0-6; 0 if none -//@sound File containing the sound to be played when the animated emoji is clicked if any; may be null. The sound is encoded with the Opus codec, and stored inside an OGG container +//@sound File containing the sound to be played when the animated emoji is clicked; may be null. The sound is encoded with the Opus codec, and stored inside an OGG container animatedEmoji sticker:sticker fitzpatrick_type:int32 sound:file = AnimatedEmoji; //@description Describes a user contact @phone_number Phone number of the user @first_name First name of the user; 1-255 characters in length @last_name Last name of the user @vcard Additional data about the user in a form of vCard; 0-2048 bytes in length @user_id Identifier of the user, if known; otherwise 0 @@ -310,7 +328,7 @@ contact phone_number:string first_name:string last_name:string vcard:string user //@horizontal_accuracy The estimated horizontal accuracy of the location, in meters; as defined by the sender. 0 if unknown location latitude:double longitude:double horizontal_accuracy:double = Location; -//@description Describes a venue @location Venue location; as defined by the sender @title Venue name; as defined by the sender @address Venue address; as defined by the sender @provider Provider of the venue database; as defined by the sender. Currently only "foursquare" and "gplaces" (Google Places) need to be supported +//@description Describes a venue @location Venue location; as defined by the sender @title Venue name; as defined by the sender @address Venue address; as defined by the sender @provider Provider of the venue database; as defined by the sender. Currently, only "foursquare" and "gplaces" (Google Places) need to be supported //@id Identifier of the venue in the provider database; as defined by the sender @type Type of the venue in the provider database; as defined by the sender venue location:location title:string address:string provider:string id:string type:string = Venue; @@ -348,10 +366,14 @@ userTypeRegular = UserType; //@description A deleted user or deleted bot. No information on the user besides the user identifier is available. It is not possible to perform any active actions on this type of user userTypeDeleted = UserType; -//@description A bot (see https://core.telegram.org/bots) @can_join_groups True, if the bot can be invited to basic group and supergroup chats +//@description A bot (see https://core.telegram.org/bots) +//@can_join_groups True, if the bot can be invited to basic group and supergroup chats //@can_read_all_group_messages True, if the bot can read all messages in basic group or supergroup chats and not just those addressed to the bot. In private and channel chats a bot can always read all messages -//@is_inline True, if the bot supports inline queries @inline_query_placeholder Placeholder for inline queries (displayed on the application input field) @need_location True, if the location of the user is expected to be sent with every inline query to this bot -userTypeBot can_join_groups:Bool can_read_all_group_messages:Bool is_inline:Bool inline_query_placeholder:string need_location:Bool = UserType; +//@is_inline True, if the bot supports inline queries +//@inline_query_placeholder Placeholder for inline queries (displayed on the application input field) +//@need_location True, if the location of the user is expected to be sent with every inline query to this bot +//@can_be_added_to_attachment_menu True, if the bot can be added to attachment menu +userTypeBot can_join_groups:Bool can_read_all_group_messages:Bool is_inline:Bool inline_query_placeholder:string need_location:Bool can_be_added_to_attachment_menu:Bool = UserType; //@description No information on the user besides the user identifier is available, yet this user has not been deleted. This object is extremely rare and must be handled like a deleted user. It is not possible to perform any actions on users of this type userTypeUnknown = UserType; @@ -363,6 +385,9 @@ botCommand command:string description:string = BotCommand; //@description Contains a list of bot commands @bot_user_id Bot's user identifier @commands List of bot commands botCommands bot_user_id:int53 commands:vector = BotCommands; +//@description Describes a button to be shown instead of bot commands menu button @text Text of the button @url URL to be passed to openWebApp +botMenuButton text:string url:string = BotMenuButton; + //@description Represents a location to which a chat is connected @location The location @address Location address; 1-64 characters, as defined by the chat owner chatLocation location:location address:string = ChatLocation; @@ -401,6 +426,32 @@ inputChatPhotoStatic photo:InputFile = InputChatPhoto; inputChatPhotoAnimation animation:InputFile main_frame_timestamp:double = InputChatPhoto; +//@description Describes actions that a user is allowed to take in a chat +//@can_send_messages True, if the user can send text messages, contacts, locations, and venues +//@can_send_media_messages True, if the user can send audio files, documents, photos, videos, video notes, and voice notes. Implies can_send_messages permissions +//@can_send_polls True, if the user can send polls. Implies can_send_messages permissions +//@can_send_other_messages True, if the user can send animations, games, stickers, and dice and use inline bots. Implies can_send_messages permissions +//@can_add_web_page_previews True, if the user may add a web page preview to their messages. Implies can_send_messages permissions +//@can_change_info True, if the user can change the chat title, photo, and other settings +//@can_invite_users True, if the user can invite new users to the chat +//@can_pin_messages True, if the user can pin messages +chatPermissions can_send_messages:Bool can_send_media_messages:Bool can_send_polls:Bool can_send_other_messages:Bool can_add_web_page_previews:Bool can_change_info:Bool can_invite_users:Bool can_pin_messages:Bool = ChatPermissions; + +//@description Describes rights of the administrator +//@can_manage_chat True, if the administrator can get chat event log, get chat statistics, get message statistics in channels, get channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other privilege; applicable to supergroups and channels only +//@can_change_info True, if the administrator can change the chat title, photo, and other settings +//@can_post_messages True, if the administrator can create channel posts; applicable to channels only +//@can_edit_messages True, if the administrator can edit messages of other users and pin messages; applicable to channels only +//@can_delete_messages True, if the administrator can delete messages of other users +//@can_invite_users True, if the administrator can invite new users to the chat +//@can_restrict_members True, if the administrator can restrict, ban, or unban chat members; always true for channels +//@can_pin_messages True, if the administrator can pin messages; applicable to basic groups and supergroups only +//@can_promote_members True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that were directly or indirectly promoted by them +//@can_manage_video_chats True, if the administrator can manage video chats +//@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_promote_members:Bool can_manage_video_chats:Bool is_anonymous:Bool = ChatAdministratorRights; + + //@description Represents a user //@id User identifier //@first_name First name of the user @@ -416,11 +467,20 @@ inputChatPhotoAnimation animation:InputFile main_frame_timestamp:double = InputC //@restriction_reason If non-empty, it contains a human-readable description of the reason why access to this user must be restricted //@is_scam True, if many users reported this user as a scam //@is_fake True, if many users reported this user as a fake account -//@have_access If false, the user is inaccessible, and the only information known about the user is inside this class. It can't be passed to any method except GetUser +//@have_access If false, the user is inaccessible, and the only information known about the user is inside this class. Identifier of the user can't be passed to any method except GetUser //@type Type of the user //@language_code IETF language tag of the user's language; only available to bots user id:int53 first_name:string last_name:string username:string phone_number:string status:UserStatus profile_photo:profilePhoto is_contact:Bool is_mutual_contact:Bool is_verified:Bool is_support:Bool restriction_reason:string is_scam:Bool is_fake:Bool have_access:Bool type:UserType language_code:string = User; +//@description Contains information about a bot +//@share_text The text that is shown on the bot's profile page and is sent together with the link when users share the bot +//@param_description The text shown in the chat with the bot if the chat is empty +//@menu_button Information about a button to show instead of the bot commands menu button; may be null if ordinary bot commands menu must be shown +//@commands List of the bot commands +//@default_group_administrator_rights Default administrator rights for adding the bot to basic group and supergroup chats; may be null +//@default_channel_administrator_rights Default administrator rights for adding the bot to channels; may be null +botInfo share_text:string description:string menu_button:botMenuButton commands:vector default_group_administrator_rights:chatAdministratorRights default_channel_administrator_rights:chatAdministratorRights = BotInfo; + //@description Contains full information about a user //@photo User profile photo; may be null //@is_blocked True, if the user is blocked by the current user @@ -430,13 +490,11 @@ user id:int53 first_name:string last_name:string username:string phone_number:st //@has_private_forwards True, if the user can't be linked in forwarded messages due to their privacy settings //@need_phone_number_privacy_exception True, if the current user needs to explicitly allow to share their phone number with the user when the method addContact is used //@bio A short user bio -//@share_text For bots, the text that is shown on the bot's profile page and is sent together with the link when users share the bot -//@param_description For bots, the text shown in the chat with the bot if the chat is empty //@group_in_common_count Number of group chats where both the other user and the current user are a member; 0 for the current user -//@commands For bots, list of the bot commands -userFullInfo photo:chatPhoto is_blocked:Bool can_be_called:Bool supports_video_calls:Bool has_private_calls:Bool has_private_forwards:Bool need_phone_number_privacy_exception:Bool bio:string share_text:string description:string group_in_common_count:int32 commands:vector = UserFullInfo; +//@bot_info For bots, information about the bot; may be null +userFullInfo photo:chatPhoto is_blocked:Bool can_be_called:Bool supports_video_calls:Bool has_private_calls:Bool has_private_forwards:Bool need_phone_number_privacy_exception:Bool bio:string group_in_common_count:int32 bot_info:botInfo = UserFullInfo; -//@description Represents a list of users @total_count Approximate total count of users found @user_ids A list of user identifiers +//@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 = Users; @@ -447,18 +505,6 @@ chatAdministrator user_id:int53 custom_title:string is_owner:Bool = ChatAdminist chatAdministrators administrators:vector = ChatAdministrators; -//@description Describes actions that a user is allowed to take in a chat -//@can_send_messages True, if the user can send text messages, contacts, locations, and venues -//@can_send_media_messages True, if the user can send audio files, documents, photos, videos, video notes, and voice notes. Implies can_send_messages permissions -//@can_send_polls True, if the user can send polls. Implies can_send_messages permissions -//@can_send_other_messages True, if the user can send animations, games, stickers, and dice and use inline bots. Implies can_send_messages permissions -//@can_add_web_page_previews True, if the user may add a web page preview to their messages. Implies can_send_messages permissions -//@can_change_info True, if the user can change the chat title, photo, and other settings -//@can_invite_users True, if the user can invite new users to the chat -//@can_pin_messages True, if the user can pin messages -chatPermissions can_send_messages:Bool can_send_media_messages:Bool can_send_polls:Bool can_send_other_messages:Bool can_add_web_page_previews:Bool can_change_info:Bool can_invite_users:Bool can_pin_messages:Bool = ChatPermissions; - - //@class ChatMemberStatus @description Provides information about the status of a member in a chat //@description The user is the owner of the chat and has all the administrator privileges @@ -470,18 +516,8 @@ chatMemberStatusCreator custom_title:string is_anonymous:Bool is_member:Bool = C //@description The user is a member of the chat and has some additional privileges. In basic groups, administrators can edit and delete messages sent by others, add new members, ban unprivileged members, and manage video chats. In supergroups and channels, there are more detailed options for administrator privileges //@custom_title A custom title of the administrator; 0-16 characters without emojis; applicable to supergroups only //@can_be_edited True, if the current user can edit the administrator privileges for the called user -//@can_manage_chat True, if the administrator can get chat event log, get chat statistics, get message statistics in channels, get channel members, see anonymous administrators in supergroups and ignore slow mode. Implied by any other privilege; applicable to supergroups and channels only -//@can_change_info True, if the administrator can change the chat title, photo, and other settings -//@can_post_messages True, if the administrator can create channel posts; applicable to channels only -//@can_edit_messages True, if the administrator can edit messages of other users and pin messages; applicable to channels only -//@can_delete_messages True, if the administrator can delete messages of other users -//@can_invite_users True, if the administrator can invite new users to the chat -//@can_restrict_members True, if the administrator can restrict, ban, or unban chat members; always true for channels -//@can_pin_messages True, if the administrator can pin messages; applicable to basic groups and supergroups only -//@can_promote_members True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that were directly or indirectly promoted by them -//@can_manage_video_chats True, if the administrator can manage video chats -//@is_anonymous True, if the administrator isn't shown in the chat member list and sends messages anonymously; applicable to supergroups only -chatMemberStatusAdministrator custom_title:string can_be_edited:Bool 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_promote_members:Bool can_manage_video_chats:Bool is_anonymous:Bool = ChatMemberStatus; +//@rights Rights of the administrator +chatMemberStatusAdministrator custom_title:string can_be_edited:Bool rights:chatAdministratorRights = ChatMemberStatus; //@description The user is a member of the chat, without any additional privileges or restrictions chatMemberStatusMember = ChatMemberStatus; @@ -507,7 +543,7 @@ chatMemberStatusBanned banned_until_date:int32 = ChatMemberStatus; //@status Status of the member in the chat chatMember member_id:MessageSender inviter_user_id:int53 joined_chat_date:int32 status:ChatMemberStatus = ChatMember; -//@description Contains a list of chat members @total_count Approximate total count of chat members found @members A list of chat members +//@description Contains a list of chat members @total_count Approximate total number of chat members found @members A list of chat members chatMembers total_count:int32 members:vector = ChatMembers; @@ -568,16 +604,16 @@ supergroupMembersFilterBots = SupergroupMembersFilter; //@creator_user_id User identifier of an administrator created the link //@date Point in time (Unix timestamp) when the link was created //@edit_date Point in time (Unix timestamp) when the link was last edited; 0 if never or unknown -//@expire_date Point in time (Unix timestamp) when the link will expire; 0 if never +//@expiration_date Point in time (Unix timestamp) when the link will expire; 0 if never //@member_limit The maximum number of members, which can join the chat using the link simultaneously; 0 if not limited. Always 0 if the link requires approval //@member_count Number of chat members, which joined the chat using the link //@pending_join_request_count Number of pending join requests created using this link //@creates_join_request True, if the link only creates join request. If true, total number of joining members will be unlimited -//@is_primary True, if the link is primary. Primary invite link can't have name, expire date or usage limit. There is exactly one primary invite link for each administrator with can_invite_users right at a given time +//@is_primary True, if the link is primary. Primary invite link can't have name, expiration date, or usage limit. There is exactly one primary invite link for each administrator with can_invite_users right at a given time //@is_revoked True, if the link was revoked -chatInviteLink invite_link:string name:string creator_user_id:int53 date:int32 edit_date:int32 expire_date:int32 member_limit:int32 member_count:int32 pending_join_request_count:int32 creates_join_request:Bool is_primary:Bool is_revoked:Bool = ChatInviteLink; +chatInviteLink invite_link:string name:string creator_user_id:int53 date:int32 edit_date:int32 expiration_date:int32 member_limit:int32 member_count:int32 pending_join_request_count:int32 creates_join_request:Bool is_primary:Bool is_revoked:Bool = ChatInviteLink; -//@description Contains a list of chat invite links @total_count Approximate total count of chat invite links found @invite_links List of invite links +//@description Contains a list of chat invite links @total_count Approximate total number of chat invite links found @invite_links List of invite links chatInviteLinks total_count:int32 invite_links:vector = ChatInviteLinks; //@description Describes a chat administrator with a number of active and revoked chat invite links @@ -589,10 +625,10 @@ chatInviteLinkCount user_id:int53 invite_link_count:int32 revoked_invite_link_co //@description Contains a list of chat invite link counts @invite_link_counts List of invite link counts chatInviteLinkCounts invite_link_counts:vector = ChatInviteLinkCounts; -//@description Describes a chat member joined a chat by an invite link @user_id User identifier @joined_chat_date Point in time (Unix timestamp) when the user joined the chat @approver_user_id User identifier of the chat administrator, approved user join request +//@description Describes a chat member joined a chat via an invite link @user_id User identifier @joined_chat_date Point in time (Unix timestamp) when the user joined the chat @approver_user_id User identifier of the chat administrator, approved user join request chatInviteLinkMember user_id:int53 joined_chat_date:int32 approver_user_id:int53 = ChatInviteLinkMember; -//@description Contains a list of chat members joined a chat by an invite link @total_count Approximate total count of chat members found @members List of chat members, joined a chat by an invite link +//@description Contains a list of chat members joined a chat via an invite link @total_count Approximate total number of chat members found @members List of chat members, joined a chat via an invite link chatInviteLinkMembers total_count:int32 members:vector = ChatInviteLinkMembers; //@description Contains information about a chat invite link @@ -611,10 +647,10 @@ chatInviteLinkInfo chat_id:int53 accessible_for:int32 type:ChatType title:string //@description Describes a user that sent a join request and waits for administrator approval @user_id User identifier @date Point in time (Unix timestamp) when the user sent the join request @bio A short bio of the user chatJoinRequest user_id:int53 date:int32 bio:string = ChatJoinRequest; -//@description Contains a list of chat join requests @total_count Approximate total count of requests found @requests List of the requests +//@description Contains a list of requests to join a chat @total_count Approximate total number of requests found @requests List of the requests chatJoinRequests total_count:int32 requests:vector = ChatJoinRequests; -//@description Contains information about pending chat join requests @total_count Total number of pending join requests @user_ids Identifiers of users sent the newest pending join requests +//@description Contains information about pending join requests for a chat @total_count Total number of pending join requests @user_ids Identifiers of at most 3 users sent the newest pending join requests chatJoinRequestsInfo total_count:int32 user_ids:vector = ChatJoinRequestsInfo; @@ -641,13 +677,13 @@ basicGroupFullInfo photo:chatPhoto description:string creator_user_id:int53 memb //@username Username of the supergroup or channel; empty for private supergroups or channels //@date Point in time (Unix timestamp) when the current user joined, or the point in time when the supergroup or channel was created, in case the user is not a member //@status Status of the current user in the supergroup or channel; custom title will be always empty -//@member_count Number of members in the supergroup or channel; 0 if unknown. Currently it is guaranteed to be known only if the supergroup or channel was received through searchPublicChats, searchChatsNearby, getInactiveSupergroupChats, getSuitableDiscussionChats, getGroupsInCommon, or getUserPrivacySettingRules +//@member_count Number of members in the supergroup or channel; 0 if unknown. Currently, it is guaranteed to be known only if the supergroup or channel was received through searchPublicChats, searchChatsNearby, getInactiveSupergroupChats, getSuitableDiscussionChats, getGroupsInCommon, or getUserPrivacySettingRules //@has_linked_chat True, if the channel has a discussion group, or the supergroup is the designated discussion group for a channel //@has_location True, if the supergroup is connected to a location, i.e. the supergroup is a location-based supergroup //@sign_messages True, if messages sent to the channel need to contain information about the sender. This field is only applicable to channels //@is_slow_mode_enabled True, if the slow mode is enabled in the supergroup //@is_channel True, if the supergroup is a channel -//@is_broadcast_group True, if the supergroup is a broadcast group, i.e. only administrators can send messages and there is no limit on number of members +//@is_broadcast_group True, if the supergroup is a broadcast group, i.e. only administrators can send messages and there is no limit on the number of members //@is_verified True, if the supergroup or channel is verified //@restriction_reason If non-empty, contains a human-readable description of the reason why access to this supergroup or channel must be restricted //@is_scam True, if many users reported this supergroup or channel as a scam @@ -672,7 +708,7 @@ supergroup id:int53 username:string date:int32 status:ChatMemberStatus member_co //@is_all_history_available True, if new chat members will have access to old messages. In public or discussion groups and both public and private channels, old messages are always available, so this option affects only private supergroups without a linked chat. The value of this field is only available for chat administrators //@sticker_set_id Identifier of the supergroup sticker set; 0 if none //@location Location to which the supergroup is connected; may be null -//@invite_link Primary invite link for this chat; may be null. For chat administrators with can_invite_users right only +//@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 //@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 @@ -711,7 +747,7 @@ messageSenderUser user_id:int53 = MessageSender; messageSenderChat chat_id:int53 = MessageSender; -//@description Represents a list of message senders @total_count Approximate total count of messages senders found @senders List of message senders +//@description Represents a list of message senders @total_count Approximate total number of messages senders found @senders List of message senders messageSenders total_count:int32 senders:vector = MessageSenders; @@ -720,9 +756,9 @@ messageSenders total_count:int32 senders:vector = MessageSenders; //@description The message was originally sent by a known user @sender_user_id Identifier of the user that originally sent the message messageForwardOriginUser sender_user_id:int53 = MessageForwardOrigin; -//@description The message was originally sent by an anonymous chat administrator on behalf of the chat +//@description The message was originally sent on behalf of a chat //@sender_chat_id Identifier of the chat that originally sent the message -//@author_signature Original message author signature +//@author_signature For messages originally sent by an anonymous chat administrator, original message author signature messageForwardOriginChat sender_chat_id:int53 author_signature:string = MessageForwardOrigin; //@description The message was originally sent by a user, which is hidden by their privacy settings @sender_name Name of the sender @@ -748,17 +784,31 @@ messageForwardInfo origin:MessageForwardOrigin date:int32 public_service_announc //@description Contains information about replies to a message //@reply_count Number of times the message was directly or indirectly replied -//@recent_replier_ids Identifiers of recent repliers to the message; available in channels with a discussion supergroup +//@recent_replier_ids Identifiers of at most 3 recent repliers to the message; available in channels with a discussion supergroup. The users and chats are expected to be inaccessible: only their photo and name will be available //@last_read_inbox_message_id Identifier of the last read incoming reply to the message //@last_read_outbox_message_id Identifier of the last read outgoing reply to the message //@last_message_id Identifier of the last reply to the message messageReplyInfo reply_count:int32 recent_replier_ids:vector last_read_inbox_message_id:int53 last_read_outbox_message_id:int53 last_message_id:int53 = MessageReplyInfo; +//@description Contains information about a reaction to a message +//@reaction Text representation of the reaction +//@total_count Number of times the reaction was added +//@is_chosen True, if the reaction is chosen by the current user +//@recent_sender_ids Identifiers of at most 3 recent message senders, added the reaction; available in private, basic group and supergroup chats +messageReaction reaction:string total_count:int32 is_chosen:Bool recent_sender_ids:vector = MessageReaction; + //@description Contains information about interactions with a message //@view_count Number of times the message was viewed //@forward_count Number of times the message was forwarded //@reply_info Information about direct or indirect replies to the message; may be null. Currently, available only in channels with a discussion supergroup and discussion supergroups for messages, which are not replies itself -messageInteractionInfo view_count:int32 forward_count:int32 reply_info:messageReplyInfo = MessageInteractionInfo; +//@reactions The list of reactions added to the message +messageInteractionInfo view_count:int32 forward_count:int32 reply_info:messageReplyInfo reactions:vector = MessageInteractionInfo; + +//@description Contains information about an unread reaction to a message +//@reaction Text representation of the reaction +//@sender_id Identifier of the sender, added the reaction +//@is_big True, if the reaction was added with a big animation +unreadReaction reaction:string sender_id:MessageSender is_big:Bool = UnreadReaction; //@class MessageSendingState @description Contains information about the sending state of the message @@ -786,10 +836,11 @@ messageSendingStateFailed error_code:int32 error_message:string can_retry:Bool n //@can_be_saved True, if content of the message can be saved locally or copied //@can_be_deleted_only_for_self True, if the message can be deleted only for the current user while other users will continue to see it //@can_be_deleted_for_all_users True, if the message can be deleted for all users -//@can_get_statistics True, if the message statistics are available -//@can_get_message_thread True, if the message thread info is available +//@can_get_added_reactions True, if the list of added reactions is available through getMessageAddedReactions +//@can_get_statistics True, if the message statistics are available through getMessageStatistics +//@can_get_message_thread True, if information about the message thread is available through getMessageThread //@can_get_viewers True, if chat members already viewed the message can be received through getMessageViewers -//@can_get_media_timestamp_links True, if media timestamp links can be generated for media timestamp entities in the message text, caption or web page description +//@can_get_media_timestamp_links True, if media timestamp links can be generated for media timestamp entities in the message text, caption or web page description through getMessageLink //@has_timestamped_media True, if media timestamp entities refers to a media in this message as opposed to a media in the replied message //@is_channel_post True, if the message is a channel post. All messages to channels are channel posts, all other messages are not channel posts //@contains_unread_mention True, if the message contains an unread mention for the current user @@ -797,6 +848,7 @@ messageSendingStateFailed error_code:int32 error_message:string can_retry:Bool n //@edit_date Point in time (Unix timestamp) when the message was last edited //@forward_info Information about the initial message sender; may be null //@interaction_info Information about interactions with the message; may be null +//@unread_reactions Information about unread reactions added to the message //@reply_in_chat_id If non-zero, the identifier of the chat to which the replied message belongs; Currently, only messages in the Replies chat can have different reply_in_chat_id and chat_id //@reply_to_message_id If non-zero, the identifier of the message this message is replying to; can be the identifier of a deleted message //@message_thread_id If non-zero, the identifier of the message thread the message belongs to; unique within the chat to which the message belongs @@ -808,33 +860,55 @@ messageSendingStateFailed error_code:int32 error_message:string can_retry:Bool n //@restriction_reason If non-empty, contains a human-readable description of the reason why access to this message must be restricted //@content Content of the message //@reply_markup Reply markup for the message; may be null -message id:int53 sender_id:MessageSender chat_id:int53 sending_state:MessageSendingState scheduling_state:MessageSchedulingState is_outgoing:Bool is_pinned:Bool can_be_edited:Bool can_be_forwarded:Bool can_be_saved:Bool can_be_deleted_only_for_self:Bool can_be_deleted_for_all_users:Bool can_get_statistics:Bool can_get_message_thread:Bool can_get_viewers:Bool can_get_media_timestamp_links:Bool has_timestamped_media:Bool is_channel_post:Bool contains_unread_mention:Bool date:int32 edit_date:int32 forward_info:messageForwardInfo interaction_info:messageInteractionInfo reply_in_chat_id:int53 reply_to_message_id:int53 message_thread_id:int53 ttl:int32 ttl_expires_in:double via_bot_user_id:int53 author_signature:string media_album_id:int64 restriction_reason:string content:MessageContent reply_markup:ReplyMarkup = Message; +message id:int53 sender_id:MessageSender chat_id:int53 sending_state:MessageSendingState scheduling_state:MessageSchedulingState is_outgoing:Bool is_pinned:Bool can_be_edited:Bool can_be_forwarded:Bool can_be_saved:Bool can_be_deleted_only_for_self:Bool can_be_deleted_for_all_users:Bool can_get_added_reactions:Bool can_get_statistics:Bool can_get_message_thread:Bool can_get_viewers:Bool can_get_media_timestamp_links:Bool has_timestamped_media:Bool is_channel_post:Bool contains_unread_mention:Bool date:int32 edit_date:int32 forward_info:messageForwardInfo interaction_info:messageInteractionInfo unread_reactions:vector reply_in_chat_id:int53 reply_to_message_id:int53 message_thread_id:int53 ttl:int32 ttl_expires_in:double via_bot_user_id:int53 author_signature:string media_album_id:int64 restriction_reason:string content:MessageContent reply_markup:ReplyMarkup = Message; -//@description Contains a list of messages @total_count Approximate total count of messages found @messages List of messages; messages may be null +//@description Contains a list of messages @total_count Approximate total number of messages found @messages List of messages; messages may be null messages total_count:int32 messages:vector = Messages; -//@description Contains a list of messages found by a search @total_count Approximate total count of messages found; -1 if unknown @messages List of messages @next_offset The offset for the next request. If empty, there are no more results +//@description Contains a list of messages found by a search @total_count Approximate total number of messages found; -1 if unknown @messages List of messages @next_offset The offset for the next request. If empty, there are no more results foundMessages total_count:int32 messages:vector next_offset:string = FoundMessages; //@description Contains information about a message in a specific position @position 0-based message position in the full list of suitable messages @message_id Message identifier @date Point in time (Unix timestamp) when the message was sent messagePosition position:int32 message_id:int53 date:int32 = MessagePosition; -//@description Contains a list of message positions @total_count Total count of messages found @positions List of message positions +//@description Contains a list of message positions @total_count Total number of messages found @positions List of message positions messagePositions total_count:int32 positions:vector = MessagePositions; -//@description Contains information about found messages sent in a specific day @total_count Total number of found messages sent in the day @message First message sent in the day +//@description Contains information about found messages sent on a specific day @total_count Total number of found messages sent on the day @message First message sent on the day messageCalendarDay total_count:int32 message:message = MessageCalendarDay; -//@description Contains information about found messages, splitted by days according to the option "utc_time_offset" @total_count Total number of found messages @days Information about messages sent +//@description Contains information about found messages, split by days according to the option "utc_time_offset" @total_count Total number of found messages @days Information about messages sent messageCalendar total_count:int32 days:vector = MessageCalendar; -//@description Describes a sponsored message @id Unique sponsored message identifier @sponsor_chat_id Chat identifier -//@link An internal link to be opened when the sponsored message is clicked; may be null. If null, the sponsor chat needs to be opened instead @content Content of the message -sponsoredMessage id:int32 sponsor_chat_id:int53 link:InternalLinkType content:MessageContent = SponsoredMessage; +//@description Describes a sponsored message +//@message_id Message identifier; unique for the chat to which the sponsored message belongs among both ordinary and sponsored messages +//@sponsor_chat_id Sponsor chat identifier; 0 if the sponsor chat is accessible through an invite link +//@sponsor_chat_info Information about the sponsor chat; may be null unless sponsor_chat_id == 0 +//@link An internal link to be opened when the sponsored message is clicked; may be null if the sponsor chat needs to be opened instead +//@content Content of the message. Currently, can be only of the type messageText +sponsoredMessage message_id:int53 sponsor_chat_id:int53 sponsor_chat_info:chatInviteLinkInfo link:InternalLinkType content:MessageContent = SponsoredMessage; -//@description Contains a list of sponsored messages @messages List of sponsored messages -sponsoredMessages messages:vector = SponsoredMessages; + +//@description Describes a file added to file download list +//@file_id File identifier +//@message The message with the file +//@add_date Point in time (Unix timestamp) when the file was added to the download list +//@complete_date Point in time (Unix timestamp) when the file downloading was completed; 0 if the file downloading isn't completed +//@is_paused True, if downloading of the file is paused +fileDownload file_id:int32 message:message add_date:int32 complete_date:int32 is_paused:Bool = FileDownload; + +//@description Contains number of being downloaded and recently downloaded files found +//@active_count Number of active file downloads found, including paused +//@paused_count Number of paused file downloads found +//@completed_count Number of completed file downloads found +downloadedFileCounts active_count:int32 paused_count:int32 completed_count:int32 = DownloadedFileCounts; + +//@description Contains a list of downloaded files, found by a search +//@total_counts Total number of suitable files, ignoring offset +//@files The list of files +//@next_offset The offset for the next request. If empty, there are no more results +foundFileDownloads total_counts:downloadedFileCounts files:vector next_offset:string = FoundFileDownloads; //@class NotificationSettingsScope @description Describes the types of chats to which notification settings are relevant @@ -842,32 +916,32 @@ sponsoredMessages messages:vector = SponsoredMessages; //@description Notification settings applied to all private and secret chats when the corresponding chat setting has a default value notificationSettingsScopePrivateChats = NotificationSettingsScope; -//@description Notification settings applied to all basic groups and supergroups when the corresponding chat setting has a default value +//@description Notification settings applied to all basic group and supergroup chats when the corresponding chat setting has a default value notificationSettingsScopeGroupChats = NotificationSettingsScope; -//@description Notification settings applied to all channels when the corresponding chat setting has a default value +//@description Notification settings applied to all channel chats when the corresponding chat setting has a default value notificationSettingsScopeChannelChats = NotificationSettingsScope; //@description Contains information about notification settings for a chat //@use_default_mute_for If true, mute_for is ignored and the value for the relevant type of chat is used instead @mute_for Time left before notifications will be unmuted, in seconds -//@use_default_sound If true, sound is ignored and the value for the relevant type of chat is used instead @sound The name of an audio file to be used for notification sounds; only applies to iOS applications +//@use_default_sound If true, the value for the relevant type of chat is used instead of sound_id @sound_id Identifier of the notification sound to be played; 0 if sound is disabled //@use_default_show_preview If true, show_preview is ignored and the value for the relevant type of chat is used instead @show_preview True, if message content must be displayed in notifications //@use_default_disable_pinned_message_notifications If true, disable_pinned_message_notifications is ignored and the value for the relevant type of chat is used instead @disable_pinned_message_notifications If true, notifications for incoming pinned messages will be created as for an ordinary unread message //@use_default_disable_mention_notifications If true, disable_mention_notifications is ignored and the value for the relevant type of chat is used instead @disable_mention_notifications If true, notifications for messages with mentions will be created as for an ordinary unread message -chatNotificationSettings use_default_mute_for:Bool mute_for:int32 use_default_sound:Bool sound:string use_default_show_preview:Bool show_preview:Bool use_default_disable_pinned_message_notifications:Bool disable_pinned_message_notifications:Bool use_default_disable_mention_notifications:Bool disable_mention_notifications:Bool = ChatNotificationSettings; +chatNotificationSettings use_default_mute_for:Bool mute_for:int32 use_default_sound:Bool sound_id:int64 use_default_show_preview:Bool show_preview:Bool use_default_disable_pinned_message_notifications:Bool disable_pinned_message_notifications:Bool use_default_disable_mention_notifications:Bool disable_mention_notifications:Bool = ChatNotificationSettings; //@description Contains information about notification settings for several chats //@mute_for Time left before notifications will be unmuted, in seconds -//@sound The name of an audio file to be used for notification sounds; only applies to iOS applications +//@sound_id Identifier of the notification sound to be played; 0 if sound is disabled //@show_preview True, if message content must be displayed in notifications //@disable_pinned_message_notifications True, if notifications for incoming pinned messages will be created as for an ordinary unread message //@disable_mention_notifications True, if notifications for messages with mentions will be created as for an ordinary unread message -scopeNotificationSettings mute_for:int32 sound:string show_preview:Bool disable_pinned_message_notifications:Bool disable_mention_notifications:Bool = ScopeNotificationSettings; +scopeNotificationSettings mute_for:int32 sound_id:int64 show_preview:Bool disable_pinned_message_notifications:Bool disable_mention_notifications:Bool = ScopeNotificationSettings; //@description Contains information about a message draft -//@reply_to_message_id Identifier of the message to reply to; 0 if none +//@reply_to_message_id Identifier of the replied message; 0 if none //@date Point in time (Unix timestamp) when the draft was created //@input_message_text Content of the message draft; must be of the type inputMessageText draftMessage reply_to_message_id:int53 date:int32 input_message_text:InputMessageContent = DraftMessage; @@ -890,7 +964,7 @@ chatTypeSecret secret_chat_id:int32 user_id:int53 = ChatType; //@description Represents a filter of user chats //@title The title of the filter; 1-12 characters without line feeds -//@icon_name The icon name for short filter representation. If non-empty, must be one of "All", "Unread", "Unmuted", "Bots", "Channels", "Groups", "Private", "Custom", "Setup", "Cat", "Crown", "Favorite", "Flower", "Game", "Home", "Love", "Mask", "Party", "Sport", "Study", "Trade", "Travel", "Work". +//@icon_name The chosen icon name for short filter representation. If non-empty, must be one of "All", "Unread", "Unmuted", "Bots", "Channels", "Groups", "Private", "Custom", "Setup", "Cat", "Crown", "Favorite", "Flower", "Game", "Home", "Love", "Mask", "Party", "Sport", "Study", "Trade", "Travel", "Work". //-If empty, use getChatFilterDefaultIconName to get default icon name for the filter //@pinned_chat_ids The chat identifiers of pinned chats in the filtered chat list //@included_chat_ids The chat identifiers of always included chats in the filtered chat list @@ -908,7 +982,7 @@ chatFilter title:string icon_name:string pinned_chat_ids:vector included_ //@description Contains basic information about a chat filter //@id Unique chat filter identifier //@title The title of the filter; 1-12 characters without line feeds -//@icon_name The icon name for short filter representation. One of "All", "Unread", "Unmuted", "Bots", "Channels", "Groups", "Private", "Custom", "Setup", "Cat", "Crown", "Favorite", "Flower", "Game", "Home", "Love", "Mask", "Party", "Sport", "Study", "Trade", "Travel", "Work" +//@icon_name The chosen or default icon name for short filter representation. One of "All", "Unread", "Unmuted", "Bots", "Channels", "Groups", "Private", "Custom", "Setup", "Cat", "Crown", "Favorite", "Flower", "Game", "Home", "Love", "Mask", "Party", "Sport", "Study", "Trade", "Travel", "Work" chatFilterInfo id:int32 title:string icon_name:string = ChatFilterInfo; //@description Describes a recommended chat filter @filter The chat filter @param_description Chat filter description @@ -965,7 +1039,7 @@ videoChat group_call_id:int32 has_participants:Bool default_participant_id:Messa //@permissions Actions that non-administrator chat members are allowed to take in the chat //@last_message Last message in the chat; may be null //@positions Positions of the chat in chat lists -//@default_message_sender_id Default identifier of a user or chat that is chosen to send messages in the chat; may be null if the user can't change message sender +//@message_sender_id Identifier of a user or chat that is selected to send messages in the chat; may be null if the user can't change message sender //@has_protected_content True, if chat content can't be saved locally, forwarded, or copied //@is_marked_as_unread True, if the chat is marked as unread //@is_blocked True, if the chat is blocked by the current user and private messages from the chat can't be received @@ -978,8 +1052,10 @@ videoChat group_call_id:int32 has_participants:Bool default_participant_id:Messa //@last_read_inbox_message_id Identifier of the last read incoming message //@last_read_outbox_message_id Identifier of the last read outgoing message //@unread_mention_count Number of unread messages with a mention/reply in the chat -//@notification_settings Notification settings for this chat -//@message_ttl_setting Current message Time To Live setting (self-destruct timer) for the chat; 0 if not defined. TTL is counted from the time message or its content is viewed in secret chats and from the send date in other chats +//@unread_reaction_count Number of messages with unread reactions in the chat +//@notification_settings Notification settings for the chat +//@available_reactions List of reactions, available in the chat +//@message_ttl Current message Time To Live setting (self-destruct timer) for the chat; 0 if not defined. TTL is counted from the time message or its content is viewed in secret chats and from the send date in other chats //@theme_name If non-empty, name of a theme, set for the chat //@action_bar Information about actions which must be possible to do through the chat action bar; may be null //@video_chat Information about video chat of the chat @@ -987,9 +1063,9 @@ 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 //@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 permissions:chatPermissions last_message:message positions:vector default_message_sender_id:MessageSender has_protected_content:Bool is_marked_as_unread:Bool is_blocked: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 notification_settings:chatNotificationSettings message_ttl_setting:int32 theme_name:string action_bar:ChatActionBar 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 permissions:chatPermissions last_message:message positions:vector message_sender_id:MessageSender has_protected_content:Bool is_marked_as_unread:Bool is_blocked: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:vector message_ttl:int32 theme_name:string action_bar:ChatActionBar 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 count of chats found @chat_ids List of chat identifiers +//@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 = Chats; @@ -1053,6 +1129,9 @@ keyboardButtonTypeRequestLocation = KeyboardButtonType; //@description A button that allows the user to create and send a poll when pressed; available only in private chats @force_regular If true, only regular polls must be allowed to create @force_quiz If true, only polls in quiz mode must be allowed to create keyboardButtonTypeRequestPoll force_regular:Bool force_quiz:Bool = KeyboardButtonType; +//@description A button that opens a web app by calling getWebAppUrl @url An HTTP URL to pass to getWebAppUrl +keyboardButtonTypeWebApp url:string = KeyboardButtonType; + //@description Represents a single button in a bot keyboard @text Text of the button @type Type of the button keyboardButton text:string type:KeyboardButtonType = KeyboardButton; @@ -1063,9 +1142,12 @@ keyboardButton text:string type:KeyboardButtonType = KeyboardButton; //@description A button that opens a specified URL @url HTTP or tg:// URL to open inlineKeyboardButtonTypeUrl url:string = InlineKeyboardButtonType; -//@description A button that opens a specified URL and automatically authorize the current user if allowed to do so @url An HTTP URL to open @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 @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 +inlineKeyboardButtonTypeWebApp url:string = InlineKeyboardButtonType; + //@description A button that sends a callback query to a bot @data Data to be sent to the bot via a callback query inlineKeyboardButtonTypeCallback data:bytes = InlineKeyboardButtonType; @@ -1081,7 +1163,7 @@ inlineKeyboardButtonTypeSwitchInline query:string in_current_chat:Bool = InlineK //@description A button to buy something. This button must be in the first column and row of the keyboard and can be attached only to a message with content of the type messageInvoice inlineKeyboardButtonTypeBuy = InlineKeyboardButtonType; -//@description A button to open a chat with a user @user_id User identifier +//@description A button with a user reference to be handled in the same way as textEntityTypeMentionName entities @user_id User identifier inlineKeyboardButtonTypeUser user_id:int53 = InlineKeyboardButtonType; @@ -1123,6 +1205,10 @@ loginUrlInfoOpen url:string skip_confirm:Bool = LoginUrlInfo; loginUrlInfoRequestConfirmation url:string domain:string bot_user_id:int53 request_write_access:Bool = LoginUrlInfo; +//@description Contains information about a web app @launch_id Unique identifier for the web app launch @url A web app URL to open in a web view +webAppInfo launch_id:int64 url:string = WebAppInfo; + + //@description Contains information about a message thread //@chat_id Identifier of the chat to which the message thread belongs //@message_thread_id Message thread identifier, unique within the chat @@ -1301,7 +1387,7 @@ pageBlockCollage page_blocks:vector caption:pageBlockCaption = PageBl //@description A slideshow @page_blocks Slideshow item contents @caption Block caption pageBlockSlideshow page_blocks:vector caption:pageBlockCaption = PageBlock; -//@description A link to a chat @title Chat title @photo Chat photo; may be null @username Chat username, by which all other information about the chat can be resolved +//@description A link to a chat @title Chat title @photo Chat photo; may be null @username Chat username by which all other information about the chat can be resolved pageBlockChatLink title:string photo:chatPhotoInfo username:string = PageBlock; //@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 @@ -1320,7 +1406,7 @@ pageBlockMap location:location zoom:int32 width:int32 height:int32 caption:pageB //@description Describes an instant view page for a web page //@page_blocks Content of the web page //@view_count Number of the instant view views; 0 if unknown -//@version Version of the instant view, currently can be 1 or 2 +//@version Version of the instant view; currently, can be 1 or 2 //@is_rtl True, if the instant view must be shown from right to left //@is_full True, if the instant view contains the full page. A network request might be needed to get the full web page instant view //@feedback_link An internal link to be opened to leave feedback about the instant view @@ -1343,12 +1429,12 @@ webPageInstantView page_blocks:vector view_count:int32 version:int32 //@author Author of the content //@animation Preview of the content as an animation, if available; may be null //@audio Preview of the content as an audio file, if available; may be null -//@document Preview of the content as a document, if available (currently only available for small PDF files and ZIP archives); may be null +//@document Preview of the content as a document, if available; may be null //@sticker Preview of the content as a sticker for small WEBP files, if available; may be null //@video Preview of the content as a video, if available; may be null //@video_note Preview of the content as a video note, if available; may be null //@voice_note Preview of the content as a voice note, if available; may be null -//@instant_view_version Version of instant view, available for the web page (currently can be 1 or 2), 0 if none +//@instant_view_version Version of instant view, available for the web page (currently, can be 1 or 2), 0 if none webPage url:string display_url:string type:string site_name:string title:string description:formattedText photo:photo embed_url:string embed_type:string embed_width:int32 embed_height:int32 duration:int32 author:string animation:animation audio:audio document:document sticker:sticker video:video video_note:videoNote voice_note:voiceNote instant_view_version:int32 = WebPage; @@ -1381,6 +1467,12 @@ bankCardInfo title:string actions:vector = BankCardInfo; address country_code:string state:string city:string street_line1:string street_line2:string postal_code:string = Address; +//@description Contains parameters of the app theme @background_color A color of the background in the RGB24 format @text_color A color of text in the RGB24 format +//@hint_color A color of hints in the RGB24 format @link_color A color of links in the RGB24 format @button_color A color of the buttons in the RGB24 format +//@button_text_color A color of text on the buttons in the RGB24 format +themeParameters background_color:int32 text_color:int32 hint_color:int32 link_color:int32 button_color:int32 button_text_color:int32 = ThemeParameters; + + //@description Portion of the price of a product (e.g., "delivery cost", "tax amount") @label Label for this portion of the product price @amount Currency amount in the smallest units of the currency labeledPricePart label:string amount:int53 = LabeledPricePart; @@ -1424,11 +1516,6 @@ inputCredentialsGooglePay data:string = InputCredentials; //@description Stripe payment provider @publishable_key Stripe API publishable key @need_country True, if the user country must be provided @need_postal_code True, if the user ZIP/postal code must be provided @need_cardholder_name True, if the cardholder name must be provided paymentsProviderStripe publishable_key:string need_country:Bool need_postal_code:Bool need_cardholder_name:Bool = PaymentsProviderStripe; -//@description Theme colors for a payment form @background_color A color of the payment form background in the RGB24 format @text_color A color of text in the RGB24 format -//@hint_color A color of hints in the RGB24 format @link_color A color of links in the RGB24 format @button_color A color of the buttons in the RGB24 format -//@button_text_color A color of text on the buttons in the RGB24 format -paymentFormTheme background_color:int32 text_color:int32 hint_color:int32 link_color:int32 button_color:int32 button_text_color:int32 = PaymentFormTheme; - //@description Contains information about an invoice payment form //@id The payment form identifier //@invoice Full information of the invoice @@ -1815,7 +1902,7 @@ messageChatDeletePhoto = MessageContent; //@description New chat members were added @member_user_ids User identifiers of the new members messageChatAddMembers member_user_ids:vector = MessageContent; -//@description A new member joined the chat by invite link +//@description A new member joined the chat via an invite link messageChatJoinByLink = MessageContent; //@description A new member was accepted to the chat by an administrator @@ -1839,7 +1926,7 @@ messageScreenshotTaken = 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 The TTL (Time To Live) setting for messages in the chat has been changed @ttl New message TTL setting +//@description The TTL (Time To Live) setting for messages in the chat has been changed @ttl New message TTL messageChatSetTtl ttl:int32 = MessageContent; //@description A non-standard action has happened in the chat @text Message text to be shown in the chat @@ -1862,7 +1949,13 @@ messageContactRegistered = MessageContent; //@description The current user has connected a website by logging in using Telegram Login Widget on it @domain_name Domain name of the connected website messageWebsiteConnected domain_name:string = MessageContent; -//@description Telegram Passport data has been sent @types List of Telegram Passport element types sent +//@description Data from a web app has been sent to a bot @button_text Text of the keyboardButtonTypeWebApp button, which opened the web app +messageWebAppDataSent button_text:string = MessageContent; + +//@description Data from a web app has been received; for bots only @button_text Text of the keyboardButtonTypeWebApp button, which opened the web app @data Received data +messageWebAppDataReceived button_text:string data:string = MessageContent; + +//@description Telegram Passport data has been sent to a bot @types List of Telegram Passport element types sent messagePassportDataSent types:vector = MessageContent; //@description Telegram Passport data has been received; for bots only @elements List of received Telegram Passport elements @credentials Encrypted data credentials @@ -1913,6 +2006,9 @@ textEntityTypeUnderline = TextEntityType; //@description A strikethrough text textEntityTypeStrikethrough = TextEntityType; +//@description A spoiler text. Not supported in secret chats +textEntityTypeSpoiler = TextEntityType; + //@description Text that must be formatted as if inside a code HTML tag textEntityTypeCode = TextEntityType; @@ -1951,8 +2047,9 @@ messageSchedulingStateSendWhenOnline = MessageSchedulingState; //@description Options to be used when a message is sent //@disable_notification Pass true to disable notification for the message //@from_background Pass true if the message is sent from the background +//@protect_content Pass true if the content of the message must be protected from forwarding and saving; for bots only //@scheduling_state Message scheduling state; pass null to send message immediately. Messages sent to a secret chat, live location messages and self-destructing messages can't be scheduled -messageSendOptions disable_notification:Bool from_background:Bool scheduling_state:MessageSchedulingState = MessageSendOptions; +messageSendOptions disable_notification:Bool from_background:Bool protect_content:Bool scheduling_state:MessageSchedulingState = MessageSendOptions; //@description Options to be used when a message content is copied without reference to the original sender. Service messages and messageInvoice can't be copied //@send_copy True, if content of the message needs to be copied without reference to the original sender. Always true if the message is forwarded to a secret chat or is local @@ -1963,7 +2060,7 @@ messageCopyOptions send_copy:Bool replace_caption:Bool new_caption:formattedText //@class InputMessageContent @description The content of a message to send -//@description A text message @text Formatted text to be sent; 1-GetOption("message_text_length_max") characters. Only Bold, Italic, Underline, Strikethrough, Code, Pre, PreCode, TextUrl and MentionName entities are allowed to be specified manually +//@description A text message @text Formatted text to be sent; 1-GetOption("message_text_length_max") characters. Only Bold, Italic, Underline, Strikethrough, Spoiler, Code, Pre, PreCode, TextUrl and MentionName entities are allowed to be specified manually //@disable_web_page_preview True, if rich web page previews for URLs in the message text must be disabled @clear_draft True, if a chat message draft must be deleted inputMessageText text:formattedText disable_web_page_preview:Bool clear_draft:Bool = InputMessageContent; @@ -2028,7 +2125,7 @@ inputMessagePoll question:string options:vector is_anonymous:Bool type:P //@description A forwarded message @from_chat_id Identifier for the chat this forwarded message came from @message_id Identifier of the message to forward //@in_game_share True, if a game message is being shared from a launched game; applies only to game messages -//@copy_options Options to be used to copy content of the message without reference to the original sender; pass null to try to forward the message as usual +//@copy_options Options to be used to copy content of the message without reference to the original sender; pass null to forward the message as usual inputMessageForwarded from_chat_id:int53 message_id:int53 in_game_share:Bool copy_options:messageCopyOptions = InputMessageContent; @@ -2064,12 +2161,6 @@ searchMessagesFilterUrl = SearchMessagesFilter; //@description Returns only messages containing chat photos searchMessagesFilterChatPhoto = SearchMessagesFilter; -//@description Returns only call messages -searchMessagesFilterCall = SearchMessagesFilter; - -//@description Returns only incoming call messages with missed/declined discard reasons -searchMessagesFilterMissedCall = SearchMessagesFilter; - //@description Returns only video note messages searchMessagesFilterVideoNote = SearchMessagesFilter; @@ -2082,6 +2173,9 @@ searchMessagesFilterMention = SearchMessagesFilter; //@description Returns only messages with unread mentions of the current user, or messages that are replies to their messages. When using this filter the results can't be additionally filtered by a query, a message thread or by the sending user searchMessagesFilterUnreadMention = SearchMessagesFilter; +//@description Returns only messages with unread reactions for the current user. When using this filter the results can't be additionally filtered by a query, a message thread or by the sending user +searchMessagesFilterUnreadReaction = SearchMessagesFilter; + //@description Returns only failed to send messages. This filter can be used only if the message database is used searchMessagesFilterFailedToSend = SearchMessagesFilter; @@ -2165,20 +2259,20 @@ stickers stickers:vector = Stickers; emojis emojis:vector = Emojis; //@description Represents a sticker set -//@id Identifier of the sticker set @title Title of the sticker set @name Name of the sticker set @thumbnail Sticker set thumbnail in WEBP or TGS format with width and height 100; may be null. The file can be downloaded only before the thumbnail is changed +//@id Identifier of the sticker set @title Title of the sticker set @name Name of the sticker set @thumbnail Sticker set thumbnail in WEBP, TGS, or WEBM format with width and height 100; may be null. The file can be downloaded only before the thumbnail is changed //@thumbnail_outline Sticker set thumbnail's outline represented as a list of closed vector paths; may be empty. The coordinate system origin is in the upper-left corner //@is_installed True, if the sticker set has been installed by the current user @is_archived True, if the sticker set has been archived. A sticker set can't be installed and archived simultaneously -//@is_official True, if the sticker set is official @is_animated True, is the stickers in the set are animated @is_masks True, if the stickers in the set are masks @is_viewed True for already viewed trending sticker sets +//@is_official True, if the sticker set is official @sticker_type Type of the stickers in the set @is_viewed True for already viewed trending sticker sets //@stickers List of stickers in this set @emojis A list of emoji corresponding to the stickers in the same order. The list is only for informational purposes, because a sticker is always sent with a fixed emoji from the corresponding Sticker object -stickerSet id:int64 title:string name:string thumbnail:thumbnail thumbnail_outline:vector is_installed:Bool is_archived:Bool is_official:Bool is_animated:Bool is_masks:Bool is_viewed:Bool stickers:vector emojis:vector = StickerSet; +stickerSet id:int64 title:string name:string thumbnail:thumbnail thumbnail_outline:vector is_installed:Bool is_archived:Bool is_official:Bool sticker_type:StickerType is_viewed:Bool stickers:vector emojis:vector = StickerSet; //@description Represents short information about a sticker set -//@id Identifier of the sticker set @title Title of the sticker set @name Name of the sticker set @thumbnail Sticker set thumbnail in WEBP or TGS format with width and height 100; may be null +//@id Identifier of the sticker set @title Title of the sticker set @name Name of the sticker set @thumbnail Sticker set thumbnail in WEBP, TGS, or WEBM format with width and height 100; may be null //@thumbnail_outline Sticker set thumbnail's outline represented as a list of closed vector paths; may be empty. The coordinate system origin is in the upper-left corner //@is_installed True, if the sticker set has been installed by the current user @is_archived True, if the sticker set has been archived. A sticker set can't be installed and archived simultaneously -//@is_official True, if the sticker set is official @is_animated True, is the stickers in the set are animated @is_masks True, if the stickers in the set are masks @is_viewed True for already viewed trending sticker sets +//@is_official True, if the sticker set is official @sticker_type Type of the stickers in the set @is_viewed True for already viewed trending sticker sets //@size Total number of stickers in the set @covers Up to the first 5 stickers from the set, depending on the context. If the application needs more stickers the full sticker set needs to be requested -stickerSetInfo id:int64 title:string name:string thumbnail:thumbnail thumbnail_outline:vector is_installed:Bool is_archived:Bool is_official:Bool is_animated:Bool is_masks:Bool is_viewed:Bool size:int32 covers:vector = StickerSetInfo; +stickerSetInfo id:int64 title:string name:string thumbnail:thumbnail thumbnail_outline:vector is_installed:Bool is_archived:Bool is_official:Bool sticker_type:StickerType is_viewed:Bool size:int32 covers:vector = StickerSetInfo; //@description Represents a list of sticker sets @total_count Approximate total number of sticker sets found @sets List of sticker sets stickerSets total_count:int32 sets:vector = StickerSets; @@ -2264,6 +2358,19 @@ groupCallVideoQualityMedium = GroupCallVideoQuality; groupCallVideoQualityFull = GroupCallVideoQuality; +//@description Describes an available stream in a group call +//@channel_id Identifier of an audio/video channel +//@scale Scale of segment durations in the stream. The duration is 1000/(2**scale) milliseconds +//@time_offset Point in time when the stream currently ends; Unix timestamp in milliseconds +groupCallStream channel_id:int32 scale:int32 time_offset:int53 = GroupCallStream; + +//@description Represents a list of group call streams @streams A list of group call streams +groupCallStreams streams:vector = GroupCallStreams; + +//@description Represents an RTMP url @url The URL @stream_key Stream key +rtmpUrl url:string stream_key:string = RtmpUrl; + + //@description Describes a recently speaking participant in a group call @participant_id Group call participant identifier @is_speaking True, is the user has spoken recently groupCallRecentSpeaker participant_id:MessageSender is_speaking:Bool = GroupCallRecentSpeaker; @@ -2273,12 +2380,14 @@ groupCallRecentSpeaker participant_id:MessageSender is_speaking:Bool = GroupCall //@scheduled_start_date Point in time (Unix timestamp) when the group call is supposed to be started by an administrator; 0 if it is already active or was ended //@enabled_start_notification True, if the group call is scheduled and the current user will receive a notification when the group call will start //@is_active True, if the call is active +//@is_rtmp_stream True, if the chat is an RTMP stream instead of an ordinary video chat //@is_joined True, if the call is joined //@need_rejoin True, if user was kicked from the call because of network loss and the call needs to be rejoined //@can_be_managed True, if the current user can manage the group call //@participant_count Number of participants in the group call +//@has_hidden_listeners True, if group call participants, which are muted, aren't returned in participant list //@loaded_all_participants True, if all group call participants are loaded -//@recent_speakers Recently speaking users in the group call +//@recent_speakers At most 3 recently speaking users in the group call //@is_my_video_enabled True, if the current user's video is enabled //@is_my_video_paused True, if the current user's video is paused //@can_enable_video True, if the current user can broadcast video or share screen @@ -2287,7 +2396,7 @@ groupCallRecentSpeaker participant_id:MessageSender is_speaking:Bool = GroupCall //@record_duration Duration of the ongoing group call recording, in seconds; 0 if none. An updateGroupCall update is not triggered when value of this field changes, but the same recording goes on //@is_video_recorded True, if a video file is being recorded for the call //@duration Call duration, in seconds; for ended calls only -groupCall id:int32 title:string scheduled_start_date:int32 enabled_start_notification:Bool is_active:Bool is_joined:Bool need_rejoin:Bool can_be_managed:Bool participant_count:int32 loaded_all_participants:Bool recent_speakers:vector is_my_video_enabled:Bool is_my_video_paused:Bool can_enable_video:Bool mute_new_participants:Bool can_toggle_mute_new_participants:Bool record_duration:int32 is_video_recorded:Bool duration:int32 = GroupCall; +groupCall id:int32 title:string scheduled_start_date:int32 enabled_start_notification:Bool is_active:Bool is_rtmp_stream:Bool is_joined:Bool need_rejoin:Bool can_be_managed:Bool participant_count:int32 has_hidden_listeners:Bool loaded_all_participants:Bool recent_speakers:vector is_my_video_enabled:Bool is_my_video_paused:Bool can_enable_video:Bool mute_new_participants:Bool can_toggle_mute_new_participants:Bool record_duration:int32 is_video_recorded:Bool duration:int32 = GroupCall; //@description Describes a group of video synchronization source identifiers @semantics The semantics of sources, one of "SIM" or "FID" @source_ids The list of synchronization source identifiers groupCallVideoSourceGroup semantics:string source_ids:vector = GroupCallVideoSourceGroup; @@ -2357,10 +2466,34 @@ call id:int32 user_id:int53 is_outgoing:Bool is_video:Bool state:CallState = Cal //@allow_missed_call Pass true if the authentication code may be sent via a missed call to the specified phone number //@is_current_phone_number Pass true if the authenticated phone number is used on the current device //@allow_sms_retriever_api For official applications only. True, if the application can use Android SMS Retriever API (requires Google Play Services >= 10.2) to automatically receive the authentication code from the SMS. See https://developers.google.com/identity/sms-retriever/ for more details -//@authentication_tokens List of authentication tokens, received in updateOption("authentication_token") in previously logged out sessions +//@authentication_tokens List of up to 20 authentication tokens, recently received in updateOption("authentication_token") in previously logged out sessions phoneNumberAuthenticationSettings allow_flash_call:Bool allow_missed_call:Bool is_current_phone_number:Bool allow_sms_retriever_api:Bool authentication_tokens:vector = PhoneNumberAuthenticationSettings; +//@description Represents a reaction applied to a message @reaction Text representation of the reaction @sender_id Identifier of the chat member, applied the reaction +addedReaction reaction:string sender_id:MessageSender = AddedReaction; + +//@description Represents a list of reactions added to a message @total_count The total number of found reactions @reactions The list of added reactions @next_offset The offset for the next request. If empty, there are no more results +addedReactions total_count:int32 reactions:vector next_offset:string = AddedReactions; + +//@description Represents a list of available reactions @reactions List of reactions +availableReactions reactions:vector = AvailableReactions; + + +//@description Contains stickers which must be used for reaction animation rendering +//@reaction Text representation of the reaction +//@title Reaction title +//@is_active True, if the reaction can be added to new messages and enabled in chats +//@static_icon Static icon for the reaction +//@appear_animation Appear animation for the reaction +//@select_animation Select animation for the reaction +//@activate_animation Activate animation for the reaction +//@effect_animation Effect animation for the reaction +//@around_animation Around animation for the reaction; may be null +//@center_animation Center animation for the reaction; may be null +reaction reaction:string title:string is_active:Bool static_icon:sticker appear_animation:sticker select_animation:sticker activate_animation:sticker effect_animation:sticker around_animation:sticker center_animation:sticker = Reaction; + + //@description Represents a list of animations @animations List of animations animations animations:vector = Animations; @@ -2384,6 +2517,25 @@ diceStickersSlotMachine background:sticker lever:sticker left_reel:sticker cente importedContacts user_ids:vector importer_count:vector = ImportedContacts; +//@description Describes a color to highlight a bot added to attachment menu @light_color Color in the RGB24 format for light themes @dark_color Color in the RGB24 format for dark themes +attachmentMenuBotColor light_color:int32 dark_color:int32 = AttachmentMenuBotColor; + +//@description Represents a bot added to attachment menu +//@bot_user_id User identifier of the bot added to attachment menu +//@name Name for the bot in attachment menu +//@name_color Color to highlight selected name of the bot if appropriate; may be null +//@default_icon Default attachment menu icon for the bot in SVG format; may be null +//@ios_static_icon Attachment menu icon for the bot in SVG format for the official iOS app; may be null +//@ios_animated_icon Attachment menu icon for the bot in TGS format for the official iOS app; may be null +//@android_icon Attachment menu icon for the bot in TGS format for the official Android app; may be null +//@macos_icon Attachment menu icon for the bot in TGS format for the official native macOS app; may be null +//@icon_color Color to highlight selected icon of the bot if appropriate; may be null +attachmentMenuBot bot_user_id:int53 name:string name_color:attachmentMenuBotColor default_icon:file ios_static_icon:file ios_animated_icon:file android_icon:file macos_icon:file icon_color:attachmentMenuBotColor = AttachmentMenuBot; + +//@description Information about the message sent by answerWebAppQuery @inline_message_id Identifier of the sent inline message, if known +sentWebAppMessage inline_message_id:string = SentWebAppMessage; + + //@description Contains an HTTP URL @url The URL httpUrl url:string = HttpUrl; @@ -2438,8 +2590,8 @@ inputInlineQueryResultLocation id:string location:location live_period:int32 tit //@input_message_content The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessagePhoto, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact inputInlineQueryResultPhoto id:string title:string description:string thumbnail_url:string photo_url:string photo_width:int32 photo_height:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult; -//@description Represents a link to a WEBP or TGS sticker @id Unique identifier of the query result @thumbnail_url URL of the sticker thumbnail, if it exists -//@sticker_url The URL of the WEBP or TGS sticker (sticker file size must not exceed 5MB) @sticker_width Width of the sticker @sticker_height Height of the sticker +//@description Represents a link to a WEBP, TGS, or WEBM sticker @id Unique identifier of the query result @thumbnail_url URL of the sticker thumbnail, if it exists +//@sticker_url The URL of the WEBP, TGS, or WEBM sticker (sticker file size must not exceed 5MB) @sticker_width Width of the sticker @sticker_height Height of the sticker //@reply_markup The message reply markup; pass null if none. Must be of type replyMarkupInlineKeyboard or null //@input_message_content The content of the message to be sent. Must be one of the following types: inputMessageText, inputMessageSticker, inputMessageInvoice, inputMessageLocation, inputMessageVenue or inputMessageContact inputInlineQueryResultSticker id:string thumbnail_url:string sticker_url:string sticker_width:int32 sticker_height:int32 reply_markup:ReplyMarkup input_message_content:InputMessageContent = InputInlineQueryResult; @@ -2543,78 +2695,81 @@ chatEventMessageEdited old_message:message new_message:message = ChatEventAction //@description A message was deleted @message Deleted message chatEventMessageDeleted message:message = ChatEventAction; -//@description A poll in a message was stopped @message The message with the poll -chatEventPollStopped message:message = ChatEventAction; - //@description A message was pinned @message Pinned message chatEventMessagePinned message:message = ChatEventAction; //@description A message was unpinned @message Unpinned message chatEventMessageUnpinned message:message = ChatEventAction; +//@description A poll in a message was stopped @message The message with the poll +chatEventPollStopped message:message = ChatEventAction; + //@description A new member joined the chat chatEventMemberJoined = ChatEventAction; -//@description A new member joined the chat by an invite link @invite_link Invite link used to join the chat +//@description A new member joined the chat via an invite link @invite_link Invite link used to join the chat chatEventMemberJoinedByInviteLink invite_link:chatInviteLink = ChatEventAction; //@description A new member was accepted to the chat by an administrator @approver_user_id User identifier of the chat administrator, approved user join request @invite_link Invite link used to join the chat; may be null chatEventMemberJoinedByRequest approver_user_id:int53 invite_link:chatInviteLink = ChatEventAction; -//@description A member left the chat -chatEventMemberLeft = ChatEventAction; - //@description A new chat member was invited @user_id New member user identifier @status New member status chatEventMemberInvited user_id:int53 status:ChatMemberStatus = ChatEventAction; +//@description A member left the chat +chatEventMemberLeft = ChatEventAction; + //@description A chat member has gained/lost administrator status, or the list of their administrator privileges has changed @user_id Affected chat member user identifier @old_status Previous status of the chat member @new_status New status of the chat member chatEventMemberPromoted user_id:int53 old_status:ChatMemberStatus new_status:ChatMemberStatus = ChatEventAction; //@description A chat member was restricted/unrestricted or banned/unbanned, or the list of their restrictions has changed @member_id Affected chat member identifier @old_status Previous status of the chat member @new_status New status of the chat member chatEventMemberRestricted member_id:MessageSender old_status:ChatMemberStatus new_status:ChatMemberStatus = ChatEventAction; -//@description The chat title was changed @old_title Previous chat title @new_title New chat title -chatEventTitleChanged old_title:string new_title:string = ChatEventAction; - -//@description The chat permissions was changed @old_permissions Previous chat permissions @new_permissions New chat permissions -chatEventPermissionsChanged old_permissions:chatPermissions new_permissions:chatPermissions = ChatEventAction; +//@description The chat available reactions were changed @old_available_reactions Previous chat available reactions @new_available_reactions New chat available reactions +chatEventAvailableReactionsChanged old_available_reactions:vector new_available_reactions:vector = ChatEventAction; //@description The chat description was changed @old_description Previous chat description @new_description New chat description chatEventDescriptionChanged old_description:string new_description:string = ChatEventAction; -//@description The chat username was changed @old_username Previous chat username @new_username New chat username -chatEventUsernameChanged old_username:string new_username:string = ChatEventAction; - -//@description The chat photo was changed @old_photo Previous chat photo value; may be null @new_photo New chat photo value; may be null -chatEventPhotoChanged old_photo:chatPhoto new_photo:chatPhoto = ChatEventAction; - -//@description The can_invite_users permission of a supergroup chat was toggled @can_invite_users New value of can_invite_users permission -chatEventInvitesToggled can_invite_users:Bool = ChatEventAction; - //@description The linked chat of a supergroup was changed @old_linked_chat_id Previous supergroup linked chat identifier @new_linked_chat_id New supergroup linked chat identifier chatEventLinkedChatChanged old_linked_chat_id:int53 new_linked_chat_id:int53 = ChatEventAction; -//@description The slow_mode_delay setting of a supergroup was changed @old_slow_mode_delay Previous value of slow_mode_delay, in seconds @new_slow_mode_delay New value of slow_mode_delay, in seconds -chatEventSlowModeDelayChanged old_slow_mode_delay:int32 new_slow_mode_delay:int32 = ChatEventAction; - -//@description The message TTL setting was changed @old_message_ttl_setting Previous value of message_ttl_setting @new_message_ttl_setting New value of message_ttl_setting -chatEventMessageTtlSettingChanged old_message_ttl_setting:int32 new_message_ttl_setting:int32 = ChatEventAction; - -//@description The sign_messages setting of a channel was toggled @sign_messages New value of sign_messages -chatEventSignMessagesToggled sign_messages:Bool = ChatEventAction; - -//@description The has_protected_content setting of a channel was toggled @has_protected_content New value of has_protected_content -chatEventHasProtectedContentToggled has_protected_content:Bool = ChatEventAction; - -//@description The supergroup sticker set was changed @old_sticker_set_id Previous identifier of the chat sticker set; 0 if none @new_sticker_set_id New identifier of the chat sticker set; 0 if none -chatEventStickerSetChanged old_sticker_set_id:int64 new_sticker_set_id:int64 = ChatEventAction; - //@description The supergroup location was changed @old_location Previous location; may be null @new_location New location; may be null chatEventLocationChanged old_location:chatLocation new_location:chatLocation = ChatEventAction; +//@description The message TTL was changed @old_message_ttl Previous value of message_ttl @new_message_ttl New value of message_ttl +chatEventMessageTtlChanged old_message_ttl:int32 new_message_ttl:int32 = ChatEventAction; + +//@description The chat permissions was changed @old_permissions Previous chat permissions @new_permissions New chat permissions +chatEventPermissionsChanged old_permissions:chatPermissions new_permissions:chatPermissions = ChatEventAction; + +//@description The chat photo was changed @old_photo Previous chat photo value; may be null @new_photo New chat photo value; may be null +chatEventPhotoChanged old_photo:chatPhoto new_photo:chatPhoto = ChatEventAction; + +//@description The slow_mode_delay setting of a supergroup was changed @old_slow_mode_delay Previous value of slow_mode_delay, in seconds @new_slow_mode_delay New value of slow_mode_delay, in seconds +chatEventSlowModeDelayChanged old_slow_mode_delay:int32 new_slow_mode_delay:int32 = ChatEventAction; + +//@description The supergroup sticker set was changed @old_sticker_set_id Previous identifier of the chat sticker set; 0 if none @new_sticker_set_id New identifier of the chat sticker set; 0 if none +chatEventStickerSetChanged old_sticker_set_id:int64 new_sticker_set_id:int64 = ChatEventAction; + +//@description The chat title was changed @old_title Previous chat title @new_title New chat title +chatEventTitleChanged old_title:string new_title:string = ChatEventAction; + +//@description The chat username was changed @old_username Previous chat username @new_username New chat username +chatEventUsernameChanged old_username:string new_username:string = ChatEventAction; + +//@description The has_protected_content setting of a channel was toggled @has_protected_content New value of has_protected_content +chatEventHasProtectedContentToggled has_protected_content:Bool = ChatEventAction; + +//@description The can_invite_users permission of a supergroup chat was toggled @can_invite_users New value of can_invite_users permission +chatEventInvitesToggled can_invite_users:Bool = ChatEventAction; + //@description The is_all_history_available setting of a supergroup was toggled @is_all_history_available New value of is_all_history_available chatEventIsAllHistoryAvailableToggled is_all_history_available:Bool = ChatEventAction; +//@description The sign_messages setting of a channel was toggled @sign_messages New value of sign_messages +chatEventSignMessagesToggled sign_messages:Bool = ChatEventAction; + //@description A chat invite link was edited @old_invite_link Previous information about the invite link @new_invite_link New information about the invite link chatEventInviteLinkEdited old_invite_link:chatInviteLink new_invite_link:chatInviteLink = ChatEventAction; @@ -2627,8 +2782,11 @@ chatEventInviteLinkDeleted invite_link:chatInviteLink = ChatEventAction; //@description A video chat was created @group_call_id Identifier of the video chat. The video chat can be received through the method getGroupCall chatEventVideoChatCreated group_call_id:int32 = ChatEventAction; -//@description A video chat was discarded @group_call_id Identifier of the video chat. The video chat can be received through the method getGroupCall -chatEventVideoChatDiscarded group_call_id:int32 = ChatEventAction; +//@description A video chat was ended @group_call_id Identifier of the video chat. The video chat can be received through the method getGroupCall +chatEventVideoChatEnded group_call_id:int32 = ChatEventAction; + +//@description The mute_new_participants setting of a video chat was toggled @mute_new_participants New value of the mute_new_participants setting +chatEventVideoChatMuteNewParticipantsToggled mute_new_participants:Bool = ChatEventAction; //@description A video chat participant was muted or unmuted @participant_id Identifier of the affected group call participant @is_muted New value of is_muted chatEventVideoChatParticipantIsMutedToggled participant_id:MessageSender is_muted:Bool = ChatEventAction; @@ -2636,11 +2794,8 @@ chatEventVideoChatParticipantIsMutedToggled participant_id:MessageSender is_mute //@description A video chat participant volume level was changed @participant_id Identifier of the affected group call participant @volume_level New value of volume_level; 1-20000 in hundreds of percents chatEventVideoChatParticipantVolumeLevelChanged participant_id:MessageSender volume_level:int32 = ChatEventAction; -//@description The mute_new_participants setting of a video chat was toggled @mute_new_participants New value of the mute_new_participants setting -chatEventVideoChatMuteNewParticipantsToggled mute_new_participants:Bool = ChatEventAction; - -//@description Represents a chat event @id Chat event identifier @date Point in time (Unix timestamp) when the event happened @user_id Identifier of the user who performed the action that triggered the event @action Action performed by the user -chatEvent id:int64 date:int32 user_id:int53 action:ChatEventAction = ChatEvent; +//@description Represents a chat event @id Chat event identifier @date Point in time (Unix timestamp) when the event happened @member_id Identifier of the user or chat who performed the action @action The action +chatEvent id:int64 date:int32 member_id:MessageSender action:ChatEventAction = ChatEvent; //@description Contains a list of chat events @events List of events chatEvents events:vector = ChatEvents; @@ -2666,7 +2821,7 @@ chatEventLogFilters message_edits:Bool message_deletions:Bool message_pins:Bool //@description An ordinary language pack string @value String value languagePackStringValueOrdinary value:string = LanguagePackStringValue; -//@description A language pack string which has different forms based on the number of some object it mentions. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more info +//@description A language pack string which has different forms based on the number of some object it mentions. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more information //@zero_value Value for zero objects @one_value Value for one object @two_value Value for two objects //@few_value Value for few objects @many_value Value for many objects @other_value Default value languagePackStringValuePluralized zero_value:string one_value:string two_value:string few_value:string many_value:string other_value:string = LanguagePackStringValue; @@ -2684,7 +2839,7 @@ languagePackStrings strings:vector = LanguagePackStrings; //@description Contains information about a language pack @id Unique language pack identifier //@base_language_pack_id Identifier of a base language pack; may be empty. If a string is missed in the language pack, then it must be fetched from base language pack. Unsupported in custom language packs //@name Language name @native_name Name of the language in that language -//@plural_code A language code to be used to apply plural forms. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more info +//@plural_code A language code to be used to apply plural forms. See https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html for more information //@is_official True, if the language pack is official @is_rtl True, if the language pack strings are RTL @is_beta True, if the language pack is a beta language pack //@is_installed True, if the language pack is installed by the current user //@total_string_count Total number of non-deleted strings from the language pack @translated_string_count Total number of translated strings from the language pack @@ -2697,38 +2852,38 @@ localizationTargetInfo language_packs:vector = LocalizationTar //@class DeviceToken @description Represents a data needed to subscribe for push notifications through registerDevice method. To use specific push notification service, the correct application platform must be specified and a valid server authentication data must be uploaded at https://my.telegram.org -//@description A token for Firebase Cloud Messaging @token Device registration token; may be empty to de-register a device @encrypt True, if push notifications must be additionally encrypted +//@description A token for Firebase Cloud Messaging @token Device registration token; may be empty to deregister a device @encrypt True, if push notifications must be additionally encrypted deviceTokenFirebaseCloudMessaging token:string encrypt:Bool = DeviceToken; -//@description A token for Apple Push Notification service @device_token Device token; may be empty to de-register a device @is_app_sandbox True, if App Sandbox is enabled +//@description A token for Apple Push Notification service @device_token Device token; may be empty to deregister a device @is_app_sandbox True, if App Sandbox is enabled deviceTokenApplePush device_token:string is_app_sandbox:Bool = DeviceToken; -//@description A token for Apple Push Notification service VoIP notifications @device_token Device token; may be empty to de-register a device @is_app_sandbox True, if App Sandbox is enabled @encrypt True, if push notifications must be additionally encrypted +//@description A token for Apple Push Notification service VoIP notifications @device_token Device token; may be empty to deregister a device @is_app_sandbox True, if App Sandbox is enabled @encrypt True, if push notifications must be additionally encrypted deviceTokenApplePushVoIP device_token:string is_app_sandbox:Bool encrypt:Bool = DeviceToken; -//@description A token for Windows Push Notification Services @access_token The access token that will be used to send notifications; may be empty to de-register a device +//@description A token for Windows Push Notification Services @access_token The access token that will be used to send notifications; may be empty to deregister a device deviceTokenWindowsPush access_token:string = DeviceToken; -//@description A token for Microsoft Push Notification Service @channel_uri Push notification channel URI; may be empty to de-register a device +//@description A token for Microsoft Push Notification Service @channel_uri Push notification channel URI; may be empty to deregister a device deviceTokenMicrosoftPush channel_uri:string = DeviceToken; -//@description A token for Microsoft Push Notification Service VoIP channel @channel_uri Push notification channel URI; may be empty to de-register a device +//@description A token for Microsoft Push Notification Service VoIP channel @channel_uri Push notification channel URI; may be empty to deregister a device deviceTokenMicrosoftPushVoIP channel_uri:string = DeviceToken; -//@description A token for web Push API @endpoint Absolute URL exposed by the push service where the application server can send push messages; may be empty to de-register a device +//@description A token for web Push API @endpoint Absolute URL exposed by the push service where the application server can send push messages; may be empty to deregister a device //@p256dh_base64url Base64url-encoded P-256 elliptic curve Diffie-Hellman public key @auth_base64url Base64url-encoded authentication secret deviceTokenWebPush endpoint:string p256dh_base64url:string auth_base64url:string = DeviceToken; -//@description A token for Simple Push API for Firefox OS @endpoint Absolute URL exposed by the push service where the application server can send push messages; may be empty to de-register a device +//@description A token for Simple Push API for Firefox OS @endpoint Absolute URL exposed by the push service where the application server can send push messages; may be empty to deregister a device deviceTokenSimplePush endpoint:string = DeviceToken; -//@description A token for Ubuntu Push Client service @token Token; may be empty to de-register a device +//@description A token for Ubuntu Push Client service @token Token; may be empty to deregister a device deviceTokenUbuntuPush token:string = DeviceToken; -//@description A token for BlackBerry Push Service @token Token; may be empty to de-register a device +//@description A token for BlackBerry Push Service @token Token; may be empty to deregister a device deviceTokenBlackBerryPush token:string = DeviceToken; -//@description A token for Tizen Push Service @reg_id Push service registration identifier; may be empty to de-register a device +//@description A token for Tizen Push Service @reg_id Push service registration identifier; may be empty to deregister a device deviceTokenTizenPush reg_id:string = DeviceToken; @@ -2836,7 +2991,7 @@ checkChatUsernameResultUsernameInvalid = CheckChatUsernameResult; //@description The username is occupied checkChatUsernameResultUsernameOccupied = CheckChatUsernameResult; -//@description The user has too much chats with username, one of them must be made private first +//@description The user has too many chats with username, one of them must be made private first checkChatUsernameResultPublicChatsTooMuch = CheckChatUsernameResult; //@description The user can't be a member of a public supergroup @@ -2955,7 +3110,7 @@ pushMessageContentChatSetTheme theme_name:string = PushMessageContent; //@is_left True, if the user has left the group themselves pushMessageContentChatDeleteMember member_name:string is_current_user:Bool is_left:Bool = PushMessageContent; -//@description A new member joined the chat by invite link +//@description A new member joined the chat via an invite link pushMessageContentChatJoinByLink = PushMessageContent; //@description A new member was accepted to the chat by an administrator @@ -3004,9 +3159,22 @@ notificationGroupTypeSecretChat = NotificationGroupType; notificationGroupTypeCalls = NotificationGroupType; +//@description Describes a notification sound in MP3 format +//@id Unique identifier of the notification sound +//@duration Duration of the sound, in seconds +//@date Point in time (Unix timestamp) when the sound was created +//@title Title of the notification sound +//@data Arbitrary data, defined while the sound was uploaded +//@sound File containing the sound +notificationSound id:int64 duration:int32 date:int32 title:string data:string sound:file = NotificationSound; + +//@description Contains a list of notification sounds @notification_sounds A list of notification sounds +notificationSounds notification_sounds:vector = NotificationSounds; + + //@description Contains information about a notification @id Unique persistent identifier of this notification @date Notification date -//@is_silent True, if the notification was initially silent @type Notification type -notification id:int32 date:int32 is_silent:Bool type:NotificationType = Notification; +//@sound_id Identifier of the notification sound to be played; 0 if sound is disabled @type Notification type +notification id:int32 date:int32 sound_id:int64 type:NotificationType = Notification; //@description Describes a group of notifications @id Unique persistent auto-incremented from 1 identifier of the notification group @type Type of the group //@chat_id Identifier of a chat to which all notifications in the group belong @@ -3139,7 +3307,7 @@ sessions sessions:vector inactive_session_ttl_days:int32 = Sessions; //@log_in_date Point in time (Unix timestamp) when the user was logged in //@last_active_date Point in time (Unix timestamp) when obtained authorization was last used //@ip IP address from which the user was logged in, in human-readable format -//@location Human-readable description of a country and a region, from which the user was logged in, based on the IP address +//@location Human-readable description of a country and a region from which the user was logged in, based on the IP address connectedWebsite id:int64 domain_name:string bot_user_id:int53 browser:string platform:string log_in_date:int32 last_active_date:int32 ip:string location:string = ConnectedWebsite; //@description Contains a list of websites the current user is logged in with Telegram @websites List of connected websites @@ -3169,6 +3337,12 @@ chatReportReasonUnrelatedLocation = ChatReportReason; //@description The chat represents a fake account chatReportReasonFake = ChatReportReason; +//@description The chat has illegal drugs related content +chatReportReasonIllegalDrugs = ChatReportReason; + +//@description The chat contains messages with personal details +chatReportReasonPersonalDetails = ChatReportReason; + //@description A custom reason provided by the user chatReportReasonCustom = ChatReportReason; @@ -3178,6 +3352,13 @@ chatReportReasonCustom = ChatReportReason; //@description The link is a link to the active sessions section of the app. Use getActiveSessions to handle the link internalLinkTypeActiveSessions = InternalLinkType; +//@description The link is a link to an attachment menu bot to be opened in the specified chat. Process given chat_link to open corresponding chat. +//-Then call searchPublicChat with the given bot username, check that the user is a bot and can be added to attachment menu. Then use getAttachmentMenuBot to receive information about the bot. +//-If the bot isn't added to attachment menu, then user needs to confirm adding the bot to attachment menu. If user confirms adding, then use toggleBotIsAddedToAttachmentMenu to add it. +//-If attachment menu bots can't be used in the current chat, show an error to the user. If the bot is added to attachment menu, then use openWebApp with the given URL +//@chat_link An internal link pointing to a chat; may be null if the current chat needs to be kept @bot_username Username of the bot @url URL to be passed to openWebApp +internalLinkTypeAttachmentMenuBot chat_link:InternalLinkType bot_username:string url:string = InternalLinkType; + //@description The link contains an authentication code. Call checkAuthenticationCode with the code if the current authorization state is authorizationStateWaitCode @code The authentication code internalLinkTypeAuthenticationCode code:string = InternalLinkType; @@ -3190,9 +3371,19 @@ internalLinkTypeBackground background_name:string = InternalLinkType; internalLinkTypeBotStart bot_username:string start_parameter:string = InternalLinkType; //@description The link is a link to a Telegram bot, which is supposed to be added to a group chat. Call searchPublicChat with the given bot username, check that the user is a bot and can be added to groups, -//-ask the current user to select a group to add the bot to, and then call sendBotStartMessage with the given start parameter and the chosen group chat. Bots can be added to a public group only by administrators of the group -//@bot_username Username of the bot @start_parameter The parameter to be passed to sendBotStartMessage -internalLinkTypeBotStartInGroup bot_username:string start_parameter:string = InternalLinkType; +//-ask the current user to select a basic group or a supergroup chat to add the bot to, taking into account that bots can be added to a public supergroup only by administrators of the supergroup. +//-If administrator rights are provided by the link, call getChatMember to receive the current bot rights in the chat and if the bot already is an administrator, +//-check that the current user can edit its administrator rights, combine received rights with the requested administrator rights, show confirmation box to the user, +//-and call setChatMemberStatus with the chosen chat and confirmed administrator rights. Before call to setChatMemberStatus it may be required to upgrade the chosen basic group chat to a supergroup chat. +//-Then if start_parameter isn't empty, call sendBotStartMessage with the given start parameter and the chosen chat, otherwise just send /start message with bot's username added to the chat. +//@bot_username Username of the bot @start_parameter The parameter to be passed to sendBotStartMessage @administrator_rights Expected administrator rights for the bot; may be null +internalLinkTypeBotStartInGroup bot_username:string start_parameter:string administrator_rights:chatAdministratorRights = InternalLinkType; + +//@description The link is a link to a Telegram bot, which is supposed to be added to a channel chat as an administrator. Call searchPublicChat with the given bot username and check that the user is a bot, +//-ask the current user to select a channel chat to add the bot to as an administrator. Then call getChatMember to receive the current bot rights in the chat and if the bot already is an administrator, +//-check that the current user can edit its administrator rights and combine received rights with the requested administrator rights. Then show confirmation box to the user, and call setChatMemberStatus with the chosen chat and confirmed rights +//@bot_username Username of the bot @administrator_rights Expected administrator rights for the bot +internalLinkTypeBotAddToChannel bot_username:string administrator_rights:chatAdministratorRights = InternalLinkType; //@description The link is a link to the change phone number section of the app internalLinkTypeChangePhoneNumber = InternalLinkType; @@ -3210,6 +3401,9 @@ internalLinkTypeGame bot_username:string game_short_name:string = InternalLinkTy //@description The link is a link to a language pack. Call getLanguagePackInfo with the given language pack identifier to process the link @language_pack_id Language pack identifier internalLinkTypeLanguagePack language_pack_id:string = InternalLinkType; +//@description The link is a link to the language settings section of the app +internalLinkTypeLanguageSettings = InternalLinkType; + //@description The link is a link to a Telegram message. Call getMessageLinkInfo with the given URL to process the link @url URL to be passed to getMessageLinkInfo internalLinkTypeMessage url:string = InternalLinkType; @@ -3226,6 +3420,9 @@ internalLinkTypePassportDataRequest bot_user_id:int53 scope:string public_key:st //@hash Hash value from the link @phone_number Phone number value from the link internalLinkTypePhoneNumberConfirmation hash:string phone_number:string = InternalLinkType; +//@description The link is a link to the privacy and security settings section of the app +internalLinkTypePrivacyAndSecuritySettings = InternalLinkType; + //@description The link is a link to a proxy. Call addProxy with the given parameters to process the link and add the proxy //@server Proxy server IP address @port Proxy server port @type Type of the proxy internalLinkTypeProxy server:string port:int32 type:ProxyType = InternalLinkType; @@ -3255,7 +3452,10 @@ internalLinkTypeUnknownDeepLink link:string = InternalLinkType; //@description The link is a link to an unsupported proxy. An alert can be shown to the user internalLinkTypeUnsupportedProxy = InternalLinkType; -//@description The link is a link to a video chat. Call searchPublicChat with the given chat username, and then joinGoupCall with the given invite hash to process the link +//@description The link is a link to a user by its phone number. Call searchUserByPhoneNumber with the given phone number to process the link @phone_number Phone number of the user +internalLinkTypeUserPhoneNumber phone_number:string = InternalLinkType; + +//@description The link is a link to a video chat. Call searchPublicChat with the given chat username, and then joinGroupCall with the given invite hash to process the link //@chat_username Username of the chat with the video chat @invite_hash If non-empty, invite hash to be used to join the video chat without being muted by administrators //@is_live_stream True, if the video chat is expected to be a live stream in a channel or a broadcast group internalLinkTypeVideoChat chat_username:string invite_hash:string is_live_stream:Bool = InternalLinkType; @@ -3292,6 +3492,9 @@ fileTypeAudio = FileType; //@description The file is a document fileTypeDocument = FileType; +//@description The file is a notification sound +fileTypeNotificationSound = FileType; + //@description The file is a photo fileTypePhoto = FileType; @@ -3452,7 +3655,7 @@ tMeUrlTypeUser user_id:int53 = TMeUrlType; //@description A URL linking to a public supergroup or channel @supergroup_id Identifier of the supergroup or channel tMeUrlTypeSupergroup supergroup_id:int53 = TMeUrlType; -//@description A chat invite link @info Chat invite link info +//@description A chat invite link @info Information about the chat invite link tMeUrlTypeChatInvite info:chatInviteLinkInfo = TMeUrlType; //@description A URL linking to a sticker set @sticker_set_id Identifier of the sticker set @@ -3470,14 +3673,14 @@ tMeUrls urls:vector = TMeUrls; //@description Suggests the user to enable "archive_and_mute_new_chats_from_unknown_users" option suggestedActionEnableArchiveAndMuteNewChats = SuggestedAction; -//@description Suggests the user to check whether 2-step verification password is still remembered +//@description Suggests the user to check whether they still remember their 2-step verification password suggestedActionCheckPassword = SuggestedAction; //@description Suggests the user to check whether authorization phone number is correct and change the phone number if it is inaccessible suggestedActionCheckPhoneNumber = SuggestedAction; -//@description Suggests the user to see a hint about meaning of one and two ticks on sent message -suggestedActionSeeTicksHint = SuggestedAction; +//@description Suggests the user to view a hint about the meaning of one and two check marks on sent messages +suggestedActionViewChecksHint = SuggestedAction; //@description Suggests the user to convert specified supergroup to a broadcast group @supergroup_id Supergroup identifier suggestedActionConvertToBroadcastGroup supergroup_id:int53 = SuggestedAction; @@ -3529,18 +3732,11 @@ proxy id:int32 server:string port:int32 last_used_date:int32 is_enabled:Bool typ proxies proxies:vector = Proxies; -//@class InputSticker @description Describes a sticker that needs to be added to a sticker set - -//@description A static sticker in PNG format, which will be converted to WEBP server-side -//@sticker PNG image with the sticker; must be up to 512 KB in size and fit in a 512x512 square +//@description A sticker to be added to a sticker set +//@sticker File with the sticker; must fit in a 512x512 square. For WEBP stickers and masks the file must be in PNG format, which will be converted to WEBP server-side. Otherwise, the file must be local or uploaded within a week. See https://core.telegram.org/animated_stickers#technical-requirements for technical requirements //@emojis Emojis corresponding to the sticker -//@mask_position For masks, position where the mask is placed; pass null if unspecified -inputStickerStatic sticker:InputFile emojis:string mask_position:maskPosition = InputSticker; - -//@description An animated sticker in TGS format -//@sticker File with the animated sticker. Only local or uploaded within a week files are supported. See https://core.telegram.org/animated_stickers#technical-requirements for technical requirements -//@emojis Emojis corresponding to the sticker -inputStickerAnimated sticker:InputFile emojis:string = InputSticker; +//@type Sticker type +inputSticker sticker:InputFile emojis:string type:StickerType = InputSticker; //@description Represents a date range @start_date Point in time (Unix timestamp) at which the date range begins @end_date Point in time (Unix timestamp) at which the date range ends @@ -3706,6 +3902,9 @@ updateMessageContentOpened chat_id:int53 message_id:int53 = Update; //@description A message with an unread mention was read @chat_id Chat identifier @message_id Message identifier @unread_mention_count The new number of unread mention messages left in the chat updateMessageMentionRead chat_id:int53 message_id:int53 unread_mention_count:int32 = Update; +//@description The list of unread reactions added to a message was changed @chat_id Chat identifier @message_id Message identifier @unread_reactions The new list of unread reactions @unread_reaction_count The new number of messages with unread reactions left in the chat +updateMessageUnreadReactions chat_id:int53 message_id:int53 unread_reactions:vector unread_reaction_count:int32 = Update; + //@description A message with a live location was viewed. When the update is received, the application is supposed to update the live location //@chat_id Identifier of the chat with the live location message @message_id Identifier of the message with live location updateMessageLiveLocationViewed chat_id:int53 message_id:int53 = Update; @@ -3728,50 +3927,29 @@ updateChatLastMessage chat_id:int53 last_message:message positions:vector = Update; + +//@description A chat draft has changed. Be aware that the update may come in the currently opened chat but with old content of the draft. If the user has changed the content of the draft, this update mustn't be applied @chat_id Chat identifier @draft_message The new draft message; may be null @positions The new chat positions in the chat lists +updateChatDraftMessage chat_id:int53 draft_message:draftMessage positions:vector = Update; + +//@description The message sender that is selected to send messages in a chat has changed @chat_id Chat identifier @message_sender_id New value of message_sender_id; may be null if the user can't change message sender +updateChatMessageSender chat_id:int53 message_sender_id:MessageSender = Update; + +//@description The message Time To Live setting for a chat was changed @chat_id Chat identifier @message_ttl New value of message_ttl +updateChatMessageTtl chat_id:int53 message_ttl:int32 = Update; + +//@description Notification settings for a chat were changed @chat_id Chat identifier @notification_settings The new notification settings +updateChatNotificationSettings chat_id:int53 notification_settings:chatNotificationSettings = Update; //@description The chat pending join requests were changed @chat_id Chat identifier @pending_join_requests The new data about pending join requests; may be null updateChatPendingJoinRequests chat_id:int53 pending_join_requests:chatJoinRequestsInfo = Update; @@ -3780,15 +3958,42 @@ updateChatPendingJoinRequests chat_id:int53 pending_join_requests:chatJoinReques //@chat_id Chat identifier @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 updateChatReplyMarkup chat_id:int53 reply_markup_message_id:int53 = Update; -//@description A chat draft has changed. Be aware that the update may come in the currently opened chat but with old content of the draft. If the user has changed the content of the draft, this update mustn't be applied @chat_id Chat identifier @draft_message The new draft message; may be null @positions The new chat positions in the chat lists -updateChatDraftMessage chat_id:int53 draft_message:draftMessage positions:vector = 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 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; + +//@description The chat unread_reaction_count has changed @chat_id Chat identifier @unread_reaction_count The number of messages with unread reactions left in the chat +updateChatUnreadReactionCount chat_id:int53 unread_reaction_count:int32 = Update; + +//@description A chat video chat state has changed @chat_id Chat identifier @video_chat New value of video_chat +updateChatVideoChat chat_id:int53 video_chat:videoChat = Update; + +//@description The value of the default disable_notification parameter, used when a message is sent to the chat, was changed @chat_id Chat identifier @default_disable_notification The new default_disable_notification value +updateChatDefaultDisableNotification chat_id:int53 default_disable_notification:Bool = Update; + +//@description A chat content was allowed or restricted for saving @chat_id Chat identifier @has_protected_content New value of has_protected_content +updateChatHasProtectedContent chat_id:int53 has_protected_content:Bool = 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 was blocked or unblocked @chat_id Chat identifier @is_blocked New value of is_blocked +updateChatIsBlocked chat_id:int53 is_blocked:Bool = Update; + +//@description A chat was marked as unread or was read @chat_id Chat identifier @is_marked_as_unread New value of is_marked_as_unread +updateChatIsMarkedAsUnread chat_id:int53 is_marked_as_unread:Bool = Update; //@description The list of chat filters or a chat filter has changed @chat_filters The new list of chat filters updateChatFilters chat_filters:vector = Update; -//@description The number of online group members has changed. This update with non-zero count is sent only for currently opened chats. There is no guarantee that it will be sent just after the count has changed @chat_id Identifier of the chat @online_member_count New number of online members in the chat, or 0 if unknown +//@description The number of online group members has changed. This update with non-zero number of online group members is sent only for currently opened chats. There is no guarantee that it will be sent just after the number of online users has changed @chat_id Identifier of the chat @online_member_count New number of online members in the chat, or 0 if unknown updateChatOnlineMemberCount chat_id:int53 online_member_count:int32 = Update; +//@description Notification settings for some type of chats were updated @scope Types of chats for which notification settings were updated @notification_settings The new notification settings +updateScopeNotificationSettings scope:NotificationSettingsScope notification_settings:scopeNotificationSettings = Update; + //@description A notification was changed @notification_group_id Unique notification group identifier @notification Changed notification updateNotification notification_group_id:int32 notification:notification = Update; @@ -3797,10 +4002,10 @@ updateNotification notification_group_id:int32 notification:notification = Updat //@type New type of the notification group //@chat_id Identifier of a chat to which all notifications in the group belong //@notification_settings_chat_id Chat identifier, which notification settings must be applied to the added notifications -//@is_silent True, if the notifications must be shown without sound +//@notification_sound_id Identifier of the notification sound to be played; 0 if sound is disabled //@total_count Total number of unread notifications in the group, can be bigger than number of active notifications //@added_notifications List of added group notifications, sorted by notification ID @removed_notification_ids Identifiers of removed group notifications, sorted by notification ID -updateNotificationGroup notification_group_id:int32 type:NotificationGroupType chat_id:int53 notification_settings_chat_id:int53 is_silent:Bool total_count:int32 added_notifications:vector removed_notification_ids:vector = Update; +updateNotificationGroup notification_group_id:int32 type:NotificationGroupType chat_id:int53 notification_settings_chat_id:int53 notification_sound_id:int64 total_count:int32 added_notifications:vector removed_notification_ids:vector = Update; //@description Contains active notifications that was shown on previous application launches. This update is sent only if the message database is used. In that case it comes once before any updateNotification and updateNotificationGroup update @groups Lists of active notification groups updateActiveNotifications groups:vector = Update; @@ -3860,6 +4065,24 @@ updateFileGenerationStart generation_id:int64 original_path:string destination_p //@description File generation is no longer needed @generation_id Unique identifier for the generation process updateFileGenerationStop generation_id:int64 = Update; +//@description The state of the file download list has changed +//@total_size Total size of files in the file download list, in bytes +//@total_count Total number of files in the file download list +//@downloaded_size Total downloaded size of files in the file download list, in bytes +updateFileDownloads total_size:int53 total_count:int32 downloaded_size:int53 = Update; + +//@description A file was added to the file download list. This update is sent only after file download list is loaded for the first time @file_download The added file download @counts New number of being downloaded and recently downloaded files found +updateFileAddedToDownloads file_download:fileDownload counts:downloadedFileCounts = Update; + +//@description A file download was changed. This update is sent only after file download list is loaded for the first time @file_id File identifier +//@complete_date Point in time (Unix timestamp) when the file downloading was completed; 0 if the file downloading isn't completed +//@is_paused True, if downloading of the file is paused +//@counts New number of being downloaded and recently downloaded files found +updateFileDownload file_id:int32 complete_date:int32 is_paused:Bool counts:downloadedFileCounts = Update; + +//@description A file was removed from the file download list. This update is sent only after file download list is loaded for the first time @file_id File identifier @counts New number of being downloaded and recently downloaded files found +updateFileRemovedFromDownloads file_id:int32 counts:downloadedFileCounts = Update; + //@description New call was created or information about a call was updated @call New data about a call updateCall call:call = Update; @@ -3908,6 +4131,9 @@ updateFavoriteStickers sticker_ids:vector = Update; //@description The list of saved animations was updated @animation_ids The new list of file identifiers of saved animations updateSavedAnimations animation_ids:vector = Update; +//@description The list of saved notifications sounds was updated. This update may not be sent until information about a notification sound was requested for the first time @notification_sound_ids The new list of identifiers of saved notification sounds +updateSavedNotificationSounds notification_sound_ids:vector = Update; + //@description The selected background has changed @for_dark_theme True, if background for dark theme has changed @background The new selected background; may be null updateSelectedBackground for_dark_theme:Bool background:background = Update; @@ -3926,6 +4152,15 @@ updateTermsOfService terms_of_service_id:string terms_of_service:termsOfService //@description The list of users nearby has changed. The update is guaranteed to be sent only 60 seconds after a successful searchChatsNearby request @users_nearby The new list of users nearby updateUsersNearby users_nearby:vector = Update; +//@description The list of bots added to attachment menu has changed @bots The new list of bots added to attachment menu. The bots must be shown in attachment menu only in private chats. The bots must not be shown on scheduled messages screen +updateAttachmentMenuBots bots:vector = Update; + +//@description A message was sent by an opened web app, so the web app needs to be closed @web_app_launch_id Identifier of web app launch +updateWebAppMessageSent web_app_launch_id:int64 = Update; + +//@description The list of supported reactions has changed @reactions The new list of supported reactions +updateReactions reactions:vector = Update; + //@description The list of supported dice emojis has changed @emojis The new list of supported dice emojis updateDiceEmojis emojis:vector = Update; @@ -3940,7 +4175,7 @@ updateAnimationSearchParameters provider:string emojis:vector = Update; updateSuggestedActions added_actions:vector removed_actions:vector = Update; //@description A new incoming inline query; for bots only @id Unique query identifier @sender_user_id Identifier of the user who sent the query @user_location User location; may be null -//@chat_type The type of the chat, from which the query originated; may be null if unknown @query Text of the query @offset Offset of the first entry to return +//@chat_type The type of the chat from which the query originated; may be null if unknown @query Text of the query @offset Offset of the first entry to return updateNewInlineQuery id:int64 sender_user_id:int53 user_location:location chat_type:ChatType query:string offset:string = Update; //@description The user has chosen a result of an inline query; for bots only @sender_user_id Identifier of the user who sent the query @user_location User location; may be null @@ -3948,11 +4183,11 @@ updateNewInlineQuery id:int64 sender_user_id:int53 user_location:location chat_t updateNewChosenInlineResult sender_user_id:int53 user_location:location query:string result_id:string inline_message_id:string = Update; //@description A new incoming callback query; for bots only @id Unique query identifier @sender_user_id Identifier of the user who sent the query -//@chat_id Identifier of the chat where the query was sent @message_id Identifier of the message, from which the query originated +//@chat_id Identifier of the chat where the query was sent @message_id Identifier of the message from which the query originated //@chat_instance Identifier that uniquely corresponds to the chat to which the message was sent @payload Query payload updateNewCallbackQuery id:int64 sender_user_id:int53 chat_id:int53 message_id:int53 chat_instance:int64 payload:CallbackQueryPayload = Update; -//@description A new incoming callback query from a message sent via a bot; for bots only @id Unique query identifier @sender_user_id Identifier of the user who sent the query @inline_message_id Identifier of the inline message, from which the query originated +//@description A new incoming callback query from a message sent via a bot; for bots only @id Unique query identifier @sender_user_id Identifier of the user who sent the query @inline_message_id Identifier of the inline message from which the query originated //@chat_instance An identifier uniquely corresponding to the chat a message was sent to @payload Query payload updateNewInlineCallbackQuery id:int64 sender_user_id:int53 inline_message_id:string chat_instance:int64 payload:CallbackQueryPayload = Update; @@ -4099,7 +4334,7 @@ setDatabaseEncryptionKey new_encryption_key:bytes = Ok; getPasswordState = PasswordState; //@description Changes the password for the current user. If a new recovery email address is specified, then the change will not be applied until the new recovery email address is confirmed -//@old_password Previous password of the user @new_password New password of the user; may be empty to remove the password @new_hint New password hint; may be empty @set_recovery_email_address Pass true if the recovery email address must be changed @new_recovery_email_address New recovery email address; may be empty +//@old_password Previous password of the user @new_password New password of the user; may be empty to remove the password @new_hint New password hint; may be empty @set_recovery_email_address Pass true to change also the recovery email address @new_recovery_email_address New recovery email address; may be empty setPassword old_password:string new_password:string new_hint:string set_recovery_email_address:Bool new_recovery_email_address:string = PasswordState; //@description Returns a 2-step verification recovery email address that was previously set up. This method can be used to verify a password provided by the user @password The password for the current user @@ -4168,7 +4403,7 @@ getChat chat_id:int53 = Chat; //@description Returns information about a message @chat_id Identifier of the chat the message belongs to @message_id Identifier of the message to get getMessage chat_id:int53 message_id:int53 = Message; -//@description Returns information about a message, if it is available locally without sending network request. This is an offline request @chat_id Identifier of the chat the message belongs to @message_id Identifier of the message to get +//@description Returns information about a message, if it is available without sending network request. This is an offline request @chat_id Identifier of the chat the message belongs to @message_id Identifier of the message to get getMessageLocally chat_id:int53 message_id:int53 = Message; //@description Returns information about a message that is replied by a given message. Also returns the pinned message, the game message, and the invoice message for messages of the types messagePinMessage, messageGameScore, and messagePaymentSuccessful respectively @@ -4207,10 +4442,10 @@ loadChats chat_list:ChatList limit:int32 = Ok; //@chat_list The chat list in which to return chats; pass null to get chats from the main chat list @limit The maximum number of chats to be returned getChats chat_list:ChatList limit:int32 = Chats; -//@description Searches a public chat by its username. Currently only private chats, supergroups and channels can be public. Returns the chat if found; otherwise an error is returned @username Username to be resolved +//@description Searches a public chat by its username. Currently, only private chats, supergroups and channels can be public. Returns the chat if found; otherwise an error is returned @username Username to be resolved searchPublicChat username:string = Chat; -//@description Searches public chats by looking for specified query in their username and title. Currently only private chats, supergroups and channels can be public. Returns a meaningful number of results. +//@description Searches public chats by looking for specified query in their username and title. Currently, only private chats, supergroups and channels can be public. Returns a meaningful number of results. //-Excludes private chats with contacts and chats from the chat list from the results @query Query to search for searchPublicChats query:string = Chats; @@ -4267,7 +4502,7 @@ getGroupsInCommon user_id:int53 offset_chat_id:int53 limit:int32 = Chats; //@from_message_id Identifier of the message starting from which history must be fetched; use 0 to get results from the last message //@offset Specify 0 to get results from exactly the from_message_id or a negative offset up to 99 to get additionally some newer messages //@limit The maximum number of messages to be returned; must be positive and can't be greater than 100. If the offset is negative, the limit must be greater than or equal to -offset. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit -//@only_local If true, returns only messages that are available locally without sending network requests +//@only_local Pass true to get only messages that are available without sending network requests getChatHistory chat_id:int53 from_message_id:int53 offset:int32 limit:int32 only_local:Bool = Messages; //@description Returns messages in a message thread of a message. Can be used only if message.can_get_message_thread == true. Message thread of a channel message is in the channel's linked supergroup. @@ -4280,10 +4515,10 @@ getChatHistory chat_id:int53 from_message_id:int53 offset:int32 limit:int32 only getMessageThreadHistory chat_id:int53 message_id:int53 from_message_id:int53 offset:int32 limit:int32 = Messages; //@description Deletes all messages in the chat. Use chat.can_be_deleted_only_for_self and chat.can_be_deleted_for_all_users fields to find whether and how the method can be applied to the chat -//@chat_id Chat identifier @remove_from_chat_list Pass true if the chat needs to be removed from the chat list @revoke Pass true to try to delete chat history for all users +//@chat_id Chat identifier @remove_from_chat_list Pass true to remove the chat from all chat lists @revoke Pass true to delete chat history for all users deleteChatHistory chat_id:int53 remove_from_chat_list:Bool revoke:Bool = Ok; -//@description Deletes a chat along with all messages in the corresponding chat for all chat members; requires owner privileges. For group chats this will release the username and remove all members. Chats with more than 1000 members can't be deleted using this method @chat_id Chat identifier +//@description Deletes a chat along with all messages in the corresponding chat for all chat members. For group chats this will release the username and remove all members. Use the field chat.can_be_deleted_for_all_users to find whether the method can be applied to the chat @chat_id Chat identifier deleteChat chat_id:int53 = Ok; //@description Searches for messages with given words in the chat. Returns the results in reverse chronological order, i.e. in order of decreasing message_id. Cannot be used in secret chats with a non-empty query @@ -4306,7 +4541,7 @@ searchChatMessages chat_id:int53 query:string sender_id:MessageSender from_messa //@offset_chat_id The chat identifier of the last found message, or 0 for the first request //@offset_message_id The message identifier of the last found message, or 0 for the first request //@limit The maximum number of messages to be returned; up to 100. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit -//@filter Additional filter for messages to search; pass null to search for all messages. Filters searchMessagesFilterCall, searchMessagesFilterMissedCall, searchMessagesFilterMention, searchMessagesFilterUnreadMention, searchMessagesFilterFailedToSend and searchMessagesFilterPinned are unsupported in this function +//@filter Additional filter for messages to search; pass null to search for all messages. Filters searchMessagesFilterMention, searchMessagesFilterUnreadMention, searchMessagesFilterUnreadReaction, searchMessagesFilterFailedToSend, and searchMessagesFilterPinned are unsupported in this function //@min_date If not 0, the minimum date of the messages to return //@max_date If not 0, the maximum date of the messages to return searchMessages chat_list:ChatList query:string offset_date:int32 offset_chat_id:int53 offset_message_id:int53 limit:int32 filter:SearchMessagesFilter min_date:int32 max_date:int32 = Messages; @@ -4314,16 +4549,22 @@ searchMessages chat_list:ChatList query:string offset_date:int32 offset_chat_id: //@description Searches for messages in secret chats. Returns the results in reverse chronological order. For optimal performance, the number of returned messages is chosen by TDLib //@chat_id Identifier of the chat in which to search. Specify 0 to search in all secret chats //@query Query to search for. If empty, searchChatMessages must be used instead -//@offset Offset of the first entry to return as received from the previous request; use empty string to get first chunk of results +//@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 messages to be returned; up to 100. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit //@filter Additional filter for messages to search; pass null to search for all messages searchSecretMessages chat_id:int53 query:string offset:string limit:int32 filter:SearchMessagesFilter = FoundMessages; //@description Searches for call messages. Returns the results in reverse chronological order (i. e., in order of decreasing message_id). For optimal performance, the number of returned messages is chosen by TDLib //@from_message_id Identifier of the message from which to search; use 0 to get results from the last message -//@limit The maximum number of messages to be returned; up to 100. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit @only_missed If true, returns only messages with missed calls +//@limit The maximum number of messages to be returned; up to 100. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit +//@only_missed Pass true to search only for messages with missed/declined calls searchCallMessages from_message_id:int53 limit:int32 only_missed:Bool = Messages; +//@description Searches for outgoing messages with content of the type messageDocument in all chats except secret chats. Returns the results in reverse chronological order +//@query Query to search for in document file name and message caption +//@limit The maximum number of messages to be returned; up to 100 +searchOutgoingDocumentMessages query:string limit:int32 = FoundMessages; + //@description Deletes all call messages @revoke Pass true to delete the messages for all users deleteAllCallMessages revoke:Bool = Ok; @@ -4339,18 +4580,18 @@ getChatMessageByDate chat_id:int53 date:int32 = Message; //@description Returns sparse positions of messages of the specified type in the chat to be used for shared media scroll implementation. Returns the results in reverse chronological order (i.e., in order of decreasing message_id). //-Cannot be used in secret chats or with searchMessagesFilterFailedToSend filter without an enabled message database //@chat_id Identifier of the chat in which to return information about message positions -//@filter Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterCall, searchMessagesFilterMissedCall, searchMessagesFilterMention and searchMessagesFilterUnreadMention are unsupported in this function +//@filter Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterMention, searchMessagesFilterUnreadMention, and searchMessagesFilterUnreadReaction are unsupported in this function //@from_message_id The message identifier from which to return information about message positions //@limit The expected number of message positions to be returned; 50-2000. A smaller number of positions can be returned, if there are not enough appropriate messages getChatSparseMessagePositions chat_id:int53 filter:SearchMessagesFilter from_message_id:int53 limit:int32 = MessagePositions; -//@description Returns information about the next messages of the specified type in the chat splitted by days. Returns the results in reverse chronological order. Can return partial result for the last returned day. Behavior of this method depends on the value of the option "utc_time_offset" +//@description Returns information about the next messages of the specified type in the chat split by days. Returns the results in reverse chronological order. Can return partial result for the last returned day. Behavior of this method depends on the value of the option "utc_time_offset" //@chat_id Identifier of the chat in which to return information about messages -//@filter Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterCall, searchMessagesFilterMissedCall, searchMessagesFilterMention and searchMessagesFilterUnreadMention are unsupported in this function +//@filter Filter for message content. Filters searchMessagesFilterEmpty, searchMessagesFilterMention, searchMessagesFilterUnreadMention, and searchMessagesFilterUnreadReaction are unsupported in this function //@from_message_id The message identifier from which to return information about messages; use 0 to get results from the last message getChatMessageCalendar chat_id:int53 filter:SearchMessagesFilter from_message_id:int53 = MessageCalendar; -//@description Returns approximate number of messages of the specified type in the chat @chat_id Identifier of the chat in which to count messages @filter Filter for message content; searchMessagesFilterEmpty is unsupported in this function @return_local If true, returns count that is available locally without sending network requests, returning -1 if the number of messages is unknown +//@description Returns approximate number of messages of the specified type in the chat @chat_id Identifier of the chat in which to count messages @filter Filter for message content; searchMessagesFilterEmpty is unsupported in this function @return_local Pass true to get the number of messages without sending network requests, or -1 if the number of messages is unknown locally getChatMessageCount chat_id:int53 filter:SearchMessagesFilter return_local:Bool = Count; //@description Returns all scheduled messages in a chat. The messages are returned in a reverse chronological order (i.e., in order of decreasing message_id) @chat_id Chat identifier @@ -4359,15 +4600,12 @@ getChatScheduledMessages chat_id:int53 = Messages; //@description Returns forwarded copies of a channel message to different public channels. For optimal performance, the number of returned messages is chosen by TDLib //@chat_id Chat identifier of the message //@message_id Message identifier -//@offset Offset of the first entry to return as received from the previous request; use empty string to get first chunk of results +//@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 messages to be returned; must be positive and can't be greater than 100. For optimal performance, the number of returned messages is chosen by TDLib and can be smaller than the specified limit getMessagePublicForwards chat_id:int53 message_id:int53 offset:string limit:int32 = FoundMessages; -//@description Returns sponsored messages to be shown in a chat; for channel chats only @chat_id Identifier of the chat -getChatSponsoredMessages chat_id:int53 = SponsoredMessages; - -//@description Informs TDLib that a sponsored message was viewed by the user @chat_id Identifier of the chat with the sponsored message @sponsored_message_id The identifier of the sponsored message being viewed -viewSponsoredMessage chat_id:int53 sponsored_message_id:int32 = Ok; +//@description Returns sponsored message to be shown in a chat; for channel chats only. Returns a 404 error if there is no sponsored message in the chat @chat_id Identifier of the chat +getChatSponsoredMessage chat_id:int53 = SponsoredMessage; //@description Removes an active notification from notification list. Needs to be called only if the notification is removed by the current user @notification_group_id Identifier of notification group to which the notification belongs @notification_id Identifier of removed notification @@ -4395,28 +4633,36 @@ getMessageEmbeddingCode chat_id:int53 message_id:int53 for_album:Bool = Text; getMessageLinkInfo url:string = MessageLinkInfo; +//@description Translates a text to the given language. Returns a 404 error if the translation can't be performed +//@text Text to translate +//@from_language_code A two-letter ISO 639-1 language code of the language from which the message is translated. If empty, the language will be detected automatically +//@to_language_code A two-letter ISO 639-1 language code of the language to which the message is translated +translateText text:string from_language_code:string to_language_code:string = Text; + + //@description Returns list of message sender identifiers, which can be used to send messages in a chat @chat_id Chat identifier getChatAvailableMessageSenders chat_id:int53 = MessageSenders; -//@description Changes default message sender that is chosen in a chat @chat_id Chat identifier @default_message_sender_id New default message sender in the chat -setChatDefaultMessageSender chat_id:int53 default_message_sender_id:MessageSender = Ok; +//@description Selects a message sender to send messages in a chat @chat_id Chat identifier @message_sender_id New message sender for the chat +setChatMessageSender chat_id:int53 message_sender_id:MessageSender = Ok; //@description Sends a message. Returns the sent message //@chat_id Target chat //@message_thread_id If not 0, a message thread identifier in which the message will be sent -//@reply_to_message_id Identifier of the message to reply to or 0 +//@reply_to_message_id Identifier of the replied message; 0 if none //@options Options to be used to send the message; pass null to use default options //@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 sendMessage chat_id:int53 message_thread_id:int53 reply_to_message_id:int53 options:messageSendOptions reply_markup:ReplyMarkup input_message_content:InputMessageContent = Message; -//@description Sends 2-10 messages grouped together into an album. Currently only audio, document, photo and video messages can be grouped into an album. Documents and audio files can be only grouped in an album with messages of the same type. Returns sent messages +//@description Sends 2-10 messages grouped together into an album. Currently, only audio, document, photo and video messages can be grouped into an album. Documents and audio files can be only grouped in an album with messages of the same type. Returns sent messages //@chat_id Target chat //@message_thread_id If not 0, a message thread identifier in which the messages will be sent -//@reply_to_message_id Identifier of a message to reply to or 0 +//@reply_to_message_id Identifier of a replied message; 0 if none //@options Options to be used to send the messages; pass null to use default options //@input_message_contents Contents of messages to be sent. At most 10 messages can be added to an album -sendMessageAlbum chat_id:int53 message_thread_id:int53 reply_to_message_id:int53 options:messageSendOptions input_message_contents:vector = Messages; +//@only_preview Pass true to get fake messages instead of actually sending them +sendMessageAlbum chat_id:int53 message_thread_id:int53 reply_to_message_id:int53 options:messageSendOptions input_message_contents:vector only_preview:Bool = Messages; //@description Invites a bot to a chat (if it is not yet a member) and sends it the /start command. Bots can't be invited to a private chat other than the chat with the bot. Bots can't be invited to channels (although they can be added as admins) and secret chats. Returns the sent message //@bot_user_id Identifier of the bot @chat_id Identifier of the target chat @parameter A hidden parameter sent to the bot for deep linking purposes (https://core.telegram.org/bots#deep-linking) @@ -4425,11 +4671,11 @@ sendBotStartMessage bot_user_id:int53 chat_id:int53 parameter:string = Message; //@description Sends the result of an inline query as a message. Returns the sent message. Always clears a chat draft message //@chat_id Target chat //@message_thread_id If not 0, a message thread identifier in which the message will be sent -//@reply_to_message_id Identifier of a message to reply to or 0 +//@reply_to_message_id Identifier of a replied message; 0 if none //@options Options to be used to send the message; pass null to use default options //@query_id Identifier of the inline query //@result_id Identifier of the inline result -//@hide_via_bot If true, there will be no mention of a bot, via which the message is sent. Can be used only for bots GetOption("animation_search_bot_username"), GetOption("photo_search_bot_username") and GetOption("venue_search_bot_username") +//@hide_via_bot Pass true to hide the bot, via which the message is sent. Can be used only for bots GetOption("animation_search_bot_username"), GetOption("photo_search_bot_username"), and GetOption("venue_search_bot_username") sendInlineQueryResultMessage chat_id:int53 message_thread_id:int53 reply_to_message_id:int53 options:messageSendOptions query_id:int64 result_id:string hide_via_bot:Bool = Message; //@description Forwards previously sent messages. Returns the forwarded messages in the same order as the message identifiers passed in message_ids. If a message can't be forwarded, null will be returned instead of the message @@ -4437,9 +4683,9 @@ sendInlineQueryResultMessage chat_id:int53 message_thread_id:int53 reply_to_mess //@from_chat_id Identifier of the chat from which to forward messages //@message_ids Identifiers of the messages to forward. Message identifiers must be in a strictly increasing order. At most 100 messages can be forwarded simultaneously //@options Options to be used to send the messages; pass null to use default options -//@send_copy If true, content of the messages will be copied without reference to the original sender. Always true if the messages are forwarded to a secret chat or are local -//@remove_caption If true, media caption of message copies will be removed. Ignored if send_copy is false -//@only_preview If true, messages will not be forwarded and instead fake messages will be returned +//@send_copy Pass true to copy content of the messages without reference to the original sender. Always true if the messages are forwarded to a secret chat or are local +//@remove_caption Pass true to remove media captions of message copies. Ignored if send_copy is false +//@only_preview Pass true to get fake messages instead of actually forwarding them forwardMessages chat_id:int53 from_chat_id:int53 message_ids:vector options:messageSendOptions send_copy:Bool remove_caption:Bool only_preview:Bool = Messages; //@description Resends messages which failed to send. Can be called only for messages for which messageSendingStateFailed.can_retry is true and after specified in messageSendingStateFailed.retry_after time passed. @@ -4453,19 +4699,19 @@ sendChatScreenshotTakenNotification chat_id:int53 = Ok; //@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 //@sender_id Identifier of the sender of the message -//@reply_to_message_id Identifier of the message to reply to or 0 +//@reply_to_message_id Identifier of the replied message; 0 if none //@disable_notification Pass true to disable notification for the message //@input_message_content The content of the message to be added addLocalMessage chat_id:int53 sender_id:MessageSender reply_to_message_id:int53 disable_notification:Bool input_message_content:InputMessageContent = Message; -//@description Deletes messages @chat_id Chat identifier @message_ids Identifiers of the messages to be deleted @revoke Pass true to try to delete messages for all chat members. Always true for supergroups, channels and secret chats +//@description Deletes messages @chat_id Chat identifier @message_ids Identifiers of the messages to be deleted @revoke Pass true to delete messages for all chat members. Always true for supergroups, channels and secret chats deleteMessages chat_id:int53 message_ids:vector revoke:Bool = Ok; //@description Deletes all messages sent by the specified message sender in a chat. Supported only for supergroups; requires can_delete_messages administrator privileges @chat_id Chat identifier @sender_id Identifier of the sender of messages to delete deleteChatMessagesBySender chat_id:int53 sender_id:MessageSender = Ok; //@description Deletes all messages between the specified dates in a chat. Supported only for private chats and basic groups. Messages sent in the last 30 seconds will not be deleted -//@chat_id Chat identifier @min_date The minimum date of the messages to delete @max_date The maximum date of the messages to delete @revoke Pass true to try to delete chat messages for all users; private chats only +//@chat_id Chat identifier @min_date The minimum date of the messages to delete @max_date The maximum date of the messages to delete @revoke Pass true to delete chat messages for all users; private chats only deleteChatMessagesByDate chat_id:int53 min_date:int32 max_date:int32 revoke:Bool = Ok; @@ -4544,14 +4790,35 @@ editInlineMessageReplyMarkup inline_message_id:string reply_markup:ReplyMarkup = editMessageSchedulingState chat_id:int53 message_id:int53 scheduling_state:MessageSchedulingState = Ok; +//@description Returns reactions, which can be added to a message. The list can change after updateReactions, updateChatAvailableReactions for the chat, or updateMessageInteractionInfo for the message +//@chat_id Identifier of the chat to which the message belongs +//@message_id Identifier of the message +getMessageAvailableReactions chat_id:int53 message_id:int53 = AvailableReactions; + +//@description Changes chosen reaction for a message +//@chat_id Identifier of the chat to which the message belongs +//@message_id Identifier of the message +//@reaction Text representation of the new chosen reaction. Can be an empty string or the currently chosen non-big reaction to remove the reaction +//@is_big Pass true if the reaction is added with a big animation +setMessageReaction chat_id:int53 message_id:int53 reaction:string is_big:Bool = Ok; + +//@description Returns reactions added for a message, along with their sender +//@chat_id Identifier of the chat to which the message belongs +//@message_id Identifier of the message +//@reaction If non-empty, only added reactions with the specified text representation will be returned +//@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 reactions to be returned; must be positive and can't be greater than 100 +getMessageAddedReactions chat_id:int53 message_id:int53 reaction:string offset:string limit:int32 = AddedReactions; + + //@description Returns all entities (mentions, hashtags, cashtags, bot commands, bank card numbers, URLs, and email addresses) contained in the text. Can be called synchronously @text The text in which to look for entites getTextEntities text:string = TextEntities; -//@description Parses Bold, Italic, Underline, Strikethrough, Code, Pre, PreCode, TextUrl and MentionName entities contained in the text. Can be called synchronously @text The text to parse @parse_mode Text parse mode +//@description Parses Bold, Italic, Underline, Strikethrough, Spoiler, Code, Pre, PreCode, TextUrl and MentionName entities contained in the text. Can be called synchronously @text The text to parse @parse_mode Text parse mode parseTextEntities text:string parse_mode:TextParseMode = FormattedText; //@description Parses Markdown entities in a human-friendly format, ignoring markup errors. Can be called synchronously -//@text The text to parse. For example, "__italic__ ~~strikethrough~~ **bold** `code` ```pre``` __[italic__ text_url](telegram.org) __italic**bold italic__bold**" +//@text The text to parse. For example, "__italic__ ~~strikethrough~~ ||spoiler|| **bold** `code` ```pre``` __[italic__ text_url](telegram.org) __italic**bold italic__bold**" parseMarkdown text:formattedText = FormattedText; //@description Replaces text entities with Markdown formatting in a human-friendly format. Entities that can't be represented in Markdown unambiguously are kept as is. Can be called synchronously @text The text @@ -4576,14 +4843,19 @@ getJsonValue json:string = JsonValue; //@description Converts a JsonValue object to corresponding JSON-serialized string. Can be called synchronously @json_value The JsonValue object getJsonString json_value:JsonValue = Text; +//@description Converts a themeParameters object to corresponding JSON-serialized string. Can be called synchronously @theme Theme parameters to convert to JSON +getThemeParametersJsonString theme:themeParameters = Text; + //@description Changes the user answer to a poll. A poll in quiz mode can be answered only once -//@chat_id Identifier of the chat to which the poll belongs @message_id Identifier of the message containing the poll +//@chat_id Identifier of the chat to which the poll belongs +//@message_id Identifier of the message containing the poll //@option_ids 0-based identifiers of answer options, chosen by the user. User can choose more than 1 answer option only is the poll allows multiple answers setPollAnswer chat_id:int53 message_id:int53 option_ids:vector = Ok; //@description Returns users voted for the specified option in a non-anonymous polls. For optimal performance, the number of returned users is chosen by TDLib -//@chat_id Identifier of the chat to which the poll belongs @message_id Identifier of the message containing the poll +//@chat_id Identifier of the chat to which the poll belongs +//@message_id Identifier of the message containing the poll //@option_id 0-based identifier of the answer option //@offset Number of users to skip in the result; must be non-negative //@limit The maximum number of users to be returned; must be positive and can't be greater than 50. For optimal performance, the number of returned users is chosen by TDLib and can be smaller than the specified limit, even if the end of the voter list has not been reached @@ -4607,7 +4879,7 @@ getLoginUrlInfo chat_id:int53 message_id:int53 button_id:int53 = LoginUrlInfo; //@description Returns an HTTP URL which can be used to automatically authorize the user on a website after clicking an inline button of type inlineKeyboardButtonTypeLoginUrl. //-Use the method getLoginUrlInfo to find whether a prior user confirmation is needed. If an error is returned, then the button must be handled as an ordinary URL button //@chat_id Chat identifier of the message with the button @message_id Message identifier of the message with the button @button_id Button identifier -//@allow_write_access True, if the user allowed the bot to send them messages +//@allow_write_access Pass true to allow the bot to send messages to the current user getLoginUrl chat_id:int53 message_id:int53 button_id:int53 allow_write_access:Bool = HttpUrl; @@ -4621,7 +4893,7 @@ getInlineQueryResults bot_user_id:int53 chat_id:int53 user_location:location que //@description Sets the result of an inline query; for bots only //@inline_query_id Identifier of the inline query -//@is_personal True, if the result of the query can be cached for the specified user +//@is_personal Pass true if results may be cached and returned only for the user that sent the query. By default, results may be returned to any user who sends the same query //@results The results of the query //@cache_time Allowed time to cache the results of the query, in seconds //@next_offset Offset for the next inline query; pass an empty string if there are no more results @@ -4630,10 +4902,38 @@ getInlineQueryResults bot_user_id:int53 chat_id:int53 user_location:location que answerInlineQuery inline_query_id:int64 is_personal:Bool results:vector cache_time:int32 next_offset:string switch_pm_text:string switch_pm_parameter:string = Ok; +//@description Returns an HTTPS URL of a web app to open after keyboardButtonTypeWebApp button is pressed +//@bot_user_id Identifier of the target bot +//@url The URL from the keyboardButtonTypeWebApp button +//@theme Preferred web app theme; pass null to use the default theme +getWebAppUrl bot_user_id:int53 url:string theme:themeParameters = HttpUrl; + +//@description Sends data received from a keyboardButtonTypeWebApp web app to a bot +//@bot_user_id Identifier of the target bot @button_text Text of the keyboardButtonTypeWebApp button, which opened the web app @data Received data +sendWebAppData bot_user_id:int53 button_text:string data:string = Ok; + +//@description Informs TDLib that a web app is being opened from attachment menu, a botMenuButton button, an internalLinkTypeAttachmentMenuBot link, or an inlineKeyboardButtonTypeWebApp button. +//-For each bot, a confirmation alert about data sent to the bot must be shown once +//@chat_id Identifier of the chat in which the web app is opened. Web apps can be opened only in private chats for now +//@bot_user_id Identifier of the bot, providing the web app +//@url The URL from an inlineKeyboardButtonTypeWebApp button, a botMenuButton button, or an internalLinkTypeAttachmentMenuBot link, or an empty string otherwise +//@theme Preferred web app theme; pass null to use the default theme +//@reply_to_message_id Identifier of the replied message for the message sent by the web app; 0 if none +openWebApp chat_id:int53 bot_user_id:int53 url:string theme:themeParameters reply_to_message_id:int53 = WebAppInfo; + +//@description Informs TDLib that a previously opened web app was closed @web_app_launch_id Identifier of web app launch, received from openWebApp +closeWebApp web_app_launch_id:int64 = Ok; + +//@description Sets the result of interaction with a web app and sends corresponding message on behalf of the user to the chat from which the query originated; for bots only +//@web_app_query_id Identifier of the web app query +//@result The result of the query +answerWebAppQuery web_app_query_id:string result:InputInlineQueryResult = SentWebAppMessage; + + //@description Sends a callback query to a bot and returns an answer. Returns an error with code 502 if the bot fails to answer the query before the query timeout expires @chat_id Identifier of the chat with the message @message_id Identifier of the message from which the query originated @payload Query payload getCallbackQueryAnswer chat_id:int53 message_id:int53 payload:CallbackQueryPayload = CallbackQueryAnswer; -//@description Sets the result of a callback query; for bots only @callback_query_id Identifier of the callback query @text Text of the answer @show_alert If true, an alert must be shown to the user instead of a toast notification @url URL to be opened @cache_time Time during which the result of the query can be cached, in seconds +//@description Sets the result of a callback query; for bots only @callback_query_id Identifier of the callback query @text Text of the answer @show_alert Pass true to show an alert to the user instead of a toast notification @url URL to be opened @cache_time Time during which the result of the query can be cached, in seconds answerCallbackQuery callback_query_id:int64 text:string show_alert:Bool url:string cache_time:int32 = Ok; @@ -4644,11 +4944,12 @@ answerShippingQuery shipping_query_id:int64 shipping_options:vector force_read:Bool = Ok; //@description Informs TDLib that the message content has been opened (e.g., the user has opened a photo, video, document, location or venue, or has listened to an audio file or voice note message). An updateMessageContentOpened update will be generated if something has changed @chat_id Chat identifier of the message @message_id Identifier of the message with the opened content @@ -4695,21 +4996,24 @@ getInternalLinkType link:string = InternalLinkType; getExternalLinkInfo link:string = LoginUrlInfo; //@description Returns an HTTP URL which can be used to automatically authorize the current user on a website after clicking an HTTP link. Use the method getExternalLinkInfo to find whether a prior user confirmation is needed -//@link The HTTP link @allow_write_access True, if the current user allowed the bot, returned in getExternalLinkInfo, to send them messages +//@link The HTTP link @allow_write_access Pass true if the current user allowed the bot, returned in getExternalLinkInfo, to send them messages getExternalLink link:string allow_write_access:Bool = HttpUrl; //@description Marks all mentions in a chat as read @chat_id Chat identifier readAllChatMentions chat_id:int53 = Ok; +//@description Marks all reactions in a chat as read @chat_id Chat identifier +readAllChatReactions chat_id:int53 = Ok; -//@description Returns an existing chat corresponding to a given user @user_id User identifier @force If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect + +//@description Returns an existing chat corresponding to a given user @user_id User identifier @force Pass true to create the chat without a network request. In this case all information about the chat except its type, title and photo can be incorrect createPrivateChat user_id:int53 force:Bool = Chat; -//@description Returns an existing chat corresponding to a known basic group @basic_group_id Basic group identifier @force If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect +//@description Returns an existing chat corresponding to a known basic group @basic_group_id Basic group identifier @force Pass true to create the chat without a network request. In this case all information about the chat except its type, title and photo can be incorrect createBasicGroupChat basic_group_id:int53 force:Bool = Chat; -//@description Returns an existing chat corresponding to a known supergroup or channel @supergroup_id Supergroup or channel identifier @force If true, the chat will be created without network request. In this case all information about the chat except its type, title and photo can be incorrect +//@description Returns an existing chat corresponding to a known supergroup or channel @supergroup_id Supergroup or channel identifier @force Pass true to create the chat without a network request. In this case all information about the chat except its type, title and photo can be incorrect createSupergroupChat supergroup_id:int53 force:Bool = Chat; //@description Returns an existing chat corresponding to a known secret chat @secret_chat_id Secret chat identifier @@ -4720,10 +5024,10 @@ createNewBasicGroupChat user_ids:vector title:string = Chat; //@description Creates a new supergroup or channel and sends a corresponding messageSupergroupChatCreate. Returns the newly created chat //@title Title of the new chat; 1-128 characters -//@is_channel True, if a channel chat needs to be created +//@is_channel Pass true to create a channel chat //@param_description Chat description; 0-255 characters //@location Chat location if a location-based supergroup is being created; pass null to create an ordinary supergroup chat -//@for_import True, if the supergroup is created for importing messages using importMessage +//@for_import Pass true to create a supergroup for importing messages using importMessage createNewSupergroupChat title:string is_channel:Bool description:string location:chatLocation for_import:Bool = Chat; //@description Creates a new secret chat. Returns the newly created chat @user_id Identifier of the target user @@ -4770,10 +5074,10 @@ setChatTitle chat_id:int53 title:string = Ok; //@chat_id Chat identifier @photo New chat photo; pass null to delete the chat photo setChatPhoto chat_id:int53 photo:InputChatPhoto = Ok; -//@description Changes the message TTL setting (sets a new self-destruct timer) in a chat. Requires can_delete_messages administrator right in basic groups, supergroups and channels -//-Message TTL setting of a chat with the current user (Saved Messages) and the chat 777000 (Telegram) can't be changed -//@chat_id Chat identifier @ttl New TTL value, in seconds; must be one of 0, 86400, 7 * 86400, or 31 * 86400 unless the chat is secret -setChatMessageTtlSetting chat_id:int53 ttl:int32 = Ok; +//@description Changes the message TTL in a chat. Requires can_delete_messages administrator right in basic groups, supergroups and channels +//-Message TTL can't be changed in a chat with the current user (Saved Messages) and the chat 777000 (Telegram). +//@chat_id Chat identifier @ttl New TTL value, in seconds; unless the chat is secret, it must be from 0 up to 365 * 86400 and be divisible by 86400 +setChatMessageTtl chat_id:int53 ttl:int32 = Ok; //@description Changes the chat members permissions. Supported only for basic groups and supergroups. Requires can_restrict_members administrator right //@chat_id Chat identifier @permissions New non-administrator members permissions in the chat @@ -4790,7 +5094,7 @@ setChatDraftMessage chat_id:int53 message_thread_id:int53 draft_message:draftMes setChatNotificationSettings chat_id:int53 notification_settings:chatNotificationSettings = Ok; //@description Changes the ability of users to save, forward, or copy chat content. Supported only for basic groups, supergroups and channels. Requires owner privileges -//@chat_id Chat identifier @has_protected_content True, if chat content can't be saved locally, forwarded, or copied +//@chat_id Chat identifier @has_protected_content New value of has_protected_content toggleChatHasProtectedContent chat_id:int53 has_protected_content:Bool = Ok; //@description Changes the marked as unread state of a chat @chat_id Chat identifier @is_marked_as_unread New value of is_marked_as_unread @@ -4799,6 +5103,9 @@ toggleChatIsMarkedAsUnread chat_id:int53 is_marked_as_unread:Bool = Ok; //@description Changes the value of the default disable_notification parameter, used when a message is sent to a chat @chat_id Chat identifier @default_disable_notification New value of default_disable_notification toggleChatDefaultDisableNotification chat_id:int53 default_disable_notification:Bool = Ok; +//@description Changes reactions, available in a chat. Available for basic groups, supergroups, and channels. Requires can_change_info administrator right @chat_id Identifier of the chat @available_reactions New list of reactions, available in the chat. All reactions must be active +setChatAvailableReactions chat_id:int53 available_reactions:vector = Ok; + //@description Changes application-specific data associated with a chat @chat_id Chat identifier @client_data New value of client_data setChatClientData chat_id:int53 client_data:string = Ok; @@ -4818,8 +5125,8 @@ setChatSlowModeDelay chat_id:int53 slow_mode_delay:int32 = Ok; //@description Pins a message in a chat; requires can_pin_messages rights or can_edit_messages rights in the channel //@chat_id Identifier of the chat //@message_id Identifier of the new pinned message -//@disable_notification True, if there must be no notification about the pinned message. Notifications are always disabled in channels and private chats -//@only_for_self True, if the message needs to be pinned for one side only; private chats only +//@disable_notification Pass true to disable notification about the pinned message. Notifications are always disabled in channels and private chats +//@only_for_self Pass true to pin the message only for self; private chats only pinChatMessage chat_id:int53 message_id:int53 disable_notification:Bool only_for_self:Bool = Ok; //@description Removes a pinned message from a chat; requires can_pin_messages rights in the group or can_edit_messages rights in the channel @chat_id Identifier of the chat @message_id Identifier of the removed pinned message @@ -4839,7 +5146,7 @@ leaveChat chat_id:int53 = Ok; //@chat_id Chat identifier @user_id Identifier of the user @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 = Ok; -//@description Adds multiple new members to a chat. Currently this method is only available for 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 +//@description Adds multiple new members to a chat. Currently, this method is only available for 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 //@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 addChatMembers chat_id:int53 user_ids:vector = Ok; @@ -4850,7 +5157,7 @@ setChatMemberStatus chat_id:int53 member_id:MessageSender status:ChatMemberStatu //@description Bans a member in a chat. Members can't be banned in private or secret chats. In supergroups and channels, the user will not be able to return to the group on their own using invite links, etc., unless unbanned first //@chat_id Chat identifier //@member_id Member identifier -//@banned_until_date Point in time (Unix timestamp) when the user will be unbanned; 0 if never. If the user is banned for more than 366 days or for less than 30 seconds from the current time, the user is considered to be banned forever. Ignored in basic groups +//@banned_until_date Point in time (Unix timestamp) when the user will be unbanned; 0 if never. If the user is banned for more than 366 days or for less than 30 seconds from the current time, the user is considered to be banned forever. Ignored in basic groups and if a chat is banned //@revoke_messages Pass true to delete all messages in the chat for the user that is being removed. Always true for supergroups and channels banChatMember chat_id:int53 member_id:MessageSender banned_until_date:int32 revoke_messages:Bool = Ok; @@ -4875,13 +5182,26 @@ searchChatMembers chat_id:int53 query:string limit:int32 filter:ChatMembersFilte getChatAdministrators chat_id:int53 = ChatAdministrators; -//@description Clears draft messages in all chats @exclude_secret_chats If true, local draft messages in secret chats will not be cleared +//@description Clears message drafts in all chats @exclude_secret_chats Pass true to keep local message drafts in secret chats clearAllDraftMessages exclude_secret_chats:Bool = Ok; +//@description Returns saved notification sound by its identifier. Returns a 404 error if there is no saved notification sound with the specified identifier @notification_sound_id Identifier of the notification sound +getSavedNotificationSound notification_sound_id:int64 = NotificationSounds; + +//@description Returns list of saved notification sounds. If a sound isn't in the list, then default sound needs to be used +getSavedNotificationSounds = NotificationSounds; + +//@description Adds a new notification sound to the list of saved notification sounds. The new notification sound is added to the top of the list. If it is already in the list, it is position isn't changed @sound Notification sound file to add +addSavedNotificationSound sound:InputFile = NotificationSound; + +//@description Removes a notification sound from the list of saved notification sounds @notification_sound_id Identifier of the notification sound +removeSavedNotificationSound notification_sound_id:int64 = Ok; + + //@description Returns list of chats with non-default notification settings //@scope If specified, only chats from the scope will be returned; pass null to return chats from all scopes -//@compare_sound If true, also chats with non-default sound will be returned +//@compare_sound Pass true to include in the response chats with only non-default sound getChatNotificationSettingsExceptions scope:NotificationSettingsScope compare_sound:Bool = Chats; //@description Returns the notification settings for chats of a given type @scope Types of chats for which to return the notification settings information @@ -4890,25 +5210,31 @@ getScopeNotificationSettings scope:NotificationSettingsScope = ScopeNotification //@description Changes notification settings for chats of a given type @scope Types of chats for which to change the notification settings @notification_settings The new notification settings for the given scope setScopeNotificationSettings scope:NotificationSettingsScope notification_settings:scopeNotificationSettings = Ok; -//@description Resets all notification settings to their default values. By default, all chats are unmuted, the sound is set to "default" and message previews are shown +//@description Resets all notification settings to their default values. By default, all chats are unmuted and message previews are shown resetAllNotificationSettings = Ok; -//@description Changes the pinned state of a chat. There can be up to GetOption("pinned_chat_count_max")/GetOption("pinned_archived_chat_count_max") pinned non-secret chats and the same number of secret chats in the main/arhive chat list -//@chat_list Chat list in which to change the pinned state of the chat @chat_id Chat identifier @is_pinned True, if the chat is pinned +//@description Changes the pinned state of a chat. There can be up to GetOption("pinned_chat_count_max")/GetOption("pinned_archived_chat_count_max") pinned non-secret chats and the same number of secret chats in the main/archive chat list +//@chat_list Chat list in which to change the pinned state of the chat @chat_id Chat identifier @is_pinned Pass true to pin the chat; pass false to unpin it toggleChatIsPinned chat_list:ChatList chat_id:int53 is_pinned:Bool = Ok; //@description Changes the order of pinned chats @chat_list Chat list in which to change the order of pinned chats @chat_ids The new list of pinned chats setPinnedChats chat_list:ChatList chat_ids:vector = Ok; +//@description Returns information about a bot that can be added to attachment menu @bot_user_id Bot's user identifier +getAttachmentMenuBot bot_user_id:int53 = AttachmentMenuBot; + +//@description Adds or removes a bot to attachment menu. Bot can be added to attachment menu, only if userTypeBot.can_be_added_to_attachment_menu == true @bot_user_id Bot's user identifier @is_added Pass true to add the bot to attachment menu; pass false to remove the bot from attachment menu +toggleBotIsAddedToAttachmentMenu bot_user_id:int53 is_added:Bool = Ok; + + //@description Downloads a file from the cloud. Download progress and completion of the download will be notified through updateFile updates //@file_id Identifier of the file to download -//@priority Priority of the download (1-32). The higher the priority, the earlier the file will be downloaded. If the priorities of two files are equal, then the last one for which downloadFile was called will be downloaded first +//@priority Priority of the download (1-32). The higher the priority, the earlier the file will be downloaded. If the priorities of two files are equal, then the last one for which downloadFile/addFileToDownloads was called will be downloaded first //@offset The starting position from which the file needs to be downloaded //@limit Number of bytes which need to be downloaded starting from the "offset" position before the download will automatically be canceled; use 0 to download without a limit -//@synchronous If false, this request returns file state just after the download has been started. If true, this request returns file state only after -//-the download has succeeded, has failed, has been canceled or a new downloadFile request with different offset/limit parameters was sent +//@synchronous Pass true to return response only after the file download has succeeded, has failed, has been canceled, or a new downloadFile request with different offset/limit parameters was sent; pass false to return file state immediately, just after the download has been started downloadFile file_id:int32 priority:int32 offset:int32 limit:int32 synchronous:Bool = File; //@description Returns file downloaded prefix size from a given offset, in bytes @file_id Identifier of the file @offset Offset from which downloaded prefix size needs to be calculated @@ -4953,6 +5279,39 @@ readFilePart file_id:int32 offset:int32 count:int32 = FilePart; //@description Deletes a file from the TDLib file cache @file_id Identifier of the file to delete deleteFile file_id:int32 = Ok; +//@description Adds a file from a message to the list of file downloads. Download progress and completion of the download will be notified through updateFile updates. +//-If message database is used, the list of file downloads is persistent across application restarts. The downloading is independent from download using downloadFile, i.e. it continues if downloadFile is canceled or is used to download a part of the file +//@file_id Identifier of the file to download +//@chat_id Chat identifier of the message with the file +//@message_id Message identifier +//@priority Priority of the download (1-32). The higher the priority, the earlier the file will be downloaded. If the priorities of two files are equal, then the last one for which downloadFile/addFileToDownloads was called will be downloaded first +addFileToDownloads file_id:int32 chat_id:int53 message_id:int53 priority:int32 = File; + +//@description Changes pause state of a file in the file download list +//@file_id Identifier of the downloaded file +//@is_paused Pass true if the download is paused +toggleDownloadIsPaused file_id:int32 is_paused:Bool = Ok; + +//@description Changes pause state of all files in the file download list @are_paused Pass true to pause all downloads; pass false to unpause them +toggleAllDownloadsArePaused are_paused:Bool = Ok; + +//@description Removes a file from the file download list @file_id Identifier of the downloaded file @delete_from_cache Pass true to delete the file from the TDLib file cache +removeFileFromDownloads file_id:int32 delete_from_cache:Bool = Ok; + +//@description Removes all files from the file download list +//@only_active Pass true to remove only active downloads, including paused +//@only_completed Pass true to remove only completed downloads +//@delete_from_cache Pass true to delete the file from the TDLib file cache +removeAllFilesFromDownloads only_active:Bool only_completed:Bool delete_from_cache:Bool = Ok; + +//@description Searches for files in the file download list or recently downloaded files from the list +//@query Query to search for; may be empty to return all downloaded files +//@only_active Pass true to search only for active downloads, including paused +//@only_completed Pass true to search only for completed downloads +//@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 files to be returned +searchFileDownloads query:string only_active:Bool only_completed:Bool offset:string limit:int32 = FoundFileDownloads; + //@description Returns information about a file with messages exported from another app @message_file_head Beginning of the message file; up to 100 first lines getMessageFileType message_file_head:string = MessageFileType; @@ -4974,19 +5333,19 @@ replacePrimaryChatInviteLink chat_id:int53 = ChatInviteLink; //@description Creates a new invite link for a chat. Available for basic groups, supergroups, and channels. Requires administrator privileges and can_invite_users right in the chat //@chat_id Chat identifier //@name Invite link name; 0-32 characters -//@expire_date Point in time (Unix timestamp) when the link will expire; pass 0 if never -//@member_limit The maximum number of chat members that can join the chat by the link simultaneously; 0-99999; pass 0 if not limited -//@creates_join_request True, if the link only creates join request. If true, member_limit must not be specified -createChatInviteLink chat_id:int53 name:string expire_date:int32 member_limit:int32 creates_join_request:Bool = ChatInviteLink; +//@expiration_date Point in time (Unix timestamp) when the link will expire; pass 0 if never +//@member_limit The maximum number of chat members that can join the chat via the link simultaneously; 0-99999; pass 0 if not limited +//@creates_join_request Pass true if users joining the chat via the link need to be approved by chat administrators. In this case, member_limit must be 0 +createChatInviteLink chat_id:int53 name:string expiration_date:int32 member_limit:int32 creates_join_request:Bool = ChatInviteLink; //@description Edits a non-primary 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 //@chat_id Chat identifier //@invite_link Invite link to be edited //@name Invite link name; 0-32 characters -//@expire_date Point in time (Unix timestamp) when the link will expire; pass 0 if never -//@member_limit The maximum number of chat members that can join the chat by the link simultaneously; 0-99999; pass 0 if not limited -//@creates_join_request True, if the link only creates join request. If true, member_limit must not be specified -editChatInviteLink chat_id:int53 invite_link:string name:string expire_date:int32 member_limit:int32 creates_join_request:Bool = ChatInviteLink; +//@expiration_date Point in time (Unix timestamp) when the link will expire; pass 0 if never +//@member_limit The maximum number of chat members that can join the chat via the link simultaneously; 0-99999; pass 0 if not limited +//@creates_join_request Pass true if users joining the chat via the link need to be approved by chat administrators. In this case, member_limit must be 0 +editChatInviteLink chat_id:int53 invite_link:string name:string expiration_date:int32 member_limit:int32 creates_join_request:Bool = ChatInviteLink; //@description Returns information about an invite link. Requires administrator privileges and can_invite_users right in the chat to get own links and owner privileges to get other links //@chat_id Chat identifier @@ -5005,7 +5364,7 @@ getChatInviteLinkCounts chat_id:int53 = ChatInviteLinkCounts; //@limit The maximum number of invite links to return; up to 100 getChatInviteLinks chat_id:int53 creator_user_id:int53 is_revoked:Bool offset_date:int32 offset_invite_link:string limit:int32 = ChatInviteLinks; -//@description Returns chat members joined a chat by an invite link. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links @chat_id Chat identifier @invite_link Invite link for which to return chat members +//@description Returns chat members joined a chat via an invite link. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links @chat_id Chat identifier @invite_link Invite link for which to return chat members //@offset_member A chat member from which to return next chat members; pass null to get results from the beginning @limit The maximum number of chat members to return; up to 100 getChatInviteLinkMembers chat_id:int53 invite_link:string offset_member:chatInviteLinkMember limit:int32 = ChatInviteLinkMembers; @@ -5034,20 +5393,20 @@ joinChatByInviteLink invite_link:string = Chat; //@invite_link Invite link for which to return join requests. If empty, all join requests will be returned. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links //@query A query to search for in the first names, last names and usernames of the users to return //@offset_request A chat join request from which to return next requests; pass null to get results from the beginning -//@limit The maximum number of chat join requests to return +//@limit The maximum number of requests to join the chat to return getChatJoinRequests chat_id:int53 invite_link:string query:string offset_request:chatJoinRequest limit:int32 = ChatJoinRequests; -//@description Handles a pending join request in a chat @chat_id Chat identifier @user_id Identifier of the user that sent the request @approve True, if the request is approved. Otherwise the request is declived +//@description Handles a pending join request in a chat @chat_id Chat identifier @user_id Identifier of the user that sent the request @approve Pass true to approve the request; pass false to decline it processChatJoinRequest chat_id:int53 user_id:int53 approve:Bool = Ok; //@description Handles all pending join requests for a given link in a chat //@chat_id Chat identifier //@invite_link Invite link for which to process join requests. If empty, all join requests will be processed. Requires administrator privileges and can_invite_users right in the chat for own links and owner privileges for other links -//@approve True, if the requests are approved. Otherwise the requests are declived +//@approve Pass true to approve all requests; pass false to decline them processChatJoinRequests chat_id:int53 invite_link:string approve:Bool = Ok; -//@description Creates a new call @user_id Identifier of the user to be called @protocol The call protocols supported by the application @is_video True, if a video call needs to be created +//@description Creates a new call @user_id Identifier of the user to be called @protocol The call protocols supported by the application @is_video Pass true to create a video call createCall user_id:int53 protocol:callProtocol is_video:Bool = CallId; //@description Accepts an incoming call @call_id Call identifier @protocol The call protocols supported by the application @@ -5056,7 +5415,7 @@ acceptCall call_id:int32 protocol:callProtocol = Ok; //@description Sends call signaling data @call_id Call identifier @data The data sendCallSignalingData call_id:int32 data:bytes = Ok; -//@description Discards a call @call_id Call identifier @is_disconnected True, if the user was disconnected @duration The call duration, in seconds @is_video True, if the call was a video call @connection_id Identifier of the connection used during the call +//@description Discards a call @call_id Call identifier @is_disconnected Pass true if the user was disconnected @duration The call duration, in seconds @is_video Pass true if the call was a video call @connection_id Identifier of the connection used during the call discardCall call_id:int32 is_disconnected:Bool duration:int32 is_video:Bool connection_id:int64 = Ok; //@description Sends a call rating @call_id Call identifier @rating Call rating; 1-5 @comment An optional user comment if the rating is less than 5 @problems List of the exact types of problems with the call, specified by the user @@ -5066,17 +5425,24 @@ sendCallRating call_id:int32 rating:int32 comment:string problems:vector = Ok; @@ -5129,6 +5492,9 @@ inviteGroupCallParticipants group_call_id:int32 user_ids:vector = Ok; //@can_self_unmute Pass true if the invite link needs to contain an invite hash, passing which to joinGroupCall would allow the invited user to unmute themselves. Requires groupCall.can_be_managed group call flag getGroupCallInviteLink group_call_id:int32 can_self_unmute:Bool = HttpUrl; +//@description Revokes invite link for a group call. Requires groupCall.can_be_managed group call flag @group_call_id Group call identifier +revokeGroupCallInviteLink group_call_id:int32 = Ok; + //@description Starts recording of an active group call. Requires groupCall.can_be_managed group call flag @group_call_id Group call identifier @title Group call recording title; 0-64 characters //@record_video Pass true to record a video file instead of an audio file @use_portrait_orientation Pass true to use portrait orientation for video instead of landscape one startGroupCallRecording group_call_id:int32 title:string record_video:Bool use_portrait_orientation:Bool = Ok; @@ -5143,11 +5509,11 @@ toggleGroupCallIsMyVideoPaused group_call_id:int32 is_my_video_paused:Bool = Ok; toggleGroupCallIsMyVideoEnabled group_call_id:int32 is_my_video_enabled:Bool = Ok; //@description Informs TDLib that speaking state of a participant of an active group has changed @group_call_id Group call identifier -//@audio_source Group call participant's synchronization audio source identifier, or 0 for the current user @is_speaking True, if the user is speaking +//@audio_source Group call participant's synchronization audio source identifier, or 0 for the current user @is_speaking Pass true if the user is speaking setGroupCallParticipantIsSpeaking group_call_id:int32 audio_source:int32 is_speaking:Bool = Ok; //@description Toggles whether a participant of an active group call is muted, unmuted, or allowed to unmute themselves -//@group_call_id Group call identifier @participant_id Participant identifier @is_muted Pass true if the user must be muted and false otherwise +//@group_call_id Group call identifier @participant_id Participant identifier @is_muted Pass true to mute the user; pass false to unmute the them toggleGroupCallParticipantIsMuted group_call_id:int32 participant_id:MessageSender is_muted:Bool = Ok; //@description Changes volume level of a participant of an active group call. If the current user can manage the group call, then the participant's volume level will be changed for all users with the default volume level @@ -5167,8 +5533,11 @@ loadGroupCallParticipants group_call_id:int32 limit:int32 = Ok; //@description Leaves a group call @group_call_id Group call identifier leaveGroupCall group_call_id:int32 = Ok; -//@description Discards a group call. Requires groupCall.can_be_managed @group_call_id Group call identifier -discardGroupCall group_call_id:int32 = Ok; +//@description Ends a group call. Requires groupCall.can_be_managed @group_call_id Group call identifier +endGroupCall group_call_id:int32 = Ok; + +//@description Returns information about available group call streams @group_call_id Group call identifier +getGroupCallStreams group_call_id:int32 = GroupCallStreams; //@description Returns a file with a segment of a group call stream in a modified OGG format for audio or MPEG-4 format for video //@group_call_id Group call identifier @@ -5184,17 +5553,17 @@ toggleMessageSenderIsBlocked sender_id:MessageSender is_blocked:Bool = Ok; //@description Blocks an original sender of a message in the Replies chat //@message_id The identifier of an incoming message in the Replies chat -//@delete_message Pass true if the message must be deleted -//@delete_all_messages Pass true if all messages from the same sender must be deleted -//@report_spam Pass true if the sender must be reported to the Telegram moderators +//@delete_message Pass true to delete the message +//@delete_all_messages Pass true to delete all messages from the same sender +//@report_spam Pass true to report the sender to the Telegram moderators blockMessageSenderFromReplies message_id:int53 delete_message:Bool delete_all_messages:Bool report_spam:Bool = Ok; //@description Returns users and chats that were blocked by the current user @offset Number of users and chats to skip in the result; must be non-negative @limit The maximum number of users and chats to return; up to 100 getBlockedMessageSenders offset:int32 limit:int32 = MessageSenders; -//@description Adds a user to the contact list or edits an existing contact by their user identifier @contact The contact to add or edit; phone number can be empty and needs to be specified only if known, vCard is ignored -//@share_phone_number True, if the new contact needs to be allowed to see current user's phone number. A corresponding rule to userPrivacySettingShowPhoneNumber will be added if needed. Use the field userFullInfo.need_phone_number_privacy_exception to check whether the current user needs to be asked to share their phone number +//@description Adds a user to the contact list or edits an existing contact by their user identifier @contact The contact to add or edit; phone number may be empty and needs to be specified only if known, vCard is ignored +//@share_phone_number Pass true to share the current user's phone number with the new contact. A corresponding rule to userPrivacySettingShowPhoneNumber will be added if needed. Use the field userFullInfo.need_phone_number_privacy_exception to check whether the current user needs to be asked to share their phone number addContact contact:contact share_phone_number:Bool = Ok; //@description Adds new contacts or edits existing contacts by their phone numbers; contacts' user identifiers are ignored @contacts The list of contacts to import or edit; contacts' vCard are ignored and are not imported @@ -5220,6 +5589,9 @@ changeImportedContacts contacts:vector = ImportedContacts; clearImportedContacts = Ok; +//@description Searches a user by their phone number @phone_number Phone number to search for +searchUserByPhoneNumber phone_number:string = 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 sharePhoneNumber user_id:int53 = Ok; @@ -5245,7 +5617,7 @@ getArchivedStickerSets is_masks:Bool offset_sticker_set_id:int64 limit:int32 = S //@limit The maximum number of sticker sets to be returned; up to 100. For optimal performance, the number of returned sticker sets is chosen by TDLib and can be smaller than the specified limit, even if the end of the list has not been reached getTrendingStickerSets offset:int32 limit:int32 = StickerSets; -//@description Returns a list of sticker sets attached to a file. Currently only photos and videos can have attached sticker sets @file_id File identifier +//@description Returns a list of sticker sets attached to a file. Currently, only photos and videos can have attached sticker sets @file_id File identifier getAttachedStickerSets file_id:int32 = StickerSets; //@description Returns information about a sticker set by its identifier @set_id Identifier of the sticker set @@ -5295,7 +5667,7 @@ removeFavoriteSticker sticker:InputFile = Ok; //@description Returns emoji corresponding to a sticker. The list is only for informational purposes, because a sticker is always sent with a fixed emoji from the corresponding Sticker object @sticker Sticker file identifier getStickerEmojis sticker:InputFile = Emojis; -//@description Searches for emojis by keywords. Supported only if the file database is enabled @text Text to search for @exact_match True, if only emojis, which exactly match text needs to be returned @input_language_codes List of possible IETF language tags of the user's input language; may be empty if unknown +//@description Searches for emojis by keywords. Supported only if the file database is enabled @text Text to search for @exact_match Pass true if only emojis, which exactly match the text, needs to be returned @input_language_codes List of possible IETF language tags of the user's input language; may be empty if unknown searchEmojis text:string exact_match:Bool input_language_codes:vector = Emojis; //@description Returns an animated emoji corresponding to a given emoji. Returns a 404 error if the emoji has no animated emoji @emoji The emoji @@ -5330,7 +5702,7 @@ removeRecentHashtag hashtag:string = Ok; //@description Returns a web page preview by the text of the message. Do not call this function too often. Returns a 404 error if the web page has no preview @text Message text with formatting getWebPagePreview text:formattedText = WebPage; -//@description Returns an instant view version of a web page if available. Returns a 404 error if the web page has no instant view page @url The web page URL @force_full If true, the full instant view for the web page will be returned +//@description Returns an instant view version of a web page if available. Returns a 404 error if the web page has no instant view page @url The web page URL @force_full Pass true to get full instant view for the web page getWebPageInstantView url:string force_full:Bool = WebPageInstantView; @@ -5365,20 +5737,34 @@ checkChangePhoneNumberCode code:string = Ok; //@description Sets the list of commands supported by the bot for the given user scope and language; for bots only //@scope The scope to which the commands are relevant; pass null to change commands in the default bot command scope -//@language_code A two-letter ISO 639-1 country code. If empty, the commands will be applied to all users from the given scope, for which language there are no dedicated commands +//@language_code A two-letter ISO 639-1 language code. If empty, the commands will be applied to all users from the given scope, for which language there are no dedicated commands //@commands List of the bot's commands setCommands scope:BotCommandScope language_code:string commands:vector = Ok; //@description Deletes commands supported by the bot for the given user scope and language; for bots only //@scope The scope to which the commands are relevant; pass null to delete commands in the default bot command scope -//@language_code A two-letter ISO 639-1 country code or an empty string +//@language_code A two-letter ISO 639-1 language code or an empty string deleteCommands scope:BotCommandScope language_code:string = Ok; //@description Returns the list of commands supported by the bot for the given user scope and language; for bots only //@scope The scope to which the commands are relevant; pass null to get commands in the default bot command scope -//@language_code A two-letter ISO 639-1 country code or an empty string +//@language_code A two-letter ISO 639-1 language code or an empty string getCommands scope:BotCommandScope language_code:string = BotCommands; +//@description Sets menu button for the given user or for all users; for bots only +//@user_id Identifier of the user or 0 to set menu button for all users +//@menu_button New menu button +setMenuButton user_id:int53 menu_button:botMenuButton = Ok; + +//@description Returns menu button set by the bot for the given user; for bots only @user_id Identifier of the user or 0 to get the default menu button +getMenuButton user_id:int53 = BotMenuButton; + +//@description Sets default administrator rights for adding the bot to basic group and supergroup chats; for bots only @default_group_administrator_rights Default administrator rights for adding the bot to basic group and supergroup chats; may be null +setDefaultGroupAdministratorRights default_group_administrator_rights:chatAdministratorRights = Ok; + +//@description Sets default administrator rights for adding the bot to channel chats; for bots only @default_channel_administrator_rights Default administrator rights for adding the bot to channels; may be null +setDefaultChannelAdministratorRights default_channel_administrator_rights:chatAdministratorRights = Ok; + //@description Returns all active sessions of the current user getActiveSessions = Sessions; @@ -5389,10 +5775,10 @@ terminateSession session_id:int64 = Ok; //@description Terminates all other sessions of the current user terminateAllOtherSessions = Ok; -//@description Toggles whether a session can accept incoming calls @session_id Session identifier @can_accept_calls True, if incoming calls can be accepted by the session +//@description Toggles whether a session can accept incoming calls @session_id Session identifier @can_accept_calls Pass true to allow accepting incoming calls by the session; pass false otherwise toggleSessionCanAcceptCalls session_id:int64 can_accept_calls:Bool = Ok; -//@description Toggles whether a session can accept incoming secret chats @session_id Session identifier @can_accept_secret_chats True, if incoming secret chats can be accepted by the session +//@description Toggles whether a session can accept incoming secret chats @session_id Session identifier @can_accept_secret_chats Pass true to allow accepring secret chats by the session; pass false otherwise toggleSessionCanAcceptSecretChats session_id:int64 can_accept_secret_chats:Bool = Ok; //@description Changes the period of inactivity after which sessions will automatically be terminated @inactive_session_ttl_days New number of days of inactivity before sessions will be automatically terminated; 1-366 days @@ -5424,7 +5810,7 @@ toggleSupergroupIsAllHistoryAvailable supergroup_id:int53 is_all_history_availab //@description Upgrades supergroup to a broadcast group; requires owner privileges in the supergroup @supergroup_id Identifier of the supergroup toggleSupergroupIsBroadcastGroup supergroup_id:int53 = Ok; -//@description Reports some messages from a message sender in a supergroup as spam; requires administrator rights in the supergroup @supergroup_id Supergroup identifier @message_ids Identifiers of messages sent in the supergroup. All messages must be sent by the same sender. This list must be non-empty +//@description Reports messages in a supergroup as spam; requires administrator rights in the supergroup @supergroup_id Supergroup identifier @message_ids Identifiers of messages to report reportSupergroupSpam supergroup_id:int53 message_ids:vector = Ok; //@description Returns information about members or banned users in a supergroup or channel. Can be used only if supergroupFullInfo.can_get_members == true; additionally, administrator privileges may be required for some filters @supergroup_id Identifier of the supergroup or channel @@ -5446,13 +5832,13 @@ getChatEventLog chat_id:int53 query:string from_event_id:int64 limit:int32 filte //@chat_id Chat identifier of the Invoice message //@message_id Message identifier //@theme Preferred payment form theme; pass null to use the default theme -getPaymentForm chat_id:int53 message_id:int53 theme:paymentFormTheme = PaymentForm; +getPaymentForm chat_id:int53 message_id:int53 theme:themeParameters = PaymentForm; //@description Validates the order information provided by a user and returns the available shipping options for a flexible invoice //@chat_id Chat identifier of the Invoice message //@message_id Message identifier //@order_info The order information, provided by the user; pass null if empty -//@allow_save True, if the order information can be saved +//@allow_save Pass true to save the order information validateOrderInfo chat_id:int53 message_id:int53 order_info:orderInfo allow_save:Bool = ValidatedOrderInfo; //@description Sends a filled-out payment form to the bot for final verification @chat_id Chat identifier of the Invoice message @message_id Message identifier @@ -5463,10 +5849,10 @@ sendPaymentForm chat_id:int53 message_id:int53 payment_form_id:int64 order_info_ //@description Returns information about a successful payment @chat_id Chat identifier of the PaymentSuccessful message @message_id Message identifier getPaymentReceipt chat_id:int53 message_id:int53 = PaymentReceipt; -//@description Returns saved order info, if any +//@description Returns saved order information. Returns a 404 error if there is no saved order information getSavedOrderInfo = OrderInfo; -//@description Deletes saved order info +//@description Deletes saved order information deleteSavedOrderInfo = Ok; //@description Deletes saved credentials for all payment provider bots @@ -5477,7 +5863,7 @@ deleteSavedCredentials = Ok; getSupportUser = User; -//@description Returns backgrounds installed by the user @for_dark_theme True, if the backgrounds must be ordered for dark theme +//@description Returns backgrounds installed by the user @for_dark_theme Pass true to order returned backgrounds for a dark theme getBackgrounds for_dark_theme:Bool = Backgrounds; //@description Constructs a persistent HTTP URL for a background @name Background name @type Background type @@ -5489,7 +5875,7 @@ searchBackground name:string = Background; //@description Changes the background selected by the user; adds background to the list of installed backgrounds //@background The input background to use; pass null to create a new filled backgrounds or to remove the current background //@type Background type; pass null to use the default type of the remote background or to remove the current background -//@for_dark_theme True, if the background is chosen for dark theme +//@for_dark_theme Pass true if the background is changed for a dark theme setBackground background:InputBackground type:BackgroundType for_dark_theme:Bool = Background; //@description Removes background from the list of installed backgrounds @background_id The background identifier @@ -5499,7 +5885,7 @@ removeBackground background_id:int64 = Ok; resetBackgrounds = Ok; -//@description Returns information about the current localization target. This is an offline request if only_local is true. Can be called before authorization @only_local If true, returns only locally available information without sending network requests +//@description Returns information about the current localization target. This is an offline request if only_local is true. Can be called before authorization @only_local Pass true to get only locally available information without sending network requests getLocalizationTargetInfo only_local:Bool = LocalizationTargetInfo; //@description Returns information about a language pack. Returned language pack identifier may be different from a provided one. Can be called before authorization @language_pack_id Language pack identifier @@ -5571,15 +5957,15 @@ deleteAccount reason:string = Ok; //@description Removes a chat action bar without any other action @chat_id Chat identifier removeChatActionBar chat_id:int53 = Ok; -//@description Reports a chat to the Telegram moderators. A chat can be reported only from the chat action bar, or if this is a private chat with a bot, a private chat with a user sharing their location, a supergroup, or a channel, since other chats can't be checked by moderators -//@chat_id Chat identifier @message_ids Identifiers of reported messages, if any @reason The reason for reporting the chat @text Additional report details; 0-1024 characters +//@description Reports a chat to the Telegram moderators. A chat can be reported only from the chat action bar, or if chat.can_be_reported +//@chat_id Chat identifier @message_ids Identifiers of reported messages; may be empty to report the whole chat @reason The reason for reporting the chat @text Additional report details; 0-1024 characters reportChat chat_id:int53 message_ids:vector reason:ChatReportReason text:string = Ok; -//@description Reports a chat photo to the Telegram moderators. A chat photo can be reported only if this is a private chat with a bot, a private chat with a user sharing their location, a supergroup, or a channel, since other chats can't be checked by moderators +//@description Reports a chat photo to the Telegram moderators. A chat photo can be reported only if chat.can_be_reported //@chat_id Chat identifier @file_id Identifier of the photo to report. Only full photos from chatPhoto can be reported @reason The reason for reporting the chat photo @text Additional report details; 0-1024 characters reportChatPhoto chat_id:int53 file_id:int32 reason:ChatReportReason text:string = Ok; -//@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 +//@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; //@description Returns detailed statistics about a message. Can be used only if message.can_get_statistics == true @chat_id Chat identifier @message_id Message identifier @is_dark Pass true if a dark theme is used by the application @@ -5601,7 +5987,7 @@ getDatabaseStatistics = DatabaseStatistics; //@description Optimizes storage usage, i.e. deletes some files and returns new storage usage statistics. Secret thumbnails can't be deleted //@size Limit on the total size of files after deletion, in bytes. Pass -1 to use the default limit //@ttl Limit on the time that has passed since the last time a file was accessed (or creation time for some filesystems). Pass -1 to use the default limit -//@count Limit on the total count of files after deletion. Pass -1 to use the default limit +//@count Limit on the total number of files after deletion. Pass -1 to use the default limit //@immunity_delay The amount of time after the creation of a file during which it can't be deleted, in seconds. Pass -1 to use the default value //@file_types If non-empty, only files with the given types are considered. By default, all types except thumbnails, profile photos, stickers and wallpapers are deleted //@chat_ids If non-empty, only files from the given chats are considered. Use 0 as chat identifier to delete files not belonging to any chat (e.g., profile photos) @@ -5615,7 +6001,7 @@ optimizeStorage size:int53 ttl:int32 count:int32 immunity_delay:int32 file_types //-Network type is used to check whether the library can use the network at all and also for collecting detailed network data usage statistics @type The new network type; pass null to set network type to networkTypeOther setNetworkType type:NetworkType = Ok; -//@description Returns network data usage statistics. Can be called before authorization @only_current If true, returns only data for the current library launch +//@description Returns network data usage statistics. Can be called before authorization @only_current Pass true to get statistics only for the current library launch getNetworkStatistics only_current:Bool = NetworkStatistics; //@description Adds the specified data to data usage statistics. Can be called before authorization @entry The network statistics entry with the data to be added to statistics @@ -5701,8 +6087,8 @@ checkPhoneNumberConfirmationCode code:string = Ok; setBotUpdatesStatus pending_update_count:int32 error_message:string = Ok; -//@description Uploads a PNG image with a sticker; returns the uploaded file @user_id Sticker file owner; ignored for regular users @sticker Sticker file to upload -uploadStickerFile user_id:int53 sticker:InputSticker = File; +//@description Uploads a file with a sticker; returns the uploaded file @user_id Sticker file owner; ignored for regular users @sticker Sticker file to upload +uploadStickerFile user_id:int53 sticker:inputSticker = File; //@description Returns a suggested name for a new sticker set with a given title @title Sticker set title; 1-64 characters getSuggestedStickerSetName title:string = Text; @@ -5714,18 +6100,17 @@ checkStickerSetName name:string = CheckStickerSetNameResult; //@user_id Sticker set owner; ignored for regular users //@title Sticker set title; 1-64 characters //@name Sticker set name. Can contain only English letters, digits and underscores. Must end with *"_by_"* (** is case insensitive) for bots; 1-64 characters -//@is_masks True, if stickers are masks. Animated stickers can't be masks -//@stickers List of stickers to be added to the set; must be non-empty. All stickers must be of the same type. For animated stickers, uploadStickerFile must be used before the sticker is shown +//@stickers List of stickers to be added to the set; must be non-empty. All stickers must have the same format. For TGS stickers, uploadStickerFile must be used before the sticker is shown //@source Source of the sticker set; may be empty if unknown -createNewStickerSet user_id:int53 title:string name:string is_masks:Bool stickers:vector source:string = StickerSet; +createNewStickerSet user_id:int53 title:string name:string stickers:vector source:string = StickerSet; //@description Adds a new sticker to a set; for bots only. Returns the sticker set //@user_id Sticker set owner @name Sticker set name @sticker Sticker to add to the set -addStickerToSet user_id:int53 name:string sticker:InputSticker = StickerSet; +addStickerToSet user_id:int53 name:string sticker:inputSticker = StickerSet; //@description Sets a sticker set thumbnail; for bots only. Returns the sticker set //@user_id Sticker set owner @name Sticker set name -//@thumbnail Thumbnail to set in PNG or TGS format; pass null to remove the sticker set thumbnail. Animated thumbnail must be set for animated sticker sets and only for them +//@thumbnail Thumbnail to set in PNG, TGS, or WEBM format; pass null to remove the sticker set thumbnail. Thumbnail format must match the format of stickers in the set setStickerSetThumbnail user_id:int53 name:string thumbnail:InputFile = StickerSet; //@description Changes the position of a sticker in the set to which it belongs; for bots only. The sticker set must have been created by the bot @@ -5736,7 +6121,7 @@ setStickerPositionInSet sticker:InputFile position:int32 = Ok; removeStickerFromSet sticker:InputFile = Ok; -//@description Returns information about a file with a map thumbnail in PNG format. Only map thumbnail files with size less than 1MB can be downloaded @location Location of the map center @zoom Map zoom level; 13-20 @width Map width in pixels before applying scale; 16-1024 @height Map height in pixels before applying scale; 16-1024 @scale Map scale; 1-3 @chat_id Identifier of a chat, in which the thumbnail will be shown. Use 0 if unknown +//@description Returns information about a file with a map thumbnail in PNG format. Only map thumbnail files with size less than 1MB can be downloaded @location Location of the map center @zoom Map zoom level; 13-20 @width Map width in pixels before applying scale; 16-1024 @height Map height in pixels before applying scale; 16-1024 @scale Map scale; 1-3 @chat_id Identifier of a chat in which the thumbnail will be shown. Use 0 if unknown getMapThumbnailFile location:location zoom:int32 width:int32 height:int32 scale:int32 chat_id:int53 = File; @@ -5765,7 +6150,7 @@ getCountryCode = Text; getPhoneNumberInfo phone_number_prefix:string = PhoneNumberInfo; //@description Returns information about a phone number by its prefix synchronously. getCountries must be called at least once after changing localization to the specified language if properly localized country information is expected. Can be called synchronously -//@language_code A two-letter ISO 639-1 country code for country information localization @phone_number_prefix The phone number prefix +//@language_code A two-letter ISO 639-1 language code for country information localization @phone_number_prefix The phone number prefix getPhoneNumberInfoSync language_code:string phone_number_prefix:string = PhoneNumberInfo; //@description Returns the link for downloading official Telegram application to be used when the current user invites friends to Telegram @@ -5782,10 +6167,10 @@ getApplicationConfig = JsonValue; saveApplicationLogEvent type:string chat_id:int53 data:JsonValue = Ok; -//@description Adds a proxy server for network requests. Can be called before authorization @server Proxy server IP address @port Proxy server port @enable True, if the proxy needs to be enabled @type Proxy type +//@description Adds a proxy server for network requests. Can be called before authorization @server Proxy server IP address @port Proxy server port @enable Pass true to immediately enable the proxy @type Proxy type addProxy server:string port:int32 enable:Bool type:ProxyType = Proxy; -//@description Edits an existing proxy server for network requests. Can be called before authorization @proxy_id Proxy identifier @server Proxy server IP address @port Proxy server port @enable True, if the proxy needs to be enabled @type Proxy type +//@description Edits an existing proxy server for network requests. Can be called before authorization @proxy_id Proxy identifier @server Proxy server IP address @port Proxy server port @enable Pass true to immediately enable the proxy @type Proxy type editProxy proxy_id:int32 server:string port:int32 enable:Bool type:ProxyType = Proxy; //@description Enables a proxy. Only one proxy can be enabled at a time. Can be called before authorization @proxy_id Proxy identifier @@ -5854,7 +6239,7 @@ testSquareInt x:int32 = TestInt; //@description Sends a simple network request to the Telegram servers; for testing only. Can be called before authorization testNetwork = Ok; //@description Sends a simple network request to the Telegram servers via proxy; for testing only. Can be called before authorization @server Proxy server IP address @port Proxy server port @type Proxy type -//@dc_id Identifier of a datacenter, with which to test connection @timeout The maximum overall timeout for the request +//@dc_id Identifier of a datacenter with which to test connection @timeout The maximum overall timeout for the request testProxy server:string port:int32 type:ProxyType dc_id:int32 timeout:double = Ok; //@description Forces an updates.getDifference call to the Telegram servers; for testing only testGetDifference = Ok;