@grammyjs/types 3.5.1 → 3.6.0

package/manage.d.ts

@@ -1,4 +1,4 @@
-import type { Location, Message, PhotoSize, ReactionType } from "./message.js";
+import type { Location, Message, PhotoSize, ReactionType, Sticker } from "./message.js";
 import type { Update } from "./update.js";
 /** Describes the current status of a webhook. */
 export interface WebhookInfo {
@@ -50,6 +50,8 @@ export interface UserFromGetMe extends User {
     can_read_all_group_messages: boolean;
     /** True, if the bot supports inline queries. Returned only in getMe. */
     supports_inline_queries: boolean;
+    /** True, if the bot can be connected to a Telegram Business account to receive its messages. Returned only in getMe. */
+    can_connect_to_business?: boolean;
 }
 export declare namespace Chat {
     /** Internal type holding properties that all kinds of chats share. */
@@ -120,8 +122,6 @@ export declare namespace Chat {
     interface MultiUserGetChat {
         /** Default chat member permissions, for groups and supergroups. Returned only in getChat. */
         permissions?: ChatPermissions;
-        /** True, if the bot can change the group sticker set. Returned only in getChat. */
-        can_set_sticker_set?: true;
     }
     /** Internal type holding properties that those private and channel chats returned from `getChat` share. */
     interface NonMultiUserGetChat {
@@ -141,6 +141,16 @@ export declare namespace Chat {
     }
     /** Internal type representing private chats returned from `getChat`. */
     interface PrivateGetChat extends PrivateChat, GetChat, NonGroupGetChat, NonMultiUserGetChat {
+        /** For private chats, the date of birth of the user. Returned only in getChat. */
+        birthdate?: Birthdate;
+        /** For private chats with business accounts, the intro of the business. Returned only in getChat. */
+        business_intro?: BusinessIntro;
+        /** For private chats with business accounts, the location of the business. Returned only in getChat. */
+        business_location?: BusinessLocation;
+        /** For private chats with business accounts, the opening hours of the business. Returned only in getChat. */
+        business_opening_hours?: BusinessOpeningHours;
+        /** For private chats, the personal channel of the user. Returned only in getChat. */
+        personal_chat?: Chat.ChannelChat;
         /** Bio of the other party in a private chat. Returned only in getChat. */
         bio?: string;
         /** True, if privacy settings of the other party in the private chat allows to use tg://user?id=<user_id> links only in chats with the user. Returned only in getChat. */
@@ -159,18 +169,20 @@ export declare namespace Chat {
         join_by_request?: true;
         /** For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds. Returned only in getChat. */
         slow_mode_delay?: number;
+        /** For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions. Returned only in getChat. */
+        unrestrict_boost_count?: number;
         /** True, if new chat members will have access to old messages; available only to chat administrators. Returned only in getChat. */
         has_visible_history?: boolean;
         /** True, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators. Returned only in getChat. */
         has_aggressive_anti_spam_enabled?: true;
         /** For supergroups, name of group sticker set. Returned only in getChat. */
         sticker_set_name?: string;
-        /** For supergroups, the location to which the supergroup is connected. Returned only in getChat. */
-        location?: ChatLocation;
-        /** For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions. Returned only in getChat. */
-        unrestrict_boost_count?: number;
+        /** True, if the bot can change the group sticker set. Returned only in getChat. */
+        can_set_sticker_set?: true;
         /** For supergroups, the name of the group's custom emoji sticker set. Custom emoji from this set can be used by all users and bots in the group. Returned only in getChat. */
         custom_emoji_sticker_set_name?: string;
+        /** For supergroups, the location to which the supergroup is connected. Returned only in getChat. */
+        location?: ChatLocation;
     }
     /** Internal type representing channel chats returned from `getChat`. */
     interface ChannelGetChat extends ChannelChat, GetChat, NonGroupGetChat, NonPrivateGetChat, NonMultiUserGetChat, LargeGetChat {
@@ -241,19 +253,19 @@ export interface ChatAdministratorRights {
     can_change_info: boolean;
     /** True, if the user is allowed to invite new users to the chat */
     can_invite_users: boolean;
-    /** True, if the administrator can post messages in the channel, or access channel statistics; channels only */
-    can_post_messages?: boolean;
-    /** True, if the administrator can edit messages of other users and can pin messages; channels only */
-    can_edit_messages?: boolean;
-    /** True, if the user is allowed to pin messages; groups and supergroups only */
-    can_pin_messages?: boolean;
     /** True, if the administrator can post stories to the chat */
-    can_post_stories?: boolean;
+    can_post_stories: boolean;
     /** True, if the administrator can edit stories posted by other users */
-    can_edit_stories?: boolean;
+    can_edit_stories: boolean;
     /** True, if the administrator can delete stories posted by other users */
-    can_delete_stories?: boolean;
-    /** True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only */
+    can_delete_stories: boolean;
+    /** True, if the administrator can post messages in the channel, or access channel statistics; for channels only */
+    can_post_messages?: boolean;
+    /** True, if the administrator can edit messages of other users and can pin messages; for channels only */
+    can_edit_messages?: boolean;
+    /** True, if the user is allowed to pin messages; for groups and supergroups only */
+    can_pin_messages?: boolean;
+    /** True, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only */
     can_manage_topics?: boolean;
 }
 /** This object represents changes in the status of a chat member. */
@@ -316,19 +328,19 @@ export interface ChatMemberAdministrator {
     can_change_info: boolean;
     /** True, if the user is allowed to invite new users to the chat */
     can_invite_users: boolean;
-    /** True, if the administrator can post messages in the channel, or access channel statistics; channels only */
-    can_post_messages?: boolean;
-    /** True, if the administrator can edit messages of other users and can pin messages; channels only */
-    can_edit_messages?: boolean;
-    /** True, if the user is allowed to pin messages; groups and supergroups only */
-    can_pin_messages?: boolean;
     /** True, if the administrator can post stories to the chat */
-    can_post_stories?: boolean;
+    can_post_stories: boolean;
     /** True, if the administrator can edit stories posted by other users */
-    can_edit_stories?: boolean;
+    can_edit_stories: boolean;
     /** True, if the administrator can delete stories posted by other users */
-    can_delete_stories?: boolean;
-    /** True, if the user is allowed to create, rename, close, and reopen forum topics; supergroups only */
+    can_delete_stories: boolean;
+    /** True, if the administrator can post messages in the channel, or access channel statistics; for channels only */
+    can_post_messages?: boolean;
+    /** True, if the administrator can edit messages of other users and can pin messages; for channels only */
+    can_edit_messages?: boolean;
+    /** True, if the user is allowed to pin messages; for groups and supergroups only */
+    can_pin_messages?: boolean;
+    /** True, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only */
     can_manage_topics?: boolean;
     /** Custom title for this user */
     custom_title?: string;
@@ -441,6 +453,40 @@ export interface ChatPermissions {
     /** True, if the user is allowed to create forum topics. If omitted defaults to the value of can_pin_messages */
     can_manage_topics?: boolean;
 }
+export interface Birthdate {
+    /** Day of the user's birth; 1-31 */
+    day: number;
+    /** Month of the user's birth; 1-12 */
+    month: number;
+    /** Year of the user's birth */
+    year?: number;
+}
+export interface BusinessIntro {
+    /** Title text of the business intro */
+    title?: string;
+    /** Message text of the business intro */
+    message?: string;
+    /** Sticker of the business intro */
+    sticker?: Sticker;
+}
+export interface BusinessLocation {
+    /** Address of the business */
+    address: string;
+    /** Location of the business */
+    location?: Location;
+}
+export interface BusinessOpeningHoursInterval {
+    /** The minute's sequence number in a week, starting on Monday, marking the start of the time interval during which the business is open; 0 - 7 24 60 */
+    opening_minute: number;
+    /** The minute's sequence number in a week, starting on Monday, marking the end of the time interval during which the business is open; 0 - 8 24 60 */
+    closing_minute: number;
+}
+export interface BusinessOpeningHours {
+    /** Unique name of the time zone for which the opening hours are defined */
+    time_zone_name: string;
+    /** List of time intervals describing business opening hours */
+    opening_hours: BusinessOpeningHoursInterval[];
+}
 /** Represents a location to which a chat is connected. */
 export interface ChatLocation {
     /** The location to which the supergroup is connected. Can't be a live location. */
@@ -531,3 +577,27 @@ export interface UserChatBoosts {
     /** The list of boosts added to the chat by the user */
     boosts: ChatBoost[];
 }
+/** Describes the connection of the bot with a business account. */
+export interface BusinessConnection {
+    /** Unique identifier of the business connection */
+    id: string;
+    /** Business account user that created the business connection */
+    user: User;
+    /** Identifier of a private chat with the user who created the business connection. */
+    user_chat_id: number;
+    /** Date the connection was established in Unix time */
+    date: number;
+    /** True, if the bot can act on behalf of the business account in chats that were active in the last 24 hours */
+    can_reply: boolean;
+    /** True, if the connection is active */
+    is_enabled: boolean;
+}
+/** This object is received when messages are deleted from a connected business account. */
+export interface BusinessMessagesDeleted {
+    /** Unique identifier of the business connection */
+    business_connection_id: string;
+    /** Information about a chat in the business account. The bot may not have access to the chat or the corresponding user. */
+    chat: Chat;
+    /** A JSON-serialized list of identifiers of deleted messages in the chat of the business account */
+    message_ids: number[];
+}

package/markup.d.ts

@@ -189,7 +189,7 @@ export interface WebAppInfo {
     /** An HTTPS URL of a Web App to be opened with additional data as specified in Initializing Web Apps */
     url: string;
 }
-/** This object defines the criteria used to request suitable users. The identifiers of the selected users will be shared with the bot when the corresponding button is pressed. */
+/** This object defines the criteria used to request suitable users. Information about the selected users will be shared with the bot when the corresponding button is pressed. */
 export interface KeyboardButtonRequestUsers {
     /** Signed 32-bit identifier of the request that will be received back in the UsersShared object. Must be unique within the message */
     request_id: number;
@@ -199,8 +199,14 @@ export interface KeyboardButtonRequestUsers {
     user_is_premium?: boolean;
     /** The maximum number of users to be selected; 1-10. Defaults to 1. */
     max_quantity?: number;
+    /** Pass True to request the users' first and last name */
+    request_name?: boolean;
+    /** Pass True to request the users' username */
+    request_username?: boolean;
+    /** Pass True to request the users' photo */
+    request_photo?: boolean;
 }
-/** This object defines the criteria used to request a suitable chat. The identifier of the selected chat will be shared with the bot when the corresponding button is pressed. */
+/** This object defines the criteria used to request a suitable chat. Information about the selected chat will be shared with the bot when the corresponding button is pressed. The bot will be granted requested rights in the chat if appropriate. */
 export interface KeyboardButtonRequestChat {
     /** Signed 32-bit identifier of the request, which will be received back in the ChatShared object. Must be unique within the message */
     request_id: number;
@@ -218,4 +224,10 @@ export interface KeyboardButtonRequestChat {
     bot_administrator_rights?: ChatAdministratorRights;
     /** Pass True to request a chat with the bot as a member. Otherwise, no additional restrictions are applied. */
     bot_is_member?: boolean;
+    /** Pass True to request the chat's title */
+    request_title?: boolean;
+    /** Pass True to request the chat's username */
+    request_username?: boolean;
+    /** Pass True to request the chat's photo */
+    request_photo?: boolean;
 }

package/message.d.ts

@@ -15,12 +15,18 @@ export declare namespace Message {
         sender_chat?: Chat;
         /** Date the message was sent in Unix time. It is always a positive number, representing a valid date. */
         date: number;
+        /** Unique identifier of the business connection from which the message was received. If non-empty, the message belongs to a chat of the corresponding business account that is independent from any potential bot chat which might share the same identifier. */
+        business_connection_id?: string;
         /** Chat the message belongs to */
         chat: Chat;
         /** True, if the message is sent to a forum topic */
         is_topic_message?: boolean;
     }
     interface CommonMessage extends ServiceMessage {
+        /** If the sender of the message boosted the chat, the number of boosts added by the user */
+        sender_boost_count?: number;
+        /** The bot that actually sent the message on behalf of the business account. Available only for outgoing messages sent on behalf of the connected business account. */
+        sender_business_bot?: User;
         /** Information about the original message for forwarded messages */
         forward_origin?: MessageOrigin;
         /** True, if the message is a channel post that was automatically forwarded to the connected discussion group */
@@ -39,6 +45,8 @@ export declare namespace Message {
         edit_date?: number;
         /** True, if the message can't be forwarded */
         has_protected_content?: true;
+        /** True, if the message was sent by an implicit action, for example, as an away or a greeting business message, or as a scheduled message */
+        is_from_offline?: true;
         /** Signature of the post author for messages in channels, or the custom title of an anonymous group administrator */
         author_signature?: string;
         /** Options used for link preview generation for the message, if it is a text message and link preview options were changed */
@@ -94,6 +102,7 @@ export declare namespace Message {
     type WriteAccessAllowedMessage = ServiceMessage & MsgWith<"write_access_allowed">;
     type PassportDataMessage = ServiceMessage & MsgWith<"passport_data">;
     type ProximityAlertTriggeredMessage = ServiceMessage & MsgWith<"proximity_alert_triggered">;
+    type BoostAddedMessage = ServiceMessage & MsgWith<"boost_added">;
     type ForumTopicCreatedMessage = ServiceMessage & MsgWith<"forum_topic_created">;
     type ForumTopicEditedMessage = ServiceMessage & MsgWith<"forum_topic_edited">;
     type ForumTopicClosedMessage = ServiceMessage & MsgWith<"forum_topic_closed">;
@@ -188,6 +197,8 @@ export interface Message extends Message.MediaMessage {
     passport_data?: PassportData;
     /** Service message. A user in the chat triggered another user's proximity alert while sharing Live Location. */
     proximity_alert_triggered?: ProximityAlertTriggered;
+    /** Service message: user boosted the chat */
+    boost_added?: ChatBoostAdded;
     /** Service message: forum topic created */
     forum_topic_created?: ForumTopicCreated;
     /** Service message: forum topic edited */
@@ -200,10 +211,6 @@ export interface Message extends Message.MediaMessage {
     general_forum_topic_hidden?: GeneralForumTopicHidden;
     /** Service message: the 'General' forum topic unhidden */
     general_forum_topic_unhidden?: GeneralForumTopicUnhidden;
-    /** The message is a service message about a user boosting the chat */
-    boost_added: ChatBoostAdded;
-    /** If the sender of the message boosted the chat, the number of boosts added by the user */
-    sender_boost_count: number;
     /** Service message: a scheduled giveaway was created */
     giveaway_created?: GiveawayCreated;
     /** The message is a scheduled giveaway message */
@@ -450,9 +457,9 @@ export interface ExternalReplyInfo {
 export interface ReplyParameters {
     /** Identifier of the message that will be replied to in the current chat, or in the chat chat_id if it is specified */
     message_id: number;
-    /** If the message to be replied to is from a different chat, unique identifier for the chat or username of the channel (in the format @channelusername) */
+    /** If the message to be replied to is from a different chat, unique identifier for the chat or username of the channel (in the format @channelusername). Not supported for messages sent on behalf of a business account. */
     chat_id?: number | string;
-    /** Pass True if the message should be sent even if the specified message to be replied to is not found; can be used only for replies in the same chat and forum topic. */
+    /** Pass True if the message should be sent even if the specified message to be replied to is not found; can be used only for replies in the same chat and forum topic. Always True for messages sent on behalf of a business account. */
     allow_sending_without_reply?: boolean;
     /** Quoted part of the message to be replied to; 0-1024 characters after entities parsing. The quote must be an exact substring of the message to be replied to, including bold, italic, underline, strikethrough, spoiler, and custom_emoji entities. The message will fail to send if the quote isn't found in the original message. */
     quote?: string;
@@ -699,10 +706,10 @@ export interface Poll {
 }
 /** This object represents a point on the map. */
 export interface Location {
-    /** Longitude as defined by sender */
-    longitude: number;
     /** Latitude as defined by sender */
     latitude: number;
+    /** Longitude as defined by sender */
+    longitude: number;
     /** The radius of uncertainty for the location, measured in meters; 0-1500 */
     horizontal_accuracy?: number;
     /** Time relative to the message sending date, during which the location can be updated; in seconds. For active live locations only. */
@@ -783,19 +790,38 @@ export interface ChatBoostAdded {
     /** Number of boosts added by the user */
     boost_count: number;
 }
+/** This object contains information about a user that was shared with the bot using a KeyboardButtonRequestUser button. */
+export interface SharedUser {
+    /** Identifier of the shared user. This number may have more than 32 significant bits and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so 64-bit integers or double-precision float types are safe for storing these identifiers. The bot may not have access to the user and could be unable to use this identifier, unless the user is already known to the bot by some other means. */
+    user_id: number;
+    /** First name of the user, if the name was requested by the bot */
+    first_name?: string;
+    /** Last name of the user, if the name was requested by the bot */
+    last_name?: string;
+    /** Username of the user, if the username was requested by the bot */
+    username?: string;
+    /** Available sizes of the chat photo, if the photo was requested by the bot */
+    photo?: PhotoSize[];
+}
 /** This object contains information about the user whose identifier was shared with the bot using a KeyboardButtonRequestUsers button. */
 export interface UsersShared {
     /** Identifier of the request */
     request_id: number;
-    /** Identifiers of the shared users. The bot may not have access to the users and could be unable to use these identifiers, unless the users are already known to the bot by some other means. */
-    user_ids: number[];
+    /** Information about users shared with the bot. */
+    users: SharedUser[];
 }
-/** This object contains information about the chat whose identifier was shared with the bot using a KeyboardButtonRequestChat button. */
+/** This object contains information about a chat that was shared with the bot using a KeyboardButtonRequestChat button. */
 export interface ChatShared {
     /** Identifier of the request */
     request_id: number;
     /** Identifier of the shared chat. The bot may not have access to the chat and could be unable to use this identifier, unless the chat is already known to the bot by some other means. */
     chat_id: number;
+    /** Title of the chat, if the title was requested by the bot. */
+    title?: string;
+    /** Username of the chat, if the username was requested by the bot and available. */
+    username?: string;
+    /** Available sizes of the chat photo, if the photo was requested by the bot */
+    photo?: PhotoSize[];
 }
 /** This object represents a service message about a user allowing a bot to write messages after adding it to the attachment menu, launching a Web App from a link, or accepting an explicit request from a Web App sent by the method requestWriteAccess. */
 export interface WriteAccessAllowed {
@@ -939,10 +965,6 @@ export interface StickerSet {
     title: string;
     /** Type of stickers in the set, currently one of “regular”, “mask”, “custom_emoji” */
     sticker_type: "regular" | "mask" | "custom_emoji";
-    /** True, if the sticker set contains animated stickers */
-    is_animated: boolean;
-    /** True, if the sticker set contains video stickers */
-    is_video: boolean;
     /** List of all set stickers */
     stickers: Sticker[];
     /** Sticker set thumbnail in the .WEBP, .TGS, or .WEBM format */

package/methods.d.ts

@@ -1,5 +1,5 @@
 import type { InlineQueryResult, InlineQueryResultsButton } from "./inline.js";
-import type { BotCommand, ChatAdministratorRights, ChatFromGetChat, ChatInviteLink, ChatMember, ChatMemberAdministrator, ChatMemberOwner, ChatPermissions, ForumTopic, UserChatBoosts, UserFromGetMe, UserProfilePhotos, WebhookInfo } from "./manage.js";
+import type { BotCommand, BusinessConnection, ChatAdministratorRights, ChatFromGetChat, ChatInviteLink, ChatMember, ChatMemberAdministrator, ChatMemberOwner, ChatPermissions, ForumTopic, UserChatBoosts, UserFromGetMe, UserProfilePhotos, WebhookInfo } from "./manage.js";
 import type { ForceReply, InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove } from "./markup.js";
 import type { File, GameHighScore, LinkPreviewOptions, MaskPosition, Message, MessageEntity, MessageId, ParseMode, Poll, ReactionType, ReplyParameters, SentWebAppMessage, Sticker, StickerSet } from "./message.js";
 import type { PassportElementError } from "./passport.js";
@@ -74,6 +74,8 @@ export type ApiMethods<F> = {
     close(): true;
     /** Use this method to send text messages. On success, the sent Message is returned. */
     sendMessage(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -92,7 +94,7 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
@@ -120,7 +122,7 @@ export type ApiMethods<F> = {
         message_thread_id?: number;
         /** Unique identifier for the chat where the original messages were sent (or channel username in the format @channelusername) */
         from_chat_id: number | string;
-        /** Identifiers of 1-100 messages in the chat from_chat_id to forward. The identifiers must be specified in a strictly increasing order. */
+        /** A list of 1-100 identifiers of messages in the chat from_chat_id to forward. The identifiers must be specified in a strictly increasing order. */
         message_ids: number[];
         /** Sends the messages silently. Users will receive a notification with no sound. */
         disable_notification?: boolean;
@@ -162,7 +164,7 @@ export type ApiMethods<F> = {
         message_thread_id?: number;
         /** Unique identifier for the chat where the original messages were sent (or channel username in the format @channelusername) */
         from_chat_id: number | string;
-        /** Identifiers of 1-100 messages in the chat from_chat_id to copy. The identifiers must be specified in a strictly increasing order. */
+        /** A list of 1-100 identifiers of messages in the chat from_chat_id to copy. The identifiers must be specified in a strictly increasing order. */
         message_ids: number[];
         /** Sends the messages silently. Users will receive a notification with no sound. */
         disable_notification?: boolean;
@@ -173,6 +175,8 @@ export type ApiMethods<F> = {
     }): MessageId[];
     /** Use this method to send photos. On success, the sent Message is returned. */
     sendPhoto(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -193,7 +197,7 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
@@ -202,6 +206,8 @@ export type ApiMethods<F> = {
   
     For sending voice messages, use the sendVoice method instead. */
     sendAudio(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -228,13 +234,15 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
     }): Message.AudioMessage;
     /** Use this method to send general files. On success, the sent Message is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future. */
     sendDocument(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -257,13 +265,15 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
     }): Message.DocumentMessage;
     /** Use this method to send video files, Telegram clients support MPEG4 videos (other formats may be sent as Document). On success, the sent Message is returned. Bots can currently send video files of up to 50 MB in size, this limit may be changed in the future. */
     sendVideo(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -294,13 +304,15 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
     }): Message.VideoMessage;
     /** Use this method to send animation files (GIF or H.264/MPEG-4 AVC video without sound). On success, the sent Message is returned. Bots can currently send animation files of up to 50 MB in size, this limit may be changed in the future. */
     sendAnimation(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -329,13 +341,15 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
     }): Message.AnimationMessage;
     /** Use this method to send audio files, if you want Telegram clients to display the file as a playable voice message. For this to work, your audio must be in an .OGG file encoded with OPUS (other formats may be sent as Audio or Document). On success, the sent Message is returned. Bots can currently send voice messages of up to 50 MB in size, this limit may be changed in the future. */
     sendVoice(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -356,7 +370,7 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
@@ -364,6 +378,8 @@ export type ApiMethods<F> = {
     /** Use this method to send video messages. On success, the sent Message is returned.
     As of v.4.0, Telegram clients support rounded square MPEG4 videos of up to 1 minute long. */
     sendVideoNote(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -382,13 +398,15 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
     }): Message.VideoNoteMessage;
     /** Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of Messages that were sent is returned. */
     sendMediaGroup(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** An array describing messages to be sent, must include 2-10 items */
@@ -406,6 +424,8 @@ export type ApiMethods<F> = {
     }): Array<Message.AudioMessage | Message.DocumentMessage | Message.PhotoMessage | Message.VideoMessage>;
     /** Use this method to send point on the map. On success, the sent Message is returned. */
     sendLocation(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -428,7 +448,7 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
@@ -467,6 +487,8 @@ export type ApiMethods<F> = {
     }): (Update.Edited & Message.LocationMessage) | true;
     /** Use this method to send information about a venue. On success, the sent Message is returned. */
     sendVenue(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -493,13 +515,15 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
     }): Message.VenueMessage;
     /** Use this method to send phone contacts. On success, the sent Message is returned. */
     sendContact(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -518,13 +542,15 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
     }): Message.ContactMessage;
     /** Use this method to send a native poll. On success, the sent Message is returned. */
     sendPoll(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -559,13 +585,15 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
     }): Message.PollMessage;
     /** Use this method to send an animated emoji that will display a random value. On success, the sent Message is returned. */
     sendDice(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -578,7 +606,7 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
@@ -589,11 +617,13 @@ export type ApiMethods<F> = {
   
     We only recommend using this method when a response from the bot will take a noticeable amount of time to arrive. */
     sendChatAction(args: {
+        /** Unique identifier of the business connection on behalf of which the action will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Type of action to broadcast. Choose one, depending on what the user is about to receive: typing for text messages, upload_photo for photos, record_video or upload_video for videos, record_voice or upload_voice for voice notes, upload_document for general files, choose_sticker for stickers, find_location for location data, record_video_note or upload_video_note for video notes. */
         action: "typing" | "upload_photo" | "record_video" | "upload_video" | "record_voice" | "upload_voice" | "upload_document" | "choose_sticker" | "find_location" | "record_video_note" | "upload_video_note";
-        /** Unique identifier for the target message thread; supergroups only */
+        /** Unique identifier for the target message thread; for supergroups only */
         message_thread_id?: number;
     }): true;
     /** Use this method to change the chosen reactions on a message. Service messages can't be reacted to. Automatically forwarded messages from a channel to its discussion group have the same available reactions as messages in the channel. In albums, bots must react to the first message. Returns True on success. */
@@ -602,7 +632,7 @@ export type ApiMethods<F> = {
         chat_id: number | string;
         /** Identifier of the target message */
         message_id: number;
-        /** New list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators. */
+        /** A list of reaction types to set on the message. Currently, as non-premium users, bots can set up to one reaction per message. A custom emoji reaction can be used if it is either already present on the message or explicitly allowed by chat administrators. */
         reaction?: ReactionType[];
         /** Pass True to set the reaction with a big animation */
         is_big?: boolean;
@@ -679,21 +709,19 @@ export type ApiMethods<F> = {
         can_promote_members?: boolean;
         /** Pass True if the administrator can change chat title, photo and other settings */
         can_change_info?: boolean;
-        /** Pass True if the administrator can invite new users to the chat */
-        can_invite_users?: boolean;
-        /** Pass True if the administrator can post messages in the channel, or access channel statistics; channels only */
-        can_post_messages?: boolean;
-        /** Pass True if the administrator can edit messages of other users and can pin messages; channels only */
-        can_edit_messages?: boolean;
-        /** Pass True if the administrator can pin messages, supergroups only */
-        can_pin_messages?: boolean;
-        /** Pass True if the administrator can post stories to the chat */
+        /** True if the administrator can post stories to the chat */
         can_post_stories?: boolean;
-        /** Pass True if the administrator can edit stories posted by other users */
+        /** True if the administrator can edit stories posted by other users */
         can_edit_stories?: boolean;
-        /** Pass True if the administrator can delete stories posted by other users */
+        /** True if the administrator can delete stories posted by other users */
         can_delete_stories?: boolean;
-        /** Pass True if the user is allowed to create, rename, close, and reopen forum topics, supergroups only */
+        /** True if the administrator can post messages in the channel, or access channel statistics; for channels only */
+        can_post_messages?: boolean;
+        /** True if the administrator can edit messages of other users and can pin messages; for channels only */
+        can_edit_messages?: boolean;
+        /** True if the administrator can pin messages; for supergroups only */
+        can_pin_messages?: boolean;
+        /** True if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only */
         can_manage_topics?: boolean;
     }): true;
     /** Use this method to set a custom title for an administrator in a supergroup promoted by the bot. Returns True on success. */
@@ -981,6 +1009,11 @@ export type ApiMethods<F> = {
         /** Unique identifier of the target user */
         user_id: number;
     }): UserChatBoosts;
+    /** Use this method to get information about the connection of the bot with a business account. Returns a BusinessConnection object on success. */
+    getBusinessConnection(args: {
+        /** Unique identifier of the business connection */
+        business_connection_id: string;
+    }): BusinessConnection;
     /** Use this method to change the list of the bot's commands. See https://core.telegram.org/bots#commands for more details about bot commands. Returns True on success. */
     setMyCommands(args: {
         /** A list of bot commands to be set as the list of the bot's commands. At most 100 commands can be specified. */
@@ -1153,16 +1186,18 @@ export type ApiMethods<F> = {
     deleteMessages(args: {
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
-        /** Identifiers of 1-100 messages to delete. See deleteMessage for limitations on which messages can be deleted */
+        /** A list of 1-100 identifiers of messages to delete. See deleteMessage for limitations on which messages can be deleted */
         message_ids: number[];
     }): true;
     /** Use this method to send static .WEBP, animated .TGS, or video .WEBM stickers. On success, the sent Message is returned. */
     sendSticker(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat or username of the target channel (in the format @channelusername) */
         chat_id: number | string;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
         message_thread_id?: number;
-        /** Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP or .TGS sticker using multipart/form-data. Video stickers can only be sent by a file_id. Animated stickers can't be sent via an HTTP URL. */
+        /** Sticker to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a .WEBP sticker from the Internet, or upload a new .WEBP, .TGS, or .WEBM sticker using multipart/form-data. Video and animated stickers can't be sent via an HTTP URL. */
         sticker: F | string;
         /** Emoji associated with the sticker; only for just uploaded stickers */
         emoji?: string;
@@ -1172,7 +1207,7 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user. */
+        /** Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup | ReplyKeyboardRemove | ForceReply;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
@@ -1184,10 +1219,10 @@ export type ApiMethods<F> = {
     }): StickerSet;
     /** Use this method to get information about custom emoji stickers by their identifiers. Returns an Array of Sticker objects. */
     getCustomEmojiStickers(args: {
-        /** List of custom emoji identifiers. At most 200 custom emoji identifiers can be specified. */
+        /** A list of custom emoji identifiers. At most 200 custom emoji identifiers can be specified. */
         custom_emoji_ids: string[];
     }): Sticker[];
-    /** Use this method to upload a file with a sticker for later use in the createNewStickerSet and addStickerToSet methods (the file can be used multiple times). Returns the uploaded File on success. */
+    /** Use this method to upload a file with a sticker for later use in the createNewStickerSet, addStickerToSet, or replaceStickerInSet methods (the file can be used multiple times). Returns the uploaded File on success. */
     uploadStickerFile(args: {
         /** User identifier of sticker file owner */
         user_id: number;
@@ -1206,14 +1241,12 @@ export type ApiMethods<F> = {
         title: string;
         /** A list of 1-50 initial stickers to be added to the sticker set */
         stickers: InputSticker<F>[];
-        /** Format of the sticker, must be one of “static”, “animated”, “video” */
-        sticker_format: "static" | "animated" | "video";
         /** Type of stickers in the set, pass “regular”, “mask”, or “custom_emoji”. By default, a regular sticker set is created. */
         sticker_type?: "regular" | "mask" | "custom_emoji";
         /** Pass True if stickers in the sticker set must be repainted to the color of text when used in messages, the accent color if used as emoji status, white on chat photos, or another appropriate color based on context; for custom emoji sticker sets only */
         needs_repainting?: boolean;
     }): true;
-    /** Use this method to add a new sticker to a set created by the bot. The format of the added sticker must match the format of the other stickers in the set. Emoji sticker sets can have up to 200 stickers. Animated and video sticker sets can have up to 50 stickers. Static sticker sets can have up to 120 stickers. Returns True on success. */
+    /** Use this method to add a new sticker to a set created by the bot. Emoji sticker sets can have up to 200 stickers. Other sticker sets can have up to 120 stickers. Returns True on success. */
     addStickerToSet(args: {
         /** User identifier of sticker set owner */
         user_id: number;
@@ -1234,6 +1267,17 @@ export type ApiMethods<F> = {
         /** File identifier of the sticker */
         sticker: string;
     }): true;
+    /** Use this method to replace an existing sticker in a sticker set with a new one. The method is equivalent to calling deleteStickerFromSet, then addStickerToSet, then setStickerPositionInSet. Returns True on success. */
+    replaceStickerInSet(args: {
+        /** User identifier of the sticker set owner */
+        user_id: number;
+        /** Sticker set name */
+        name: string;
+        /** File identifier of the replaced sticker */
+        old_sticker: string;
+        /** An object with information about the added sticker. If exactly the same sticker had already been added to the set, then the set remains unchanged.:x */
+        sticker: InputSticker<F>;
+    }): true;
     /** Use this method to change the list of emoji assigned to a regular or custom emoji sticker. The sticker must belong to a sticker set created by the bot. Returns True on success. */
     setStickerEmojiList(args: {
         /** File identifier of the sticker */
@@ -1275,6 +1319,8 @@ export type ApiMethods<F> = {
         user_id: number;
         /** A .WEBP or .PNG image with the thumbnail, must be up to 128 kilobytes in size and have a width and height of exactly 100px, or a .TGS animation with a thumbnail up to 32 kilobytes in size (see https://core.telegram.org/stickers#animated-sticker-requirements for animated sticker technical requirements), or a WEBM video with the thumbnail up to 32 kilobytes in size; see https://core.telegram.org/stickers#video-sticker-requirements for video sticker technical requirements. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files ». Animated and video sticker set thumbnails can't be uploaded via HTTP URL. If omitted, then the thumbnail is dropped and the first sticker is used as the thumbnail. */
         thumbnail?: F | string;
+        /** Format of the thumbnail, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, or “video” for a WEBM video */
+        format: "static" | "animated" | "video";
     }): true;
     /** Use this method to set the thumbnail of a custom emoji sticker set. Returns True on success. */
     setCustomEmojiStickerSetThumbnail(args: {
@@ -1441,6 +1487,8 @@ export type ApiMethods<F> = {
     }): true;
     /** Use this method to send a game. On success, the sent Message is returned. */
     sendGame(args: {
+        /** Unique identifier of the business connection on behalf of which the message will be sent */
+        business_connection_id?: string;
         /** Unique identifier for the target chat */
         chat_id: number;
         /** Unique identifier for the target message thread (topic) of the forum; for forum supergroups only */
@@ -1453,7 +1501,7 @@ export type ApiMethods<F> = {
         protect_content?: boolean;
         /** Description of the message to reply to */
         reply_parameters?: ReplyParameters;
-        /** An object for an inline keyboard. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. */
+        /** An object for an inline keyboard. If empty, one 'Play game_title' button will be shown. If not empty, the first button must launch the game. Not supported for messages sent on behalf of a business account. */
         reply_markup?: InlineKeyboardMarkup;
         /** @deprecated Use `reply_parameters` instead. */
         reply_to_message_id?: number;
@@ -1493,6 +1541,8 @@ export type ApiMethods<F> = {
 export interface InputSticker<F> {
     /** The added sticker. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. Animated and video stickers can't be uploaded via HTTP URL. */
     sticker: F | string;
+    /** Format of the added sticker, must be one of “static” for a .WEBP or .PNG image, “animated” for a .TGS animation, “video” for a WEBM video */
+    format: "static" | "animated" | "video";
     /** List of 1-20 emoji associated with the sticker */
     emoji_list: string[];
     /** Position where the mask should be placed on faces. For “mask” stickers only. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grammyjs/types",
-  "version": "3.5.1",
+  "version": "3.6.0",
   "description": "Telegram Bot API type declarations for grammY",
   "main": "mod.js",
   "repository": {

package/passport.d.ts

@@ -20,21 +20,21 @@ export interface PassportFile {
 export interface EncryptedPassportElement {
     /** Element type. One of “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport”, “address”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration”, “temporary_registration”, “phone_number”, “email”. */
     type: "personal_details" | "passport" | "driver_license" | "identity_card" | "internal_passport" | "address" | "utility_bill" | "bank_statement" | "rental_agreement" | "passport_registration" | "temporary_registration" | "phone_number" | "email";
-    /** Base64-encoded encrypted Telegram Passport element data provided by the user, available for “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport” and “address” types. Can be decrypted and verified using the accompanying EncryptedCredentials. */
+    /** Base64-encoded encrypted Telegram Passport element data provided by the user; available only for “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport” and “address” types. Can be decrypted and verified using the accompanying EncryptedCredentials. */
     data?: string;
-    /** User's verified phone number, available only for “phone_number” type */
+    /** User's verified phone number; available only for “phone_number” type */
     phone_number?: string;
-    /** User's verified email address, available only for “email” type */
+    /** User's verified email address; available only for “email” type */
     email?: string;
-    /** Array of encrypted files with documents provided by the user, available for “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” and “temporary_registration” types. Files can be decrypted and verified using the accompanying EncryptedCredentials. */
+    /** Array of encrypted files with documents provided by the user; available only for “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” and “temporary_registration” types. Files can be decrypted and verified using the accompanying EncryptedCredentials. */
     files?: PassportFile[];
-    /** Encrypted file with the front side of the document, provided by the user. Available for “passport”, “driver_license”, “identity_card” and “internal_passport”. The file can be decrypted and verified using the accompanying EncryptedCredentials. */
+    /** Encrypted file with the front side of the document, provided by the user; available only for “passport”, “driver_license”, “identity_card” and “internal_passport”. The file can be decrypted and verified using the accompanying EncryptedCredentials. */
     front_side?: PassportFile;
-    /** Encrypted file with the reverse side of the document, provided by the user. Available for “driver_license” and “identity_card”. The file can be decrypted and verified using the accompanying EncryptedCredentials. */
+    /** Encrypted file with the reverse side of the document, provided by the user; available only for “driver_license” and “identity_card”. The file can be decrypted and verified using the accompanying EncryptedCredentials. */
     reverse_side?: PassportFile;
-    /** Encrypted file with the selfie of the user holding a document, provided by the user; available for “passport”, “driver_license”, “identity_card” and “internal_passport”. The file can be decrypted and verified using the accompanying EncryptedCredentials. */
+    /** Encrypted file with the selfie of the user holding a document, provided by the user; available if requested for “passport”, “driver_license”, “identity_card” and “internal_passport”. The file can be decrypted and verified using the accompanying EncryptedCredentials. */
     selfie?: PassportFile;
-    /** Array of encrypted files with translated versions of documents provided by the user. Available if requested for “passport”, “driver_license”, “identity_card”, “internal_passport”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” and “temporary_registration” types. Files can be decrypted and verified using the accompanying EncryptedCredentials. */
+    /** Array of encrypted files with translated versions of documents provided by the user; available if requested for “passport”, “driver_license”, “identity_card”, “internal_passport”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration” and “temporary_registration” types. Files can be decrypted and verified using the accompanying EncryptedCredentials. */
     translation?: PassportFile[];
     /** Base64-encoded element hash for using in PassportElementErrorUnspecified */
     hash: string;

package/update.d.ts

@@ -1,5 +1,5 @@
 import type { ChosenInlineResult, InlineQuery } from "./inline.js";
-import type { Chat, ChatBoostRemoved, ChatBoostUpdated, ChatJoinRequest, ChatMemberUpdated, User } from "./manage.js";
+import type { BusinessConnection, BusinessMessagesDeleted, Chat, ChatBoostRemoved, ChatBoostUpdated, ChatJoinRequest, ChatMemberUpdated, User } from "./manage.js";
 import type { CallbackQuery } from "./markup.js";
 import type { Message, MessageReactionCountUpdated, MessageReactionUpdated, Poll, PollAnswer } from "./message.js";
 import type { PreCheckoutQuery, ShippingQuery } from "./payment.js";
@@ -33,6 +33,14 @@ export interface Update {
     channel_post?: Message & Update.Channel;
     /** New version of a channel post that is known to the bot and was edited. This update may at times be triggered by changes to message fields that are either unavailable or not actively used by your bot. */
     edited_channel_post?: Message & Update.Edited & Update.Channel;
+    /** The bot was connected to or disconnected from a business account, or a user edited an existing connection with the bot */
+    business_connection?: BusinessConnection;
+    /** New non-service message from a connected business account */
+    business_message?: Message;
+    /** New version of a message from a connected business account */
+    edited_business_message?: Message;
+    /** Messages were deleted from a connected business account */
+    deleted_business_messages?: BusinessMessagesDeleted;
     /** A reaction to a message was changed by a user. The bot must be an administrator in the chat and must explicitly specify "message_reaction" in the list of allowed_updates to receive these updates. The update isn't received for reactions set by bots. */
     message_reaction?: MessageReactionUpdated;
     /** Reactions to a message with anonymous reactions were changed. The bot must be an administrator in the chat and must explicitly specify "message_reaction_count" in the list of allowed_updates to receive these updates. The updates are grouped and can be sent with delay up to a few minutes. */