Bot API 9.6

https://core.telegram.org/bots/api#april-3-2026

Author: wiz0u

README.md

@@ -1,7 +1,7 @@
 # .NET Client for Telegram Bot API
 
 [![Nuget](https://img.shields.io/nuget/vpre/Telegram.Bot.svg?label=Telegram.Bot&style=flat-square&color=d8b541)](https://www.nuget.org/packages/Telegram.Bot)
-[![Bot API 9.5](https://img.shields.io/badge/Bot_API-9.5-f36caf.svg?style=flat-square)](https://core.telegram.org/bots/api)
+[![Bot API 9.6](https://img.shields.io/badge/Bot_API-9.6-f36caf.svg?style=flat-square)](https://core.telegram.org/bots/api)
 [![Documentations](https://img.shields.io/badge/Documentations-Book-orange.svg?style=flat-square)](https://telegrambots.github.io/book/)
 [![Telegram Chat](https://img.shields.io/badge/Support_Chat-Telegram-blue.svg?style=flat-square)](https://t.me/joinchat/B35YY0QbLfd034CFnvCtCA)  
 [![Master build](https://img.shields.io/azure-devops/build/tgbots/14f9ab3f-313a-4339-8534-e8b96c7763cc/6?style=flat-square&label=master)](https://dev.azure.com/tgbots/Telegram.Bot/_build/latest?definitionId=6&branchName=master)

src/Telegram.Bot/Extend.Types.cs

@@ -221,6 +221,17 @@ public partial class BotCommandScope
         public static BotCommandScopeChatMember ChatMember(ChatId chatId, long userId) => new() { ChatId = chatId, UserId = userId };
     }
 
+    public partial class Poll
+    {
+        /// <summary><em>Optional</em>. 0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the private chat with the bot.</summary>
+        [Obsolete("Use CorrectOptionIds instead")]
+        public int? CorrectOptionId
+        {
+            get => CorrectOptionIds switch { null or [] => null, [int value] => value, _ => throw new InvalidOperationException("Multiple CorrectOptionIds") };
+            set => CorrectOptionIds = value.HasValue ? [value.Value] : null;
+        }
+    }
+
 
     namespace Payments
     {

src/Telegram.Bot/Requests/Gifts/SendGiftRequest.cs

@@ -25,11 +25,11 @@ public partial class SendGiftRequest() : RequestBase<bool>("sendGift")
     /// <summary>Text that will be shown along with the gift; 0-128 characters</summary>
     public string? Text { get; set; }
 
-    /// <summary>Mode for parsing entities in the text. See <a href="https://core.telegram.org/bots/api#formatting-options">formatting options</a> for more details. Entities other than <see cref="MessageEntityType.Bold">Bold</see>, <see cref="MessageEntityType.Italic">Italic</see>, <see cref="MessageEntityType.Underline">Underline</see>, <see cref="MessageEntityType.Strikethrough">Strikethrough</see>, <see cref="MessageEntityType.Spoiler">Spoiler</see>, and <see cref="MessageEntityType.CustomEmoji">CustomEmoji</see> are ignored.</summary>
+    /// <summary>Mode for parsing entities in the text. See <a href="https://core.telegram.org/bots/api#formatting-options">formatting options</a> for more details. Entities other than <see cref="MessageEntityType.Bold">Bold</see>, <see cref="MessageEntityType.Italic">Italic</see>, <see cref="MessageEntityType.Underline">Underline</see>, <see cref="MessageEntityType.Strikethrough">Strikethrough</see>, <see cref="MessageEntityType.Spoiler">Spoiler</see>, <see cref="MessageEntityType.CustomEmoji">CustomEmoji</see>, and <see cref="MessageEntityType.DateTime">DateTime</see> are ignored.</summary>
     [JsonPropertyName("text_parse_mode")]
     public ParseMode TextParseMode { get; set; }
 
-    /// <summary>A list of special entities that appear in the gift text. It can be specified instead of <see cref="TextParseMode">TextParseMode</see>. Entities other than <see cref="MessageEntityType.Bold">Bold</see>, <see cref="MessageEntityType.Italic">Italic</see>, <see cref="MessageEntityType.Underline">Underline</see>, <see cref="MessageEntityType.Strikethrough">Strikethrough</see>, <see cref="MessageEntityType.Spoiler">Spoiler</see>, and <see cref="MessageEntityType.CustomEmoji">CustomEmoji</see> are ignored.</summary>
+    /// <summary>A list of special entities that appear in the gift text. It can be specified instead of <see cref="TextParseMode">TextParseMode</see>. Entities other than <see cref="MessageEntityType.Bold">Bold</see>, <see cref="MessageEntityType.Italic">Italic</see>, <see cref="MessageEntityType.Underline">Underline</see>, <see cref="MessageEntityType.Strikethrough">Strikethrough</see>, <see cref="MessageEntityType.Spoiler">Spoiler</see>, <see cref="MessageEntityType.CustomEmoji">CustomEmoji</see>, and <see cref="MessageEntityType.DateTime">DateTime</see> are ignored.</summary>
     [JsonPropertyName("text_entities")]
     public IEnumerable<MessageEntity>? TextEntities { get; set; }
 }

src/Telegram.Bot/Requests/Other methods/GetManagedBotTokenRequest.cs

@@ -0,0 +1,12 @@
+// GENERATED FILE - DO NOT MODIFY MANUALLY
+namespace Telegram.Bot.Requests;
+
+/// <summary>Use this method to get the token of a managed bot.<para>Returns: The token as <em>String</em> on success.</para></summary>
+[EditorBrowsable(EditorBrowsableState.Never)]
+public partial class GetManagedBotTokenRequest() : RequestBase<string>("getManagedBotToken"), IUserTargetable
+{
+    /// <summary>User identifier of the managed bot whose token will be returned</summary>
+    [JsonPropertyName("user_id")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public required long UserId { get; set; }
+}

src/Telegram.Bot/Requests/Other methods/ReplaceManagedBotTokenRequest.cs

@@ -0,0 +1,12 @@
+// GENERATED FILE - DO NOT MODIFY MANUALLY
+namespace Telegram.Bot.Requests;
+
+/// <summary>Use this method to revoke the current token of a managed bot and generate a new one.<para>Returns: The new token as <em>String</em> on success.</para></summary>
+[EditorBrowsable(EditorBrowsableState.Never)]
+public partial class ReplaceManagedBotTokenRequest() : RequestBase<string>("replaceManagedBotToken"), IUserTargetable
+{
+    /// <summary>User identifier of the managed bot whose token will be replaced</summary>
+    [JsonPropertyName("user_id")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public required long UserId { get; set; }
+}

src/Telegram.Bot/Requests/Other methods/SavePreparedKeyboardButtonRequest.cs

@@ -0,0 +1,16 @@
+// GENERATED FILE - DO NOT MODIFY MANUALLY
+namespace Telegram.Bot.Requests;
+
+/// <summary>Stores a keyboard button that can be used by a user within a Mini App.<para>Returns: A <see cref="PreparedKeyboardButton"/> object.</para></summary>
+[EditorBrowsable(EditorBrowsableState.Never)]
+public partial class SavePreparedKeyboardButtonRequest() : RequestBase<PreparedKeyboardButton>("savePreparedKeyboardButton"), IUserTargetable
+{
+    /// <summary>Unique identifier of the target user that can use the button</summary>
+    [JsonPropertyName("user_id")]
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public required long UserId { get; set; }
+
+    /// <summary>An object describing the button to be saved. The button must be of the type <em>RequestUsers</em>, <em>RequestChat</em>, or <em>RequestManagedBot</em></summary>
+    [JsonIgnore(Condition = JsonIgnoreCondition.Never)]
+    public required KeyboardButton Button { get; set; }
+}

src/Telegram.Bot/Requests/Payments/GiftPremiumSubscriptionRequest.cs

@@ -23,11 +23,11 @@ public partial class GiftPremiumSubscriptionRequest() : RequestBase<bool>("giftP
     /// <summary>Text that will be shown along with the service message about the subscription; 0-128 characters</summary>
     public string? Text { get; set; }
 
-    /// <summary>Mode for parsing entities in the text. See <a href="https://core.telegram.org/bots/api#formatting-options">formatting options</a> for more details. Entities other than <see cref="MessageEntityType.Bold">Bold</see>, <see cref="MessageEntityType.Italic">Italic</see>, <see cref="MessageEntityType.Underline">Underline</see>, <see cref="MessageEntityType.Strikethrough">Strikethrough</see>, <see cref="MessageEntityType.Spoiler">Spoiler</see>, and <see cref="MessageEntityType.CustomEmoji">CustomEmoji</see> are ignored.</summary>
+    /// <summary>Mode for parsing entities in the text. See <a href="https://core.telegram.org/bots/api#formatting-options">formatting options</a> for more details. Entities other than <see cref="MessageEntityType.Bold">Bold</see>, <see cref="MessageEntityType.Italic">Italic</see>, <see cref="MessageEntityType.Underline">Underline</see>, <see cref="MessageEntityType.Strikethrough">Strikethrough</see>, <see cref="MessageEntityType.Spoiler">Spoiler</see>, <see cref="MessageEntityType.CustomEmoji">CustomEmoji</see>, and <see cref="MessageEntityType.DateTime">DateTime</see> are ignored.</summary>
     [JsonPropertyName("text_parse_mode")]
     public ParseMode TextParseMode { get; set; }
 
-    /// <summary>A list of special entities that appear in the gift text. It can be specified instead of <see cref="TextParseMode">TextParseMode</see>. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “CustomEmoji” are ignored.</summary>
+    /// <summary>A list of special entities that appear in the gift text. It can be specified instead of <see cref="TextParseMode">TextParseMode</see>. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, “CustomEmoji”, and “DateTime” are ignored.</summary>
     [JsonPropertyName("text_entities")]
     public IEnumerable<MessageEntity>? TextEntities { get; set; }
 }

src/Telegram.Bot/Requests/Sending Messages/SendPollRequest.cs

@@ -41,13 +41,29 @@ public partial class SendPollRequest() : RequestBase<Message>("sendPoll"), IChat
     /// <summary>Poll type, <see cref="PollType.Quiz">Quiz</see> or <see cref="PollType.Regular">Regular</see>, defaults to <see cref="PollType.Regular">Regular</see></summary>
     public PollType? Type { get; set; }
 
-    /// <summary><see langword="true"/>, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to <see langword="false"/></summary>
+    /// <summary>Pass <see langword="true"/>, if the poll allows multiple answers, defaults to <see langword="false"/></summary>
     [JsonPropertyName("allows_multiple_answers")]
     public bool AllowsMultipleAnswers { get; set; }
 
-    /// <summary>0-based identifier of the correct answer option, required for polls in quiz mode</summary>
-    [JsonPropertyName("correct_option_id")]
-    public int? CorrectOptionId { get; set; }
+    /// <summary>Pass <see langword="true"/>, if the poll allows to change chosen answer options, defaults to <see langword="false"/> for quizzes and to <see langword="true"/> for regular polls</summary>
+    [JsonPropertyName("allows_revoting")]
+    public bool AllowsRevoting { get; set; }
+
+    /// <summary>Pass <see langword="true"/>, if the poll options must be shown in random order</summary>
+    [JsonPropertyName("shuffle_options")]
+    public bool ShuffleOptions { get; set; }
+
+    /// <summary>Pass <see langword="true"/>, if answer options can be added to the poll after creation; not supported for anonymous polls and quizzes</summary>
+    [JsonPropertyName("allow_adding_options")]
+    public bool AllowAddingOptions { get; set; }
+
+    /// <summary>Pass <see langword="true"/>, if poll results must be shown only after the poll closes</summary>
+    [JsonPropertyName("hide_results_until_closes")]
+    public bool HideResultsUntilCloses { get; set; }
+
+    /// <summary>A list of monotonically increasing 0-based identifiers of the correct answer options, required for polls in quiz mode</summary>
+    [JsonPropertyName("correct_option_ids")]
+    public IEnumerable<int>? CorrectOptionIds { get; set; }
 
     /// <summary>Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters with at most 2 line feeds after entities parsing</summary>
     public string? Explanation { get; set; }
@@ -60,11 +76,11 @@ public partial class SendPollRequest() : RequestBase<Message>("sendPoll"), IChat
     [JsonPropertyName("explanation_entities")]
     public IEnumerable<MessageEntity>? ExplanationEntities { get; set; }
 
-    /// <summary>Amount of time in seconds the poll will be active after creation, 5-600. Can't be used together with <see cref="CloseDate">CloseDate</see>.</summary>
+    /// <summary>Amount of time in seconds the poll will be active after creation, 5-2628000. Can't be used together with <see cref="CloseDate">CloseDate</see>.</summary>
     [JsonPropertyName("open_period")]
     public int? OpenPeriod { get; set; }
 
-    /// <summary>Point in time when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can't be used together with <see cref="OpenPeriod">OpenPeriod</see>.</summary>
+    /// <summary>Point in time when the poll will be automatically closed. Must be at least 5 and no more than 2628000 seconds in the future. Can't be used together with <see cref="OpenPeriod">OpenPeriod</see>.</summary>
     [JsonPropertyName("close_date")]
     [JsonConverter(typeof(UnixDateTimeConverter))]
     public DateTime? CloseDate { get; set; }
@@ -73,6 +89,17 @@ public partial class SendPollRequest() : RequestBase<Message>("sendPoll"), IChat
     [JsonPropertyName("is_closed")]
     public bool IsClosed { get; set; }
 
+    /// <summary>Description of the poll to be sent, 0-1024 characters after entities parsing</summary>
+    public string? Description { get; set; }
+
+    /// <summary>Mode for parsing entities in the poll description. See <a href="https://core.telegram.org/bots/api#formatting-options">formatting options</a> for more details.</summary>
+    [JsonPropertyName("description_parse_mode")]
+    public ParseMode DescriptionParseMode { get; set; }
+
+    /// <summary>A list of special entities that appear in the poll description, which can be specified instead of <see cref="DescriptionParseMode">DescriptionParseMode</see></summary>
+    [JsonPropertyName("description_entities")]
+    public IEnumerable<MessageEntity>? DescriptionEntities { get; set; }
+
     /// <summary>Sends the message <a href="https://telegram.org/blog/channels-2-0#silent-messages">silently</a>. Users will receive a notification with no sound.</summary>
     [JsonPropertyName("disable_notification")]
     public bool DisableNotification { get; set; }

src/Telegram.Bot/Serialization/JsonBotSerializerContext.cs

@@ -86,6 +86,8 @@ namespace Telegram.Bot;
 [JsonSerializable(typeof(AnswerCallbackQueryRequest))]
 [JsonSerializable(typeof(GetUserChatBoostsRequest))]
 [JsonSerializable(typeof(GetBusinessConnectionRequest))]
+[JsonSerializable(typeof(GetManagedBotTokenRequest))]
+[JsonSerializable(typeof(ReplaceManagedBotTokenRequest))]
 [JsonSerializable(typeof(SetMyCommandsRequest))]
 [JsonSerializable(typeof(DeleteMyCommandsRequest))]
 [JsonSerializable(typeof(GetMyCommandsRequest))]
@@ -128,6 +130,9 @@ namespace Telegram.Bot;
 [JsonSerializable(typeof(RepostStoryRequest))]
 [JsonSerializable(typeof(EditStoryRequest))]
 [JsonSerializable(typeof(DeleteStoryRequest))]
+[JsonSerializable(typeof(AnswerWebAppQueryRequest))]
+[JsonSerializable(typeof(SavePreparedInlineMessageRequest))]
+[JsonSerializable(typeof(SavePreparedKeyboardButtonRequest))]
 [JsonSerializable(typeof(EditMessageTextRequest))]
 [JsonSerializable(typeof(EditInlineMessageTextRequest))]
 [JsonSerializable(typeof(EditMessageCaptionRequest))]
@@ -163,8 +168,6 @@ namespace Telegram.Bot;
 [JsonSerializable(typeof(SetCustomEmojiStickerSetThumbnailRequest))]
 [JsonSerializable(typeof(DeleteStickerSetRequest))]
 [JsonSerializable(typeof(AnswerInlineQueryRequest))]
-[JsonSerializable(typeof(AnswerWebAppQueryRequest))]
-[JsonSerializable(typeof(SavePreparedInlineMessageRequest))]
 [JsonSerializable(typeof(SendInvoiceRequest))]
 [JsonSerializable(typeof(CreateInvoiceLinkRequest))]
 [JsonSerializable(typeof(AnswerShippingQueryRequest))]
@@ -211,10 +214,11 @@ namespace Telegram.Bot;
 [JsonSerializable(typeof(ApiResponse<StarAmount>))]
 [JsonSerializable(typeof(ApiResponse<OwnedGifts>))]
 [JsonSerializable(typeof(ApiResponse<Story>))]
-[JsonSerializable(typeof(ApiResponse<Poll>))]
-[JsonSerializable(typeof(ApiResponse<StickerSet>))]
 [JsonSerializable(typeof(ApiResponse<SentWebAppMessage>))]
 [JsonSerializable(typeof(ApiResponse<PreparedInlineMessage>))]
+[JsonSerializable(typeof(ApiResponse<PreparedKeyboardButton>))]
+[JsonSerializable(typeof(ApiResponse<Poll>))]
+[JsonSerializable(typeof(ApiResponse<StickerSet>))]
 [JsonSerializable(typeof(ApiResponse<StarTransactions>))]
 [JsonSerializable(typeof(ApiResponse<GameHighScore[]>))]
 [JsonSerializable(typeof(MessageOriginUser))]