@telegram.ts/types 1.24.0 → 1.25.0

package/src/manageTypes.d.ts

@@ -6,6 +6,7 @@ import type {
   Sticker,
 } from "./messageTypes";
 import type { LanguageCode } from "./languageTypes";
+import type { UniqueGiftColors } from "./invoiceTypes";
 import type { Update } from "./updateTypes";
 
 /** Describes the current status of a webhook. */
@@ -40,6 +41,8 @@ export interface AcceptedGiftTypes {
   unique_gifts: boolean;
   /** True, if a Telegram Premium subscription is accepted */
   premium_subscription: boolean;
+  /** True, if transfers of unique gifts from channels are accepted */
+  gifts_from_channels: boolean;
 }
 
 /** This object represents a Telegram user or bot. */
@@ -55,7 +58,7 @@ export interface User {
   /** User's or bot's username */
   username?: string;
   /** IETF language tag of the user's language */
-  language_code?: LanguageCode;
+  language_code?: string;
   /** True, if this user is a Telegram Premium user */
   is_premium?: true;
   /** True, if this user added the bot to the attachment menu */
@@ -76,6 +79,20 @@ export interface UserFromGetMe extends User {
   can_connect_to_business: boolean;
   /** True, if the bot has main Web App. Returned only in getMe. */
   has_main_web_app: boolean;
+  /** True, if the bot has forum topic mode enabled in private chats. Returned only in getMe. */
+  has_topics_enabled?: boolean;
+}
+
+/** This object describes the rating of a user based on their Telegram Star spendings. */
+export interface UserRating {
+  /** Current level of the user, indicating their reliability when purchasing digital goods and services. A higher level suggests a more trustworthy customer; a negative level is likely reason for concern. */
+  level: number;
+  /** Numerical value of the user's rating; the higher the rating, the better */
+  rating: number;
+  /** The rating value required to get the current level */
+  current_level_rating: number;
+  /** The rating value required to get to the next level; omitted if the maximum level was reached */
+  next_level_rating?: number;
 }
 
 export declare namespace Chat {
@@ -173,14 +190,16 @@ export declare namespace ChatFullInfo {
     type: "private";
     /** Title, for supergroups, channels and group chats */
     title?: undefined;
-    /**  Username, for private chats, supergroups and channels if available */
+    /** Username, for private chats, supergroups and channels if available */
     username?: string;
-    /**  First name of the other party in a private chat */
+    /** First name of the other party in a private chat */
     first_name: string;
-    /**  Last name of the other party in a private chat */
+    /** Last name of the other party in a private chat */
     last_name?: string;
     /** True, if the supergroup chat is a forum (has topics enabled) */
     is_forum?: undefined;
+    /** True, if the chat is the direct messages chat of a channel */
+    is_direct_messages?: undefined;
     /** Identifier of the accent color for the chat name and backgrounds of the chat photo, reply header, and link preview. See accent colors for more details. */
     accent_color_id: number;
     /** The maximum number of reactions that can be set on a message in the chat */
@@ -197,8 +216,14 @@ export declare namespace ChatFullInfo {
     business_location?: BusinessLocation;
     /** For private chats with business accounts, the opening hours of the business */
     business_opening_hours?: BusinessOpeningHours;
+    /** For private chats, the rating of the user if any */
+    rating?: UserRating;
+    /** The color scheme based on a unique gift that must be used for the chat's name, message replies and link previews */
+    unique_gift_colors?: UniqueGiftColors;
     /** For private chats, the personal channel of the user */
     personal_chat?: Chat;
+    /** Information about the corresponding channel chat; for direct messages chats only */
+    parent_chat?: undefined;
     /** List of available reactions allowed in the chat. If omitted, then all emoji reactions are allowed. */
     available_reactions?: ReactionType[];
     /** Custom emoji identifier of the emoji chosen by the chat for the reply header and link preview background */
@@ -207,7 +232,7 @@ export declare namespace ChatFullInfo {
     profile_accent_color_id?: number;
     /** Custom emoji identifier of the emoji chosen by the chat for its profile background */
     profile_background_custom_emoji_id?: string;
-    /**  Custom emoji identifier of the emoji status of the chat or the other party in a private chat */
+    /** Custom emoji identifier of the emoji status of the chat or the other party in a private chat */
     emoji_status_custom_emoji_id?: string;
     /** Expiration date of the emoji status of the chat or the other party in a private chat, in Unix time, if any */
     emoji_status_expiration_date?: number;
@@ -223,7 +248,7 @@ export declare namespace ChatFullInfo {
     join_by_request?: undefined;
     /** Description, for groups, supergroups and channel chats */
     description?: undefined;
-    /**  Primary invite link, for groups, supergroups and channel chats */
+    /** Primary invite link, for groups, supergroups and channel chats */
     invite_link?: undefined;
     /** The most recent pinned message (by sending date) */
     pinned_message?: Message;
@@ -231,11 +256,13 @@ export declare namespace ChatFullInfo {
     permissions?: undefined;
     /** Information about types of gifts that are accepted by the chat or by the corresponding user for private chats */
     accepted_gift_types: AcceptedGiftTypes;
+    /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
+    can_send_paid_media?: undefined;
     /** For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds */
     slow_mode_delay?: undefined;
-    /**  For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions */
+    /** For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions */
     unrestrict_boost_count?: undefined;
-    /**  The time after which all messages sent to the chat will be automatically deleted; in seconds */
+    /** The time after which all messages sent to the chat will be automatically deleted; in seconds */
     message_auto_delete_time?: number;
     /** True, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators. */
     has_aggressive_anti_spam_enabled?: undefined;
@@ -253,12 +280,8 @@ export declare namespace ChatFullInfo {
     custom_emoji_sticker_set_name?: undefined;
     /** Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. */
     linked_chat_id?: undefined;
-    /** Information about the corresponding channel chat; for direct messages chats only */
-    parent_chat?: undefined;
     /** For supergroups, the location to which the supergroup is connected */
     location?: undefined;
-    /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
-    can_send_paid_media?: undefined;
   }
   /** Internal type for group chats */
   export interface GroupChat {
@@ -268,14 +291,16 @@ export declare namespace ChatFullInfo {
     type: "group";
     /** Title, for supergroups, channels and group chats */
     title: string;
-    /**  Username, for private chats, supergroups and channels if available */
+    /** Username, for private chats, supergroups and channels if available */
     username?: undefined;
-    /**  First name of the other party in a private chat */
+    /** First name of the other party in a private chat */
     first_name?: undefined;
-    /**  Last name of the other party in a private chat */
+    /** Last name of the other party in a private chat */
     last_name?: undefined;
     /** True, if the supergroup chat is a forum (has topics enabled) */
     is_forum?: undefined;
+    /** True, if the chat is the direct messages chat of a channel */
+    is_direct_messages?: undefined;
     /** Identifier of the accent color for the chat name and backgrounds of the chat photo, reply header, and link preview. See accent colors for more details. */
     accent_color_id: number;
     /** The maximum number of reactions that can be set on a message in the chat */
@@ -292,8 +317,14 @@ export declare namespace ChatFullInfo {
     business_location?: undefined;
     /** For private chats with business accounts, the opening hours of the business */
     business_opening_hours?: undefined;
+    /** For private chats, the rating of the user if any */
+    rating?: undefined;
+    /** The color scheme based on a unique gift that must be used for the chat's name, message replies and link previews */
+    unique_gift_colors?: UniqueGiftColors;
     /** For private chats, the personal channel of the user */
     personal_chat?: undefined;
+    /** Information about the corresponding channel chat; for direct messages chats only */
+    parent_chat?: undefined;
     /** List of available reactions allowed in the chat. If omitted, then all emoji reactions are allowed. */
     available_reactions?: ReactionType[];
     /** Custom emoji identifier of the emoji chosen by the chat for the reply header and link preview background */
@@ -302,7 +333,7 @@ export declare namespace ChatFullInfo {
     profile_accent_color_id?: number;
     /** Custom emoji identifier of the emoji chosen by the chat for its profile background */
     profile_background_custom_emoji_id?: string;
-    /**  Custom emoji identifier of the emoji status of the chat or the other party in a private chat */
+    /** Custom emoji identifier of the emoji status of the chat or the other party in a private chat */
     emoji_status_custom_emoji_id?: string;
     /** Expiration date of the emoji status of the chat or the other party in a private chat, in Unix time, if any */
     emoji_status_expiration_date?: number;
@@ -318,19 +349,21 @@ export declare namespace ChatFullInfo {
     join_by_request?: undefined;
     /** Description, for groups, supergroups and channel chats */
     description?: string;
-    /**  Primary invite link, for groups, supergroups and channel chats */
+    /** Primary invite link, for groups, supergroups and channel chats */
     invite_link?: string;
     /** The most recent pinned message (by sending date) */
     pinned_message?: Message;
     /** Default chat member permissions, for groups and supergroups */
     permissions?: ChatPermissions;
-    /** True, if gifts can be sent to the chat */
-    can_send_gift?: true;
+    /** Information about types of gifts that are accepted by the chat or by the corresponding user for private chats */
+    accepted_gift_types: AcceptedGiftTypes;
+    /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
+    can_send_paid_media?: undefined;
     /** For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds */
     slow_mode_delay?: undefined;
-    /**  For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions */
+    /** For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions */
     unrestrict_boost_count?: undefined;
-    /**  The time after which all messages sent to the chat will be automatically deleted; in seconds */
+    /** The time after which all messages sent to the chat will be automatically deleted; in seconds */
     message_auto_delete_time?: number;
     /** True, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators. */
     has_aggressive_anti_spam_enabled?: undefined;
@@ -348,12 +381,8 @@ export declare namespace ChatFullInfo {
     custom_emoji_sticker_set_name?: undefined;
     /** Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. */
     linked_chat_id?: undefined;
-    /** Information about the corresponding channel chat; for direct messages chats only */
-    parent_chat?: undefined;
     /** For supergroups, the location to which the supergroup is connected */
     location?: undefined;
-    /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
-    can_send_paid_media?: undefined;
   }
   /** Internal type for supergroup chats */
   export interface SupergroupChat {
@@ -363,14 +392,16 @@ export declare namespace ChatFullInfo {
     type: "supergroup";
     /** Title, for supergroups, channels and group chats */
     title: string;
-    /**  Username, for private chats, supergroups and channels if available */
+    /** Username, for private chats, supergroups and channels if available */
     username?: string;
-    /**  First name of the other party in a private chat */
+    /** First name of the other party in a private chat */
     first_name?: undefined;
-    /**  Last name of the other party in a private chat */
+    /** Last name of the other party in a private chat */
     last_name?: undefined;
     /** True, if the supergroup chat is a forum (has topics enabled) */
     is_forum?: true;
+    /** True, if the chat is the direct messages chat of a channel */
+    is_direct_messages?: true;
     /** Identifier of the accent color for the chat name and backgrounds of the chat photo, reply header, and link preview. See accent colors for more details. */
     accent_color_id: number;
     /** The maximum number of reactions that can be set on a message in the chat */
@@ -387,8 +418,14 @@ export declare namespace ChatFullInfo {
     business_location?: undefined;
     /** For private chats with business accounts, the opening hours of the business */
     business_opening_hours?: undefined;
+    /** For private chats, the rating of the user if any */
+    rating?: undefined;
+    /** The color scheme based on a unique gift that must be used for the chat's name, message replies and link previews */
+    unique_gift_colors?: UniqueGiftColors;
     /** For private chats, the personal channel of the user */
     personal_chat?: undefined;
+    /** Information about the corresponding channel chat; for direct messages chats only */
+    parent_chat?: Chat.ChannelChat;
     /** List of available reactions allowed in the chat. If omitted, then all emoji reactions are allowed. */
     available_reactions?: ReactionType[];
     /** Custom emoji identifier of the emoji chosen by the chat for the reply header and link preview background */
@@ -397,7 +434,7 @@ export declare namespace ChatFullInfo {
     profile_accent_color_id?: number;
     /** Custom emoji identifier of the emoji chosen by the chat for its profile background */
     profile_background_custom_emoji_id?: string;
-    /**  Custom emoji identifier of the emoji status of the chat or the other party in a private chat */
+    /** Custom emoji identifier of the emoji status of the chat or the other party in a private chat */
     emoji_status_custom_emoji_id?: string;
     /** Expiration date of the emoji status of the chat or the other party in a private chat, in Unix time, if any */
     emoji_status_expiration_date?: number;
@@ -413,19 +450,21 @@ export declare namespace ChatFullInfo {
     join_by_request?: true;
     /** Description, for groups, supergroups and channel chats */
     description?: string;
-    /**  Primary invite link, for groups, supergroups and channel chats */
+    /** Primary invite link, for groups, supergroups and channel chats */
     invite_link?: string;
     /** The most recent pinned message (by sending date) */
     pinned_message?: Message;
     /** Default chat member permissions, for groups and supergroups */
     permissions?: ChatPermissions;
-    /** True, if gifts can be sent to the chat */
-    can_send_gift?: true;
+    /** Information about types of gifts that are accepted by the chat or by the corresponding user for private chats */
+    accepted_gift_types: AcceptedGiftTypes;
+    /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
+    can_send_paid_media?: undefined;
     /** For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds */
     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 */
+    /** For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions */
     unrestrict_boost_count?: number;
-    /**  The time after which all messages sent to the chat will be automatically deleted; in seconds */
+    /** The time after which all messages sent to the chat will be automatically deleted; in seconds */
     message_auto_delete_time?: number;
     /** True, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators. */
     has_aggressive_anti_spam_enabled?: true;
@@ -443,12 +482,8 @@ export declare namespace ChatFullInfo {
     custom_emoji_sticker_set_name?: string;
     /** Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. */
     linked_chat_id?: number;
-    /** Information about the corresponding channel chat; for direct messages chats only */
-    parent_chat?: Chat.ChannelChat;
     /** For supergroups, the location to which the supergroup is connected */
     location?: ChatLocation;
-    /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
-    can_send_paid_media?: undefined;
   }
   /** Internal type for channel chats */
   export interface ChannelChat {
@@ -458,14 +493,16 @@ export declare namespace ChatFullInfo {
     type: "channel";
     /** Title, for supergroups, channels and group chats */
     title: string;
-    /**  Username, for private chats, supergroups and channels if available */
+    /** Username, for private chats, supergroups and channels if available */
     username?: string;
-    /**  First name of the other party in a private chat */
+    /** First name of the other party in a private chat */
     first_name?: undefined;
-    /**  Last name of the other party in a private chat */
+    /** Last name of the other party in a private chat */
     last_name?: undefined;
     /** True, if the supergroup chat is a forum (has topics enabled) */
     is_forum?: undefined;
+    /** True, if the chat is the direct messages chat of a channel */
+    is_direct_messages?: undefined;
     /** Identifier of the accent color for the chat name and backgrounds of the chat photo, reply header, and link preview. See accent colors for more details. */
     accent_color_id: number;
     /** The maximum number of reactions that can be set on a message in the chat */
@@ -482,8 +519,14 @@ export declare namespace ChatFullInfo {
     business_location?: undefined;
     /** For private chats with business accounts, the opening hours of the business */
     business_opening_hours?: undefined;
+    /** For private chats, the rating of the user if any */
+    rating?: undefined;
+    /** The color scheme based on a unique gift that must be used for the chat's name, message replies and link previews */
+    unique_gift_colors?: UniqueGiftColors;
     /** For private chats, the personal channel of the user */
     personal_chat?: undefined;
+    /** Information about the corresponding channel chat; for direct messages chats only */
+    parent_chat?: undefined;
     /** List of available reactions allowed in the chat. If omitted, then all emoji reactions are allowed. */
     available_reactions?: ReactionType[];
     /** Custom emoji identifier of the emoji chosen by the chat for the reply header and link preview background */
@@ -492,7 +535,7 @@ export declare namespace ChatFullInfo {
     profile_accent_color_id?: number;
     /** Custom emoji identifier of the emoji chosen by the chat for its profile background */
     profile_background_custom_emoji_id?: string;
-    /**  Custom emoji identifier of the emoji status of the chat or the other party in a private chat */
+    /** Custom emoji identifier of the emoji status of the chat or the other party in a private chat */
     emoji_status_custom_emoji_id?: string;
     /** Expiration date of the emoji status of the chat or the other party in a private chat, in Unix time, if any */
     emoji_status_expiration_date?: number;
@@ -508,19 +551,21 @@ export declare namespace ChatFullInfo {
     join_by_request?: undefined;
     /** Description, for groups, supergroups and channel chats */
     description?: string;
-    /**  Primary invite link, for groups, supergroups and channel chats */
+    /** Primary invite link, for groups, supergroups and channel chats */
     invite_link?: string;
     /** The most recent pinned message (by sending date) */
     pinned_message?: Message;
     /** Default chat member permissions, for groups and supergroups */
     permissions?: undefined;
-    /** True, if gifts can be sent to the chat */
-    can_send_gift?: true;
+    /** Information about types of gifts that are accepted by the chat or by the corresponding user for private chats */
+    accepted_gift_types: AcceptedGiftTypes;
+    /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
+    can_send_paid_media?: true;
     /** For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds */
     slow_mode_delay?: undefined;
-    /**  For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions */
+    /** For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions */
     unrestrict_boost_count?: undefined;
-    /**  The time after which all messages sent to the chat will be automatically deleted; in seconds */
+    /** The time after which all messages sent to the chat will be automatically deleted; in seconds */
     message_auto_delete_time?: number;
     /** True, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators. */
     has_aggressive_anti_spam_enabled?: undefined;
@@ -538,12 +583,8 @@ export declare namespace ChatFullInfo {
     custom_emoji_sticker_set_name?: undefined;
     /** Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. */
     linked_chat_id?: number;
-    /** Information about the corresponding channel chat; for direct messages chats only */
-    parent_chat?: undefined;
     /** For supergroups, the location to which the supergroup is connected */
     location?: undefined;
-    /** True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats. */
-    can_send_paid_media?: undefined;
   }
 }
 
@@ -903,6 +944,8 @@ export interface ForumTopic {
   message_thread_id: number;
   /** Name of the topic */
   name: string;
+  /** True, if the name of the topic wasn't specified explicitly by its creator and likely needs to be changed by the bot */
+  is_name_implicit?: true;
   /** Color of the topic icon in RGB format */
   icon_color: number;
   /** Unique identifier of the custom emoji shown as the topic icon */

package/src/messageTypes.d.ts

@@ -29,7 +29,7 @@ export declare namespace Message {
   interface ServiceMessage {
     /** Unique message identifier inside this chat. In specific instances (e.g., message containing a video sent to a big chat), the server might automatically schedule a message instead of sending it immediately. In such cases, this field will be 0 and the relevant message will be unusable until it is actually sent */
     message_id: number;
-    /** Unique identifier of a message thread or a forum topic to which the message belongs; for supergroups only */
+    /** Unique identifier of a message thread or forum topic to which the message belongs; for supergroups and private chats only */
     message_thread_id?: number;
     /** Sender of the message; may be empty for messages sent to channels. For backward compatibility, if the message was sent on behalf of a chat, the field contains a fake sender user in non-channel chats. */
     from?: User;
@@ -41,7 +41,7 @@ export declare namespace Message {
     business_connection_id?: string;
     /** Chat the message belongs to */
     chat: Chat;
-    /** True, if the message is sent to a forum topic */
+    /** True, if the message is sent to a topic in a forum supergroup or a private chat with the bot */
     is_topic_message?: boolean;
     /** Information about the direct messages chat topic that contains the message */
     direct_messages_topic?: DirectMessagesTopic;
@@ -101,7 +101,9 @@ export declare namespace Message {
     has_media_spoiler?: true;
   }
 
-  export type TextMessage = CommonMessage & MsgWith<"text">;
+  export type TextMessage = CommonMessage &
+    MsgWith<"text"> &
+    Partial<MsgWith<"entities">>;
   export type AudioMessage = CaptionableMessage & MsgWith<"audio">;
   export type DocumentMessage = CaptionableMessage & MsgWith<"document">;
   export type AnimationMessage = DocumentMessage & MsgWith<"animation">;
@@ -196,6 +198,8 @@ export declare namespace Message {
     MsgWith<"giveaway_completed">;
   export type GiftMessage = ServiceMessage & MsgWith<"gift">;
   export type UniqueGiftMessage = ServiceMessage & MsgWith<"unique_gift">;
+  export type GiftUpgradeSentMessage = ServiceMessage &
+    MsgWith<"gift_upgrade_sent">;
   export type PaidMessagePriceChangedMessage = ServiceMessage &
     MsgWith<"paid_message_price_changed">;
   export type VideoChatScheduledMessage = ServiceMessage &
@@ -334,6 +338,8 @@ export interface Message extends Message.MediaMessage {
   giveaway_completed?: GiveawayCompleted;
   /** Service message: a regular gift was sent or received */
   gift?: GiftInfo;
+  /** Service message: upgrade of a gift was purchased after the gift was sent */
+  gift_upgrade_sent?: GiftInfo;
   /** Service message: a unique gift was sent or received */
   unique_gift?: UniqueGiftInfo;
   /** Service message: the price for paid messages has changed in the chat */
@@ -442,7 +448,7 @@ Please note:
 - Inside `pre` and `code` entities, all '`' and '\' characters must be escaped with a preceding '\' character.
 - Inside the `(...)` part of the inline link and custom emoji definition, all ')' and '\' must be escaped with a preceding '\' character.
 - In all other places characters '_', '*', '[', ']', '(', ')', '~', '`', '>', '#', '+', '-', '=', '|', '{', '}', '.', '!' must be escaped with the preceding character '\'.
-- In case of ambiguity between `italic` and `underline` entities `__` is always greadily treated from left to right as beginning or end of an `underline` entity, so instead of `___italic underline___` use `___italic underline_**__`, adding an empty bold entity as a separator.
+- In case of ambiguity between `italic` and `underline` entities `__` is always greedily treated from left to right as beginning or end of an `underline` entity, so instead of `___italic underline___` use `___italic underline_**__`, adding an empty bold entity as a separator.
 - A valid emoji must be provided as an alternative value for the custom emoji. The emoji will be shown instead of the custom emoji in places where a custom emoji cannot be displayed (e.g., system notifications) or if the message is forwarded by a non-premium user. It is recommended to use the emoji from the emoji field of the custom emoji sticker.
 - Custom emoji entities can only be used by bots that purchased additional usernames on Fragment.
 
@@ -496,7 +502,7 @@ Please note:
 
 - Entities must not be nested, use parse mode MarkdownV2 instead.
 - There is no way to specify “underline”, “strikethrough”, “spoiler”, “blockquote”, “expandable_blockquote” and “custom_emoji” entities, use parse mode MarkdownV2 instead.
-- To escape characters '_', '*', '`', '[' outside of an entity, prepend the characters '\' before them.
+- To escape character '_', '*', '`', '[' outside of an entity, prepend the characters '\' before them.
 - Escaping inside entities is not allowed, so entity must be closed first and reopened again: use `_snake_\__case_` for italic `snake_case` and `*2*\**2=4*` for bold `2*2=4`. */
 export type ParseMode = "Markdown" | "MarkdownV2" | "HTML";
 
@@ -1028,6 +1034,8 @@ export interface MessageAutoDeleteTimerChanged {
 export interface ForumTopicCreated {
   /** Name of the topic */
   name: string;
+  /** True, if the name of the topic wasn't specified explicitly by its creator and likely needs to be changed by the bot */
+  is_name_implicit?: true;
   /** Color of the topic icon in RGB format */
   icon_color: number;
   /** Unique identifier of the custom emoji shown as the topic icon */