From 4733159753a902ac2d04c4329fa8ba6b7c70e3a2 Mon Sep 17 00:00:00 2001
From: Ayrat Hudaygulov <szer.penguin@gmail.com>
Date: Wed, 15 Jul 2026 17:27:33 +0100
Subject: [PATCH 1/2] Fix DU case selection for tag-discriminated unions
 (ChatMember et al.)

DiscriminatedUnionConverter picked union cases by field-shape overlap,
ignoring the discriminator value Telegram actually uses. Shape matching
cannot be correct for ChatMember: ChatMemberLeft and ChatMemberMember are
shape-identical on the wire, and the first shape-superset won, so
{"status":"member"} parsed as Owner, {"status":"left"} as Owner, and
{"status":"kicked"} as Member. Re-serializing a misdiscriminated value
also invented fields that were never on the wire (is_anonymous).

Fix:
- New Funogram.Types.TelegramTagAttribute(field, value) marks a generated
  record as a tag-discriminated union payload (the Bot API documents the
  fixed value as `always "X"` on the field).
- The converter captures top-level string property values while shape-
  reading and selects the case whose tag matches the JSON value; unions
  without tags (and unknown future tag values) fall back to the previous
  shape-based resolution, so behavior is strictly corrected, never
  narrowed.
- The generator parses `always "X"` from required string field
  descriptions and emits the attribute; the checked-in generated Types.fs
  is updated accordingly (91 subtypes across ChatMember, MessageOrigin,
  ReactionType, PaidMedia, ChatBoostSource, BackgroundType/Fill,
  StoryAreaType, OwnedGift, RichText, PageBlock, ...).

Tests: all six ChatMember statuses now parse to the right case (three
failed before), round-trip no longer invents fields, unknown future
statuses still parse (forward compat), and MessageOrigin/ReactionType
keep working.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RrGX1qGPj7jLo1jgotgLKU
---
 .../Types/TypesGenerator.fs                   |  22 ++-
 src/Funogram.Telegram/Types.fs                | 182 +++++++++---------
 src/Funogram.Tests/Funogram.Tests.fsproj      |   1 +
 src/Funogram.Tests/UnionDiscriminators.fs     |  96 +++++++++
 src/Funogram/Converters.fs                    |  84 ++++++--
 src/Funogram/Types.fs                         |  12 ++
 6 files changed, 284 insertions(+), 113 deletions(-)
 create mode 100644 src/Funogram.Tests/UnionDiscriminators.fs

diff --git a/src/Funogram.Generator/Types/TypesGenerator.fs b/src/Funogram.Generator/Types/TypesGenerator.fs
index e496c54..dd539e9 100644
--- a/src/Funogram.Generator/Types/TypesGenerator.fs
+++ b/src/Funogram.Generator/Types/TypesGenerator.fs
@@ -163,9 +163,29 @@ let private generateFieldsCreateMember tp (fields: ApiTypeField[]) code =
   |> Code.setIndent 2
   |> Code.printNewLine "}"
 
+// Subtypes of tag-discriminated unions (ChatMember, MessageOrigin, ReactionType, ...)
+// document their fixed discriminator as `always "X"` on a required string field.
+// Emit it as a TelegramTag attribute so the union converter can select the case by
+// the discriminator value (shape-identical subtypes like ChatMemberLeft vs
+// ChatMemberMember cannot be discriminated any other way).
+let private discriminatorRegex =
+  System.Text.RegularExpressions.Regex("""always [“"]([A-Za-z0-9_]+)[”"]""",
+                                       System.Text.RegularExpressions.RegexOptions.Compiled)
+
+let private discriminatorTag (fields: ApiTypeField[]) =
+  fields
+  |> Array.tryPick (fun f ->
+    if f.IsOptional || f.ConvertedFieldType <> "string" then None
+    else
+      let m = discriminatorRegex.Match f.Description
+      if m.Success then Some (f.OriginalName, m.Groups[1].Value) else None)
+
 let private attributesForType tp =
   match tp.Kind with
-  | ApiTypeKind.Fields _ -> " [<CLIMutable>]"
+  | ApiTypeKind.Fields fields ->
+    match discriminatorTag fields with
+    | Some (field, value) -> sprintf " [<CLIMutable; Funogram.Types.TelegramTag(\"%s\", \"%s\")>]" field value
+    | None -> " [<CLIMutable>]"
   | _ -> ""
 
 let generate config =
diff --git a/src/Funogram.Telegram/Types.fs b/src/Funogram.Telegram/Types.fs
index 74d0f29..a37c55e 100644
--- a/src/Funogram.Telegram/Types.fs
+++ b/src/Funogram.Telegram/Types.fs
@@ -1305,7 +1305,7 @@ and MessageOrigin =
   | Channel of MessageOriginChannel
 
 /// The message was originally sent by a known user.
-and [<CLIMutable>] MessageOriginUser =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "user")>] MessageOriginUser =
   {
     /// Type of the message origin, always “user”
     [<DataMember(Name = "type")>]
@@ -1325,7 +1325,7 @@ and [<CLIMutable>] MessageOriginUser =
     }
 
 /// The message was originally sent by an unknown user.
-and [<CLIMutable>] MessageOriginHiddenUser =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "hidden_user")>] MessageOriginHiddenUser =
   {
     /// Type of the message origin, always “hidden_user”
     [<DataMember(Name = "type")>]
@@ -1345,7 +1345,7 @@ and [<CLIMutable>] MessageOriginHiddenUser =
     }
 
 /// The message was originally sent on behalf of a chat to a group chat.
-and [<CLIMutable>] MessageOriginChat =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "chat")>] MessageOriginChat =
   {
     /// Type of the message origin, always “chat”
     [<DataMember(Name = "type")>]
@@ -1369,7 +1369,7 @@ and [<CLIMutable>] MessageOriginChat =
     }
 
 /// The message was originally sent to a channel chat.
-and [<CLIMutable>] MessageOriginChannel =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "channel")>] MessageOriginChannel =
   {
     /// Type of the message origin, always “channel”
     [<DataMember(Name = "type")>]
@@ -1772,7 +1772,7 @@ and PaidMedia =
   | Video of PaidMediaVideo
 
 /// The paid media is a live photo.
-and [<CLIMutable>] PaidMediaLivePhoto =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "live_photo")>] PaidMediaLivePhoto =
   {
     /// Type of the paid media, always “live_photo”
     [<DataMember(Name = "type")>]
@@ -1788,7 +1788,7 @@ and [<CLIMutable>] PaidMediaLivePhoto =
     }
 
 /// The paid media is a photo.
-and [<CLIMutable>] PaidMediaPhoto =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "photo")>] PaidMediaPhoto =
   {
     /// Type of the paid media, always “photo”
     [<DataMember(Name = "type")>]
@@ -1804,7 +1804,7 @@ and [<CLIMutable>] PaidMediaPhoto =
     }
 
 /// The paid media isn't available before the payment.
-and [<CLIMutable>] PaidMediaPreview =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "preview")>] PaidMediaPreview =
   {
     /// Type of the paid media, always “preview”
     [<DataMember(Name = "type")>]
@@ -1828,7 +1828,7 @@ and [<CLIMutable>] PaidMediaPreview =
     }
 
 /// The paid media is a video.
-and [<CLIMutable>] PaidMediaVideo =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "video")>] PaidMediaVideo =
   {
     /// Type of the paid media, always “video”
     [<DataMember(Name = "type")>]
@@ -2516,7 +2516,7 @@ and BackgroundFill =
   | FreeformGradient of BackgroundFillFreeformGradient
 
 /// The background is filled using the selected color.
-and [<CLIMutable>] BackgroundFillSolid =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "solid")>] BackgroundFillSolid =
   {
     /// Type of the background fill, always “solid”
     [<DataMember(Name = "type")>]
@@ -2532,7 +2532,7 @@ and [<CLIMutable>] BackgroundFillSolid =
     }
 
 /// The background is a gradient fill.
-and [<CLIMutable>] BackgroundFillGradient =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "gradient")>] BackgroundFillGradient =
   {
     /// Type of the background fill, always “gradient”
     [<DataMember(Name = "type")>]
@@ -2556,7 +2556,7 @@ and [<CLIMutable>] BackgroundFillGradient =
     }
 
 /// The background is a freeform gradient that rotates after every message in the chat.
-and [<CLIMutable>] BackgroundFillFreeformGradient =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "freeform_gradient")>] BackgroundFillFreeformGradient =
   {
     /// Type of the background fill, always “freeform_gradient”
     [<DataMember(Name = "type")>]
@@ -2579,7 +2579,7 @@ and BackgroundType =
   | ChatTheme of BackgroundTypeChatTheme
 
 /// The background is automatically filled based on the selected colors.
-and [<CLIMutable>] BackgroundTypeFill =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "fill")>] BackgroundTypeFill =
   {
     /// Type of the background, always “fill”
     [<DataMember(Name = "type")>]
@@ -2599,7 +2599,7 @@ and [<CLIMutable>] BackgroundTypeFill =
     }
 
 /// The background is a wallpaper in the JPEG format.
-and [<CLIMutable>] BackgroundTypeWallpaper =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "wallpaper")>] BackgroundTypeWallpaper =
   {
     /// Type of the background, always “wallpaper”
     [<DataMember(Name = "type")>]
@@ -2627,7 +2627,7 @@ and [<CLIMutable>] BackgroundTypeWallpaper =
     }
 
 /// The background is a .PNG or .TGV (gzipped subset of SVG with MIME type “application/x-tgwallpattern”) pattern to be combined with the background fill chosen by the user.
-and [<CLIMutable>] BackgroundTypePattern =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "pattern")>] BackgroundTypePattern =
   {
     /// Type of the background, always “pattern”
     [<DataMember(Name = "type")>]
@@ -2659,7 +2659,7 @@ and [<CLIMutable>] BackgroundTypePattern =
     }
 
 /// The background is taken directly from a built-in chat theme.
-and [<CLIMutable>] BackgroundTypeChatTheme =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "chat_theme")>] BackgroundTypeChatTheme =
   {
     /// Type of the background, always “chat_theme”
     [<DataMember(Name = "type")>]
@@ -3933,7 +3933,7 @@ and ChatMember =
   | Banned of ChatMemberBanned
 
 /// Represents a chat member that owns the chat and has all administrator privileges.
-and [<CLIMutable>] ChatMemberOwner =
+and [<CLIMutable; Funogram.Types.TelegramTag("status", "creator")>] ChatMemberOwner =
   {
     /// The member's status in the chat, always “creator”
     [<DataMember(Name = "status")>]
@@ -3957,7 +3957,7 @@ and [<CLIMutable>] ChatMemberOwner =
     }
 
 /// Represents a chat member that has some additional privileges.
-and [<CLIMutable>] ChatMemberAdministrator =
+and [<CLIMutable; Funogram.Types.TelegramTag("status", "administrator")>] ChatMemberAdministrator =
   {
     /// The member's status in the chat, always “administrator”
     [<DataMember(Name = "status")>]
@@ -4053,7 +4053,7 @@ and [<CLIMutable>] ChatMemberAdministrator =
     }
 
 /// Represents a chat member that has no additional privileges or restrictions.
-and [<CLIMutable>] ChatMemberMember =
+and [<CLIMutable; Funogram.Types.TelegramTag("status", "member")>] ChatMemberMember =
   {
     /// The member's status in the chat, always “member”
     [<DataMember(Name = "status")>]
@@ -4077,7 +4077,7 @@ and [<CLIMutable>] ChatMemberMember =
     }
 
 /// Represents a chat member that is under certain restrictions in the chat. Supergroups only.
-and [<CLIMutable>] ChatMemberRestricted =
+and [<CLIMutable; Funogram.Types.TelegramTag("status", "restricted")>] ChatMemberRestricted =
   {
     /// The member's status in the chat, always “restricted”
     [<DataMember(Name = "status")>]
@@ -4169,7 +4169,7 @@ and [<CLIMutable>] ChatMemberRestricted =
     }
 
 /// Represents a chat member that isn't currently a member of the chat, but may join it themselves.
-and [<CLIMutable>] ChatMemberLeft =
+and [<CLIMutable; Funogram.Types.TelegramTag("status", "left")>] ChatMemberLeft =
   {
     /// The member's status in the chat, always “left”
     [<DataMember(Name = "status")>]
@@ -4185,7 +4185,7 @@ and [<CLIMutable>] ChatMemberLeft =
     }
 
 /// Represents a chat member that was banned in the chat and can't return to the chat or view chat messages.
-and [<CLIMutable>] ChatMemberBanned =
+and [<CLIMutable; Funogram.Types.TelegramTag("status", "kicked")>] ChatMemberBanned =
   {
     /// The member's status in the chat, always “kicked”
     [<DataMember(Name = "status")>]
@@ -4489,7 +4489,7 @@ and StoryAreaType =
   | UniqueGift of StoryAreaTypeUniqueGift
 
 /// Describes a story area pointing to a location. Currently, a story can have up to 10 location areas.
-and [<CLIMutable>] StoryAreaTypeLocation =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "location")>] StoryAreaTypeLocation =
   {
     /// Type of the area, always “location”
     [<DataMember(Name = "type")>]
@@ -4513,7 +4513,7 @@ and [<CLIMutable>] StoryAreaTypeLocation =
     }
 
 /// Describes a story area pointing to a suggested reaction. Currently, a story can have up to 5 suggested reaction areas.
-and [<CLIMutable>] StoryAreaTypeSuggestedReaction =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "suggested_reaction")>] StoryAreaTypeSuggestedReaction =
   {
     /// Type of the area, always “suggested_reaction”
     [<DataMember(Name = "type")>]
@@ -4537,7 +4537,7 @@ and [<CLIMutable>] StoryAreaTypeSuggestedReaction =
     }
 
 /// Describes a story area pointing to an HTTP or tg:// link. Currently, a story can have up to 3 link areas.
-and [<CLIMutable>] StoryAreaTypeLink =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "link")>] StoryAreaTypeLink =
   {
     /// Type of the area, always “link”
     [<DataMember(Name = "type")>]
@@ -4553,7 +4553,7 @@ and [<CLIMutable>] StoryAreaTypeLink =
     }
 
 /// Describes a story area containing weather information. Currently, a story can have up to 3 weather areas.
-and [<CLIMutable>] StoryAreaTypeWeather =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "weather")>] StoryAreaTypeWeather =
   {
     /// Type of the area, always “weather”
     [<DataMember(Name = "type")>]
@@ -4577,7 +4577,7 @@ and [<CLIMutable>] StoryAreaTypeWeather =
     }
 
 /// Describes a story area pointing to a unique gift. Currently, a story can have at most 1 unique gift area.
-and [<CLIMutable>] StoryAreaTypeUniqueGift =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "unique_gift")>] StoryAreaTypeUniqueGift =
   {
     /// Type of the area, always “unique_gift”
     [<DataMember(Name = "type")>]
@@ -4631,7 +4631,7 @@ and ReactionType =
   | Paid of ReactionTypePaid
 
 /// The reaction is based on an emoji.
-and [<CLIMutable>] ReactionTypeEmoji =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "emoji")>] ReactionTypeEmoji =
   {
     /// Type of the reaction, always “emoji”
     [<DataMember(Name = "type")>]
@@ -4647,7 +4647,7 @@ and [<CLIMutable>] ReactionTypeEmoji =
     }
 
 /// The reaction is based on a custom emoji.
-and [<CLIMutable>] ReactionTypeCustomEmoji =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "custom_emoji")>] ReactionTypeCustomEmoji =
   {
     /// Type of the reaction, always “custom_emoji”
     [<DataMember(Name = "type")>]
@@ -4663,7 +4663,7 @@ and [<CLIMutable>] ReactionTypeCustomEmoji =
     }
 
 /// The reaction is paid.
-and [<CLIMutable>] ReactionTypePaid =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "paid")>] ReactionTypePaid =
   {
     /// Type of the reaction, always “paid”
     [<DataMember(Name = "type")>]
@@ -5136,7 +5136,7 @@ and OwnedGift =
   | Unique of OwnedGiftUnique
 
 /// Describes a regular gift owned by a user or a chat.
-and [<CLIMutable>] OwnedGiftRegular =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "regular")>] OwnedGiftRegular =
   {
     /// Type of the gift, always “regular”
     [<DataMember(Name = "type")>]
@@ -5204,7 +5204,7 @@ and [<CLIMutable>] OwnedGiftRegular =
     }
 
 /// Describes a unique gift received and owned by a user or a chat.
-and [<CLIMutable>] OwnedGiftUnique =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "unique")>] OwnedGiftUnique =
   {
     /// Type of the gift, always “unique”
     [<DataMember(Name = "type")>]
@@ -5547,7 +5547,7 @@ and ChatBoostSource =
   | Giveaway of ChatBoostSourceGiveaway
 
 /// The boost was obtained by subscribing to Telegram Premium or by gifting a Telegram Premium subscription to another user.
-and [<CLIMutable>] ChatBoostSourcePremium =
+and [<CLIMutable; Funogram.Types.TelegramTag("source", "premium")>] ChatBoostSourcePremium =
   {
     /// Source of the boost, always “premium”
     [<DataMember(Name = "source")>]
@@ -5563,7 +5563,7 @@ and [<CLIMutable>] ChatBoostSourcePremium =
     }
 
 /// The boost was obtained by the creation of Telegram Premium gift codes to boost a chat. Each such code boosts the chat 4 times for the duration of the corresponding Telegram Premium subscription.
-and [<CLIMutable>] ChatBoostSourceGiftCode =
+and [<CLIMutable; Funogram.Types.TelegramTag("source", "gift_code")>] ChatBoostSourceGiftCode =
   {
     /// Source of the boost, always “gift_code”
     [<DataMember(Name = "source")>]
@@ -5579,7 +5579,7 @@ and [<CLIMutable>] ChatBoostSourceGiftCode =
     }
 
 /// The boost was obtained by the creation of a Telegram Premium or a Telegram Star giveaway. This boosts the chat 4 times for the duration of the corresponding Telegram Premium subscription for Telegram Premium giveaways and prize_star_count / 500 times for one year for Telegram Star giveaways.
-and [<CLIMutable>] ChatBoostSourceGiveaway =
+and [<CLIMutable; Funogram.Types.TelegramTag("source", "giveaway")>] ChatBoostSourceGiveaway =
   {
     /// Source of the boost, always “giveaway”
     [<DataMember(Name = "source")>]
@@ -6670,7 +6670,7 @@ and RichText =
   | ArrayOf of RichText array
 
 /// A bold text.
-and [<CLIMutable>] RichTextBold =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "bold")>] RichTextBold =
   {
     /// Type of the rich text, always “bold”
     [<DataMember(Name = "type")>]
@@ -6686,7 +6686,7 @@ and [<CLIMutable>] RichTextBold =
     }
 
 /// An italicized text.
-and [<CLIMutable>] RichTextItalic =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "italic")>] RichTextItalic =
   {
     /// Type of the rich text, always “italic”
     [<DataMember(Name = "type")>]
@@ -6702,7 +6702,7 @@ and [<CLIMutable>] RichTextItalic =
     }
 
 /// An underlined text.
-and [<CLIMutable>] RichTextUnderline =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "underline")>] RichTextUnderline =
   {
     /// Type of the rich text, always “underline”
     [<DataMember(Name = "type")>]
@@ -6718,7 +6718,7 @@ and [<CLIMutable>] RichTextUnderline =
     }
 
 /// A strikethrough text.
-and [<CLIMutable>] RichTextStrikethrough =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "strikethrough")>] RichTextStrikethrough =
   {
     /// Type of the rich text, always “strikethrough”
     [<DataMember(Name = "type")>]
@@ -6734,7 +6734,7 @@ and [<CLIMutable>] RichTextStrikethrough =
     }
 
 /// A text covered by a spoiler.
-and [<CLIMutable>] RichTextSpoiler =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "spoiler")>] RichTextSpoiler =
   {
     /// Type of the rich text, always “spoiler”
     [<DataMember(Name = "type")>]
@@ -6750,7 +6750,7 @@ and [<CLIMutable>] RichTextSpoiler =
     }
 
 /// Formatted date and time.
-and [<CLIMutable>] RichTextDateTime =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "date_time")>] RichTextDateTime =
   {
     /// Type of the rich text, always “date_time”
     [<DataMember(Name = "type")>]
@@ -6774,7 +6774,7 @@ and [<CLIMutable>] RichTextDateTime =
     }
 
 /// A mention of a Telegram user by their identifier.
-and [<CLIMutable>] RichTextTextMention =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "text_mention")>] RichTextTextMention =
   {
     /// Type of the rich text, always “text_mention”
     [<DataMember(Name = "type")>]
@@ -6794,7 +6794,7 @@ and [<CLIMutable>] RichTextTextMention =
     }
 
 /// A subscript text.
-and [<CLIMutable>] RichTextSubscript =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "subscript")>] RichTextSubscript =
   {
     /// Type of the rich text, always “subscript”
     [<DataMember(Name = "type")>]
@@ -6810,7 +6810,7 @@ and [<CLIMutable>] RichTextSubscript =
     }
 
 /// A superscript text.
-and [<CLIMutable>] RichTextSuperscript =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "superscript")>] RichTextSuperscript =
   {
     /// Type of the rich text, always “superscript”
     [<DataMember(Name = "type")>]
@@ -6826,7 +6826,7 @@ and [<CLIMutable>] RichTextSuperscript =
     }
 
 /// A marked text.
-and [<CLIMutable>] RichTextMarked =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "marked")>] RichTextMarked =
   {
     /// Type of the rich text, always “marked”
     [<DataMember(Name = "type")>]
@@ -6842,7 +6842,7 @@ and [<CLIMutable>] RichTextMarked =
     }
 
 /// A monowidth text.
-and [<CLIMutable>] RichTextCode =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "code")>] RichTextCode =
   {
     /// Type of the rich text, always “code”
     [<DataMember(Name = "type")>]
@@ -6858,7 +6858,7 @@ and [<CLIMutable>] RichTextCode =
     }
 
 /// A custom emoji.
-and [<CLIMutable>] RichTextCustomEmoji =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "custom_emoji")>] RichTextCustomEmoji =
   {
     /// Type of the rich text, always “custom_emoji”
     [<DataMember(Name = "type")>]
@@ -6878,7 +6878,7 @@ and [<CLIMutable>] RichTextCustomEmoji =
     }
 
 /// A mathematical expression.
-and [<CLIMutable>] RichTextMathematicalExpression =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "mathematical_expression")>] RichTextMathematicalExpression =
   {
     /// Type of the rich text, always “mathematical_expression”
     [<DataMember(Name = "type")>]
@@ -6894,7 +6894,7 @@ and [<CLIMutable>] RichTextMathematicalExpression =
     }
 
 /// A text with a link.
-and [<CLIMutable>] RichTextUrl =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "url")>] RichTextUrl =
   {
     /// Type of the rich text, always “url”
     [<DataMember(Name = "type")>]
@@ -6914,7 +6914,7 @@ and [<CLIMutable>] RichTextUrl =
     }
 
 /// A text with an email address.
-and [<CLIMutable>] RichTextEmailAddress =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "email_address")>] RichTextEmailAddress =
   {
     /// Type of the rich text, always “email_address”
     [<DataMember(Name = "type")>]
@@ -6934,7 +6934,7 @@ and [<CLIMutable>] RichTextEmailAddress =
     }
 
 /// A text with a phone number.
-and [<CLIMutable>] RichTextPhoneNumber =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "phone_number")>] RichTextPhoneNumber =
   {
     /// Type of the rich text, always “phone_number”
     [<DataMember(Name = "type")>]
@@ -6954,7 +6954,7 @@ and [<CLIMutable>] RichTextPhoneNumber =
     }
 
 /// A text with a bank card number.
-and [<CLIMutable>] RichTextBankCardNumber =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "bank_card_number")>] RichTextBankCardNumber =
   {
     /// Type of the rich text, always “bank_card_number”
     [<DataMember(Name = "type")>]
@@ -6974,7 +6974,7 @@ and [<CLIMutable>] RichTextBankCardNumber =
     }
 
 /// A mention by a username.
-and [<CLIMutable>] RichTextMention =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "mention")>] RichTextMention =
   {
     /// Type of the rich text, always “mention”
     [<DataMember(Name = "type")>]
@@ -6994,7 +6994,7 @@ and [<CLIMutable>] RichTextMention =
     }
 
 /// A hashtag.
-and [<CLIMutable>] RichTextHashtag =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "hashtag")>] RichTextHashtag =
   {
     /// Type of the rich text, always “hashtag”
     [<DataMember(Name = "type")>]
@@ -7014,7 +7014,7 @@ and [<CLIMutable>] RichTextHashtag =
     }
 
 /// A cashtag.
-and [<CLIMutable>] RichTextCashtag =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "cashtag")>] RichTextCashtag =
   {
     /// Type of the rich text, always “cashtag”
     [<DataMember(Name = "type")>]
@@ -7034,7 +7034,7 @@ and [<CLIMutable>] RichTextCashtag =
     }
 
 /// A bot command.
-and [<CLIMutable>] RichTextBotCommand =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "bot_command")>] RichTextBotCommand =
   {
     /// Type of the rich text, always “bot_command”
     [<DataMember(Name = "type")>]
@@ -7054,7 +7054,7 @@ and [<CLIMutable>] RichTextBotCommand =
     }
 
 /// An anchor.
-and [<CLIMutable>] RichTextAnchor =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "anchor")>] RichTextAnchor =
   {
     /// Type of the rich text, always “anchor”
     [<DataMember(Name = "type")>]
@@ -7070,7 +7070,7 @@ and [<CLIMutable>] RichTextAnchor =
     }
 
 /// A link to an anchor.
-and [<CLIMutable>] RichTextAnchorLink =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "anchor_link")>] RichTextAnchorLink =
   {
     /// Type of the rich text, always “anchor_link”
     [<DataMember(Name = "type")>]
@@ -7090,7 +7090,7 @@ and [<CLIMutable>] RichTextAnchorLink =
     }
 
 /// A reference.
-and [<CLIMutable>] RichTextReference =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "reference")>] RichTextReference =
   {
     /// Type of the rich text, always “reference”
     [<DataMember(Name = "type")>]
@@ -7110,7 +7110,7 @@ and [<CLIMutable>] RichTextReference =
     }
 
 /// A link to a reference.
-and [<CLIMutable>] RichTextReferenceLink =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "reference_link")>] RichTextReferenceLink =
   {
     /// Type of the rich text, always “reference_link”
     [<DataMember(Name = "type")>]
@@ -7234,7 +7234,7 @@ and RichBlock =
   | Thinking of RichBlockThinking
 
 /// A text paragraph, corresponding to the HTML tag <p>.
-and [<CLIMutable>] RichBlockParagraph =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "paragraph")>] RichBlockParagraph =
   {
     /// Type of the block, always “paragraph”
     [<DataMember(Name = "type")>]
@@ -7250,7 +7250,7 @@ and [<CLIMutable>] RichBlockParagraph =
     }
 
 /// A section heading, corresponding to the HTML tags <h1>, <h2>, <h3>, <h4>, <h5>, or <h6>.
-and [<CLIMutable>] RichBlockSectionHeading =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "heading")>] RichBlockSectionHeading =
   {
     /// Type of the block, always “heading”
     [<DataMember(Name = "type")>]
@@ -7270,7 +7270,7 @@ and [<CLIMutable>] RichBlockSectionHeading =
     }
 
 /// A preformatted text block, corresponding to the nested HTML tags <pre> and <code>.
-and [<CLIMutable>] RichBlockPreformatted =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "pre")>] RichBlockPreformatted =
   {
     /// Type of the block, always “pre”
     [<DataMember(Name = "type")>]
@@ -7290,7 +7290,7 @@ and [<CLIMutable>] RichBlockPreformatted =
     }
 
 /// A footer, corresponding to the HTML tag <footer>.
-and [<CLIMutable>] RichBlockFooter =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "footer")>] RichBlockFooter =
   {
     /// Type of the block, always “footer”
     [<DataMember(Name = "type")>]
@@ -7306,7 +7306,7 @@ and [<CLIMutable>] RichBlockFooter =
     }
 
 /// A divider, corresponding to the HTML tag <hr/>.
-and [<CLIMutable>] RichBlockDivider =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "divider")>] RichBlockDivider =
   {
     /// Type of the block, always “divider”
     [<DataMember(Name = "type")>]
@@ -7318,7 +7318,7 @@ and [<CLIMutable>] RichBlockDivider =
     }
 
 /// A block with a mathematical expression in LaTeX format, corresponding to the custom HTML tag <tg-math-block>.
-and [<CLIMutable>] RichBlockMathematicalExpression =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "mathematical_expression")>] RichBlockMathematicalExpression =
   {
     /// Type of the block, always “mathematical_expression”
     [<DataMember(Name = "type")>]
@@ -7334,7 +7334,7 @@ and [<CLIMutable>] RichBlockMathematicalExpression =
     }
 
 /// A block with an anchor, corresponding to the HTML tag <a> with the attribute name.
-and [<CLIMutable>] RichBlockAnchor =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "anchor")>] RichBlockAnchor =
   {
     /// Type of the block, always “anchor”
     [<DataMember(Name = "type")>]
@@ -7350,7 +7350,7 @@ and [<CLIMutable>] RichBlockAnchor =
     }
 
 /// A list of blocks, corresponding to the HTML tag <ul> or <ol> with multiple nested tags <li>.
-and [<CLIMutable>] RichBlockList =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "list")>] RichBlockList =
   {
     /// Type of the block, always “list”
     [<DataMember(Name = "type")>]
@@ -7366,7 +7366,7 @@ and [<CLIMutable>] RichBlockList =
     }
 
 /// A block quotation, corresponding to the HTML tag <blockquote>.
-and [<CLIMutable>] RichBlockBlockQuotation =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "blockquote")>] RichBlockBlockQuotation =
   {
     /// Type of the block, always “blockquote”
     [<DataMember(Name = "type")>]
@@ -7386,7 +7386,7 @@ and [<CLIMutable>] RichBlockBlockQuotation =
     }
 
 /// A quotation with centered text, loosely corresponding to the HTML tag <aside>.
-and [<CLIMutable>] RichBlockPullQuotation =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "pullquote")>] RichBlockPullQuotation =
   {
     /// Type of the block, always “pullquote”
     [<DataMember(Name = "type")>]
@@ -7406,7 +7406,7 @@ and [<CLIMutable>] RichBlockPullQuotation =
     }
 
 /// A collage, corresponding to the custom HTML tag <tg-collage>.
-and [<CLIMutable>] RichBlockCollage =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "collage")>] RichBlockCollage =
   {
     /// Type of the block, always “collage”
     [<DataMember(Name = "type")>]
@@ -7426,7 +7426,7 @@ and [<CLIMutable>] RichBlockCollage =
     }
 
 /// A slideshow, corresponding to the custom HTML tag <tg-slideshow>.
-and [<CLIMutable>] RichBlockSlideshow =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "slideshow")>] RichBlockSlideshow =
   {
     /// Type of the block, always “slideshow”
     [<DataMember(Name = "type")>]
@@ -7446,7 +7446,7 @@ and [<CLIMutable>] RichBlockSlideshow =
     }
 
 /// A table, corresponding to the HTML tag <table>.
-and [<CLIMutable>] RichBlockTable =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "table")>] RichBlockTable =
   {
     /// Type of the block, always “table”
     [<DataMember(Name = "type")>]
@@ -7474,7 +7474,7 @@ and [<CLIMutable>] RichBlockTable =
     }
 
 /// An expandable block for details disclosure, corresponding to the HTML tag <details>.
-and [<CLIMutable>] RichBlockDetails =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "details")>] RichBlockDetails =
   {
     /// Type of the block, always “details”
     [<DataMember(Name = "type")>]
@@ -7498,7 +7498,7 @@ and [<CLIMutable>] RichBlockDetails =
     }
 
 /// A block with a map, corresponding to the custom HTML tag <tg-map>.
-and [<CLIMutable>] RichBlockMap =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "map")>] RichBlockMap =
   {
     /// Type of the block, always “map”
     [<DataMember(Name = "type")>]
@@ -7530,7 +7530,7 @@ and [<CLIMutable>] RichBlockMap =
     }
 
 /// A block with an animation, corresponding to the HTML tag <video>.
-and [<CLIMutable>] RichBlockAnimation =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "animation")>] RichBlockAnimation =
   {
     /// Type of the block, always “animation”
     [<DataMember(Name = "type")>]
@@ -7554,7 +7554,7 @@ and [<CLIMutable>] RichBlockAnimation =
     }
 
 /// A block with a music file, corresponding to the HTML tag <audio>.
-and [<CLIMutable>] RichBlockAudio =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "audio")>] RichBlockAudio =
   {
     /// Type of the block, always “audio”
     [<DataMember(Name = "type")>]
@@ -7574,7 +7574,7 @@ and [<CLIMutable>] RichBlockAudio =
     }
 
 /// A block with a photo, corresponding to the HTML tag <photo>.
-and [<CLIMutable>] RichBlockPhoto =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "photo")>] RichBlockPhoto =
   {
     /// Type of the block, always “photo”
     [<DataMember(Name = "type")>]
@@ -7598,7 +7598,7 @@ and [<CLIMutable>] RichBlockPhoto =
     }
 
 /// A block with a video, corresponding to the HTML tag <video>.
-and [<CLIMutable>] RichBlockVideo =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "video")>] RichBlockVideo =
   {
     /// Type of the block, always “video”
     [<DataMember(Name = "type")>]
@@ -7622,7 +7622,7 @@ and [<CLIMutable>] RichBlockVideo =
     }
 
 /// A block with a voice note, corresponding to the HTML tag <audio>.
-and [<CLIMutable>] RichBlockVoiceNote =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "voice_note")>] RichBlockVoiceNote =
   {
     /// Type of the block, always “voice_note”
     [<DataMember(Name = "type")>]
@@ -7645,7 +7645,7 @@ and [<CLIMutable>] RichBlockVoiceNote =
 /// The following methods and objects allow your bot to work in inline mode.
 /// Please see our Introduction to Inline bots for more details.
 /// To enable this option, send the /setinline command to @BotFather and provide the placeholder text that the user will see in the input field after typing your bot's name.
-and [<CLIMutable>] RichBlockThinking =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "thinking")>] RichBlockThinking =
   {
     /// Type of the block, always “thinking”
     [<DataMember(Name = "type")>]
@@ -9218,7 +9218,7 @@ and [<CLIMutable>] SuccessfulPayment =
     }
 
 /// This object contains basic information about a refunded payment.
-and [<CLIMutable>] RefundedPayment =
+and [<CLIMutable; Funogram.Types.TelegramTag("currency", "XTR")>] RefundedPayment =
   {
     /// Three-letter ISO 4217 currency code, or “XTR” for payments in Telegram Stars. Currently, always “XTR”.
     [<DataMember(Name = "currency")>]
@@ -9328,7 +9328,7 @@ and RevenueWithdrawalState =
   | Failed of RevenueWithdrawalStateFailed
 
 /// The withdrawal is in progress.
-and [<CLIMutable>] RevenueWithdrawalStatePending =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "pending")>] RevenueWithdrawalStatePending =
   {
     /// Type of the state, always “pending”
     [<DataMember(Name = "type")>]
@@ -9340,7 +9340,7 @@ and [<CLIMutable>] RevenueWithdrawalStatePending =
     }
 
 /// The withdrawal succeeded.
-and [<CLIMutable>] RevenueWithdrawalStateSucceeded =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "succeeded")>] RevenueWithdrawalStateSucceeded =
   {
     /// Type of the state, always “succeeded”
     [<DataMember(Name = "type")>]
@@ -9360,7 +9360,7 @@ and [<CLIMutable>] RevenueWithdrawalStateSucceeded =
     }
 
 /// The withdrawal failed and the transaction was refunded.
-and [<CLIMutable>] RevenueWithdrawalStateFailed =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "failed")>] RevenueWithdrawalStateFailed =
   {
     /// Type of the state, always “failed”
     [<DataMember(Name = "type")>]
@@ -9410,7 +9410,7 @@ and TransactionPartner =
   | Other of TransactionPartnerOther
 
 /// Describes a transaction with a user.
-and [<CLIMutable>] TransactionPartnerUser =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "user")>] TransactionPartnerUser =
   {
     /// Type of the transaction partner, always “user”
     [<DataMember(Name = "type")>]
@@ -9458,7 +9458,7 @@ and [<CLIMutable>] TransactionPartnerUser =
     }
 
 /// Describes a transaction with a chat.
-and [<CLIMutable>] TransactionPartnerChat =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "chat")>] TransactionPartnerChat =
   {
     /// Type of the transaction partner, always “chat”
     [<DataMember(Name = "type")>]
@@ -9478,7 +9478,7 @@ and [<CLIMutable>] TransactionPartnerChat =
     }
 
 /// Describes the affiliate program that issued the affiliate commission received via this transaction.
-and [<CLIMutable>] TransactionPartnerAffiliateProgram =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "affiliate_program")>] TransactionPartnerAffiliateProgram =
   {
     /// Type of the transaction partner, always “affiliate_program”
     [<DataMember(Name = "type")>]
@@ -9498,7 +9498,7 @@ and [<CLIMutable>] TransactionPartnerAffiliateProgram =
     }
 
 /// Describes a withdrawal transaction with Fragment.
-and [<CLIMutable>] TransactionPartnerFragment =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "fragment")>] TransactionPartnerFragment =
   {
     /// Type of the transaction partner, always “fragment”
     [<DataMember(Name = "type")>]
@@ -9514,7 +9514,7 @@ and [<CLIMutable>] TransactionPartnerFragment =
     }
 
 /// Describes a withdrawal transaction to the Telegram Ads platform.
-and [<CLIMutable>] TransactionPartnerTelegramAds =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "telegram_ads")>] TransactionPartnerTelegramAds =
   {
     /// Type of the transaction partner, always “telegram_ads”
     [<DataMember(Name = "type")>]
@@ -9526,7 +9526,7 @@ and [<CLIMutable>] TransactionPartnerTelegramAds =
     }
 
 /// Describes a transaction with payment for paid broadcasting.
-and [<CLIMutable>] TransactionPartnerTelegramApi =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "telegram_api")>] TransactionPartnerTelegramApi =
   {
     /// Type of the transaction partner, always “telegram_api”
     [<DataMember(Name = "type")>]
@@ -9542,7 +9542,7 @@ and [<CLIMutable>] TransactionPartnerTelegramApi =
     }
 
 /// Describes a transaction with an unknown source or recipient.
-and [<CLIMutable>] TransactionPartnerOther =
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "other")>] TransactionPartnerOther =
   {
     /// Type of the transaction partner, always “other”
     [<DataMember(Name = "type")>]
diff --git a/src/Funogram.Tests/Funogram.Tests.fsproj b/src/Funogram.Tests/Funogram.Tests.fsproj
index 4fd939f..c5f76e5 100644
--- a/src/Funogram.Tests/Funogram.Tests.fsproj
+++ b/src/Funogram.Tests/Funogram.Tests.fsproj
@@ -8,6 +8,7 @@
     <Compile Include="Constants.fs" />
     <Compile Include="Extensions.fs" />
     <Compile Include="Json.fs" />
+    <Compile Include="UnionDiscriminators.fs" />
     <Compile Include="Core.fs" />
     <Compile Include="Deserializer.fs" />
   </ItemGroup>
diff --git a/src/Funogram.Tests/UnionDiscriminators.fs b/src/Funogram.Tests/UnionDiscriminators.fs
new file mode 100644
index 0000000..c413396
--- /dev/null
+++ b/src/Funogram.Tests/UnionDiscriminators.fs
@@ -0,0 +1,96 @@
+module Funogram.Tests.UnionDiscriminators
+
+open Funogram.Telegram.Types
+open Xunit
+open Helpers
+
+// ChatMember subtypes are discriminated by the VALUE of the "status" field
+// (https://core.telegram.org/bots/api#chatmember). Several cases are
+// shape-identical (e.g. ChatMemberLeft and ChatMemberMember are both
+// {status, user} on the wire), so the converter must select the case by the
+// discriminator value — shape matching alone cannot be correct.
+
+let private caseName (m: ChatMember) =
+  match m with
+  | ChatMember.Owner _ -> "Owner"
+  | ChatMember.Administrator _ -> "Administrator"
+  | ChatMember.Member _ -> "Member"
+  | ChatMember.Restricted _ -> "Restricted"
+  | ChatMember.Left _ -> "Left"
+  | ChatMember.Banned _ -> "Banned"
+
+let private user = """{"id":42,"is_bot":false,"first_name":"x"}"""
+
+/// Tools.parseJson expects the Telegram {"ok":true,"result":...} envelope.
+let private parseResult<'a> (payload: string) : Result<'a, Funogram.Types.ApiResponseError> =
+  parseJson<'a> ("""{"ok":true,"result":""" + payload + "}")
+
+[<Theory>]
+[<InlineData("creator", """{"status":"creator","user":%USER%,"is_anonymous":false}""", "Owner")>]
+[<InlineData("administrator", """{"status":"administrator","user":%USER%,"is_anonymous":false,"can_be_edited":false,"can_manage_chat":true,"can_delete_messages":true,"can_manage_video_chats":false,"can_restrict_members":true,"can_promote_members":false,"can_change_info":false,"can_invite_users":false,"can_post_stories":false,"can_edit_stories":false,"can_delete_stories":false}""", "Administrator")>]
+[<InlineData("member", """{"status":"member","user":%USER%}""", "Member")>]
+[<InlineData("restricted", """{"status":"restricted","user":%USER%,"is_member":true,"can_send_messages":false,"can_send_audios":false,"can_send_documents":false,"can_send_photos":false,"can_send_videos":false,"can_send_video_notes":false,"can_send_voice_notes":false,"can_send_polls":false,"can_send_other_messages":false,"can_add_web_page_previews":false,"can_change_info":false,"can_invite_users":false,"can_pin_messages":false,"can_manage_topics":false,"until_date":0}""", "Restricted")>]
+[<InlineData("left", """{"status":"left","user":%USER%}""", "Left")>]
+[<InlineData("kicked", """{"status":"kicked","user":%USER%,"until_date":0}""", "Banned")>]
+let ``ChatMember deserializes to the case matching the status value`` (status: string, jsonTemplate: string, expectedCase: string) =
+  let json = jsonTemplate.Replace("%USER%", user)
+  match parseResult<ChatMember> json with
+  | Ok m ->
+    Assert.Equal(expectedCase, caseName m)
+    // the wire status must survive on whichever case was chosen
+    let actualStatus =
+      match m with
+      | ChatMember.Owner x -> x.Status
+      | ChatMember.Administrator x -> x.Status
+      | ChatMember.Member x -> x.Status
+      | ChatMember.Restricted x -> x.Status
+      | ChatMember.Left x -> x.Status
+      | ChatMember.Banned x -> x.Status
+    Assert.Equal(status, actualStatus)
+  | Error e -> failwith e.Description
+
+[<Fact>]
+let ``ChatMember member round-trip does not invent fields`` () =
+  // A misdiscriminated {"status":"member"} used to come back as Owner and
+  // re-serialize with an is_anonymous field that was never on the wire.
+  let json = """{"status":"member","user":""" + user + "}"
+  match parseResult<ChatMember> json with
+  | Ok m ->
+    let reserialized = toJsonString m
+    Assert.DoesNotContain("is_anonymous", reserialized)
+  | Error e -> failwith e.Description
+
+[<Fact>]
+let ``ChatMember with an unknown future status falls back to shape matching without throwing`` () =
+  // Forward compatibility: when Telegram introduces a status this library version
+  // doesn't know, deserialization must not fail; the wire status is still readable.
+  let json = """{"status":"holographic_member","user":""" + user + "}"
+  match parseResult<ChatMember> json with
+  | Ok m ->
+    let status =
+      match m with
+      | ChatMember.Owner x -> x.Status
+      | ChatMember.Administrator x -> x.Status
+      | ChatMember.Member x -> x.Status
+      | ChatMember.Restricted x -> x.Status
+      | ChatMember.Left x -> x.Status
+      | ChatMember.Banned x -> x.Status
+    Assert.Equal("holographic_member", status)
+  | Error e -> failwith e.Description
+
+[<Theory>]
+[<InlineData("""{"type":"user","date":1,"sender_user":{"id":1,"is_bot":false,"first_name":"x"}}""", "User")>]
+[<InlineData("""{"type":"hidden_user","date":1,"sender_user_name":"x"}""", "HiddenUser")>]
+[<InlineData("""{"type":"chat","date":1,"sender_chat":{"id":-1,"type":"channel"}}""", "Chat")>]
+[<InlineData("""{"type":"channel","date":1,"chat":{"id":-1,"type":"channel"},"message_id":5}""", "Channel")>]
+let ``MessageOrigin deserializes to the case matching the type value`` (json: string, expectedCase: string) =
+  match parseResult<MessageOrigin> json with
+  | Ok o ->
+    let actual =
+      match o with
+      | MessageOrigin.User _ -> "User"
+      | MessageOrigin.HiddenUser _ -> "HiddenUser"
+      | MessageOrigin.Chat _ -> "Chat"
+      | MessageOrigin.Channel _ -> "Channel"
+    Assert.Equal(expectedCase, actual)
+  | Error e -> failwith e.Description
diff --git a/src/Funogram/Converters.fs b/src/Funogram/Converters.fs
index 7cbd210..f756f3e 100644
--- a/src/Funogram/Converters.fs
+++ b/src/Funogram/Converters.fs
@@ -78,14 +78,18 @@ module internal Converters =
     | Nullary of name: string
     | Scalar  of clrType: Type
     | Array
-    | Object  of props: Set<string>
+    /// tag = (discriminator property name, expected value) from TelegramTagAttribute,
+    /// for subtypes discriminated by a field value rather than by shape.
+    | Object  of props: Set<string> * tag: (string * string) option
 
   [<RequireQualifiedAccess>]
   type private JsonShape =
     | String of value: string
     | Scalar of candidateTypes: Type list
     | Array
-    | Object of props: string list
+    /// Top-level property names, with the value kept for string-valued properties
+    /// (candidates for a discriminator tag).
+    | Object of props: (string * string option) list
 
   let private fsharpListTypeDef = typedefof<_ list>
 
@@ -114,10 +118,17 @@ module internal Converters =
           elif isArrayLike tp then
             CaseDescriptor.Array
           else
-            tp.GetProperties()
-            |> Seq.map (fun x -> x.Name |> toSnakeCase)
-            |> Set.ofSeq
-            |> CaseDescriptor.Object)
+            let props =
+              tp.GetProperties()
+              |> Seq.map (fun x -> x.Name |> toSnakeCase)
+              |> Set.ofSeq
+            let tag =
+              tp.GetCustomAttributes(typeof<Funogram.Types.TelegramTagAttribute>, false)
+              |> Seq.tryHead
+              |> Option.map (fun a ->
+                let a = a :?> Funogram.Types.TelegramTagAttribute
+                a.Field, a.Value)
+            CaseDescriptor.Object (props, tag))
       |> Seq.toArray
     
     let serializers =
@@ -147,13 +158,30 @@ module internal Converters =
       | JsonTokenType.StartArray ->
         JsonShape.Array
       | JsonTokenType.StartObject ->
-        let props = List<string>()
+        let props = List<string * string option>()
         let mutable loop = reader.Read()
         while loop do
           match reader.TokenType with
           | JsonTokenType.PropertyName ->
-            props.Add(reader.GetString())
+            let name = reader.GetString()
             loop <- reader.Read()
+            if loop then
+              match reader.TokenType with
+              | JsonTokenType.String ->
+                // keep string values: they are discriminator-tag candidates
+                props.Add(name, Some (reader.GetString()))
+                loop <- reader.Read()
+              | JsonTokenType.StartObject
+              | JsonTokenType.StartArray ->
+                props.Add(name, None)
+                reader.Skip()
+                loop <- reader.Read()
+              | JsonTokenType.EndObject ->
+                props.Add(name, None)
+                loop <- false
+              | _ ->
+                props.Add(name, None)
+                loop <- reader.Read()
           | JsonTokenType.StartObject
           | JsonTokenType.StartArray ->
             reader.Skip()
@@ -167,24 +195,38 @@ module internal Converters =
         JsonShape.Object []
     
     override x.Read(reader, _, options) =
-      let resolveObject (props: string list) =
-        let exact =
+      let resolveObject (props: (string * string option) list) =
+        // 1) Discriminator value: a case tagged (field, value) wins when the JSON
+        //    carries exactly that value (e.g. {"status":"member"} -> ChatMember.Member).
+        //    Shape matching cannot do this — some subtypes are shape-identical.
+        let byTag =
           cases
           |> Array.tryFindIndex (function
-             | CaseDescriptor.Object known -> props |> List.forall known.Contains
+             | CaseDescriptor.Object (_, Some (tagField, tagValue)) ->
+               props |> List.exists (fun (n, v) -> n = tagField && v = Some tagValue)
              | _ -> false)
-        match exact with
-        | Some _ -> exact
+        match byTag with
+        | Some _ -> byTag
         | None ->
-          let scored =
+          // 2) Shape fallback (untagged unions, or an unknown future tag value).
+          let names = props |> List.map fst
+          let exact =
             cases
-            |> Array.mapi (fun i c ->
-              match c with
-              | CaseDescriptor.Object known ->
-                i, props |> List.sumBy (fun n -> if known.Contains n then 1 else 0)
-              | _ -> i, -1)
-          let i, best = scored |> Array.maxBy snd
-          if best < 0 then None else Some i
+            |> Array.tryFindIndex (function
+               | CaseDescriptor.Object (known, _) -> names |> List.forall known.Contains
+               | _ -> false)
+          match exact with
+          | Some _ -> exact
+          | None ->
+            let scored =
+              cases
+              |> Array.mapi (fun i c ->
+                match c with
+                | CaseDescriptor.Object (known, _) ->
+                  i, names |> List.sumBy (fun n -> if known.Contains n then 1 else 0)
+                | _ -> i, -1)
+            let i, best = scored |> Array.maxBy snd
+            if best < 0 then None else Some i
 
       let idx =
         match x.ReadShape(&reader) with
diff --git a/src/Funogram/Types.fs b/src/Funogram/Types.fs
index aacc197..e19ed4a 100644
--- a/src/Funogram/Types.fs
+++ b/src/Funogram/Types.fs
@@ -11,6 +11,18 @@ type IBotLogger =
   abstract member Log: message: string -> unit
   abstract member Enabled: bool
 
+/// Marks a generated Telegram type as a tag-discriminated union payload: the JSON
+/// property `Field` always carries the literal `Value` for this subtype (e.g.
+/// ChatMemberOwner -> ("status", "creator")). The union converter uses it to select
+/// the case by discriminator value; several subtypes (ChatMemberLeft vs
+/// ChatMemberMember) are shape-identical on the wire, so field-shape matching alone
+/// cannot discriminate them.
+[<AttributeUsage(AttributeTargets.Class, AllowMultiple = false)>]
+type TelegramTagAttribute(field: string, value: string) =
+  inherit Attribute()
+  member _.Field = field
+  member _.Value = value
+
 type BotConfig = 
   { IsTest: bool
     Token: string

From b3217414d5cbe4809dd10812046e65c8c34ea9fe Mon Sep 17 00:00:00 2001
From: Friedrich von Never <friedrich@fornever.me>
Date: Wed, 15 Jul 2026 23:06:01 +0200
Subject: [PATCH 2/2] (#92) Implement Bot API 10.2

---
 README.md                                   |    2 +-
 src/Funogram.Generator/Helpers.fs           |    1 +
 src/Funogram.Generator/out/methods.json     |  553 +++++++-
 src/Funogram.Generator/out/types.json       | 1357 +++++++++++++++++--
 src/Funogram.Telegram/Directory.Build.props |    2 +-
 src/Funogram.Telegram/RequestsTypes.fs      |  303 ++++-
 src/Funogram.Telegram/Types.fs              |  826 +++++++++--
 7 files changed, 2704 insertions(+), 340 deletions(-)

diff --git a/README.md b/README.md
index bb84cbb..22dd76e 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 ![.NET Core](https://github.com/Dolfik1/Funogram/workflows/.NET/badge.svg)
 [![NuGet](https://img.shields.io/nuget/v/Funogram.svg)](https://www.nuget.org/packages/Funogram/)
 [![NuGet](https://img.shields.io/nuget/v/Funogram.Telegram.svg)](https://www.nuget.org/packages/Funogram.Telegram/)
-[![NuGet](https://img.shields.io/badge/Bot%20API-10.1-blue?logo=telegram)](https://www.nuget.org/packages/Funogram.Telegram/)
+[![NuGet](https://img.shields.io/badge/Bot%20API-10.2-blue?logo=telegram)](https://www.nuget.org/packages/Funogram.Telegram/)
 
 <img src="https://github.com/Dolfik1/Funogram/raw/master/docs/files/img/logo.png" alt="Funogram Logo" width="200" align="right" />
 
diff --git a/src/Funogram.Generator/Helpers.fs b/src/Funogram.Generator/Helpers.fs
index 1481848..6e187bd 100644
--- a/src/Funogram.Generator/Helpers.fs
+++ b/src/Funogram.Generator/Helpers.fs
@@ -24,6 +24,7 @@ let typeMap =
     "Float", "float"
     "Float number", "float"
     "InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply", "Markup"
+    "InputMediaAnimation or InputMediaAudio or InputMediaPhoto or InputMediaVideo or InputMediaVoiceNote", "InputMedia"
     "array of Messages", "Message[]"
     "array of Message", "Message[]"
     "array of MessageId", "MessageId[]"
diff --git a/src/Funogram.Generator/out/methods.json b/src/Funogram.Generator/out/methods.json
index fa39473..baf1d91 100644
--- a/src/Funogram.Generator/out/methods.json
+++ b/src/Funogram.Generator/out/methods.json
@@ -191,6 +191,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "text",
         "ConvertedName": "Text",
@@ -375,7 +391,7 @@
   {
     "OriginalName": "forwardMessages",
     "ConvertedName": "ForwardMessages",
-    "Description": "Use this method to forward multiple messages of any kind. If some of the specified messages can\u0027t be found or forwarded, they are skipped. Service messages and messages with protected content can\u0027t be forwarded. Album grouping is kept for forwarded messages. On success, an array of MessageId of the sent messages is returned.",
+    "Description": "Use this method to forward multiple messages of any kind. If some of the specified messages can\u0027t be found or forwarded, they are skipped. Service messages and messages with protected content can\u0027t be forwarded. Album grouping is kept for forwarded messages. On success, an Array of MessageId of the sent messages is returned.",
     "Fields": [
       {
         "OriginalName": "chat_id",
@@ -434,7 +450,7 @@
         "Optional": true
       }
     ],
-    "OriginalReturnType": "array of MessageId",
+    "OriginalReturnType": "Array of MessageId",
     "ConvertedReturnType": "MessageId[]"
   },
   {
@@ -517,7 +533,7 @@
       {
         "OriginalName": "show_caption_above_media",
         "ConvertedName": "ShowCaptionAboveMedia",
-        "Description": "Pass True, if the caption must be shown above the message media. Ignored if a new caption isn\u0027t specified.",
+        "Description": "Pass True if the caption must be shown above the message media. Ignored if a new caption isn\u0027t specified.",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -585,7 +601,7 @@
   {
     "OriginalName": "copyMessages",
     "ConvertedName": "CopyMessages",
-    "Description": "Use this method to copy messages of any kind. If some of the specified messages can\u0027t be found or copied, they are skipped. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can\u0027t be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don\u0027t have a link to the original message. Album grouping is kept for copied messages. On success, an array of MessageId of the sent messages is returned.",
+    "Description": "Use this method to copy messages of any kind. If some of the specified messages can\u0027t be found or copied, they are skipped. Service messages, paid media messages, giveaway messages, giveaway winners messages, and invoice messages can\u0027t be copied. A quiz poll can be copied only if the value of the field correct_option_id is known to the bot. The method is analogous to the method forwardMessages, but the copied messages don\u0027t have a link to the original message. Album grouping is kept for copied messages. On success, an Array of MessageId of the sent messages is returned.",
     "Fields": [
       {
         "OriginalName": "chat_id",
@@ -652,7 +668,7 @@
         "Optional": true
       }
     ],
-    "OriginalReturnType": "array of MessageId",
+    "OriginalReturnType": "Array of MessageId",
     "ConvertedReturnType": "MessageId[]"
   },
   {
@@ -692,6 +708,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "photo",
         "ConvertedName": "Photo",
@@ -727,7 +759,7 @@
       {
         "OriginalName": "show_caption_above_media",
         "ConvertedName": "ShowCaptionAboveMedia",
-        "Description": "Pass True, if the caption must be shown above the message media",
+        "Description": "Pass True if the caption must be shown above the message media",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -837,6 +869,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "live_photo",
         "ConvertedName": "LivePhoto",
@@ -880,7 +928,7 @@
       {
         "OriginalName": "show_caption_above_media",
         "ConvertedName": "ShowCaptionAboveMedia",
-        "Description": "Pass True, if the caption must be shown above the message media",
+        "Description": "Pass True if the caption must be shown above the message media",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -990,6 +1038,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "audio",
         "ConvertedName": "Audio",
@@ -1151,6 +1215,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "document",
         "ConvertedName": "Document",
@@ -1296,6 +1376,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "video",
         "ConvertedName": "Video",
@@ -1379,7 +1475,7 @@
       {
         "OriginalName": "show_caption_above_media",
         "ConvertedName": "ShowCaptionAboveMedia",
-        "Description": "Pass True, if the caption must be shown above the message media",
+        "Description": "Pass True if the caption must be shown above the message media",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -1497,6 +1593,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "animation",
         "ConvertedName": "Animation",
@@ -1564,7 +1676,7 @@
       {
         "OriginalName": "show_caption_above_media",
         "ConvertedName": "ShowCaptionAboveMedia",
-        "Description": "Pass True, if the caption must be shown above the message media",
+        "Description": "Pass True if the caption must be shown above the message media",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -1674,6 +1786,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "voice",
         "ConvertedName": "Voice",
@@ -1811,6 +1939,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "video_note",
         "ConvertedName": "VideoNote",
@@ -1951,7 +2095,7 @@
       {
         "OriginalName": "media",
         "ConvertedName": "Media",
-        "Description": "A JSON-serialized array describing the media to be sent; up to 10 items",
+        "Description": "A JSON-serialized Array describing the media to be sent; up to 10 items",
         "OriginalFieldType": "Array of InputPaidMedia",
         "ConvertedFieldType": "InputPaidMedia[]",
         "Optional": false
@@ -1991,7 +2135,7 @@
       {
         "OriginalName": "show_caption_above_media",
         "ConvertedName": "ShowCaptionAboveMedia",
-        "Description": "Pass True, if the caption must be shown above the message media",
+        "Description": "Pass True if the caption must be shown above the message media",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -2051,7 +2195,7 @@
   {
     "OriginalName": "sendMediaGroup",
     "ConvertedName": "SendMediaGroup",
-    "Description": "Use this method to send a group of photos, live 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 Message objects that were sent is returned.",
+    "Description": "Use this method to send a group of photos, live 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 Message objects that were sent is returned.",
     "Fields": [
       {
         "OriginalName": "business_connection_id",
@@ -2088,7 +2232,7 @@
       {
         "OriginalName": "media",
         "ConvertedName": "Media",
-        "Description": "A JSON-serialized array describing messages to be sent, must include 2-10 items",
+        "Description": "A JSON-serialized Array describing messages to be sent, must include 2-10 items",
         "OriginalFieldType": "Array of InputMediaAudio, InputMediaDocument, InputMediaLivePhoto, InputMediaPhoto and InputMediaVideo",
         "ConvertedFieldType": "InputMedia[]",
         "Optional": false
@@ -2134,7 +2278,7 @@
         "Optional": true
       }
     ],
-    "OriginalReturnType": "array of Message",
+    "OriginalReturnType": "Array of Message",
     "ConvertedReturnType": "Message[]"
   },
   {
@@ -2174,6 +2318,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "latitude",
         "ConvertedName": "Latitude",
@@ -2201,7 +2361,7 @@
       {
         "OriginalName": "live_period",
         "ConvertedName": "LivePeriod",
-        "Description": "Period in seconds during which the location will be updated (see Live Locations, should be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely",
+        "Description": "Period in seconds during which the location will be updated (see Live Locations), must be between 60 and 86400, or 0x7FFFFFFF for live locations that can be edited indefinitely. Must be 0 for ephemeral messages.",
         "OriginalFieldType": "Integer",
         "ConvertedFieldType": "int64",
         "Optional": true
@@ -2319,6 +2479,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "latitude",
         "ConvertedName": "Latitude",
@@ -2480,6 +2656,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "phone_number",
         "ConvertedName": "PhoneNumber",
@@ -2652,7 +2844,7 @@
       {
         "OriginalName": "allows_multiple_answers",
         "ConvertedName": "AllowsMultipleAnswers",
-        "Description": "Pass True, if the poll allows multiple answers, defaults to False",
+        "Description": "Pass True if the poll allows multiple answers, defaults to False",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -2660,7 +2852,7 @@
       {
         "OriginalName": "allows_revoting",
         "ConvertedName": "AllowsRevoting",
-        "Description": "Pass True, if the poll allows to change chosen answer options, defaults to False for quizzes and to True for regular polls",
+        "Description": "Pass True if the poll allows to change chosen answer options, defaults to False for quizzes and to True for regular polls",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -2668,7 +2860,7 @@
       {
         "OriginalName": "shuffle_options",
         "ConvertedName": "ShuffleOptions",
-        "Description": "Pass True, if the poll options must be shown in random order",
+        "Description": "Pass True if the poll options must be shown in random order",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -2676,7 +2868,7 @@
       {
         "OriginalName": "allow_adding_options",
         "ConvertedName": "AllowAddingOptions",
-        "Description": "Pass True, if answer options can be added to the poll after creation; not supported for anonymous polls and quizzes",
+        "Description": "Pass True if answer options can be added to the poll after creation; not supported for anonymous polls and quizzes",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -2684,7 +2876,7 @@
       {
         "OriginalName": "hide_results_until_closes",
         "ConvertedName": "HideResultsUntilCloses",
-        "Description": "Pass True, if poll results must be shown only after the poll closes",
+        "Description": "Pass True if poll results must be shown only after the poll closes",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -2692,7 +2884,7 @@
       {
         "OriginalName": "members_only",
         "ConvertedName": "MembersOnly",
-        "Description": "Pass True, if voting is limited to users who have been members of the chat where the poll is being sent for more than 24 hours; for channel chats only",
+        "Description": "Pass True if voting is limited to users who have been members of the chat where the poll is being sent for more than 24 hours; for channel chats only",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -4019,7 +4211,7 @@
   {
     "OriginalName": "sendChatJoinRequestWebApp",
     "ConvertedName": "SendChatJoinRequestWebApp",
-    "Description": "Use this method to process a received chat join request query by showing a Mini App to the user before deciding the outcome. Returns True on success.",
+    "Description": "Use this method to process a received chat join request query by showing a Mini App to the user before deciding the outcome. Call answerChatJoinRequestQuery to resolve the join request query based on the user interaction with the Mini App. Returns True on success.",
     "Fields": [
       {
         "OriginalName": "chat_join_request_query_id",
@@ -4032,7 +4224,7 @@
       {
         "OriginalName": "web_app_url",
         "ConvertedName": "WebAppUrl",
-        "Description": "The URL of the Mini App to be opened",
+        "Description": "An HTTPS URL of a Web App to be opened with additional data as specified in Initializing Web Apps",
         "OriginalFieldType": "String",
         "ConvertedFieldType": "string",
         "Optional": false
@@ -4286,7 +4478,7 @@
   {
     "OriginalName": "getChatMemberCount",
     "ConvertedName": "GetChatMemberCount",
-    "Description": "Use this method to get the number of members in a chat. Returns Int on success.",
+    "Description": "Use this method to get the number of members in a chat. Returns Integer on success.",
     "Fields": [
       {
         "OriginalName": "chat_id",
@@ -4297,8 +4489,8 @@
         "Optional": false
       }
     ],
-    "OriginalReturnType": "Int",
-    "ConvertedReturnType": "int"
+    "OriginalReturnType": "Integer",
+    "ConvertedReturnType": "int64"
   },
   {
     "OriginalName": "getChatMember",
@@ -4328,7 +4520,7 @@
   {
     "OriginalName": "getUserPersonalChatMessages",
     "ConvertedName": "GetUserPersonalChatMessages",
-    "Description": "Use this method to get the last messages from the personal chat (i.e., the chat currently added to their profile) of a given user. On success, an array of Message objects is returned.",
+    "Description": "Use this method to get the last messages from the personal chat (i.e., the chat currently added to their profile) of a given user. On success, an Array of Message objects is returned.",
     "Fields": [
       {
         "OriginalName": "user_id",
@@ -4347,7 +4539,7 @@
         "Optional": false
       }
     ],
-    "OriginalReturnType": "array of Message",
+    "OriginalReturnType": "Array of Message",
     "ConvertedReturnType": "Message[]"
   },
   {
@@ -4716,7 +4908,7 @@
       {
         "OriginalName": "show_alert",
         "ConvertedName": "ShowAlert",
-        "Description": "If True, an alert will be shown by the client instead of a notification at the top of the chat screen. Defaults to false.",
+        "Description": "If True, an alert will be shown by the client instead of a notification at the top of the chat screen. Defaults to False.",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -4875,7 +5067,7 @@
       {
         "OriginalName": "is_access_restricted",
         "ConvertedName": "IsAccessRestricted",
-        "Description": "Pass True, if only selected users can access the bot. The bot\u0027s owner can always access it.",
+        "Description": "Pass True if only selected users can access the bot. The bot\u0027s owner can always access it.",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": false
@@ -4883,7 +5075,7 @@
       {
         "OriginalName": "added_user_ids",
         "ConvertedName": "AddedUserIds",
-        "Description": "A JSON-serialized list of up to 10 identifiers of users who will have access to the bot in addition to its owner. Ignored if is_access_restricted is false.",
+        "Description": "A JSON-serialized list of up to 10 identifiers of users who will have access to the bot in addition to its owner. Ignored if is_access_restricted is False.",
         "OriginalFieldType": "Array of Integer",
         "ConvertedFieldType": "int64[]",
         "Optional": true
@@ -5639,7 +5831,7 @@
       {
         "OriginalName": "show_gift_button",
         "ConvertedName": "ShowGiftButton",
-        "Description": "Pass True, if a button for sending a gift to the user or by the business account must always be shown in the input field",
+        "Description": "Pass True if a button for sending a gift to the user or by the business account must always be shown in the input field",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": false
@@ -6487,7 +6679,7 @@
       {
         "OriginalName": "rich_message",
         "ConvertedName": "RichMessage",
-        "Description": "New rich content of the message; required if text isn\u0027t specified",
+        "Description": "New rich content of the message; required if text isn\u0027t specified. Direct upload of new files isn\u0027t supported when an inline message is edited.",
         "OriginalFieldType": "InputRichMessage",
         "ConvertedFieldType": "InputRichMessage",
         "Optional": true
@@ -6568,7 +6760,7 @@
       {
         "OriginalName": "show_caption_above_media",
         "ConvertedName": "ShowCaptionAboveMedia",
-        "Description": "Pass True, if the caption must be shown above the message media. Supported only for animation, photo and video messages.",
+        "Description": "Pass True if the caption must be shown above the message media. Supported only for animation, photo and video messages.",
         "OriginalFieldType": "Boolean",
         "ConvertedFieldType": "bool",
         "Optional": true
@@ -6625,7 +6817,7 @@
       {
         "OriginalName": "media",
         "ConvertedName": "Media",
-        "Description": "A JSON-serialized object for a new media content of the message",
+        "Description": "A JSON-serialized object for the new media content of the message",
         "OriginalFieldType": "InputMedia",
         "ConvertedFieldType": "InputMedia",
         "Optional": false
@@ -6927,6 +7119,234 @@
     "OriginalReturnType": "Poll",
     "ConvertedReturnType": "Poll"
   },
+  {
+    "OriginalName": "editEphemeralMessageText",
+    "ConvertedName": "EditEphemeralMessageText",
+    "Description": "Use this method to edit an ephemeral text message. Note that it is not guaranteed that the user will receive the message edit event, especially if they are offline. On success, True is returned.",
+    "Fields": [
+      {
+        "OriginalName": "chat_id",
+        "ConvertedName": "ChatId",
+        "Description": "Unique identifier for the target chat or username of the target supergroup in the format @username",
+        "OriginalFieldType": "Integer or String",
+        "ConvertedFieldType": "ChatId",
+        "Optional": false
+      },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "Identifier of the user who received the message",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": false
+      },
+      {
+        "OriginalName": "ephemeral_message_id",
+        "ConvertedName": "EphemeralMessageId",
+        "Description": "Identifier of the ephemeral message to edit",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": false
+      },
+      {
+        "OriginalName": "text",
+        "ConvertedName": "Text",
+        "Description": "New text of the message, 1-4096 characters after entity parsing",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": false
+      },
+      {
+        "OriginalName": "parse_mode",
+        "ConvertedName": "ParseMode",
+        "Description": "Mode for parsing entities in the message text. See formatting options for more details.",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "ParseMode",
+        "Optional": true
+      },
+      {
+        "OriginalName": "entities",
+        "ConvertedName": "Entities",
+        "Description": "A JSON-serialized list of special entities that appear in message text, which can be specified instead of parse_mode",
+        "OriginalFieldType": "Array of MessageEntity",
+        "ConvertedFieldType": "MessageEntity[]",
+        "Optional": true
+      },
+      {
+        "OriginalName": "link_preview_options",
+        "ConvertedName": "LinkPreviewOptions",
+        "Description": "Link preview generation options for the message",
+        "OriginalFieldType": "LinkPreviewOptions",
+        "ConvertedFieldType": "LinkPreviewOptions",
+        "Optional": true
+      },
+      {
+        "OriginalName": "reply_markup",
+        "ConvertedName": "ReplyMarkup",
+        "Description": "A JSON-serialized object for an inline keyboard",
+        "OriginalFieldType": "InlineKeyboardMarkup",
+        "ConvertedFieldType": "InlineKeyboardMarkup",
+        "Optional": true
+      }
+    ],
+    "OriginalReturnType": "True",
+    "ConvertedReturnType": "bool"
+  },
+  {
+    "OriginalName": "editEphemeralMessageMedia",
+    "ConvertedName": "EditEphemeralMessageMedia",
+    "Description": "Use this method to edit the media of an ephemeral message. Note that it is not guaranteed that the user will receive the message edit event, especially if they are offline. On success, True is returned.",
+    "Fields": [
+      {
+        "OriginalName": "chat_id",
+        "ConvertedName": "ChatId",
+        "Description": "Unique identifier for the target chat or username of the target supergroup in the format @username",
+        "OriginalFieldType": "Integer or String",
+        "ConvertedFieldType": "ChatId",
+        "Optional": false
+      },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "Identifier of the user who received the message",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": false
+      },
+      {
+        "OriginalName": "ephemeral_message_id",
+        "ConvertedName": "EphemeralMessageId",
+        "Description": "Identifier of the ephemeral message to edit",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": false
+      },
+      {
+        "OriginalName": "media",
+        "ConvertedName": "Media",
+        "Description": "A JSON-serialized object for the new media content of the message. A new file can\u0027t be uploaded; use a previously uploaded file via its file_id or specify a URL.",
+        "OriginalFieldType": "InputMedia",
+        "ConvertedFieldType": "InputMedia",
+        "Optional": false
+      },
+      {
+        "OriginalName": "reply_markup",
+        "ConvertedName": "ReplyMarkup",
+        "Description": "A JSON-serialized object for an inline keyboard",
+        "OriginalFieldType": "InlineKeyboardMarkup",
+        "ConvertedFieldType": "InlineKeyboardMarkup",
+        "Optional": true
+      }
+    ],
+    "OriginalReturnType": "True",
+    "ConvertedReturnType": "bool"
+  },
+  {
+    "OriginalName": "editEphemeralMessageCaption",
+    "ConvertedName": "EditEphemeralMessageCaption",
+    "Description": "Use this method to edit the caption of an ephemeral message. Note that it is not guaranteed that the user will receive the message edit event, especially if they are offline. On success, True is returned.",
+    "Fields": [
+      {
+        "OriginalName": "chat_id",
+        "ConvertedName": "ChatId",
+        "Description": "Unique identifier for the target chat or username of the target supergroup in the format @username",
+        "OriginalFieldType": "Integer or String",
+        "ConvertedFieldType": "ChatId",
+        "Optional": false
+      },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "Identifier of the user who received the message",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": false
+      },
+      {
+        "OriginalName": "ephemeral_message_id",
+        "ConvertedName": "EphemeralMessageId",
+        "Description": "Identifier of the ephemeral message to edit",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": false
+      },
+      {
+        "OriginalName": "caption",
+        "ConvertedName": "Caption",
+        "Description": "New caption of the message, 0-1024 characters after entities parsing",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
+      {
+        "OriginalName": "parse_mode",
+        "ConvertedName": "ParseMode",
+        "Description": "Mode for parsing entities in the message caption. See formatting options for more details.",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "ParseMode",
+        "Optional": true
+      },
+      {
+        "OriginalName": "caption_entities",
+        "ConvertedName": "CaptionEntities",
+        "Description": "A JSON-serialized list of special entities that appear in the caption, which can be specified instead of parse_mode",
+        "OriginalFieldType": "Array of MessageEntity",
+        "ConvertedFieldType": "MessageEntity[]",
+        "Optional": true
+      },
+      {
+        "OriginalName": "reply_markup",
+        "ConvertedName": "ReplyMarkup",
+        "Description": "A JSON-serialized object for an inline keyboard",
+        "OriginalFieldType": "InlineKeyboardMarkup",
+        "ConvertedFieldType": "InlineKeyboardMarkup",
+        "Optional": true
+      }
+    ],
+    "OriginalReturnType": "True",
+    "ConvertedReturnType": "bool"
+  },
+  {
+    "OriginalName": "editEphemeralMessageReplyMarkup",
+    "ConvertedName": "EditEphemeralMessageReplyMarkup",
+    "Description": "Use this method to edit only the reply markup of an ephemeral message. Note that it is not guaranteed that the user will receive the message edit event, especially if they are offline. On success, True is returned.",
+    "Fields": [
+      {
+        "OriginalName": "chat_id",
+        "ConvertedName": "ChatId",
+        "Description": "Unique identifier for the target chat or username of the target supergroup in the format @username",
+        "OriginalFieldType": "Integer or String",
+        "ConvertedFieldType": "ChatId",
+        "Optional": false
+      },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "Identifier of the user who received the message",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": false
+      },
+      {
+        "OriginalName": "ephemeral_message_id",
+        "ConvertedName": "EphemeralMessageId",
+        "Description": "Identifier of the ephemeral message to edit",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": false
+      },
+      {
+        "OriginalName": "reply_markup",
+        "ConvertedName": "ReplyMarkup",
+        "Description": "A JSON-serialized object for an inline keyboard",
+        "OriginalFieldType": "InlineKeyboardMarkup",
+        "ConvertedFieldType": "InlineKeyboardMarkup",
+        "Optional": true
+      }
+    ],
+    "OriginalReturnType": "True",
+    "ConvertedReturnType": "bool"
+  },
   {
     "OriginalName": "approveSuggestedPost",
     "ConvertedName": "ApproveSuggestedPost",
@@ -7043,6 +7463,39 @@
     "OriginalReturnType": "True",
     "ConvertedReturnType": "bool"
   },
+  {
+    "OriginalName": "deleteEphemeralMessage",
+    "ConvertedName": "DeleteEphemeralMessage",
+    "Description": "Use this method to delete an ephemeral message. Note that it is not guaranteed that the user will receive the message deletion event, especially if they are offline. Returns True on success.",
+    "Fields": [
+      {
+        "OriginalName": "chat_id",
+        "ConvertedName": "ChatId",
+        "Description": "Unique identifier for the target chat or username of the target supergroup in the format @username",
+        "OriginalFieldType": "Integer or String",
+        "ConvertedFieldType": "ChatId",
+        "Optional": false
+      },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "Identifier of the user who received the message",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": false
+      },
+      {
+        "OriginalName": "ephemeral_message_id",
+        "ConvertedName": "EphemeralMessageId",
+        "Description": "Identifier of the ephemeral message to delete",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": false
+      }
+    ],
+    "OriginalReturnType": "True",
+    "ConvertedReturnType": "bool"
+  },
   {
     "OriginalName": "deleteMessageReaction",
     "ConvertedName": "DeleteMessageReaction",
@@ -7154,6 +7607,22 @@
         "ConvertedFieldType": "int64",
         "Optional": true
       },
+      {
+        "OriginalName": "receiver_user_id",
+        "ConvertedName": "ReceiverUserId",
+        "Description": "For outgoing ephemeral messages, unique identifier of the user who will receive the message; for group and supergroup chats only. It is not guaranteed that the user will receive the message, especially if they are offline. See ephemeral message sending for more details.",
+        "OriginalFieldType": "Integer",
+        "ConvertedFieldType": "int64",
+        "Optional": true
+      },
+      {
+        "OriginalName": "callback_query_id",
+        "ConvertedName": "CallbackQueryId",
+        "Description": "For outgoing ephemeral messages, identifier of the callback query which triggered the message if any",
+        "OriginalFieldType": "String",
+        "ConvertedFieldType": "string",
+        "Optional": true
+      },
       {
         "OriginalName": "sticker",
         "ConvertedName": "Sticker",
@@ -7661,7 +8130,7 @@
       {
         "OriginalName": "business_connection_id",
         "ConvertedName": "BusinessConnectionId",
-        "Description": "Unique identifier of the business connection on behalf of which the message will be sent",
+        "Description": "Unique identifier of the business connection on behalf of which the message will be sent. Bot can send rich messages on behalf of a business account only if the corresponding user can send rich messages.",
         "OriginalFieldType": "String",
         "ConvertedFieldType": "string",
         "Optional": true
@@ -7790,7 +8259,7 @@
       {
         "OriginalName": "rich_message",
         "ConvertedName": "RichMessage",
-        "Description": "The partial message to be streamed",
+        "Description": "The partial message to be streamed. Direct upload of new files isn\u0027t supported.",
         "OriginalFieldType": "InputRichMessage",
         "ConvertedFieldType": "InputRichMessage",
         "Optional": false
@@ -7815,7 +8284,7 @@
       {
         "OriginalName": "results",
         "ConvertedName": "Results",
-        "Description": "A JSON-serialized array of results for the inline query",
+        "Description": "A JSON-serialized Array of results for the inline query",
         "OriginalFieldType": "Array of InlineQueryResult",
         "ConvertedFieldType": "InlineQueryResult[]",
         "Optional": false
@@ -7944,7 +8413,7 @@
       {
         "OriginalName": "suggested_tip_amounts",
         "ConvertedName": "SuggestedTipAmounts",
-        "Description": "A JSON-serialized array of suggested amounts of tips in the smallest units of the currency (integer, not float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed max_tip_amount.",
+        "Description": "A JSON-serialized Array of suggested amounts of tips in the smallest units of the currency (integer, not float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed max_tip_amount.",
         "OriginalFieldType": "Array of Integer",
         "ConvertedFieldType": "int64[]",
         "Optional": true
@@ -8193,7 +8662,7 @@
       {
         "OriginalName": "suggested_tip_amounts",
         "ConvertedName": "SuggestedTipAmounts",
-        "Description": "A JSON-serialized array of suggested amounts of tips in the smallest units of the currency (integer, not float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed max_tip_amount.",
+        "Description": "A JSON-serialized Array of suggested amounts of tips in the smallest units of the currency (integer, not float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed max_tip_amount.",
         "OriginalFieldType": "Array of Integer",
         "ConvertedFieldType": "int64[]",
         "Optional": true
@@ -8322,7 +8791,7 @@
       {
         "OriginalName": "shipping_options",
         "ConvertedName": "ShippingOptions",
-        "Description": "Required if ok is True. A JSON-serialized array of available shipping options.",
+        "Description": "Required if ok is True. A JSON-serialized Array of available shipping options.",
         "OriginalFieldType": "Array of ShippingOption",
         "ConvertedFieldType": "ShippingOption[]",
         "Optional": true
@@ -8479,7 +8948,7 @@
       {
         "OriginalName": "errors",
         "ConvertedName": "Errors",
-        "Description": "A JSON-serialized array describing the errors",
+        "Description": "A JSON-serialized Array describing the errors",
         "OriginalFieldType": "Array of PassportElementError",
         "ConvertedFieldType": "PassportElementError[]",
         "Optional": false
diff --git a/src/Funogram.Generator/out/types.json b/src/Funogram.Generator/out/types.json
index cc123ec..9bb048f 100644
--- a/src/Funogram.Generator/out/types.json
+++ b/src/Funogram.Generator/out/types.json
@@ -213,6 +213,14 @@
             "OriginalFieldType": "ManagedBotUpdated",
             "ConvertedFieldType": "ManagedBotUpdated",
             "Optional": true
+          },
+          {
+            "OriginalName": "subscription",
+            "ConvertedName": "Subscription",
+            "Description": "User payment subscription has changed",
+            "OriginalFieldType": "BotSubscriptionUpdated",
+            "ConvertedFieldType": "BotSubscriptionUpdated",
+            "Optional": true
           }
         ]
       ]
@@ -953,6 +961,14 @@
             "OriginalFieldType": "User",
             "ConvertedFieldType": "User",
             "Optional": true
+          },
+          {
+            "OriginalName": "community",
+            "ConvertedName": "Community",
+            "Description": "The Community to which the chat belongs",
+            "OriginalFieldType": "Community",
+            "ConvertedFieldType": "Community",
+            "Optional": true
           }
         ]
       ]
@@ -968,7 +984,7 @@
           {
             "OriginalName": "message_id",
             "ConvertedName": "MessageId",
-            "Description": "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.",
+            "Description": "Unique message identifier inside this chat; 0 for ephemeral messages. In specific instances (e.g., a 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.",
             "OriginalFieldType": "Integer",
             "ConvertedFieldType": "int64",
             "Optional": false
@@ -1029,6 +1045,22 @@
             "ConvertedFieldType": "string",
             "Optional": true
           },
+          {
+            "OriginalName": "receiver_user",
+            "ConvertedName": "ReceiverUser",
+            "Description": "For ephemeral messages, the user who received the message",
+            "OriginalFieldType": "User",
+            "ConvertedFieldType": "User",
+            "Optional": true
+          },
+          {
+            "OriginalName": "ephemeral_message_id",
+            "ConvertedName": "EphemeralMessageId",
+            "Description": "For ephemeral messages, identifier of the ephemeral message inside this chat. The identifier may be reused for another ephemeral message after the message is deleted or expires.",
+            "OriginalFieldType": "Integer",
+            "ConvertedFieldType": "int64",
+            "Optional": true
+          },
           {
             "OriginalName": "date",
             "ConvertedName": "Date",
@@ -1088,7 +1120,7 @@
           {
             "OriginalName": "reply_to_message",
             "ConvertedName": "ReplyToMessage",
-            "Description": "For replies in the same chat and message thread, the original message. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply.",
+            "Description": "For replies in the same chat and message thread, the original message. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply. If the message is a reply to an ephemeral message, then this field may be omitted.",
             "OriginalFieldType": "Message",
             "ConvertedFieldType": "Message",
             "Optional": true
@@ -1640,7 +1672,7 @@
           {
             "OriginalName": "proximity_alert_triggered",
             "ConvertedName": "ProximityAlertTriggered",
-            "Description": "Service message. A user in the chat triggered another user\u0027s proximity alert while sharing Live Location.",
+            "Description": "Service message: a user in the chat triggered another user\u0027s proximity alert while sharing Live Location",
             "OriginalFieldType": "ProximityAlertTriggered",
             "ConvertedFieldType": "ProximityAlertTriggered",
             "Optional": true
@@ -1677,6 +1709,22 @@
             "ConvertedFieldType": "ChecklistTasksAdded",
             "Optional": true
           },
+          {
+            "OriginalName": "community_chat_added",
+            "ConvertedName": "CommunityChatAdded",
+            "Description": "Service message: chat added to a Community",
+            "OriginalFieldType": "CommunityChatAdded",
+            "ConvertedFieldType": "CommunityChatAdded",
+            "Optional": true
+          },
+          {
+            "OriginalName": "community_chat_removed",
+            "ConvertedName": "CommunityChatRemoved",
+            "Description": "Service message: chat removed from a Community",
+            "OriginalFieldType": "CommunityChatRemoved",
+            "ConvertedFieldType": "CommunityChatRemoved",
+            "Optional": true
+          },
           {
             "OriginalName": "direct_message_price_changed",
             "ConvertedName": "DirectMessagePriceChanged",
@@ -2317,23 +2365,31 @@
           {
             "OriginalName": "message_id",
             "ConvertedName": "MessageId",
-            "Description": "Identifier of the message that will be replied to in the current chat, or in the chat chat_id if it is specified",
+            "Description": "Identifier of the message that will be replied to in the current chat, or in the chat chat_id if it is specified. Required if ephemeral_message_id isn\u0027t specified.",
             "OriginalFieldType": "Integer",
             "ConvertedFieldType": "int64",
-            "Optional": false
+            "Optional": true
           },
           {
             "OriginalName": "chat_id",
             "ConvertedName": "ChatId",
-            "Description": "If the message to be replied to is from a different chat, unique identifier for the chat or username of the bot, supergroup or channel in the format @username. Not supported for messages sent on behalf of a business account and messages from channel direct messages chats.",
+            "Description": "If the message to be replied to is from a different chat, unique identifier for the chat or username of the bot, supergroup or channel in the format @username. Not supported for messages sent on behalf of a business account, messages from channel direct messages chats and ephemeral messages.",
             "OriginalFieldType": "Integer or String",
             "ConvertedFieldType": "ChatId",
             "Optional": true
           },
+          {
+            "OriginalName": "ephemeral_message_id",
+            "ConvertedName": "EphemeralMessageId",
+            "Description": "Identifier of the incoming ephemeral message that will be replied to in the current chat. A reply to an ephemeral message must itself be an ephemeral message. An ephemeral message may only be replied to within 15 seconds of being sent. Required if message_id isn\u0027t specified.",
+            "OriginalFieldType": "Integer",
+            "ConvertedFieldType": "int64",
+            "Optional": true
+          },
           {
             "OriginalName": "allow_sending_without_reply",
             "ConvertedName": "AllowSendingWithoutReply",
-            "Description": "Pass True if the message should be sent even if the specified message to be replied to is not found. Always False for replies in another chat or forum topic. Always True for messages sent on behalf of a business account.",
+            "Description": "Pass True if the message should be sent even if the specified message to be replied to is not found. Always False for replies in another chat or forum topic, and sent ephemeral messages. Always True for messages sent on behalf of a business account.",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -2341,7 +2397,7 @@
           {
             "OriginalName": "quote",
             "ConvertedName": "Quote",
-            "Description": "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, custom_emoji, and date_time entities. The message will fail to send if the quote isn\u0027t found in the original message.",
+            "Description": "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, custom_emoji, and date_time entities. The message will fail to send if the quote isn\u0027t found in the original message. Ignored for ephemeral messages.",
             "OriginalFieldType": "String",
             "ConvertedFieldType": "string",
             "Optional": true
@@ -4247,68 +4303,6 @@
       ]
     }
   },
-  {
-    "Name": "ChecklistTasksDone",
-    "Description": "Describes a service message about checklist tasks marked as done or not done.",
-    "Kind": {
-      "Case": "Fields",
-      "Fields": [
-        [
-          {
-            "OriginalName": "checklist_message",
-            "ConvertedName": "ChecklistMessage",
-            "Description": "Message containing the checklist whose tasks were marked as done or not done. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply.",
-            "OriginalFieldType": "Message",
-            "ConvertedFieldType": "Message",
-            "Optional": true
-          },
-          {
-            "OriginalName": "marked_as_done_task_ids",
-            "ConvertedName": "MarkedAsDoneTaskIds",
-            "Description": "Identifiers of the tasks that were marked as done",
-            "OriginalFieldType": "Array of Integer",
-            "ConvertedFieldType": "int64[]",
-            "Optional": true
-          },
-          {
-            "OriginalName": "marked_as_not_done_task_ids",
-            "ConvertedName": "MarkedAsNotDoneTaskIds",
-            "Description": "Identifiers of the tasks that were marked as not done",
-            "OriginalFieldType": "Array of Integer",
-            "ConvertedFieldType": "int64[]",
-            "Optional": true
-          }
-        ]
-      ]
-    }
-  },
-  {
-    "Name": "ChecklistTasksAdded",
-    "Description": "Describes a service message about tasks added to a checklist.",
-    "Kind": {
-      "Case": "Fields",
-      "Fields": [
-        [
-          {
-            "OriginalName": "checklist_message",
-            "ConvertedName": "ChecklistMessage",
-            "Description": "Message containing the checklist to which the tasks were added. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply.",
-            "OriginalFieldType": "Message",
-            "ConvertedFieldType": "Message",
-            "Optional": true
-          },
-          {
-            "OriginalName": "tasks",
-            "ConvertedName": "Tasks",
-            "Description": "List of tasks added to the checklist",
-            "OriginalFieldType": "Array of ChecklistTask",
-            "ConvertedFieldType": "ChecklistTask[]",
-            "Optional": false
-          }
-        ]
-      ]
-    }
-  },
   {
     "Name": "Location",
     "Description": "This object represents a point on the map.",
@@ -4562,6 +4556,41 @@
       ]
     }
   },
+  {
+    "Name": "BotSubscriptionUpdated",
+    "Description": "This object contains information about changes to a user payment subscription toward the current bot.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "user",
+            "ConvertedName": "User",
+            "Description": "User who subscribed for payments toward the bot",
+            "OriginalFieldType": "User",
+            "ConvertedFieldType": "User",
+            "Optional": false
+          },
+          {
+            "OriginalName": "invoice_payload",
+            "ConvertedName": "InvoicePayload",
+            "Description": "Bot-specified invoice payload",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "state",
+            "ConvertedName": "State",
+            "Description": "The new state of the subscription. Currently, it can be one of \u201Ccanceled\u201D if the user canceled the subscription, \u201Cactive\u201D if the user re-enabled a previously canceled subscription, or \u201Cfailed\u201D if payment for the subscription failed.",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
   {
     "Name": "PollOptionAdded",
     "Description": "Describes a service message about an option added to a poll.",
@@ -5005,6 +5034,94 @@
       ]
     }
   },
+  {
+    "Name": "ChecklistTasksDone",
+    "Description": "Describes a service message about checklist tasks marked as done or not done.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "checklist_message",
+            "ConvertedName": "ChecklistMessage",
+            "Description": "Message containing the checklist whose tasks were marked as done or not done. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply.",
+            "OriginalFieldType": "Message",
+            "ConvertedFieldType": "Message",
+            "Optional": true
+          },
+          {
+            "OriginalName": "marked_as_done_task_ids",
+            "ConvertedName": "MarkedAsDoneTaskIds",
+            "Description": "Identifiers of the tasks that were marked as done",
+            "OriginalFieldType": "Array of Integer",
+            "ConvertedFieldType": "int64[]",
+            "Optional": true
+          },
+          {
+            "OriginalName": "marked_as_not_done_task_ids",
+            "ConvertedName": "MarkedAsNotDoneTaskIds",
+            "Description": "Identifiers of the tasks that were marked as not done",
+            "OriginalFieldType": "Array of Integer",
+            "ConvertedFieldType": "int64[]",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "ChecklistTasksAdded",
+    "Description": "Describes a service message about tasks added to a checklist.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "checklist_message",
+            "ConvertedName": "ChecklistMessage",
+            "Description": "Message containing the checklist to which the tasks were added. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply.",
+            "OriginalFieldType": "Message",
+            "ConvertedFieldType": "Message",
+            "Optional": true
+          },
+          {
+            "OriginalName": "tasks",
+            "ConvertedName": "Tasks",
+            "Description": "List of tasks added to the checklist",
+            "OriginalFieldType": "Array of ChecklistTask",
+            "ConvertedFieldType": "ChecklistTask[]",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "CommunityChatAdded",
+    "Description": "Describes a service message about a chat being added to a community.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "community",
+            "ConvertedName": "Community",
+            "Description": "The new community to which the chat belongs",
+            "OriginalFieldType": "Community",
+            "ConvertedFieldType": "Community",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "CommunityChatRemoved",
+    "Description": "Describes a service message about a chat being removed from a community. Currently holds no information.",
+    "Kind": {
+      "Case": "Stub"
+    }
+  },
   {
     "Name": "ForumTopicCreated",
     "Description": "This object represents a service message about a new forum topic created in the chat.",
@@ -5360,7 +5477,7 @@
           {
             "OriginalName": "are_direct_messages_enabled",
             "ConvertedName": "AreDirectMessagesEnabled",
-            "Description": "True, if direct messages are enabled for the channel chat; false otherwise",
+            "Description": "True, if direct messages are enabled for the channel chat; False otherwise",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": false
@@ -5484,7 +5601,7 @@
           {
             "OriginalName": "currency",
             "ConvertedName": "Currency",
-            "Description": "Currency in which the payment was made. Currently, one of \u201CXTR\u201D for Telegram Stars or \u201CTON\u201D for toncoins.",
+            "Description": "Currency in which the payment was made. Currently, one of \u201CXTR\u201D for Telegram Stars or \u201CTON\u201D for TON grams.",
             "OriginalFieldType": "String",
             "ConvertedFieldType": "string",
             "Optional": false
@@ -5492,7 +5609,7 @@
           {
             "OriginalName": "amount",
             "ConvertedName": "Amount",
-            "Description": "The amount of the currency that was received by the channel in nanotoncoins; for payments in toncoins only",
+            "Description": "The amount of the currency that was received by the channel in nanograms; for payments in TON grams only",
             "OriginalFieldType": "Integer",
             "ConvertedFieldType": "int64",
             "Optional": true
@@ -5849,7 +5966,7 @@
           {
             "OriginalName": "currency",
             "ConvertedName": "Currency",
-            "Description": "Currency in which the post will be paid. Currently, must be one of \u201CXTR\u201D for Telegram Stars or \u201CTON\u201D for toncoins.",
+            "Description": "Currency in which the post will be paid. Currently, must be one of \u201CXTR\u201D for Telegram Stars or \u201CTON\u201D for TON grams.",
             "OriginalFieldType": "String",
             "ConvertedFieldType": "string",
             "Optional": false
@@ -5857,7 +5974,7 @@
           {
             "OriginalName": "amount",
             "ConvertedName": "Amount",
-            "Description": "The amount of the currency that will be paid for the post in the smallest units of the currency, i.e. Telegram Stars or nanotoncoins. Currently, price in Telegram Stars must be between 5 and 100000, and price in nanotoncoins must be between 10000000 and 10000000000000.",
+            "Description": "The amount of the currency that will be paid for the post in the smallest units of the currency, i.e. Telegram Stars or nanograms. Currently, price in Telegram Stars must be between 5 and 100000, and price in nanograms must be between 10000000 and 10000000000000.",
             "OriginalFieldType": "Integer",
             "ConvertedFieldType": "int64",
             "Optional": false
@@ -6089,7 +6206,7 @@
           {
             "OriginalName": "is_persistent",
             "ConvertedName": "IsPersistent",
-            "Description": "Requests clients to always show the keyboard when the regular keyboard is hidden. Defaults to false, in which case the custom keyboard can be hidden and opened with a keyboard icon.",
+            "Description": "Requests clients to always show the keyboard when the regular keyboard is hidden. Defaults to False, in which case the custom keyboard can be hidden and opened with a keyboard icon.",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -6097,7 +6214,7 @@
           {
             "OriginalName": "resize_keyboard",
             "ConvertedName": "ResizeKeyboard",
-            "Description": "Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). Defaults to false, in which case the custom keyboard is always of the same height as the app\u0027s standard keyboard.",
+            "Description": "Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). Defaults to False, in which case the custom keyboard is always of the same height as the app\u0027s standard keyboard.",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -6105,7 +6222,7 @@
           {
             "OriginalName": "one_time_keyboard",
             "ConvertedName": "OneTimeKeyboard",
-            "Description": "Requests clients to hide the keyboard as soon as it\u0027s been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat - the user can press a special button in the input field to see the custom keyboard again. Defaults to false.",
+            "Description": "Requests clients to hide the keyboard as soon as it\u0027s been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat - the user can press a special button in the input field to see the custom keyboard again. Defaults to False.",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -6817,6 +6934,33 @@
       ]
     }
   },
+  {
+    "Name": "Community",
+    "Description": "Represents a community (a group of chats).",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "id",
+            "ConvertedName": "Id",
+            "Description": "Unique identifier for this community. 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 a signed 64-bit integer or double-precision float type are safe for storing this identifier.",
+            "OriginalFieldType": "Integer",
+            "ConvertedFieldType": "int64",
+            "Optional": false
+          },
+          {
+            "OriginalName": "name",
+            "ConvertedName": "Name",
+            "Description": "Name of the community",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
   {
     "Name": "ChatPhoto",
     "Description": "This object represents a chat photo.",
@@ -7097,7 +7241,7 @@
           {
             "OriginalName": "can_manage_tags",
             "ConvertedName": "CanManageTags",
-            "Description": "True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of can_pin_messages.",
+            "Description": "True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted, defaults to the value of can_pin_messages.",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -7429,7 +7573,7 @@
           {
             "OriginalName": "can_manage_tags",
             "ConvertedName": "CanManageTags",
-            "Description": "True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of can_pin_messages.",
+            "Description": "True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted, defaults to the value of can_pin_messages.",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -7796,7 +7940,7 @@
           {
             "OriginalName": "query_id",
             "ConvertedName": "QueryId",
-            "Description": "Identifier of the join request query. If present, then the bot must call sendChatJoinRequestWebApp or directly call answerChatJoinRequestQuery within 10 seconds.",
+            "Description": "Identifier of the join request query; for bots assigned to process join requests only. If present, then the bot must call sendChatJoinRequestWebApp or directly call answerChatJoinRequestQuery within 10 seconds.",
             "OriginalFieldType": "String",
             "ConvertedFieldType": "string",
             "Optional": true
@@ -7935,7 +8079,7 @@
           {
             "OriginalName": "can_manage_topics",
             "ConvertedName": "CanManageTopics",
-            "Description": "True, if the user is allowed to create forum topics. If omitted defaults to the value of can_pin_messages.",
+            "Description": "True, if the user is allowed to create forum topics. If omitted, defaults to the value of can_pin_messages.",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -9400,7 +9544,7 @@
           {
             "OriginalName": "last_resale_currency",
             "ConvertedName": "LastResaleCurrency",
-            "Description": "For gifts bought from other users, the currency in which the payment for the gift was done. Currently, one of \u201CXTR\u201D for Telegram Stars or \u201CTON\u201D for toncoins.",
+            "Description": "For gifts bought from other users, the currency in which the payment for the gift was done. Currently, one of \u201CXTR\u201D for Telegram Stars or \u201CTON\u201D for TON grams.",
             "OriginalFieldType": "String",
             "ConvertedFieldType": "string",
             "Optional": true
@@ -9408,7 +9552,7 @@
           {
             "OriginalName": "last_resale_amount",
             "ConvertedName": "LastResaleAmount",
-            "Description": "For gifts bought from other users, the price paid for the gift in either Telegram Stars or nanotoncoins",
+            "Description": "For gifts bought from other users, the price paid for the gift in either Telegram Stars or nanograms",
             "OriginalFieldType": "Integer",
             "ConvertedFieldType": "int64",
             "Optional": true
@@ -9836,6 +9980,14 @@
             "OriginalFieldType": "String",
             "ConvertedFieldType": "string",
             "Optional": false
+          },
+          {
+            "OriginalName": "is_ephemeral",
+            "ConvertedName": "IsEphemeral",
+            "Description": "True, if the command sends an ephemeral message, which can be seen only by the sender of the message and the bot",
+            "OriginalFieldType": "Boolean",
+            "ConvertedFieldType": "bool",
+            "Optional": true
           }
         ]
       ]
@@ -10917,7 +11069,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -11193,7 +11345,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -11303,7 +11455,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -11512,7 +11664,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -11562,30 +11714,89 @@
     }
   },
   {
-    "Name": "InputFile",
-    "Description": "This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.",
-    "Kind": {
-      "Case": "Stub"
-    }
-  },
-  {
-    "Name": "InputPaidMedia",
-    "Description": "This object describes the paid media to be sent. Currently, it can be one of",
+    "Name": "InputMediaVoiceNote",
+    "Description": "Represents a voice message file to be sent.",
     "Kind": {
-      "Case": "Cases",
+      "Case": "Fields",
       "Fields": [
         [
           {
-            "Name": "LivePhoto",
-            "CaseType": "InputPaidMediaLivePhoto"
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the media, must be voice_note",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
           },
           {
-            "Name": "Photo",
-            "CaseType": "InputPaidMediaPhoto"
+            "OriginalName": "media",
+            "ConvertedName": "Media",
+            "Description": "File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass \u0022attach://\u003Cfile_attach_name\u003E\u0022 to upload a new one using multipart/form-data under \u003Cfile_attach_name\u003E name. More information on Sending Files \u00BB",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "InputFile",
+            "Optional": false
           },
           {
-            "Name": "Video",
-            "CaseType": "InputPaidMediaVideo"
+            "OriginalName": "caption",
+            "ConvertedName": "Caption",
+            "Description": "Caption of the voice message to be sent, 0-1024 characters after entities parsing",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": true
+          },
+          {
+            "OriginalName": "parse_mode",
+            "ConvertedName": "ParseMode",
+            "Description": "Mode for parsing entities in the voice message caption. See formatting options for more details.",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "ParseMode",
+            "Optional": true
+          },
+          {
+            "OriginalName": "caption_entities",
+            "ConvertedName": "CaptionEntities",
+            "Description": "List of special entities that appear in the caption, which can be specified instead of parse_mode",
+            "OriginalFieldType": "Array of MessageEntity",
+            "ConvertedFieldType": "MessageEntity[]",
+            "Optional": true
+          },
+          {
+            "OriginalName": "duration",
+            "ConvertedName": "Duration",
+            "Description": "Duration of the voice message in seconds",
+            "OriginalFieldType": "Integer",
+            "ConvertedFieldType": "int64",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputFile",
+    "Description": "This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.",
+    "Kind": {
+      "Case": "Stub"
+    }
+  },
+  {
+    "Name": "InputPaidMedia",
+    "Description": "This object describes the paid media to be sent. Currently, it can be one of",
+    "Kind": {
+      "Case": "Cases",
+      "Fields": [
+        [
+          {
+            "Name": "LivePhoto",
+            "CaseType": "InputPaidMediaLivePhoto"
+          },
+          {
+            "Name": "Photo",
+            "CaseType": "InputPaidMediaPhoto"
+          },
+          {
+            "Name": "Video",
+            "CaseType": "InputPaidMediaVideo"
           }
         ]
       ]
@@ -12219,15 +12430,23 @@
   },
   {
     "Name": "InputRichMessage",
-    "Description": "Describes a rich message to be sent. Exactly one of the fields html or markdown must be used.",
+    "Description": "Describes a rich message to be sent. Exactly one of the fields html, markdown, or blocks must be used.",
     "Kind": {
       "Case": "Fields",
       "Fields": [
         [
+          {
+            "OriginalName": "blocks",
+            "ConvertedName": "Blocks",
+            "Description": "Content of the rich message to send described as a list of blocks",
+            "OriginalFieldType": "Array of InputRichBlock",
+            "ConvertedFieldType": "InputRichBlock[]",
+            "Optional": true
+          },
           {
             "OriginalName": "html",
             "ConvertedName": "Html",
-            "Description": "Content of the rich message to send described using HTML formatting. See rich message formatting options for more details.",
+            "Description": "Content of the rich message to send described using HTML formatting. See rich message formatting options for more details. Use media field to specify the media used in the message.",
             "OriginalFieldType": "String",
             "ConvertedFieldType": "string",
             "Optional": true
@@ -12235,11 +12454,19 @@
           {
             "OriginalName": "markdown",
             "ConvertedName": "Markdown",
-            "Description": "Content of the rich message to send described using Markdown formatting. See rich message formatting options for more details.",
+            "Description": "Content of the rich message to send described using Markdown formatting. See rich message formatting options for more details. Use media field to specify the media used in the message.",
             "OriginalFieldType": "String",
             "ConvertedFieldType": "string",
             "Optional": true
           },
+          {
+            "OriginalName": "media",
+            "ConvertedName": "Media",
+            "Description": "List of media that are specified in the markdown or html fields using tg://photo?id=, tg://video?id=, and tg://audio?id= links",
+            "OriginalFieldType": "Array of InputRichMessageMedia",
+            "ConvertedFieldType": "InputRichMessageMedia[]",
+            "Optional": true
+          },
           {
             "OriginalName": "is_rtl",
             "ConvertedName": "IsRtl",
@@ -12260,6 +12487,33 @@
       ]
     }
   },
+  {
+    "Name": "InputRichMessageMedia",
+    "Description": "Describes a media element embedded in an outgoing rich message.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "id",
+            "ConvertedName": "Id",
+            "Description": "Unique identifier of the media used in a tg://photo?id=, tg://video?id=, or tg://audio?id= link. 1-64 characters, only A-Z, a-z, 0-9, _ and - are allowed.",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "media",
+            "ConvertedName": "Media",
+            "Description": "The media to be sent. Everything except the media itself and its properties is ignored.",
+            "OriginalFieldType": "InputMediaAnimation or InputMediaAudio or InputMediaPhoto or InputMediaVideo or InputMediaVoiceNote",
+            "ConvertedFieldType": "InputMedia",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
   {
     "Name": "RichText",
     "Description": "This object represents a rich formatted text. Currently, it can be either a String for plain text, an Array of RichText, or any of the following types:",
@@ -14003,7 +14257,7 @@
   },
   {
     "Name": "RichBlockPhoto",
-    "Description": "A block with a photo, corresponding to the HTML tag \u003Cphoto\u003E.",
+    "Description": "A block with a photo, corresponding to the HTML tag \u003Cimg\u003E.",
     "Kind": {
       "Case": "Fields",
       "Fields": [
@@ -14124,7 +14378,872 @@
   },
   {
     "Name": "RichBlockThinking",
-    "Description": "A block with a \u201CThinking\u2026\u201D placeholder, corresponding to the custom HTML tag \u003Ctg-thinking\u003E. The block may be used only in sendRichMessageDraft, therefore it can\u0027t be received in messages. See https://t.me/addemoji/AIActions for examples of custom emoji, which are recommended for usage in the block.\nThe following methods and objects allow your bot to work in inline mode.\nPlease see our Introduction to Inline bots for more details.\nTo enable this option, send the /setinline command to @BotFather and provide the placeholder text that the user will see in the input field after typing your bot\u0027s name.",
+    "Description": "A block with a \u201CThinking\u2026\u201D placeholder, corresponding to the custom HTML tag \u003Ctg-thinking\u003E. The block may be used only in sendRichMessageDraft, therefore it can\u0027t be received in messages. See https://t.me/addemoji/AIActions for examples of custom emoji that are recommended for usage in the block.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cthinking\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "text",
+            "ConvertedName": "Text",
+            "Description": "Text of the block. See https://t.me/addemoji/AIActions for examples of custom emoji that are recommended for usage in the block.",
+            "OriginalFieldType": "RichText",
+            "ConvertedFieldType": "RichText",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockListItem",
+    "Description": "An item of a list to be sent.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "blocks",
+            "ConvertedName": "Blocks",
+            "Description": "The content of the item",
+            "OriginalFieldType": "Array of InputRichBlock",
+            "ConvertedFieldType": "InputRichBlock[]",
+            "Optional": false
+          },
+          {
+            "OriginalName": "has_checkbox",
+            "ConvertedName": "HasCheckbox",
+            "Description": "Pass True if the item has a checkbox",
+            "OriginalFieldType": "True",
+            "ConvertedFieldType": "bool",
+            "Optional": true
+          },
+          {
+            "OriginalName": "is_checked",
+            "ConvertedName": "IsChecked",
+            "Description": "Pass True if the item has a checked checkbox",
+            "OriginalFieldType": "True",
+            "ConvertedFieldType": "bool",
+            "Optional": true
+          },
+          {
+            "OriginalName": "value",
+            "ConvertedName": "Value",
+            "Description": "For ordered lists, the numeric value of the item label",
+            "OriginalFieldType": "Integer",
+            "ConvertedFieldType": "int64",
+            "Optional": true
+          },
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "For ordered lists, the type of the item label; must be one of \u201Ca\u201D for lowercase letters, \u201CA\u201D for uppercase letters, \u201Ci\u201D for lowercase Roman numerals, \u201CI\u201D for uppercase Roman numerals, or \u201C1\u201D for decimal numbers",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlock",
+    "Description": "This object represents a block in a rich formatted message to be sent. Currently, it can be any of the following types:",
+    "Kind": {
+      "Case": "Cases",
+      "Fields": [
+        [
+          {
+            "Name": "Paragraph",
+            "CaseType": "InputRichBlockParagraph"
+          },
+          {
+            "Name": "SectionHeading",
+            "CaseType": "InputRichBlockSectionHeading"
+          },
+          {
+            "Name": "Preformatted",
+            "CaseType": "InputRichBlockPreformatted"
+          },
+          {
+            "Name": "Footer",
+            "CaseType": "InputRichBlockFooter"
+          },
+          {
+            "Name": "Divider",
+            "CaseType": "InputRichBlockDivider"
+          },
+          {
+            "Name": "MathematicalExpression",
+            "CaseType": "InputRichBlockMathematicalExpression"
+          },
+          {
+            "Name": "Anchor",
+            "CaseType": "InputRichBlockAnchor"
+          },
+          {
+            "Name": "List",
+            "CaseType": "InputRichBlockList"
+          },
+          {
+            "Name": "BlockQuotation",
+            "CaseType": "InputRichBlockBlockQuotation"
+          },
+          {
+            "Name": "PullQuotation",
+            "CaseType": "InputRichBlockPullQuotation"
+          },
+          {
+            "Name": "Collage",
+            "CaseType": "InputRichBlockCollage"
+          },
+          {
+            "Name": "Slideshow",
+            "CaseType": "InputRichBlockSlideshow"
+          },
+          {
+            "Name": "Table",
+            "CaseType": "InputRichBlockTable"
+          },
+          {
+            "Name": "Details",
+            "CaseType": "InputRichBlockDetails"
+          },
+          {
+            "Name": "Map",
+            "CaseType": "InputRichBlockMap"
+          },
+          {
+            "Name": "Animation",
+            "CaseType": "InputRichBlockAnimation"
+          },
+          {
+            "Name": "Audio",
+            "CaseType": "InputRichBlockAudio"
+          },
+          {
+            "Name": "Photo",
+            "CaseType": "InputRichBlockPhoto"
+          },
+          {
+            "Name": "Video",
+            "CaseType": "InputRichBlockVideo"
+          },
+          {
+            "Name": "VoiceNote",
+            "CaseType": "InputRichBlockVoiceNote"
+          },
+          {
+            "Name": "Thinking",
+            "CaseType": "InputRichBlockThinking"
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockParagraph",
+    "Description": "A text paragraph, corresponding to the HTML tag \u003Cp\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cparagraph\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "text",
+            "ConvertedName": "Text",
+            "Description": "Text of the block",
+            "OriginalFieldType": "RichText",
+            "ConvertedFieldType": "RichText",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockSectionHeading",
+    "Description": "A section heading, corresponding to the HTML tags \u003Ch1\u003E, \u003Ch2\u003E, \u003Ch3\u003E, \u003Ch4\u003E, \u003Ch5\u003E, or \u003Ch6\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cheading\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "text",
+            "ConvertedName": "Text",
+            "Description": "Text of the block",
+            "OriginalFieldType": "RichText",
+            "ConvertedFieldType": "RichText",
+            "Optional": false
+          },
+          {
+            "OriginalName": "size",
+            "ConvertedName": "Size",
+            "Description": "Relative size of the text font; 1-6, 1 is the largest, 6 is the smallest",
+            "OriginalFieldType": "Integer",
+            "ConvertedFieldType": "int64",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockPreformatted",
+    "Description": "A preformatted text block, corresponding to the nested HTML tags \u003Cpre\u003E and \u003Ccode\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cpre\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "text",
+            "ConvertedName": "Text",
+            "Description": "Text of the block",
+            "OriginalFieldType": "RichText",
+            "ConvertedFieldType": "RichText",
+            "Optional": false
+          },
+          {
+            "OriginalName": "language",
+            "ConvertedName": "Language",
+            "Description": "The programming language of the text",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockFooter",
+    "Description": "A footer, corresponding to the HTML tag \u003Cfooter\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cfooter\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "text",
+            "ConvertedName": "Text",
+            "Description": "Text of the block",
+            "OriginalFieldType": "RichText",
+            "ConvertedFieldType": "RichText",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockDivider",
+    "Description": "A divider, corresponding to the HTML tag \u003Chr/\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cdivider\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockMathematicalExpression",
+    "Description": "A block with a mathematical expression in LaTeX format, corresponding to the custom HTML tag \u003Ctg-math-block\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cmathematical_expression\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "expression",
+            "ConvertedName": "Expression",
+            "Description": "The mathematical expression in LaTeX format",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockAnchor",
+    "Description": "A block with an anchor, corresponding to the HTML tag \u003Ca\u003E with the attribute name.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Canchor\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "name",
+            "ConvertedName": "Name",
+            "Description": "The name of the anchor",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockList",
+    "Description": "A list of blocks, corresponding to the HTML tag \u003Cul\u003E or \u003Col\u003E with multiple nested tags \u003Cli\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Clist\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "items",
+            "ConvertedName": "Items",
+            "Description": "Items of the list",
+            "OriginalFieldType": "Array of InputRichBlockListItem",
+            "ConvertedFieldType": "InputRichBlockListItem[]",
+            "Optional": false
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockBlockQuotation",
+    "Description": "A block quotation, corresponding to the HTML tag \u003Cblockquote\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cblockquote\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "blocks",
+            "ConvertedName": "Blocks",
+            "Description": "Content of the block",
+            "OriginalFieldType": "Array of InputRichBlock",
+            "ConvertedFieldType": "InputRichBlock[]",
+            "Optional": false
+          },
+          {
+            "OriginalName": "credit",
+            "ConvertedName": "Credit",
+            "Description": "Credit of the block",
+            "OriginalFieldType": "RichText",
+            "ConvertedFieldType": "RichText",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockPullQuotation",
+    "Description": "A quotation with centered text, loosely corresponding to the HTML tag \u003Caside\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cpullquote\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "text",
+            "ConvertedName": "Text",
+            "Description": "Text of the block",
+            "OriginalFieldType": "RichText",
+            "ConvertedFieldType": "RichText",
+            "Optional": false
+          },
+          {
+            "OriginalName": "credit",
+            "ConvertedName": "Credit",
+            "Description": "Credit of the block",
+            "OriginalFieldType": "RichText",
+            "ConvertedFieldType": "RichText",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockCollage",
+    "Description": "A collage, corresponding to the custom HTML tag \u003Ctg-collage\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Ccollage\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "blocks",
+            "ConvertedName": "Blocks",
+            "Description": "Elements of the collage",
+            "OriginalFieldType": "Array of InputRichBlock",
+            "ConvertedFieldType": "InputRichBlock[]",
+            "Optional": false
+          },
+          {
+            "OriginalName": "caption",
+            "ConvertedName": "Caption",
+            "Description": "Caption of the block",
+            "OriginalFieldType": "RichBlockCaption",
+            "ConvertedFieldType": "RichBlockCaption",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockSlideshow",
+    "Description": "A slideshow, corresponding to the custom HTML tag \u003Ctg-slideshow\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cslideshow\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "blocks",
+            "ConvertedName": "Blocks",
+            "Description": "Elements of the slideshow",
+            "OriginalFieldType": "Array of InputRichBlock",
+            "ConvertedFieldType": "InputRichBlock[]",
+            "Optional": false
+          },
+          {
+            "OriginalName": "caption",
+            "ConvertedName": "Caption",
+            "Description": "Caption of the block",
+            "OriginalFieldType": "RichBlockCaption",
+            "ConvertedFieldType": "RichBlockCaption",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockTable",
+    "Description": "A table, corresponding to the HTML tag \u003Ctable\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Ctable\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "cells",
+            "ConvertedName": "Cells",
+            "Description": "Cells of the table",
+            "OriginalFieldType": "Array of Array of RichBlockTableCell",
+            "ConvertedFieldType": "RichBlockTableCell[][]",
+            "Optional": false
+          },
+          {
+            "OriginalName": "is_bordered",
+            "ConvertedName": "IsBordered",
+            "Description": "Pass True if the table has borders",
+            "OriginalFieldType": "True",
+            "ConvertedFieldType": "bool",
+            "Optional": true
+          },
+          {
+            "OriginalName": "is_striped",
+            "ConvertedName": "IsStriped",
+            "Description": "Pass True if the table is striped",
+            "OriginalFieldType": "True",
+            "ConvertedFieldType": "bool",
+            "Optional": true
+          },
+          {
+            "OriginalName": "caption",
+            "ConvertedName": "Caption",
+            "Description": "Caption of the table",
+            "OriginalFieldType": "RichText",
+            "ConvertedFieldType": "RichText",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockDetails",
+    "Description": "An expandable block for details disclosure, corresponding to the HTML tag \u003Cdetails\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cdetails\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "summary",
+            "ConvertedName": "Summary",
+            "Description": "Always shown summary of the block",
+            "OriginalFieldType": "RichText",
+            "ConvertedFieldType": "RichText",
+            "Optional": false
+          },
+          {
+            "OriginalName": "blocks",
+            "ConvertedName": "Blocks",
+            "Description": "Content of the block",
+            "OriginalFieldType": "Array of InputRichBlock",
+            "ConvertedFieldType": "InputRichBlock[]",
+            "Optional": false
+          },
+          {
+            "OriginalName": "is_open",
+            "ConvertedName": "IsOpen",
+            "Description": "Pass True if the content of the block is visible by default",
+            "OriginalFieldType": "True",
+            "ConvertedFieldType": "bool",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockMap",
+    "Description": "A block with a map, corresponding to the custom HTML tag \u003Ctg-map\u003E. The map\u0027s width and height must not exceed 10000 in total. The width and height ratio must be at most 20.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cmap\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "location",
+            "ConvertedName": "Location",
+            "Description": "Location of the center of the map",
+            "OriginalFieldType": "Location",
+            "ConvertedFieldType": "Location",
+            "Optional": false
+          },
+          {
+            "OriginalName": "zoom",
+            "ConvertedName": "Zoom",
+            "Description": "Map zoom level; 0-24",
+            "OriginalFieldType": "Integer",
+            "ConvertedFieldType": "int64",
+            "Optional": false
+          },
+          {
+            "OriginalName": "width",
+            "ConvertedName": "Width",
+            "Description": "Map width; 0-10000",
+            "OriginalFieldType": "Integer",
+            "ConvertedFieldType": "int64",
+            "Optional": false
+          },
+          {
+            "OriginalName": "height",
+            "ConvertedName": "Height",
+            "Description": "Map height; 0-10000",
+            "OriginalFieldType": "Integer",
+            "ConvertedFieldType": "int64",
+            "Optional": false
+          },
+          {
+            "OriginalName": "caption",
+            "ConvertedName": "Caption",
+            "Description": "Caption of the block",
+            "OriginalFieldType": "RichBlockCaption",
+            "ConvertedFieldType": "RichBlockCaption",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockAnimation",
+    "Description": "A block with an animation, corresponding to the HTML tag \u003Cvideo\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Canimation\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "animation",
+            "ConvertedName": "Animation",
+            "Description": "The animation. Caption is ignored.",
+            "OriginalFieldType": "InputMediaAnimation",
+            "ConvertedFieldType": "InputMediaAnimation",
+            "Optional": false
+          },
+          {
+            "OriginalName": "caption",
+            "ConvertedName": "Caption",
+            "Description": "Caption of the block",
+            "OriginalFieldType": "RichBlockCaption",
+            "ConvertedFieldType": "RichBlockCaption",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockAudio",
+    "Description": "A block with a music file, corresponding to the HTML tag \u003Caudio\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Caudio\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "audio",
+            "ConvertedName": "Audio",
+            "Description": "The audio. Caption is ignored.",
+            "OriginalFieldType": "InputMediaAudio",
+            "ConvertedFieldType": "InputMediaAudio",
+            "Optional": false
+          },
+          {
+            "OriginalName": "caption",
+            "ConvertedName": "Caption",
+            "Description": "Caption of the block",
+            "OriginalFieldType": "RichBlockCaption",
+            "ConvertedFieldType": "RichBlockCaption",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockPhoto",
+    "Description": "A block with a photo, corresponding to the HTML tag \u003Cimg\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cphoto\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "photo",
+            "ConvertedName": "Photo",
+            "Description": "The photo. Caption is ignored.",
+            "OriginalFieldType": "InputMediaPhoto",
+            "ConvertedFieldType": "InputMediaPhoto",
+            "Optional": false
+          },
+          {
+            "OriginalName": "caption",
+            "ConvertedName": "Caption",
+            "Description": "Caption of the block",
+            "OriginalFieldType": "RichBlockCaption",
+            "ConvertedFieldType": "RichBlockCaption",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockVideo",
+    "Description": "A block with a video, corresponding to the HTML tag \u003Cvideo\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cvideo\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "video",
+            "ConvertedName": "Video",
+            "Description": "The video. Caption is ignored.",
+            "OriginalFieldType": "InputMediaVideo",
+            "ConvertedFieldType": "InputMediaVideo",
+            "Optional": false
+          },
+          {
+            "OriginalName": "caption",
+            "ConvertedName": "Caption",
+            "Description": "Caption of the block",
+            "OriginalFieldType": "RichBlockCaption",
+            "ConvertedFieldType": "RichBlockCaption",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockVoiceNote",
+    "Description": "A block with a voice note, corresponding to the HTML tag \u003Caudio\u003E.",
+    "Kind": {
+      "Case": "Fields",
+      "Fields": [
+        [
+          {
+            "OriginalName": "type",
+            "ConvertedName": "Type",
+            "Description": "Type of the block, always \u201Cvoice_note\u201D",
+            "OriginalFieldType": "String",
+            "ConvertedFieldType": "string",
+            "Optional": false
+          },
+          {
+            "OriginalName": "voice_note",
+            "ConvertedName": "VoiceNote",
+            "Description": "The voice note. Caption is ignored.",
+            "OriginalFieldType": "InputMediaVoiceNote",
+            "ConvertedFieldType": "InputMediaVoiceNote",
+            "Optional": false
+          },
+          {
+            "OriginalName": "caption",
+            "ConvertedName": "Caption",
+            "Description": "Caption of the block",
+            "OriginalFieldType": "RichBlockCaption",
+            "ConvertedFieldType": "RichBlockCaption",
+            "Optional": true
+          }
+        ]
+      ]
+    }
+  },
+  {
+    "Name": "InputRichBlockThinking",
+    "Description": "A block with a \u201CThinking\u2026\u201D placeholder, corresponding to the custom HTML tag \u003Ctg-thinking\u003E. The block may be used only in sendRichMessageDraft, therefore it can\u0027t be received in messages. See https://t.me/addemoji/AIActions for examples of custom emoji that are recommended for usage in the block.\nThe following methods and objects allow your bot to work in inline mode.\nPlease see our Introduction to Inline bots for more details.\nTo enable this option, send the /setinline command to @BotFather and provide the placeholder text that the user will see in the input field after typing your bot\u0027s name.",
     "Kind": {
       "Case": "Fields",
       "Fields": [
@@ -14140,7 +15259,7 @@
           {
             "OriginalName": "text",
             "ConvertedName": "Text",
-            "Description": "Text of the block. See https://t.me/addemoji/AIActions for examples of custom emoji, which are recommended for usage in the block.",
+            "Description": "Text of the block. See https://t.me/addemoji/AIActions for examples of custom emoji that are recommended for usage in the block.",
             "OriginalFieldType": "RichText",
             "ConvertedFieldType": "RichText",
             "Optional": false
@@ -14523,7 +15642,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -14654,7 +15773,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -14785,7 +15904,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -14892,7 +16011,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -15732,7 +16851,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -15823,7 +16942,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -15914,7 +17033,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -16155,7 +17274,7 @@
           {
             "OriginalName": "show_caption_above_media",
             "ConvertedName": "ShowCaptionAboveMedia",
-            "Description": "Pass True, if the caption must be shown above the message media",
+            "Description": "Pass True if the caption must be shown above the message media",
             "OriginalFieldType": "Boolean",
             "ConvertedFieldType": "bool",
             "Optional": true
@@ -16678,7 +17797,7 @@
           {
             "OriginalName": "suggested_tip_amounts",
             "ConvertedName": "SuggestedTipAmounts",
-            "Description": "A JSON-serialized array of suggested amounts of tip in the smallest units of the currency (integer, not float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed max_tip_amount.",
+            "Description": "A JSON-serialized Array of suggested amounts of tip in the smallest units of the currency (integer, not float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed max_tip_amount.",
             "OriginalFieldType": "Array of Integer",
             "ConvertedFieldType": "int64[]",
             "Optional": true
diff --git a/src/Funogram.Telegram/Directory.Build.props b/src/Funogram.Telegram/Directory.Build.props
index fd14ca1..6665a46 100644
--- a/src/Funogram.Telegram/Directory.Build.props
+++ b/src/Funogram.Telegram/Directory.Build.props
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <Project>
   <PropertyGroup>
-    <Version>10.1.0.0</Version>
+    <Version>10.2.0.0</Version>
     <Authors>Nikolay Matyushin</Authors>
     <Product>Funogram.Telegram</Product>
     <Title>Funogram.Telegram</Title>
diff --git a/src/Funogram.Telegram/RequestsTypes.fs b/src/Funogram.Telegram/RequestsTypes.fs
index 05db81f..9f78a89 100644
--- a/src/Funogram.Telegram/RequestsTypes.fs
+++ b/src/Funogram.Telegram/RequestsTypes.fs
@@ -82,6 +82,8 @@ type SendMessage =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     Text: string
     ParseMode: ParseMode option
     Entities: MessageEntity[] option
@@ -94,12 +96,14 @@ type SendMessage =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, text: string, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?parseMode: ParseMode, ?entities: MessageEntity[], ?linkPreviewOptions: LinkPreviewOptions, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, text: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?linkPreviewOptions: LinkPreviewOptions, ?entities: MessageEntity[], ?parseMode: ParseMode, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       Text = text
       ParseMode = parseMode
       Entities = entities
@@ -112,10 +116,10 @@ type SendMessage =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, text: string, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?parseMode: ParseMode, ?entities: MessageEntity[], ?linkPreviewOptions: LinkPreviewOptions, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendMessage.Make(ChatId.Int chatId, text, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?parseMode = parseMode, ?entities = entities, ?linkPreviewOptions = linkPreviewOptions, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, text: string, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?parseMode: ParseMode, ?entities: MessageEntity[], ?linkPreviewOptions: LinkPreviewOptions, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendMessage.Make(ChatId.String chatId, text, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?parseMode = parseMode, ?entities = entities, ?linkPreviewOptions = linkPreviewOptions, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, text: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?linkPreviewOptions: LinkPreviewOptions, ?entities: MessageEntity[], ?parseMode: ParseMode, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendMessage.Make(ChatId.Int chatId, text, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?linkPreviewOptions = linkPreviewOptions, ?entities = entities, ?parseMode = parseMode, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, text: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?linkPreviewOptions: LinkPreviewOptions, ?entities: MessageEntity[], ?parseMode: ParseMode, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendMessage.Make(ChatId.String chatId, text, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?linkPreviewOptions = linkPreviewOptions, ?entities = entities, ?parseMode = parseMode, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendMessage"
     
@@ -261,6 +265,8 @@ type SendPhoto =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     Photo: InputFile
     Caption: string option
     ParseMode: ParseMode option
@@ -275,12 +281,14 @@ type SendPhoto =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       Photo = photo
       Caption = caption
       ParseMode = parseMode
@@ -295,10 +303,10 @@ type SendPhoto =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendPhoto.Make(ChatId.Int chatId, photo, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendPhoto.Make(ChatId.String chatId, photo, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendPhoto.Make(ChatId.Int chatId, photo, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendPhoto.Make(ChatId.String chatId, photo, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendPhoto"
     
@@ -308,6 +316,8 @@ type SendLivePhoto =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     LivePhoto: InputFile
     Photo: InputFile
     Caption: string option
@@ -323,12 +333,14 @@ type SendLivePhoto =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, livePhoto: InputFile, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?captionEntities: MessageEntity[], ?replyParameters: ReplyParameters, ?parseMode: ParseMode, ?caption: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?showCaptionAboveMedia: bool, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, livePhoto: InputFile, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?parseMode: ParseMode, ?replyParameters: ReplyParameters, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?captionEntities: MessageEntity[], ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       LivePhoto = livePhoto
       Photo = photo
       Caption = caption
@@ -344,10 +356,10 @@ type SendLivePhoto =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, livePhoto: InputFile, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?captionEntities: MessageEntity[], ?replyParameters: ReplyParameters, ?parseMode: ParseMode, ?caption: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?showCaptionAboveMedia: bool, ?replyMarkup: Markup) = 
-    SendLivePhoto.Make(ChatId.Int chatId, livePhoto, photo, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?captionEntities = captionEntities, ?replyParameters = replyParameters, ?parseMode = parseMode, ?caption = caption, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?showCaptionAboveMedia = showCaptionAboveMedia, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, livePhoto: InputFile, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?captionEntities: MessageEntity[], ?replyParameters: ReplyParameters, ?parseMode: ParseMode, ?caption: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?showCaptionAboveMedia: bool, ?replyMarkup: Markup) = 
-    SendLivePhoto.Make(ChatId.String chatId, livePhoto, photo, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?captionEntities = captionEntities, ?replyParameters = replyParameters, ?parseMode = parseMode, ?caption = caption, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?showCaptionAboveMedia = showCaptionAboveMedia, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, livePhoto: InputFile, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?parseMode: ParseMode, ?replyParameters: ReplyParameters, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?captionEntities: MessageEntity[], ?replyMarkup: Markup) = 
+    SendLivePhoto.Make(ChatId.Int chatId, livePhoto, photo, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?parseMode = parseMode, ?replyParameters = replyParameters, ?caption = caption, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?captionEntities = captionEntities, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, livePhoto: InputFile, photo: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?parseMode: ParseMode, ?replyParameters: ReplyParameters, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?captionEntities: MessageEntity[], ?replyMarkup: Markup) = 
+    SendLivePhoto.Make(ChatId.String chatId, livePhoto, photo, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?parseMode = parseMode, ?replyParameters = replyParameters, ?caption = caption, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?captionEntities = captionEntities, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendLivePhoto"
     
@@ -357,6 +369,8 @@ type SendAudio =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     Audio: InputFile
     Caption: string option
     ParseMode: ParseMode option
@@ -373,12 +387,14 @@ type SendAudio =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, audio: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?thumbnail: InputFile, ?title: string, ?performer: string, ?duration: int64, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, audio: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?thumbnail: InputFile, ?title: string, ?performer: string, ?duration: int64, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       Audio = audio
       Caption = caption
       ParseMode = parseMode
@@ -395,10 +411,10 @@ type SendAudio =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, audio: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?thumbnail: InputFile, ?title: string, ?performer: string, ?duration: int64, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendAudio.Make(ChatId.Int chatId, audio, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?thumbnail = thumbnail, ?title = title, ?performer = performer, ?duration = duration, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, audio: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?thumbnail: InputFile, ?title: string, ?performer: string, ?duration: int64, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendAudio.Make(ChatId.String chatId, audio, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?thumbnail = thumbnail, ?title = title, ?performer = performer, ?duration = duration, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, audio: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?thumbnail: InputFile, ?title: string, ?performer: string, ?duration: int64, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendAudio.Make(ChatId.Int chatId, audio, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?thumbnail = thumbnail, ?title = title, ?performer = performer, ?duration = duration, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, audio: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?thumbnail: InputFile, ?title: string, ?performer: string, ?duration: int64, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendAudio.Make(ChatId.String chatId, audio, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?thumbnail = thumbnail, ?title = title, ?performer = performer, ?duration = duration, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendAudio"
     
@@ -408,6 +424,8 @@ type SendDocument =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     Document: InputFile
     Thumbnail: InputFile option
     Caption: string option
@@ -422,12 +440,14 @@ type SendDocument =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, document: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?disableContentTypeDetection: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, document: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?disableContentTypeDetection: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       Document = document
       Thumbnail = thumbnail
       Caption = caption
@@ -442,10 +462,10 @@ type SendDocument =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, document: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?disableContentTypeDetection: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendDocument.Make(ChatId.Int chatId, document, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?disableContentTypeDetection = disableContentTypeDetection, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?thumbnail = thumbnail, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, document: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?disableContentTypeDetection: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendDocument.Make(ChatId.String chatId, document, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?disableContentTypeDetection = disableContentTypeDetection, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?thumbnail = thumbnail, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, document: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?disableContentTypeDetection: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendDocument.Make(ChatId.Int chatId, document, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?disableContentTypeDetection = disableContentTypeDetection, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?thumbnail = thumbnail, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, document: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?disableContentTypeDetection: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendDocument.Make(ChatId.String chatId, document, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?disableContentTypeDetection = disableContentTypeDetection, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?thumbnail = thumbnail, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendDocument"
     
@@ -455,6 +475,8 @@ type SendVideo =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     Video: InputFile
     Duration: int64 option
     Width: int64 option
@@ -476,12 +498,14 @@ type SendVideo =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, video: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?supportsStreaming: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?caption: string, ?replyParameters: ReplyParameters, ?startTimestamp: int64, ?cover: InputFile, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?parseMode: ParseMode, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, video: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?supportsStreaming: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?startTimestamp: int64, ?replyParameters: ReplyParameters, ?cover: InputFile, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?caption: string, ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       Video = video
       Duration = duration
       Width = width
@@ -503,10 +527,10 @@ type SendVideo =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, video: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?supportsStreaming: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?caption: string, ?replyParameters: ReplyParameters, ?startTimestamp: int64, ?cover: InputFile, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?parseMode: ParseMode, ?replyMarkup: Markup) = 
-    SendVideo.Make(ChatId.Int chatId, video, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?supportsStreaming = supportsStreaming, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?caption = caption, ?replyParameters = replyParameters, ?startTimestamp = startTimestamp, ?cover = cover, ?thumbnail = thumbnail, ?height = height, ?width = width, ?duration = duration, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?parseMode = parseMode, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, video: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?supportsStreaming: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?caption: string, ?replyParameters: ReplyParameters, ?startTimestamp: int64, ?cover: InputFile, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?parseMode: ParseMode, ?replyMarkup: Markup) = 
-    SendVideo.Make(ChatId.String chatId, video, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?supportsStreaming = supportsStreaming, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?caption = caption, ?replyParameters = replyParameters, ?startTimestamp = startTimestamp, ?cover = cover, ?thumbnail = thumbnail, ?height = height, ?width = width, ?duration = duration, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?parseMode = parseMode, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, video: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?supportsStreaming: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?startTimestamp: int64, ?replyParameters: ReplyParameters, ?cover: InputFile, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?caption: string, ?replyMarkup: Markup) = 
+    SendVideo.Make(ChatId.Int chatId, video, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?supportsStreaming = supportsStreaming, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?parseMode = parseMode, ?startTimestamp = startTimestamp, ?replyParameters = replyParameters, ?cover = cover, ?thumbnail = thumbnail, ?height = height, ?width = width, ?duration = duration, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?caption = caption, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, video: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?supportsStreaming: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?startTimestamp: int64, ?replyParameters: ReplyParameters, ?cover: InputFile, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?caption: string, ?replyMarkup: Markup) = 
+    SendVideo.Make(ChatId.String chatId, video, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?supportsStreaming = supportsStreaming, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?parseMode = parseMode, ?startTimestamp = startTimestamp, ?replyParameters = replyParameters, ?cover = cover, ?thumbnail = thumbnail, ?height = height, ?width = width, ?duration = duration, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?caption = caption, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendVideo"
     
@@ -516,6 +540,8 @@ type SendAnimation =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     Animation: InputFile
     Duration: int64 option
     Width: int64 option
@@ -534,12 +560,14 @@ type SendAnimation =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, animation: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, animation: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       Animation = animation
       Duration = duration
       Width = width
@@ -558,10 +586,10 @@ type SendAnimation =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, animation: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendAnimation.Make(ChatId.Int chatId, animation, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?thumbnail = thumbnail, ?height = height, ?width = width, ?duration = duration, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, animation: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendAnimation.Make(ChatId.String chatId, animation, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?thumbnail = thumbnail, ?height = height, ?width = width, ?duration = duration, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, animation: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendAnimation.Make(ChatId.Int chatId, animation, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?thumbnail = thumbnail, ?height = height, ?width = width, ?duration = duration, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, animation: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?hasSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?parseMode: ParseMode, ?caption: string, ?thumbnail: InputFile, ?height: int64, ?width: int64, ?duration: int64, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendAnimation.Make(ChatId.String chatId, animation, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?hasSpoiler = hasSpoiler, ?showCaptionAboveMedia = showCaptionAboveMedia, ?captionEntities = captionEntities, ?parseMode = parseMode, ?caption = caption, ?thumbnail = thumbnail, ?height = height, ?width = width, ?duration = duration, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendAnimation"
     
@@ -571,6 +599,8 @@ type SendVoice =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     Voice: InputFile
     Caption: string option
     ParseMode: ParseMode option
@@ -584,12 +614,14 @@ type SendVoice =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, voice: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?caption: string, ?parseMode: ParseMode, ?captionEntities: MessageEntity[], ?duration: int64, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, voice: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?duration: int64, ?parseMode: ParseMode, ?replyParameters: ReplyParameters, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?captionEntities: MessageEntity[], ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       Voice = voice
       Caption = caption
       ParseMode = parseMode
@@ -603,10 +635,10 @@ type SendVoice =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, voice: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?caption: string, ?parseMode: ParseMode, ?captionEntities: MessageEntity[], ?duration: int64, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendVoice.Make(ChatId.Int chatId, voice, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?caption = caption, ?parseMode = parseMode, ?captionEntities = captionEntities, ?duration = duration, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, voice: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?caption: string, ?parseMode: ParseMode, ?captionEntities: MessageEntity[], ?duration: int64, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendVoice.Make(ChatId.String chatId, voice, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?caption = caption, ?parseMode = parseMode, ?captionEntities = captionEntities, ?duration = duration, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, voice: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?duration: int64, ?parseMode: ParseMode, ?replyParameters: ReplyParameters, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?captionEntities: MessageEntity[], ?replyMarkup: Markup) = 
+    SendVoice.Make(ChatId.Int chatId, voice, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?duration = duration, ?parseMode = parseMode, ?replyParameters = replyParameters, ?caption = caption, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?captionEntities = captionEntities, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, voice: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?duration: int64, ?parseMode: ParseMode, ?replyParameters: ReplyParameters, ?caption: string, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?captionEntities: MessageEntity[], ?replyMarkup: Markup) = 
+    SendVoice.Make(ChatId.String chatId, voice, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?duration = duration, ?parseMode = parseMode, ?replyParameters = replyParameters, ?caption = caption, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?captionEntities = captionEntities, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendVoice"
     
@@ -616,6 +648,8 @@ type SendVideoNote =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     VideoNote: InputFile
     Duration: int64 option
     Length: int64 option
@@ -628,12 +662,14 @@ type SendVideoNote =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, videoNote: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?duration: int64, ?length: int64, ?thumbnail: InputFile, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, videoNote: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?thumbnail: InputFile, ?length: int64, ?duration: int64, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       VideoNote = videoNote
       Duration = duration
       Length = length
@@ -646,10 +682,10 @@ type SendVideoNote =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, videoNote: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?duration: int64, ?length: int64, ?thumbnail: InputFile, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendVideoNote.Make(ChatId.Int chatId, videoNote, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?duration = duration, ?length = length, ?thumbnail = thumbnail, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, videoNote: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?duration: int64, ?length: int64, ?thumbnail: InputFile, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendVideoNote.Make(ChatId.String chatId, videoNote, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?duration = duration, ?length = length, ?thumbnail = thumbnail, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, videoNote: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?thumbnail: InputFile, ?length: int64, ?duration: int64, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendVideoNote.Make(ChatId.Int chatId, videoNote, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?thumbnail = thumbnail, ?length = length, ?duration = duration, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, videoNote: InputFile, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?thumbnail: InputFile, ?length: int64, ?duration: int64, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendVideoNote.Make(ChatId.String chatId, videoNote, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?thumbnail = thumbnail, ?length = length, ?duration = duration, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendVideoNote"
     
@@ -739,6 +775,8 @@ type SendLocation =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     Latitude: float
     Longitude: float
     HorizontalAccuracy: float option
@@ -753,12 +791,14 @@ type SendLocation =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, latitude: float, longitude: float, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?heading: int64, ?replyParameters: ReplyParameters, ?livePeriod: int64, ?horizontalAccuracy: float, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?proximityAlertRadius: int64, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, latitude: float, longitude: float, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?proximityAlertRadius: int64, ?livePeriod: int64, ?replyParameters: ReplyParameters, ?horizontalAccuracy: float, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?heading: int64, ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       Latitude = latitude
       Longitude = longitude
       HorizontalAccuracy = horizontalAccuracy
@@ -773,10 +813,10 @@ type SendLocation =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, latitude: float, longitude: float, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?heading: int64, ?replyParameters: ReplyParameters, ?livePeriod: int64, ?horizontalAccuracy: float, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?proximityAlertRadius: int64, ?replyMarkup: Markup) = 
-    SendLocation.Make(ChatId.Int chatId, latitude, longitude, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?heading = heading, ?replyParameters = replyParameters, ?livePeriod = livePeriod, ?horizontalAccuracy = horizontalAccuracy, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?proximityAlertRadius = proximityAlertRadius, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, latitude: float, longitude: float, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?heading: int64, ?replyParameters: ReplyParameters, ?livePeriod: int64, ?horizontalAccuracy: float, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?proximityAlertRadius: int64, ?replyMarkup: Markup) = 
-    SendLocation.Make(ChatId.String chatId, latitude, longitude, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?heading = heading, ?replyParameters = replyParameters, ?livePeriod = livePeriod, ?horizontalAccuracy = horizontalAccuracy, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?proximityAlertRadius = proximityAlertRadius, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, latitude: float, longitude: float, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?proximityAlertRadius: int64, ?livePeriod: int64, ?replyParameters: ReplyParameters, ?horizontalAccuracy: float, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?heading: int64, ?replyMarkup: Markup) = 
+    SendLocation.Make(ChatId.Int chatId, latitude, longitude, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?proximityAlertRadius = proximityAlertRadius, ?livePeriod = livePeriod, ?replyParameters = replyParameters, ?horizontalAccuracy = horizontalAccuracy, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?heading = heading, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, latitude: float, longitude: float, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?proximityAlertRadius: int64, ?livePeriod: int64, ?replyParameters: ReplyParameters, ?horizontalAccuracy: float, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?heading: int64, ?replyMarkup: Markup) = 
+    SendLocation.Make(ChatId.String chatId, latitude, longitude, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?proximityAlertRadius = proximityAlertRadius, ?livePeriod = livePeriod, ?replyParameters = replyParameters, ?horizontalAccuracy = horizontalAccuracy, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?heading = heading, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendLocation"
     
@@ -786,6 +826,8 @@ type SendVenue =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     Latitude: float
     Longitude: float
     Title: string
@@ -802,12 +844,14 @@ type SendVenue =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, latitude: float, longitude: float, title: string, address: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?foursquareType: string, ?googlePlaceId: string, ?replyParameters: ReplyParameters, ?foursquareId: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?googlePlaceType: string, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, latitude: float, longitude: float, title: string, address: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?googlePlaceType: string, ?foursquareId: string, ?foursquareType: string, ?replyParameters: ReplyParameters, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?googlePlaceId: string, ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       Latitude = latitude
       Longitude = longitude
       Title = title
@@ -824,10 +868,10 @@ type SendVenue =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, latitude: float, longitude: float, title: string, address: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?foursquareType: string, ?googlePlaceId: string, ?replyParameters: ReplyParameters, ?foursquareId: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?googlePlaceType: string, ?replyMarkup: Markup) = 
-    SendVenue.Make(ChatId.Int chatId, latitude, longitude, title, address, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?foursquareType = foursquareType, ?googlePlaceId = googlePlaceId, ?replyParameters = replyParameters, ?foursquareId = foursquareId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?googlePlaceType = googlePlaceType, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, latitude: float, longitude: float, title: string, address: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?foursquareType: string, ?googlePlaceId: string, ?replyParameters: ReplyParameters, ?foursquareId: string, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?googlePlaceType: string, ?replyMarkup: Markup) = 
-    SendVenue.Make(ChatId.String chatId, latitude, longitude, title, address, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?foursquareType = foursquareType, ?googlePlaceId = googlePlaceId, ?replyParameters = replyParameters, ?foursquareId = foursquareId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?googlePlaceType = googlePlaceType, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, latitude: float, longitude: float, title: string, address: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?googlePlaceType: string, ?foursquareId: string, ?foursquareType: string, ?replyParameters: ReplyParameters, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?googlePlaceId: string, ?replyMarkup: Markup) = 
+    SendVenue.Make(ChatId.Int chatId, latitude, longitude, title, address, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?googlePlaceType = googlePlaceType, ?foursquareId = foursquareId, ?foursquareType = foursquareType, ?replyParameters = replyParameters, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?googlePlaceId = googlePlaceId, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, latitude: float, longitude: float, title: string, address: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?googlePlaceType: string, ?foursquareId: string, ?foursquareType: string, ?replyParameters: ReplyParameters, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?googlePlaceId: string, ?replyMarkup: Markup) = 
+    SendVenue.Make(ChatId.String chatId, latitude, longitude, title, address, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?googlePlaceType = googlePlaceType, ?foursquareId = foursquareId, ?foursquareType = foursquareType, ?replyParameters = replyParameters, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?googlePlaceId = googlePlaceId, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendVenue"
     
@@ -837,6 +881,8 @@ type SendContact =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     PhoneNumber: string
     FirstName: string
     LastName: string option
@@ -849,12 +895,14 @@ type SendContact =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, phoneNumber: string, firstName: string, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?lastName: string, ?vcard: string, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, phoneNumber: string, firstName: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?lastName: string, ?replyParameters: ReplyParameters, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?vcard: string, ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       PhoneNumber = phoneNumber
       FirstName = firstName
       LastName = lastName
@@ -867,10 +915,10 @@ type SendContact =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, phoneNumber: string, firstName: string, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?lastName: string, ?vcard: string, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendContact.Make(ChatId.Int chatId, phoneNumber, firstName, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?lastName = lastName, ?vcard = vcard, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, phoneNumber: string, firstName: string, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?lastName: string, ?vcard: string, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendContact.Make(ChatId.String chatId, phoneNumber, firstName, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?lastName = lastName, ?vcard = vcard, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, phoneNumber: string, firstName: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?lastName: string, ?replyParameters: ReplyParameters, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?vcard: string, ?replyMarkup: Markup) = 
+    SendContact.Make(ChatId.Int chatId, phoneNumber, firstName, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?lastName = lastName, ?replyParameters = replyParameters, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?vcard = vcard, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, phoneNumber: string, firstName: string, ?businessConnectionId: string, ?suggestedPostParameters: SuggestedPostParameters, ?messageEffectId: string, ?allowPaidBroadcast: bool, ?protectContent: bool, ?disableNotification: bool, ?lastName: string, ?replyParameters: ReplyParameters, ?callbackQueryId: string, ?receiverUserId: int64, ?directMessagesTopicId: int64, ?messageThreadId: int64, ?vcard: string, ?replyMarkup: Markup) = 
+    SendContact.Make(ChatId.String chatId, phoneNumber, firstName, ?businessConnectionId = businessConnectionId, ?suggestedPostParameters = suggestedPostParameters, ?messageEffectId = messageEffectId, ?allowPaidBroadcast = allowPaidBroadcast, ?protectContent = protectContent, ?disableNotification = disableNotification, ?lastName = lastName, ?replyParameters = replyParameters, ?callbackQueryId = callbackQueryId, ?receiverUserId = receiverUserId, ?directMessagesTopicId = directMessagesTopicId, ?messageThreadId = messageThreadId, ?vcard = vcard, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendContact"
     
@@ -1701,7 +1749,7 @@ type GetChatMemberCount =
     GetChatMemberCount.Make(ChatId.Int chatId)
   static member Make(chatId: string) = 
     GetChatMemberCount.Make(ChatId.String chatId)
-  interface IRequestBase<int> with
+  interface IRequestBase<int64> with
     member _.MethodName = "getChatMemberCount"
     
 type GetChatMember =
@@ -2956,6 +3004,106 @@ type StopPoll =
   interface IRequestBase<Poll> with
     member _.MethodName = "stopPoll"
     
+type EditEphemeralMessageText =
+  {
+    ChatId: ChatId
+    ReceiverUserId: int64
+    EphemeralMessageId: int64
+    Text: string
+    ParseMode: ParseMode option
+    Entities: MessageEntity[] option
+    LinkPreviewOptions: LinkPreviewOptions option
+    ReplyMarkup: InlineKeyboardMarkup option
+  }
+  static member Make(chatId: ChatId, receiverUserId: int64, ephemeralMessageId: int64, text: string, ?parseMode: ParseMode, ?entities: MessageEntity[], ?linkPreviewOptions: LinkPreviewOptions, ?replyMarkup: InlineKeyboardMarkup) = 
+    {
+      ChatId = chatId
+      ReceiverUserId = receiverUserId
+      EphemeralMessageId = ephemeralMessageId
+      Text = text
+      ParseMode = parseMode
+      Entities = entities
+      LinkPreviewOptions = linkPreviewOptions
+      ReplyMarkup = replyMarkup
+    }
+  static member Make(chatId: int64, receiverUserId: int64, ephemeralMessageId: int64, text: string, ?parseMode: ParseMode, ?entities: MessageEntity[], ?linkPreviewOptions: LinkPreviewOptions, ?replyMarkup: InlineKeyboardMarkup) = 
+    EditEphemeralMessageText.Make(ChatId.Int chatId, receiverUserId, ephemeralMessageId, text, ?parseMode = parseMode, ?entities = entities, ?linkPreviewOptions = linkPreviewOptions, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, receiverUserId: int64, ephemeralMessageId: int64, text: string, ?parseMode: ParseMode, ?entities: MessageEntity[], ?linkPreviewOptions: LinkPreviewOptions, ?replyMarkup: InlineKeyboardMarkup) = 
+    EditEphemeralMessageText.Make(ChatId.String chatId, receiverUserId, ephemeralMessageId, text, ?parseMode = parseMode, ?entities = entities, ?linkPreviewOptions = linkPreviewOptions, ?replyMarkup = replyMarkup)
+  interface IRequestBase<bool> with
+    member _.MethodName = "editEphemeralMessageText"
+    
+type EditEphemeralMessageMedia =
+  {
+    ChatId: ChatId
+    ReceiverUserId: int64
+    EphemeralMessageId: int64
+    Media: InputMedia
+    ReplyMarkup: InlineKeyboardMarkup option
+  }
+  static member Make(chatId: ChatId, receiverUserId: int64, ephemeralMessageId: int64, media: InputMedia, ?replyMarkup: InlineKeyboardMarkup) = 
+    {
+      ChatId = chatId
+      ReceiverUserId = receiverUserId
+      EphemeralMessageId = ephemeralMessageId
+      Media = media
+      ReplyMarkup = replyMarkup
+    }
+  static member Make(chatId: int64, receiverUserId: int64, ephemeralMessageId: int64, media: InputMedia, ?replyMarkup: InlineKeyboardMarkup) = 
+    EditEphemeralMessageMedia.Make(ChatId.Int chatId, receiverUserId, ephemeralMessageId, media, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, receiverUserId: int64, ephemeralMessageId: int64, media: InputMedia, ?replyMarkup: InlineKeyboardMarkup) = 
+    EditEphemeralMessageMedia.Make(ChatId.String chatId, receiverUserId, ephemeralMessageId, media, ?replyMarkup = replyMarkup)
+  interface IRequestBase<bool> with
+    member _.MethodName = "editEphemeralMessageMedia"
+    
+type EditEphemeralMessageCaption =
+  {
+    ChatId: ChatId
+    ReceiverUserId: int64
+    EphemeralMessageId: int64
+    Caption: string option
+    ParseMode: ParseMode option
+    CaptionEntities: MessageEntity[] option
+    ReplyMarkup: InlineKeyboardMarkup option
+  }
+  static member Make(chatId: ChatId, receiverUserId: int64, ephemeralMessageId: int64, ?caption: string, ?parseMode: ParseMode, ?captionEntities: MessageEntity[], ?replyMarkup: InlineKeyboardMarkup) = 
+    {
+      ChatId = chatId
+      ReceiverUserId = receiverUserId
+      EphemeralMessageId = ephemeralMessageId
+      Caption = caption
+      ParseMode = parseMode
+      CaptionEntities = captionEntities
+      ReplyMarkup = replyMarkup
+    }
+  static member Make(chatId: int64, receiverUserId: int64, ephemeralMessageId: int64, ?caption: string, ?parseMode: ParseMode, ?captionEntities: MessageEntity[], ?replyMarkup: InlineKeyboardMarkup) = 
+    EditEphemeralMessageCaption.Make(ChatId.Int chatId, receiverUserId, ephemeralMessageId, ?caption = caption, ?parseMode = parseMode, ?captionEntities = captionEntities, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, receiverUserId: int64, ephemeralMessageId: int64, ?caption: string, ?parseMode: ParseMode, ?captionEntities: MessageEntity[], ?replyMarkup: InlineKeyboardMarkup) = 
+    EditEphemeralMessageCaption.Make(ChatId.String chatId, receiverUserId, ephemeralMessageId, ?caption = caption, ?parseMode = parseMode, ?captionEntities = captionEntities, ?replyMarkup = replyMarkup)
+  interface IRequestBase<bool> with
+    member _.MethodName = "editEphemeralMessageCaption"
+    
+type EditEphemeralMessageReplyMarkup =
+  {
+    ChatId: ChatId
+    ReceiverUserId: int64
+    EphemeralMessageId: int64
+    ReplyMarkup: InlineKeyboardMarkup option
+  }
+  static member Make(chatId: ChatId, receiverUserId: int64, ephemeralMessageId: int64, ?replyMarkup: InlineKeyboardMarkup) = 
+    {
+      ChatId = chatId
+      ReceiverUserId = receiverUserId
+      EphemeralMessageId = ephemeralMessageId
+      ReplyMarkup = replyMarkup
+    }
+  static member Make(chatId: int64, receiverUserId: int64, ephemeralMessageId: int64, ?replyMarkup: InlineKeyboardMarkup) = 
+    EditEphemeralMessageReplyMarkup.Make(ChatId.Int chatId, receiverUserId, ephemeralMessageId, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, receiverUserId: int64, ephemeralMessageId: int64, ?replyMarkup: InlineKeyboardMarkup) = 
+    EditEphemeralMessageReplyMarkup.Make(ChatId.String chatId, receiverUserId, ephemeralMessageId, ?replyMarkup = replyMarkup)
+  interface IRequestBase<bool> with
+    member _.MethodName = "editEphemeralMessageReplyMarkup"
+    
 type ApproveSuggestedPost =
   {
     ChatId: int64
@@ -3020,6 +3168,25 @@ type DeleteMessages =
   interface IRequestBase<bool> with
     member _.MethodName = "deleteMessages"
     
+type DeleteEphemeralMessage =
+  {
+    ChatId: ChatId
+    ReceiverUserId: int64
+    EphemeralMessageId: int64
+  }
+  static member Make(chatId: ChatId, receiverUserId: int64, ephemeralMessageId: int64) = 
+    {
+      ChatId = chatId
+      ReceiverUserId = receiverUserId
+      EphemeralMessageId = ephemeralMessageId
+    }
+  static member Make(chatId: int64, receiverUserId: int64, ephemeralMessageId: int64) = 
+    DeleteEphemeralMessage.Make(ChatId.Int chatId, receiverUserId, ephemeralMessageId)
+  static member Make(chatId: string, receiverUserId: int64, ephemeralMessageId: int64) = 
+    DeleteEphemeralMessage.Make(ChatId.String chatId, receiverUserId, ephemeralMessageId)
+  interface IRequestBase<bool> with
+    member _.MethodName = "deleteEphemeralMessage"
+    
 type DeleteMessageReaction =
   {
     ChatId: ChatId
@@ -3066,6 +3233,8 @@ type SendSticker =
     ChatId: ChatId
     MessageThreadId: int64 option
     DirectMessagesTopicId: int64 option
+    ReceiverUserId: int64 option
+    CallbackQueryId: string option
     Sticker: InputFile
     Emoji: string option
     DisableNotification: bool option
@@ -3076,12 +3245,14 @@ type SendSticker =
     ReplyParameters: ReplyParameters option
     ReplyMarkup: Markup option
   }
-  static member Make(chatId: ChatId, sticker: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?emoji: string, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+  static member Make(chatId: ChatId, sticker: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?receiverUserId: int64, ?callbackQueryId: string, ?emoji: string, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
     {
       BusinessConnectionId = businessConnectionId
       ChatId = chatId
       MessageThreadId = messageThreadId
       DirectMessagesTopicId = directMessagesTopicId
+      ReceiverUserId = receiverUserId
+      CallbackQueryId = callbackQueryId
       Sticker = sticker
       Emoji = emoji
       DisableNotification = disableNotification
@@ -3092,10 +3263,10 @@ type SendSticker =
       ReplyParameters = replyParameters
       ReplyMarkup = replyMarkup
     }
-  static member Make(chatId: int64, sticker: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?emoji: string, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendSticker.Make(ChatId.Int chatId, sticker, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?emoji = emoji, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
-  static member Make(chatId: string, sticker: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?emoji: string, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
-    SendSticker.Make(ChatId.String chatId, sticker, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?emoji = emoji, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: int64, sticker: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?receiverUserId: int64, ?callbackQueryId: string, ?emoji: string, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendSticker.Make(ChatId.Int chatId, sticker, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?receiverUserId = receiverUserId, ?callbackQueryId = callbackQueryId, ?emoji = emoji, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
+  static member Make(chatId: string, sticker: InputFile, ?businessConnectionId: string, ?messageThreadId: int64, ?directMessagesTopicId: int64, ?receiverUserId: int64, ?callbackQueryId: string, ?emoji: string, ?disableNotification: bool, ?protectContent: bool, ?allowPaidBroadcast: bool, ?messageEffectId: string, ?suggestedPostParameters: SuggestedPostParameters, ?replyParameters: ReplyParameters, ?replyMarkup: Markup) = 
+    SendSticker.Make(ChatId.String chatId, sticker, ?businessConnectionId = businessConnectionId, ?messageThreadId = messageThreadId, ?directMessagesTopicId = directMessagesTopicId, ?receiverUserId = receiverUserId, ?callbackQueryId = callbackQueryId, ?emoji = emoji, ?disableNotification = disableNotification, ?protectContent = protectContent, ?allowPaidBroadcast = allowPaidBroadcast, ?messageEffectId = messageEffectId, ?suggestedPostParameters = suggestedPostParameters, ?replyParameters = replyParameters, ?replyMarkup = replyMarkup)
   interface IRequestBase<Message> with
     member _.MethodName = "sendSticker"
     
diff --git a/src/Funogram.Telegram/Types.fs b/src/Funogram.Telegram/Types.fs
index a37c55e..e523e0b 100644
--- a/src/Funogram.Telegram/Types.fs
+++ b/src/Funogram.Telegram/Types.fs
@@ -155,10 +155,14 @@ and [<CLIMutable>] Update =
     /// A new bot was created to be managed by the bot, or token or owner of a managed bot was changed
     [<DataMember(Name = "managed_bot")>]
     ManagedBot: ManagedBotUpdated option
+    /// User payment subscription has changed
+    [<DataMember(Name = "subscription")>]
+    Subscription: BotSubscriptionUpdated option
   }
-  static member Create(updateId: int64, ?chatBoost: ChatBoostUpdated, ?chatJoinRequest: ChatJoinRequest, ?chatMember: ChatMemberUpdated, ?myChatMember: ChatMemberUpdated, ?pollAnswer: PollAnswer, ?poll: Poll, ?purchasedPaidMedia: PaidMediaPurchased, ?preCheckoutQuery: PreCheckoutQuery, ?shippingQuery: ShippingQuery, ?callbackQuery: CallbackQuery, ?chosenInlineResult: ChosenInlineResult, ?inlineQuery: InlineQuery, ?messageReactionCount: MessageReactionCountUpdated, ?messageReaction: MessageReactionUpdated, ?guestMessage: Message, ?deletedBusinessMessages: BusinessMessagesDeleted, ?editedBusinessMessage: Message, ?businessMessage: Message, ?businessConnection: BusinessConnection, ?editedChannelPost: Message, ?channelPost: Message, ?editedMessage: Message, ?message: Message, ?removedChatBoost: ChatBoostRemoved, ?managedBot: ManagedBotUpdated) = 
+  static member Create(updateId: int64, ?removedChatBoost: ChatBoostRemoved, ?chatBoost: ChatBoostUpdated, ?chatJoinRequest: ChatJoinRequest, ?chatMember: ChatMemberUpdated, ?myChatMember: ChatMemberUpdated, ?pollAnswer: PollAnswer, ?poll: Poll, ?purchasedPaidMedia: PaidMediaPurchased, ?preCheckoutQuery: PreCheckoutQuery, ?shippingQuery: ShippingQuery, ?callbackQuery: CallbackQuery, ?managedBot: ManagedBotUpdated, ?chosenInlineResult: ChosenInlineResult, ?messageReactionCount: MessageReactionCountUpdated, ?messageReaction: MessageReactionUpdated, ?guestMessage: Message, ?deletedBusinessMessages: BusinessMessagesDeleted, ?editedBusinessMessage: Message, ?businessMessage: Message, ?businessConnection: BusinessConnection, ?editedChannelPost: Message, ?channelPost: Message, ?editedMessage: Message, ?message: Message, ?inlineQuery: InlineQuery, ?subscription: BotSubscriptionUpdated) = 
     {
       UpdateId = updateId
+      RemovedChatBoost = removedChatBoost
       ChatBoost = chatBoost
       ChatJoinRequest = chatJoinRequest
       ChatMember = chatMember
@@ -169,8 +173,8 @@ and [<CLIMutable>] Update =
       PreCheckoutQuery = preCheckoutQuery
       ShippingQuery = shippingQuery
       CallbackQuery = callbackQuery
+      ManagedBot = managedBot
       ChosenInlineResult = chosenInlineResult
-      InlineQuery = inlineQuery
       MessageReactionCount = messageReactionCount
       MessageReaction = messageReaction
       GuestMessage = guestMessage
@@ -182,8 +186,8 @@ and [<CLIMutable>] Update =
       ChannelPost = channelPost
       EditedMessage = editedMessage
       Message = message
-      RemovedChatBoost = removedChatBoost
-      ManagedBot = managedBot
+      InlineQuery = inlineQuery
+      Subscription = subscription
     }
 
 /// Describes the current status of a webhook.
@@ -511,15 +515,17 @@ and [<CLIMutable>] ChatFullInfo =
     /// The bot that processes join request queries in the chat. The field is only available to chat administrators.
     [<DataMember(Name = "guard_bot")>]
     GuardBot: User option
+    /// The Community to which the chat belongs
+    [<DataMember(Name = "community")>]
+    Community: Community option
   }
-  static member Create(id: int64, ``type``: string, acceptedGiftTypes: AcceptedGiftTypes, accentColorId: int64, maxReactionCount: int64, ?description: string, ?inviteLink: string, ?pinnedMessage: Message, ?permissions: ChatPermissions, ?canSendPaidMedia: bool, ?slowModeDelay: int64, ?unrestrictBoostCount: int64, ?messageAutoDeleteTime: int64, ?hasAggressiveAntiSpamEnabled: bool, ?hasProtectedContent: bool, ?joinByRequest: bool, ?hasVisibleHistory: bool, ?stickerSetName: string, ?canSetStickerSet: bool, ?customEmojiStickerSetName: string, ?linkedChatId: int64, ?location: ChatLocation, ?rating: UserRating, ?firstProfileAudio: Audio, ?uniqueGiftColors: UniqueGiftColors, ?hasHiddenMembers: bool, ?joinToSendMessages: bool, ?hasPrivateForwards: bool, ?paidMessageStarCount: int64, ?title: string, ?username: string, ?firstName: string, ?lastName: string, ?isForum: bool, ?isDirectMessages: bool, ?photo: ChatPhoto, ?activeUsernames: string[], ?birthdate: Birthdate, ?businessIntro: BusinessIntro, ?businessLocation: BusinessLocation, ?businessOpeningHours: BusinessOpeningHours, ?personalChat: Chat, ?parentChat: Chat, ?availableReactions: ReactionType[], ?backgroundCustomEmojiId: string, ?profileAccentColorId: int64, ?profileBackgroundCustomEmojiId: string, ?emojiStatusCustomEmojiId: string, ?emojiStatusExpirationDate: int64, ?bio: string, ?hasRestrictedVoiceAndVideoMessages: bool, ?guardBot: User) = 
+  static member Create(id: int64, ``type``: string, acceptedGiftTypes: AcceptedGiftTypes, accentColorId: int64, maxReactionCount: int64, ?inviteLink: string, ?pinnedMessage: Message, ?permissions: ChatPermissions, ?canSendPaidMedia: bool, ?slowModeDelay: int64, ?unrestrictBoostCount: int64, ?messageAutoDeleteTime: int64, ?hasAggressiveAntiSpamEnabled: bool, ?hasHiddenMembers: bool, ?hasVisibleHistory: bool, ?description: string, ?stickerSetName: string, ?canSetStickerSet: bool, ?customEmojiStickerSetName: string, ?linkedChatId: int64, ?location: ChatLocation, ?rating: UserRating, ?firstProfileAudio: Audio, ?uniqueGiftColors: UniqueGiftColors, ?paidMessageStarCount: int64, ?hasProtectedContent: bool, ?joinByRequest: bool, ?hasRestrictedVoiceAndVideoMessages: bool, ?guardBot: User, ?title: string, ?username: string, ?firstName: string, ?lastName: string, ?isForum: bool, ?isDirectMessages: bool, ?photo: ChatPhoto, ?activeUsernames: string[], ?birthdate: Birthdate, ?businessIntro: BusinessIntro, ?joinToSendMessages: bool, ?businessLocation: BusinessLocation, ?personalChat: Chat, ?parentChat: Chat, ?availableReactions: ReactionType[], ?backgroundCustomEmojiId: string, ?profileAccentColorId: int64, ?profileBackgroundCustomEmojiId: string, ?emojiStatusCustomEmojiId: string, ?emojiStatusExpirationDate: int64, ?bio: string, ?hasPrivateForwards: bool, ?businessOpeningHours: BusinessOpeningHours, ?community: Community) = 
     {
       Id = id
       Type = ``type``
       AcceptedGiftTypes = acceptedGiftTypes
       AccentColorId = accentColorId
       MaxReactionCount = maxReactionCount
-      Description = description
       InviteLink = inviteLink
       PinnedMessage = pinnedMessage
       Permissions = permissions
@@ -528,9 +534,9 @@ and [<CLIMutable>] ChatFullInfo =
       UnrestrictBoostCount = unrestrictBoostCount
       MessageAutoDeleteTime = messageAutoDeleteTime
       HasAggressiveAntiSpamEnabled = hasAggressiveAntiSpamEnabled
-      HasProtectedContent = hasProtectedContent
-      JoinByRequest = joinByRequest
+      HasHiddenMembers = hasHiddenMembers
       HasVisibleHistory = hasVisibleHistory
+      Description = description
       StickerSetName = stickerSetName
       CanSetStickerSet = canSetStickerSet
       CustomEmojiStickerSetName = customEmojiStickerSetName
@@ -539,10 +545,11 @@ and [<CLIMutable>] ChatFullInfo =
       Rating = rating
       FirstProfileAudio = firstProfileAudio
       UniqueGiftColors = uniqueGiftColors
-      HasHiddenMembers = hasHiddenMembers
-      JoinToSendMessages = joinToSendMessages
-      HasPrivateForwards = hasPrivateForwards
       PaidMessageStarCount = paidMessageStarCount
+      HasProtectedContent = hasProtectedContent
+      JoinByRequest = joinByRequest
+      HasRestrictedVoiceAndVideoMessages = hasRestrictedVoiceAndVideoMessages
+      GuardBot = guardBot
       Title = title
       Username = username
       FirstName = firstName
@@ -553,8 +560,8 @@ and [<CLIMutable>] ChatFullInfo =
       ActiveUsernames = activeUsernames
       Birthdate = birthdate
       BusinessIntro = businessIntro
+      JoinToSendMessages = joinToSendMessages
       BusinessLocation = businessLocation
-      BusinessOpeningHours = businessOpeningHours
       PersonalChat = personalChat
       ParentChat = parentChat
       AvailableReactions = availableReactions
@@ -564,14 +571,15 @@ and [<CLIMutable>] ChatFullInfo =
       EmojiStatusCustomEmojiId = emojiStatusCustomEmojiId
       EmojiStatusExpirationDate = emojiStatusExpirationDate
       Bio = bio
-      HasRestrictedVoiceAndVideoMessages = hasRestrictedVoiceAndVideoMessages
-      GuardBot = guardBot
+      HasPrivateForwards = hasPrivateForwards
+      BusinessOpeningHours = businessOpeningHours
+      Community = community
     }
 
 /// This object represents a message.
 and [<CLIMutable>] Message =
   {
-    /// 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.
+    /// Unique message identifier inside this chat; 0 for ephemeral messages. In specific instances (e.g., a 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.
     [<DataMember(Name = "message_id")>]
     MessageId: int64
     /// Unique identifier of a message thread or forum topic to which the message belongs; for supergroups and private chats only
@@ -595,6 +603,12 @@ and [<CLIMutable>] Message =
     /// Tag or custom title of the sender of the message; for supergroups only
     [<DataMember(Name = "sender_tag")>]
     SenderTag: string option
+    /// For ephemeral messages, the user who received the message
+    [<DataMember(Name = "receiver_user")>]
+    ReceiverUser: User option
+    /// For ephemeral messages, identifier of the ephemeral message inside this chat. The identifier may be reused for another ephemeral message after the message is deleted or expires.
+    [<DataMember(Name = "ephemeral_message_id")>]
+    EphemeralMessageId: int64 option
     /// Date the message was sent in Unix time. It is always a positive number, representing a valid date.
     [<DataMember(Name = "date")>]
     Date: DateTime
@@ -616,7 +630,7 @@ and [<CLIMutable>] Message =
     /// True, if the message is a channel post that was automatically forwarded to the connected discussion group
     [<DataMember(Name = "is_automatic_forward")>]
     IsAutomaticForward: bool option
-    /// For replies in the same chat and message thread, the original message. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply.
+    /// For replies in the same chat and message thread, the original message. Note that the Message object in this field will not contain further reply_to_message fields even if it itself is a reply. If the message is a reply to an ephemeral message, then this field may be omitted.
     [<DataMember(Name = "reply_to_message")>]
     ReplyToMessage: Message option
     /// Information about the message that is being replied to, which may come from another chat or forum topic
@@ -823,7 +837,7 @@ and [<CLIMutable>] Message =
     /// Telegram Passport data
     [<DataMember(Name = "passport_data")>]
     PassportData: PassportData option
-    /// Service message. A user in the chat triggered another user's proximity alert while sharing Live Location.
+    /// Service message: a user in the chat triggered another user's proximity alert while sharing Live Location
     [<DataMember(Name = "proximity_alert_triggered")>]
     ProximityAlertTriggered: ProximityAlertTriggered option
     /// Service message: user boosted the chat
@@ -838,6 +852,12 @@ and [<CLIMutable>] Message =
     /// Service message: tasks were added to a checklist
     [<DataMember(Name = "checklist_tasks_added")>]
     ChecklistTasksAdded: ChecklistTasksAdded option
+    /// Service message: chat added to a Community
+    [<DataMember(Name = "community_chat_added")>]
+    CommunityChatAdded: CommunityChatAdded option
+    /// Service message: chat removed from a Community
+    [<DataMember(Name = "community_chat_removed")>]
+    CommunityChatRemoved: CommunityChatRemoved option
     /// Service message: the price for paid messages in the corresponding direct messages chat of a channel has changed
     [<DataMember(Name = "direct_message_price_changed")>]
     DirectMessagePriceChanged: DirectMessagePriceChanged option
@@ -917,11 +937,12 @@ and [<CLIMutable>] Message =
     [<DataMember(Name = "reply_markup")>]
     ReplyMarkup: InlineKeyboardMarkup option
   }
-  static member Create(messageId: int64, date: DateTime, chat: Chat, ?passportData: PassportData, ?writeAccessAllowed: WriteAccessAllowed, ?connectedWebsite: string, ?giftUpgradeSent: GiftInfo, ?uniqueGift: UniqueGiftInfo, ?gift: GiftInfo, ?chatShared: ChatShared, ?usersShared: UsersShared, ?refundedPayment: RefundedPayment, ?successfulPayment: SuccessfulPayment, ?invoice: Invoice, ?pinnedMessage: MaybeInaccessibleMessage, ?migrateFromChatId: int64, ?migrateToChatId: int64, ?messageAutoDeleteTimerChanged: MessageAutoDeleteTimerChanged, ?channelChatCreated: bool, ?supergroupChatCreated: bool, ?groupChatCreated: bool, ?deleteChatPhoto: bool, ?newChatPhoto: PhotoSize[], ?newChatTitle: string, ?chatOwnerChanged: ChatOwnerChanged, ?chatOwnerLeft: ChatOwnerLeft, ?leftChatMember: User, ?proximityAlertTriggered: ProximityAlertTriggered, ?boostAdded: ChatBoostAdded, ?checklistTasksDone: ChecklistTasksDone, ?newChatMembers: User[], ?videoChatParticipantsInvited: VideoChatParticipantsInvited, ?videoChatEnded: VideoChatEnded, ?videoChatStarted: VideoChatStarted, ?videoChatScheduled: VideoChatScheduled, ?suggestedPostRefunded: SuggestedPostRefunded, ?suggestedPostPaid: SuggestedPostPaid, ?suggestedPostDeclined: SuggestedPostDeclined, ?suggestedPostApprovalFailed: SuggestedPostApprovalFailed, ?suggestedPostApproved: SuggestedPostApproved, ?pollOptionDeleted: PollOptionDeleted, ?pollOptionAdded: PollOptionAdded, ?paidMessagePriceChanged: PaidMessagePriceChanged, ?managedBotCreated: ManagedBotCreated, ?giveawayCompleted: GiveawayCompleted, ?giveawayWinners: GiveawayWinners, ?giveaway: Giveaway, ?giveawayCreated: GiveawayCreated, ?generalForumTopicUnhidden: GeneralForumTopicUnhidden, ?generalForumTopicHidden: GeneralForumTopicHidden, ?forumTopicReopened: ForumTopicReopened, ?forumTopicClosed: ForumTopicClosed, ?forumTopicEdited: ForumTopicEdited, ?forumTopicCreated: ForumTopicCreated, ?directMessagePriceChanged: DirectMessagePriceChanged, ?checklistTasksAdded: ChecklistTasksAdded, ?chatBackgroundSet: ChatBackground, ?location: Location, ?venue: Venue, ?poll: Poll, ?isFromOffline: bool, ?hasProtectedContent: bool, ?editDate: int64, ?guestBotCallerChat: Chat, ?guestBotCallerUser: User, ?viaBot: User, ?replyToPollOptionId: string, ?replyToChecklistTaskId: int64, ?replyToStory: Story, ?quote: TextQuote, ?externalReply: ExternalReplyInfo, ?isPaidPost: bool, ?replyToMessage: Message, ?isTopicMessage: bool, ?forwardOrigin: MessageOrigin, ?businessConnectionId: string, ?guestQueryId: string, ?senderTag: string, ?senderBusinessBot: User, ?senderBoostCount: int64, ?senderChat: Chat, ?from: User, ?directMessagesTopic: DirectMessagesTopic, ?messageThreadId: int64, ?isAutomaticForward: bool, ?mediaGroupId: string, ?authorSignature: string, ?paidStarCount: int64, ?game: Game, ?dice: Dice, ?contact: Contact, ?checklist: Checklist, ?hasMediaSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?caption: string, ?voice: Voice, ?videoNote: VideoNote, ?video: Video, ?story: Story, ?sticker: Sticker, ?photo: PhotoSize[], ?paidMedia: PaidMediaInfo, ?livePhoto: LivePhoto, ?document: Document, ?audio: Audio, ?animation: Animation, ?richMessage: RichMessage, ?effectId: string, ?suggestedPostInfo: SuggestedPostInfo, ?linkPreviewOptions: LinkPreviewOptions, ?entities: MessageEntity[], ?text: string, ?webAppData: WebAppData, ?replyMarkup: InlineKeyboardMarkup) = 
+  static member Create(messageId: int64, date: DateTime, chat: Chat, ?proximityAlertTriggered: ProximityAlertTriggered, ?passportData: PassportData, ?writeAccessAllowed: WriteAccessAllowed, ?connectedWebsite: string, ?giftUpgradeSent: GiftInfo, ?uniqueGift: UniqueGiftInfo, ?gift: GiftInfo, ?chatShared: ChatShared, ?usersShared: UsersShared, ?refundedPayment: RefundedPayment, ?successfulPayment: SuccessfulPayment, ?invoice: Invoice, ?migrateFromChatId: int64, ?boostAdded: ChatBoostAdded, ?migrateToChatId: int64, ?messageAutoDeleteTimerChanged: MessageAutoDeleteTimerChanged, ?channelChatCreated: bool, ?supergroupChatCreated: bool, ?groupChatCreated: bool, ?deleteChatPhoto: bool, ?newChatPhoto: PhotoSize[], ?newChatTitle: string, ?chatOwnerChanged: ChatOwnerChanged, ?chatOwnerLeft: ChatOwnerLeft, ?leftChatMember: User, ?pinnedMessage: MaybeInaccessibleMessage, ?chatBackgroundSet: ChatBackground, ?checklistTasksAdded: ChecklistTasksAdded, ?newChatMembers: User[], ?videoChatParticipantsInvited: VideoChatParticipantsInvited, ?videoChatEnded: VideoChatEnded, ?videoChatStarted: VideoChatStarted, ?videoChatScheduled: VideoChatScheduled, ?suggestedPostRefunded: SuggestedPostRefunded, ?suggestedPostPaid: SuggestedPostPaid, ?suggestedPostDeclined: SuggestedPostDeclined, ?suggestedPostApprovalFailed: SuggestedPostApprovalFailed, ?suggestedPostApproved: SuggestedPostApproved, ?pollOptionDeleted: PollOptionDeleted, ?pollOptionAdded: PollOptionAdded, ?paidMessagePriceChanged: PaidMessagePriceChanged, ?checklistTasksDone: ChecklistTasksDone, ?managedBotCreated: ManagedBotCreated, ?giveawayWinners: GiveawayWinners, ?giveaway: Giveaway, ?giveawayCreated: GiveawayCreated, ?generalForumTopicUnhidden: GeneralForumTopicUnhidden, ?generalForumTopicHidden: GeneralForumTopicHidden, ?forumTopicReopened: ForumTopicReopened, ?forumTopicClosed: ForumTopicClosed, ?forumTopicEdited: ForumTopicEdited, ?forumTopicCreated: ForumTopicCreated, ?directMessagePriceChanged: DirectMessagePriceChanged, ?communityChatRemoved: CommunityChatRemoved, ?communityChatAdded: CommunityChatAdded, ?giveawayCompleted: GiveawayCompleted, ?location: Location, ?venue: Venue, ?poll: Poll, ?hasProtectedContent: bool, ?editDate: int64, ?guestBotCallerChat: Chat, ?guestBotCallerUser: User, ?viaBot: User, ?replyToPollOptionId: string, ?replyToChecklistTaskId: int64, ?replyToStory: Story, ?quote: TextQuote, ?externalReply: ExternalReplyInfo, ?replyToMessage: Message, ?isAutomaticForward: bool, ?isTopicMessage: bool, ?forwardOrigin: MessageOrigin, ?businessConnectionId: string, ?guestQueryId: string, ?ephemeralMessageId: int64, ?receiverUser: User, ?senderTag: string, ?senderBusinessBot: User, ?senderBoostCount: int64, ?senderChat: Chat, ?from: User, ?directMessagesTopic: DirectMessagesTopic, ?messageThreadId: int64, ?isFromOffline: bool, ?isPaidPost: bool, ?mediaGroupId: string, ?authorSignature: string, ?game: Game, ?dice: Dice, ?contact: Contact, ?checklist: Checklist, ?hasMediaSpoiler: bool, ?showCaptionAboveMedia: bool, ?captionEntities: MessageEntity[], ?caption: string, ?voice: Voice, ?videoNote: VideoNote, ?video: Video, ?story: Story, ?webAppData: WebAppData, ?sticker: Sticker, ?paidMedia: PaidMediaInfo, ?livePhoto: LivePhoto, ?document: Document, ?audio: Audio, ?animation: Animation, ?richMessage: RichMessage, ?effectId: string, ?suggestedPostInfo: SuggestedPostInfo, ?linkPreviewOptions: LinkPreviewOptions, ?entities: MessageEntity[], ?text: string, ?paidStarCount: int64, ?photo: PhotoSize[], ?replyMarkup: InlineKeyboardMarkup) = 
     {
       MessageId = messageId
       Date = date
       Chat = chat
+      ProximityAlertTriggered = proximityAlertTriggered
       PassportData = passportData
       WriteAccessAllowed = writeAccessAllowed
       ConnectedWebsite = connectedWebsite
@@ -933,8 +954,8 @@ and [<CLIMutable>] Message =
       RefundedPayment = refundedPayment
       SuccessfulPayment = successfulPayment
       Invoice = invoice
-      PinnedMessage = pinnedMessage
       MigrateFromChatId = migrateFromChatId
+      BoostAdded = boostAdded
       MigrateToChatId = migrateToChatId
       MessageAutoDeleteTimerChanged = messageAutoDeleteTimerChanged
       ChannelChatCreated = channelChatCreated
@@ -946,9 +967,9 @@ and [<CLIMutable>] Message =
       ChatOwnerChanged = chatOwnerChanged
       ChatOwnerLeft = chatOwnerLeft
       LeftChatMember = leftChatMember
-      ProximityAlertTriggered = proximityAlertTriggered
-      BoostAdded = boostAdded
-      ChecklistTasksDone = checklistTasksDone
+      PinnedMessage = pinnedMessage
+      ChatBackgroundSet = chatBackgroundSet
+      ChecklistTasksAdded = checklistTasksAdded
       NewChatMembers = newChatMembers
       VideoChatParticipantsInvited = videoChatParticipantsInvited
       VideoChatEnded = videoChatEnded
@@ -962,8 +983,8 @@ and [<CLIMutable>] Message =
       PollOptionDeleted = pollOptionDeleted
       PollOptionAdded = pollOptionAdded
       PaidMessagePriceChanged = paidMessagePriceChanged
+      ChecklistTasksDone = checklistTasksDone
       ManagedBotCreated = managedBotCreated
-      GiveawayCompleted = giveawayCompleted
       GiveawayWinners = giveawayWinners
       Giveaway = giveaway
       GiveawayCreated = giveawayCreated
@@ -974,12 +995,12 @@ and [<CLIMutable>] Message =
       ForumTopicEdited = forumTopicEdited
       ForumTopicCreated = forumTopicCreated
       DirectMessagePriceChanged = directMessagePriceChanged
-      ChecklistTasksAdded = checklistTasksAdded
-      ChatBackgroundSet = chatBackgroundSet
+      CommunityChatRemoved = communityChatRemoved
+      CommunityChatAdded = communityChatAdded
+      GiveawayCompleted = giveawayCompleted
       Location = location
       Venue = venue
       Poll = poll
-      IsFromOffline = isFromOffline
       HasProtectedContent = hasProtectedContent
       EditDate = editDate
       GuestBotCallerChat = guestBotCallerChat
@@ -990,12 +1011,14 @@ and [<CLIMutable>] Message =
       ReplyToStory = replyToStory
       Quote = quote
       ExternalReply = externalReply
-      IsPaidPost = isPaidPost
       ReplyToMessage = replyToMessage
+      IsAutomaticForward = isAutomaticForward
       IsTopicMessage = isTopicMessage
       ForwardOrigin = forwardOrigin
       BusinessConnectionId = businessConnectionId
       GuestQueryId = guestQueryId
+      EphemeralMessageId = ephemeralMessageId
+      ReceiverUser = receiverUser
       SenderTag = senderTag
       SenderBusinessBot = senderBusinessBot
       SenderBoostCount = senderBoostCount
@@ -1003,10 +1026,10 @@ and [<CLIMutable>] Message =
       From = from
       DirectMessagesTopic = directMessagesTopic
       MessageThreadId = messageThreadId
-      IsAutomaticForward = isAutomaticForward
+      IsFromOffline = isFromOffline
+      IsPaidPost = isPaidPost
       MediaGroupId = mediaGroupId
       AuthorSignature = authorSignature
-      PaidStarCount = paidStarCount
       Game = game
       Dice = dice
       Contact = contact
@@ -1019,8 +1042,8 @@ and [<CLIMutable>] Message =
       VideoNote = videoNote
       Video = video
       Story = story
+      WebAppData = webAppData
       Sticker = sticker
-      Photo = photo
       PaidMedia = paidMedia
       LivePhoto = livePhoto
       Document = document
@@ -1032,7 +1055,8 @@ and [<CLIMutable>] Message =
       LinkPreviewOptions = linkPreviewOptions
       Entities = entities
       Text = text
-      WebAppData = webAppData
+      PaidStarCount = paidStarCount
+      Photo = photo
       ReplyMarkup = replyMarkup
     }
 
@@ -1256,16 +1280,19 @@ and [<CLIMutable>] ExternalReplyInfo =
 /// Describes reply parameters for the message that is being sent.
 and [<CLIMutable>] ReplyParameters =
   {
-    /// Identifier of the message that will be replied to in the current chat, or in the chat chat_id if it is specified
+    /// Identifier of the message that will be replied to in the current chat, or in the chat chat_id if it is specified. Required if ephemeral_message_id isn't specified.
     [<DataMember(Name = "message_id")>]
-    MessageId: int64
-    /// If the message to be replied to is from a different chat, unique identifier for the chat or username of the bot, supergroup or channel in the format @username. Not supported for messages sent on behalf of a business account and messages from channel direct messages chats.
+    MessageId: int64 option
+    /// If the message to be replied to is from a different chat, unique identifier for the chat or username of the bot, supergroup or channel in the format @username. Not supported for messages sent on behalf of a business account, messages from channel direct messages chats and ephemeral messages.
     [<DataMember(Name = "chat_id")>]
     ChatId: ChatId option
-    /// Pass True if the message should be sent even if the specified message to be replied to is not found. Always False for replies in another chat or forum topic. Always True for messages sent on behalf of a business account.
+    /// Identifier of the incoming ephemeral message that will be replied to in the current chat. A reply to an ephemeral message must itself be an ephemeral message. An ephemeral message may only be replied to within 15 seconds of being sent. Required if message_id isn't specified.
+    [<DataMember(Name = "ephemeral_message_id")>]
+    EphemeralMessageId: int64 option
+    /// Pass True if the message should be sent even if the specified message to be replied to is not found. Always False for replies in another chat or forum topic, and sent ephemeral messages. Always True for messages sent on behalf of a business account.
     [<DataMember(Name = "allow_sending_without_reply")>]
     AllowSendingWithoutReply: bool option
-    /// 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, custom_emoji, and date_time entities. The message will fail to send if the quote isn't found in the original message.
+    /// 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, custom_emoji, and date_time entities. The message will fail to send if the quote isn't found in the original message. Ignored for ephemeral messages.
     [<DataMember(Name = "quote")>]
     Quote: string option
     /// Mode for parsing entities in the quote. See formatting options for more details.
@@ -1284,10 +1311,11 @@ and [<CLIMutable>] ReplyParameters =
     [<DataMember(Name = "poll_option_id")>]
     PollOptionId: string option
   }
-  static member Create(messageId: int64, ?chatId: ChatId, ?allowSendingWithoutReply: bool, ?quote: string, ?quoteParseMode: string, ?quoteEntities: MessageEntity[], ?quotePosition: int64, ?checklistTaskId: int64, ?pollOptionId: string) = 
+  static member Create(?messageId: int64, ?chatId: ChatId, ?ephemeralMessageId: int64, ?allowSendingWithoutReply: bool, ?quote: string, ?quoteParseMode: string, ?quoteEntities: MessageEntity[], ?quotePosition: int64, ?checklistTaskId: int64, ?pollOptionId: string) = 
     {
       MessageId = messageId
       ChatId = chatId
+      EphemeralMessageId = ephemeralMessageId
       AllowSendingWithoutReply = allowSendingWithoutReply
       Quote = quote
       QuoteParseMode = quoteParseMode
@@ -2269,42 +2297,6 @@ and [<CLIMutable>] InputChecklist =
       OthersCanMarkTasksAsDone = othersCanMarkTasksAsDone
     }
 
-/// Describes a service message about checklist tasks marked as done or not done.
-and [<CLIMutable>] ChecklistTasksDone =
-  {
-    /// Message containing the checklist whose tasks were marked as done or not done. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply.
-    [<DataMember(Name = "checklist_message")>]
-    ChecklistMessage: Message option
-    /// Identifiers of the tasks that were marked as done
-    [<DataMember(Name = "marked_as_done_task_ids")>]
-    MarkedAsDoneTaskIds: int64[] option
-    /// Identifiers of the tasks that were marked as not done
-    [<DataMember(Name = "marked_as_not_done_task_ids")>]
-    MarkedAsNotDoneTaskIds: int64[] option
-  }
-  static member Create(?checklistMessage: Message, ?markedAsDoneTaskIds: int64[], ?markedAsNotDoneTaskIds: int64[]) = 
-    {
-      ChecklistMessage = checklistMessage
-      MarkedAsDoneTaskIds = markedAsDoneTaskIds
-      MarkedAsNotDoneTaskIds = markedAsNotDoneTaskIds
-    }
-
-/// Describes a service message about tasks added to a checklist.
-and [<CLIMutable>] ChecklistTasksAdded =
-  {
-    /// Message containing the checklist to which the tasks were added. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply.
-    [<DataMember(Name = "checklist_message")>]
-    ChecklistMessage: Message option
-    /// List of tasks added to the checklist
-    [<DataMember(Name = "tasks")>]
-    Tasks: ChecklistTask[]
-  }
-  static member Create(tasks: ChecklistTask[], ?checklistMessage: Message) = 
-    {
-      Tasks = tasks
-      ChecklistMessage = checklistMessage
-    }
-
 /// This object represents a point on the map.
 and [<CLIMutable>] Location =
   {
@@ -2449,6 +2441,26 @@ and [<CLIMutable>] ManagedBotUpdated =
       Bot = bot
     }
 
+/// This object contains information about changes to a user payment subscription toward the current bot.
+and [<CLIMutable>] BotSubscriptionUpdated =
+  {
+    /// User who subscribed for payments toward the bot
+    [<DataMember(Name = "user")>]
+    User: User
+    /// Bot-specified invoice payload
+    [<DataMember(Name = "invoice_payload")>]
+    InvoicePayload: string
+    /// The new state of the subscription. Currently, it can be one of “canceled” if the user canceled the subscription, “active” if the user re-enabled a previously canceled subscription, or “failed” if payment for the subscription failed.
+    [<DataMember(Name = "state")>]
+    State: string
+  }
+  static member Create(user: User, invoicePayload: string, state: string) = 
+    {
+      User = user
+      InvoicePayload = invoicePayload
+      State = state
+    }
+
 /// Describes a service message about an option added to a poll.
 and [<CLIMutable>] PollOptionAdded =
   {
@@ -2686,6 +2698,58 @@ and [<CLIMutable>] ChatBackground =
       Type = ``type``
     }
 
+/// Describes a service message about checklist tasks marked as done or not done.
+and [<CLIMutable>] ChecklistTasksDone =
+  {
+    /// Message containing the checklist whose tasks were marked as done or not done. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply.
+    [<DataMember(Name = "checklist_message")>]
+    ChecklistMessage: Message option
+    /// Identifiers of the tasks that were marked as done
+    [<DataMember(Name = "marked_as_done_task_ids")>]
+    MarkedAsDoneTaskIds: int64[] option
+    /// Identifiers of the tasks that were marked as not done
+    [<DataMember(Name = "marked_as_not_done_task_ids")>]
+    MarkedAsNotDoneTaskIds: int64[] option
+  }
+  static member Create(?checklistMessage: Message, ?markedAsDoneTaskIds: int64[], ?markedAsNotDoneTaskIds: int64[]) = 
+    {
+      ChecklistMessage = checklistMessage
+      MarkedAsDoneTaskIds = markedAsDoneTaskIds
+      MarkedAsNotDoneTaskIds = markedAsNotDoneTaskIds
+    }
+
+/// Describes a service message about tasks added to a checklist.
+and [<CLIMutable>] ChecklistTasksAdded =
+  {
+    /// Message containing the checklist to which the tasks were added. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply.
+    [<DataMember(Name = "checklist_message")>]
+    ChecklistMessage: Message option
+    /// List of tasks added to the checklist
+    [<DataMember(Name = "tasks")>]
+    Tasks: ChecklistTask[]
+  }
+  static member Create(tasks: ChecklistTask[], ?checklistMessage: Message) = 
+    {
+      Tasks = tasks
+      ChecklistMessage = checklistMessage
+    }
+
+/// Describes a service message about a chat being added to a community.
+and [<CLIMutable>] CommunityChatAdded =
+  {
+    /// The new community to which the chat belongs
+    [<DataMember(Name = "community")>]
+    Community: Community
+  }
+  static member Create(community: Community) = 
+    {
+      Community = community
+    }
+
+/// Describes a service message about a chat being removed from a community. Currently holds no information.
+and CommunityChatRemoved =
+  new() = {}
+
 /// This object represents a service message about a new forum topic created in the chat.
 and [<CLIMutable>] ForumTopicCreated =
   {
@@ -2901,7 +2965,7 @@ and [<CLIMutable>] PaidMessagePriceChanged =
 /// Describes a service message about a change in the price of direct messages sent to a channel chat.
 and [<CLIMutable>] DirectMessagePriceChanged =
   {
-    /// True, if direct messages are enabled for the channel chat; false otherwise
+    /// True, if direct messages are enabled for the channel chat; False otherwise
     [<DataMember(Name = "are_direct_messages_enabled")>]
     AreDirectMessagesEnabled: bool
     /// The new number of Telegram Stars that must be paid by users for each direct message sent to the channel. Does not apply to users who have been exempted by administrators. Defaults to 0.
@@ -2972,10 +3036,10 @@ and [<CLIMutable>] SuggestedPostPaid =
     /// Message containing the suggested post. Note that the Message object in this field will not contain the reply_to_message field even if it itself is a reply.
     [<DataMember(Name = "suggested_post_message")>]
     SuggestedPostMessage: Message option
-    /// Currency in which the payment was made. Currently, one of “XTR” for Telegram Stars or “TON” for toncoins.
+    /// Currency in which the payment was made. Currently, one of “XTR” for Telegram Stars or “TON” for TON grams.
     [<DataMember(Name = "currency")>]
     Currency: string
-    /// The amount of the currency that was received by the channel in nanotoncoins; for payments in toncoins only
+    /// The amount of the currency that was received by the channel in nanograms; for payments in TON grams only
     [<DataMember(Name = "amount")>]
     Amount: int64 option
     /// The amount of Telegram Stars that was received by the channel; for payments in Telegram Stars only
@@ -3173,10 +3237,10 @@ and [<CLIMutable>] LinkPreviewOptions =
 /// Describes the price of a suggested post.
 and [<CLIMutable>] SuggestedPostPrice =
   {
-    /// Currency in which the post will be paid. Currently, must be one of “XTR” for Telegram Stars or “TON” for toncoins.
+    /// Currency in which the post will be paid. Currently, must be one of “XTR” for Telegram Stars or “TON” for TON grams.
     [<DataMember(Name = "currency")>]
     Currency: string
-    /// The amount of the currency that will be paid for the post in the smallest units of the currency, i.e. Telegram Stars or nanotoncoins. Currently, price in Telegram Stars must be between 5 and 100000, and price in nanotoncoins must be between 10000000 and 10000000000000.
+    /// The amount of the currency that will be paid for the post in the smallest units of the currency, i.e. Telegram Stars or nanograms. Currently, price in Telegram Stars must be between 5 and 100000, and price in nanograms must be between 10000000 and 10000000000000.
     [<DataMember(Name = "amount")>]
     Amount: int64
   }
@@ -3312,13 +3376,13 @@ and [<CLIMutable>] ReplyKeyboardMarkup =
     /// Array of button rows, each represented by an Array of KeyboardButton objects
     [<DataMember(Name = "keyboard")>]
     Keyboard: KeyboardButton[][]
-    /// Requests clients to always show the keyboard when the regular keyboard is hidden. Defaults to false, in which case the custom keyboard can be hidden and opened with a keyboard icon.
+    /// Requests clients to always show the keyboard when the regular keyboard is hidden. Defaults to False, in which case the custom keyboard can be hidden and opened with a keyboard icon.
     [<DataMember(Name = "is_persistent")>]
     IsPersistent: bool option
-    /// Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). Defaults to false, in which case the custom keyboard is always of the same height as the app's standard keyboard.
+    /// Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). Defaults to False, in which case the custom keyboard is always of the same height as the app's standard keyboard.
     [<DataMember(Name = "resize_keyboard")>]
     ResizeKeyboard: bool option
-    /// Requests clients to hide the keyboard as soon as it's been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat - the user can press a special button in the input field to see the custom keyboard again. Defaults to false.
+    /// Requests clients to hide the keyboard as soon as it's been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat - the user can press a special button in the input field to see the custom keyboard again. Defaults to False.
     [<DataMember(Name = "one_time_keyboard")>]
     OneTimeKeyboard: bool option
     /// The placeholder to be shown in the input field when the keyboard is active; 1-64 characters
@@ -3727,6 +3791,22 @@ and [<CLIMutable>] ForceReply =
       Selective = selective
     }
 
+/// Represents a community (a group of chats).
+and [<CLIMutable>] Community =
+  {
+    /// Unique identifier for this community. 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 a signed 64-bit integer or double-precision float type are safe for storing this identifier.
+    [<DataMember(Name = "id")>]
+    Id: int64
+    /// Name of the community
+    [<DataMember(Name = "name")>]
+    Name: string
+  }
+  static member Create(id: int64, name: string) = 
+    {
+      Id = id
+      Name = name
+    }
+
 /// This object represents a chat photo.
 and [<CLIMutable>] ChatPhoto =
   {
@@ -3854,7 +3934,7 @@ and [<CLIMutable>] ChatAdministratorRights =
     /// True, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only
     [<DataMember(Name = "can_manage_direct_messages")>]
     CanManageDirectMessages: bool option
-    /// True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of can_pin_messages.
+    /// True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted, defaults to the value of can_pin_messages.
     [<DataMember(Name = "can_manage_tags")>]
     CanManageTags: bool option
     /// DEPRECATED: use can_manage_video_chats instead
@@ -4016,7 +4096,7 @@ and [<CLIMutable; Funogram.Types.TelegramTag("status", "administrator")>] ChatMe
     /// True, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only
     [<DataMember(Name = "can_manage_direct_messages")>]
     CanManageDirectMessages: bool option
-    /// True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of can_pin_messages.
+    /// True, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted, defaults to the value of can_pin_messages.
     [<DataMember(Name = "can_manage_tags")>]
     CanManageTags: bool option
     /// Custom title for this user
@@ -4225,7 +4305,7 @@ and [<CLIMutable>] ChatJoinRequest =
     /// Chat invite link that was used by the user to send the join request
     [<DataMember(Name = "invite_link")>]
     InviteLink: ChatInviteLink option
-    /// Identifier of the join request query. If present, then the bot must call sendChatJoinRequestWebApp or directly call answerChatJoinRequestQuery within 10 seconds.
+    /// Identifier of the join request query; for bots assigned to process join requests only. If present, then the bot must call sendChatJoinRequestWebApp or directly call answerChatJoinRequestQuery within 10 seconds.
     [<DataMember(Name = "query_id")>]
     QueryId: string option
   }
@@ -4288,7 +4368,7 @@ and [<CLIMutable>] ChatPermissions =
     /// True, if the user is allowed to pin messages. Ignored in public supergroups.
     [<DataMember(Name = "can_pin_messages")>]
     CanPinMessages: bool option
-    /// True, if the user is allowed to create forum topics. If omitted defaults to the value of can_pin_messages.
+    /// True, if the user is allowed to create forum topics. If omitted, defaults to the value of can_pin_messages.
     [<DataMember(Name = "can_manage_topics")>]
     CanManageTopics: bool option
   }
@@ -5103,10 +5183,10 @@ and [<CLIMutable>] UniqueGiftInfo =
     /// Origin of the gift. Currently, either “upgrade” for gifts upgraded from regular gifts, “transfer” for gifts transferred from other users or channels, “resale” for gifts bought from other users, “gifted_upgrade” for upgrades purchased after the gift was sent, or “offer” for gifts bought or sold through gift purchase offers.
     [<DataMember(Name = "origin")>]
     Origin: string
-    /// For gifts bought from other users, the currency in which the payment for the gift was done. Currently, one of “XTR” for Telegram Stars or “TON” for toncoins.
+    /// For gifts bought from other users, the currency in which the payment for the gift was done. Currently, one of “XTR” for Telegram Stars or “TON” for TON grams.
     [<DataMember(Name = "last_resale_currency")>]
     LastResaleCurrency: string option
-    /// For gifts bought from other users, the price paid for the gift in either Telegram Stars or nanotoncoins
+    /// For gifts bought from other users, the price paid for the gift in either Telegram Stars or nanograms
     [<DataMember(Name = "last_resale_amount")>]
     LastResaleAmount: int64 option
     /// Unique identifier of the received gift for the bot; only present for gifts received on behalf of business accounts
@@ -5336,11 +5416,15 @@ and [<CLIMutable>] BotCommand =
     /// Description of the command; 1-256 characters
     [<DataMember(Name = "description")>]
     Description: string
+    /// True, if the command sends an ephemeral message, which can be seen only by the sender of the message and the bot
+    [<DataMember(Name = "is_ephemeral")>]
+    IsEphemeral: bool option
   }
-  static member Create(command: string, description: string) = 
+  static member Create(command: string, description: string, ?isEphemeral: bool) = 
     {
       Command = command
       Description = description
+      IsEphemeral = isEphemeral
     }
 
 /// This object represents the scope to which bot commands are applied. Currently, the following 7 scopes are supported:
@@ -5920,7 +6004,7 @@ and [<CLIMutable>] InputMediaAnimation =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Animation width
@@ -6068,7 +6152,7 @@ and [<CLIMutable>] InputMediaLivePhoto =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Pass True if the live photo needs to be covered with a spoiler animation
@@ -6129,7 +6213,7 @@ and [<CLIMutable>] InputMediaPhoto =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Pass True if the photo needs to be covered with a spoiler animation
@@ -6238,7 +6322,7 @@ and [<CLIMutable>] InputMediaVideo =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Video width
@@ -6275,6 +6359,38 @@ and [<CLIMutable>] InputMediaVideo =
       HasSpoiler = hasSpoiler
     }
 
+/// Represents a voice message file to be sent.
+and [<CLIMutable>] InputMediaVoiceNote =
+  {
+    /// Type of the media, must be voice_note
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass "attach://<file_attach_name>" to upload a new one using multipart/form-data under <file_attach_name> name. More information on Sending Files »
+    [<DataMember(Name = "media")>]
+    Media: InputFile
+    /// Caption of the voice message to be sent, 0-1024 characters after entities parsing
+    [<DataMember(Name = "caption")>]
+    Caption: string option
+    /// Mode for parsing entities in the voice message caption. See formatting options for more details.
+    [<DataMember(Name = "parse_mode")>]
+    ParseMode: ParseMode option
+    /// List of special entities that appear in the caption, which can be specified instead of parse_mode
+    [<DataMember(Name = "caption_entities")>]
+    CaptionEntities: MessageEntity[] option
+    /// Duration of the voice message in seconds
+    [<DataMember(Name = "duration")>]
+    Duration: int64 option
+  }
+  static member Create(``type``: string, media: InputFile, ?caption: string, ?parseMode: ParseMode, ?captionEntities: MessageEntity[], ?duration: int64) = 
+    {
+      Type = ``type``
+      Media = media
+      Caption = caption
+      ParseMode = parseMode
+      CaptionEntities = captionEntities
+      Duration = duration
+    }
+
 /// This object describes the paid media to be sent. Currently, it can be one of
 and InputPaidMedia =
   | LivePhoto of InputPaidMediaLivePhoto
@@ -6615,15 +6731,21 @@ and [<CLIMutable>] RichMessage =
       IsRtl = isRtl
     }
 
-/// Describes a rich message to be sent. Exactly one of the fields html or markdown must be used.
+/// Describes a rich message to be sent. Exactly one of the fields html, markdown, or blocks must be used.
 and [<CLIMutable>] InputRichMessage =
   {
-    /// Content of the rich message to send described using HTML formatting. See rich message formatting options for more details.
+    /// Content of the rich message to send described as a list of blocks
+    [<DataMember(Name = "blocks")>]
+    Blocks: InputRichBlock[] option
+    /// Content of the rich message to send described using HTML formatting. See rich message formatting options for more details. Use media field to specify the media used in the message.
     [<DataMember(Name = "html")>]
     Html: string option
-    /// Content of the rich message to send described using Markdown formatting. See rich message formatting options for more details.
+    /// Content of the rich message to send described using Markdown formatting. See rich message formatting options for more details. Use media field to specify the media used in the message.
     [<DataMember(Name = "markdown")>]
     Markdown: string option
+    /// List of media that are specified in the markdown or html fields using tg://photo?id=, tg://video?id=, and tg://audio?id= links
+    [<DataMember(Name = "media")>]
+    Media: InputRichMessageMedia[] option
     /// Pass True if the rich message must be shown right-to-left
     [<DataMember(Name = "is_rtl")>]
     IsRtl: bool option
@@ -6631,14 +6753,32 @@ and [<CLIMutable>] InputRichMessage =
     [<DataMember(Name = "skip_entity_detection")>]
     SkipEntityDetection: bool option
   }
-  static member Create(?html: string, ?markdown: string, ?isRtl: bool, ?skipEntityDetection: bool) = 
+  static member Create(?blocks: InputRichBlock[], ?html: string, ?markdown: string, ?media: InputRichMessageMedia[], ?isRtl: bool, ?skipEntityDetection: bool) = 
     {
+      Blocks = blocks
       Html = html
       Markdown = markdown
+      Media = media
       IsRtl = isRtl
       SkipEntityDetection = skipEntityDetection
     }
 
+/// Describes a media element embedded in an outgoing rich message.
+and [<CLIMutable>] InputRichMessageMedia =
+  {
+    /// Unique identifier of the media used in a tg://photo?id=, tg://video?id=, or tg://audio?id= link. 1-64 characters, only A-Z, a-z, 0-9, _ and - are allowed.
+    [<DataMember(Name = "id")>]
+    Id: string
+    /// The media to be sent. Everything except the media itself and its properties is ignored.
+    [<DataMember(Name = "media")>]
+    Media: InputMedia
+  }
+  static member Create(id: string, media: InputMedia) = 
+    {
+      Id = id
+      Media = media
+    }
+
 /// This object represents a rich formatted text. Currently, it can be either a String for plain text, an Array of RichText, or any of the following types:
 and RichText =
   | Bold of RichTextBold
@@ -7573,7 +7713,7 @@ and [<CLIMutable; Funogram.Types.TelegramTag("type", "audio")>] RichBlockAudio =
       Caption = caption
     }
 
-/// A block with a photo, corresponding to the HTML tag <photo>.
+/// A block with a photo, corresponding to the HTML tag <img>.
 and [<CLIMutable; Funogram.Types.TelegramTag("type", "photo")>] RichBlockPhoto =
   {
     /// Type of the block, always “photo”
@@ -7641,16 +7781,480 @@ and [<CLIMutable; Funogram.Types.TelegramTag("type", "voice_note")>] RichBlockVo
       Caption = caption
     }
 
-/// A block with a “Thinking…” placeholder, corresponding to the custom HTML tag <tg-thinking>. The block may be used only in sendRichMessageDraft, therefore it can't be received in messages. See https://t.me/addemoji/AIActions for examples of custom emoji, which are recommended for usage in the block.
-/// The following methods and objects allow your bot to work in inline mode.
-/// Please see our Introduction to Inline bots for more details.
-/// To enable this option, send the /setinline command to @BotFather and provide the placeholder text that the user will see in the input field after typing your bot's name.
+/// A block with a “Thinking…” placeholder, corresponding to the custom HTML tag <tg-thinking>. The block may be used only in sendRichMessageDraft, therefore it can't be received in messages. See https://t.me/addemoji/AIActions for examples of custom emoji that are recommended for usage in the block.
 and [<CLIMutable; Funogram.Types.TelegramTag("type", "thinking")>] RichBlockThinking =
   {
     /// Type of the block, always “thinking”
     [<DataMember(Name = "type")>]
     Type: string
-    /// Text of the block. See https://t.me/addemoji/AIActions for examples of custom emoji, which are recommended for usage in the block.
+    /// Text of the block. See https://t.me/addemoji/AIActions for examples of custom emoji that are recommended for usage in the block.
+    [<DataMember(Name = "text")>]
+    Text: RichText
+  }
+  static member Create(``type``: string, text: RichText) = 
+    {
+      Type = ``type``
+      Text = text
+    }
+
+/// An item of a list to be sent.
+and [<CLIMutable>] InputRichBlockListItem =
+  {
+    /// The content of the item
+    [<DataMember(Name = "blocks")>]
+    Blocks: InputRichBlock[]
+    /// Pass True if the item has a checkbox
+    [<DataMember(Name = "has_checkbox")>]
+    HasCheckbox: bool option
+    /// Pass True if the item has a checked checkbox
+    [<DataMember(Name = "is_checked")>]
+    IsChecked: bool option
+    /// For ordered lists, the numeric value of the item label
+    [<DataMember(Name = "value")>]
+    Value: int64 option
+    /// For ordered lists, the type of the item label; must be one of “a” for lowercase letters, “A” for uppercase letters, “i” for lowercase Roman numerals, “I” for uppercase Roman numerals, or “1” for decimal numbers
+    [<DataMember(Name = "type")>]
+    Type: string option
+  }
+  static member Create(blocks: InputRichBlock[], ?hasCheckbox: bool, ?isChecked: bool, ?value: int64, ?``type``: string) = 
+    {
+      Blocks = blocks
+      HasCheckbox = hasCheckbox
+      IsChecked = isChecked
+      Value = value
+      Type = ``type``
+    }
+
+/// This object represents a block in a rich formatted message to be sent. Currently, it can be any of the following types:
+and InputRichBlock =
+  | Paragraph of InputRichBlockParagraph
+  | SectionHeading of InputRichBlockSectionHeading
+  | Preformatted of InputRichBlockPreformatted
+  | Footer of InputRichBlockFooter
+  | Divider of InputRichBlockDivider
+  | MathematicalExpression of InputRichBlockMathematicalExpression
+  | Anchor of InputRichBlockAnchor
+  | List of InputRichBlockList
+  | BlockQuotation of InputRichBlockBlockQuotation
+  | PullQuotation of InputRichBlockPullQuotation
+  | Collage of InputRichBlockCollage
+  | Slideshow of InputRichBlockSlideshow
+  | Table of InputRichBlockTable
+  | Details of InputRichBlockDetails
+  | Map of InputRichBlockMap
+  | Animation of InputRichBlockAnimation
+  | Audio of InputRichBlockAudio
+  | Photo of InputRichBlockPhoto
+  | Video of InputRichBlockVideo
+  | VoiceNote of InputRichBlockVoiceNote
+  | Thinking of InputRichBlockThinking
+
+/// A text paragraph, corresponding to the HTML tag <p>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "paragraph")>] InputRichBlockParagraph =
+  {
+    /// Type of the block, always “paragraph”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Text of the block
+    [<DataMember(Name = "text")>]
+    Text: RichText
+  }
+  static member Create(``type``: string, text: RichText) = 
+    {
+      Type = ``type``
+      Text = text
+    }
+
+/// A section heading, corresponding to the HTML tags <h1>, <h2>, <h3>, <h4>, <h5>, or <h6>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "heading")>] InputRichBlockSectionHeading =
+  {
+    /// Type of the block, always “heading”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Text of the block
+    [<DataMember(Name = "text")>]
+    Text: RichText
+    /// Relative size of the text font; 1-6, 1 is the largest, 6 is the smallest
+    [<DataMember(Name = "size")>]
+    Size: int64
+  }
+  static member Create(``type``: string, text: RichText, size: int64) = 
+    {
+      Type = ``type``
+      Text = text
+      Size = size
+    }
+
+/// A preformatted text block, corresponding to the nested HTML tags <pre> and <code>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "pre")>] InputRichBlockPreformatted =
+  {
+    /// Type of the block, always “pre”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Text of the block
+    [<DataMember(Name = "text")>]
+    Text: RichText
+    /// The programming language of the text
+    [<DataMember(Name = "language")>]
+    Language: string option
+  }
+  static member Create(``type``: string, text: RichText, ?language: string) = 
+    {
+      Type = ``type``
+      Text = text
+      Language = language
+    }
+
+/// A footer, corresponding to the HTML tag <footer>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "footer")>] InputRichBlockFooter =
+  {
+    /// Type of the block, always “footer”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Text of the block
+    [<DataMember(Name = "text")>]
+    Text: RichText
+  }
+  static member Create(``type``: string, text: RichText) = 
+    {
+      Type = ``type``
+      Text = text
+    }
+
+/// A divider, corresponding to the HTML tag <hr/>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "divider")>] InputRichBlockDivider =
+  {
+    /// Type of the block, always “divider”
+    [<DataMember(Name = "type")>]
+    Type: string
+  }
+  static member Create(``type``: string) = 
+    {
+      Type = ``type``
+    }
+
+/// A block with a mathematical expression in LaTeX format, corresponding to the custom HTML tag <tg-math-block>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "mathematical_expression")>] InputRichBlockMathematicalExpression =
+  {
+    /// Type of the block, always “mathematical_expression”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// The mathematical expression in LaTeX format
+    [<DataMember(Name = "expression")>]
+    Expression: string
+  }
+  static member Create(``type``: string, expression: string) = 
+    {
+      Type = ``type``
+      Expression = expression
+    }
+
+/// A block with an anchor, corresponding to the HTML tag <a> with the attribute name.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "anchor")>] InputRichBlockAnchor =
+  {
+    /// Type of the block, always “anchor”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// The name of the anchor
+    [<DataMember(Name = "name")>]
+    Name: string
+  }
+  static member Create(``type``: string, name: string) = 
+    {
+      Type = ``type``
+      Name = name
+    }
+
+/// A list of blocks, corresponding to the HTML tag <ul> or <ol> with multiple nested tags <li>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "list")>] InputRichBlockList =
+  {
+    /// Type of the block, always “list”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Items of the list
+    [<DataMember(Name = "items")>]
+    Items: InputRichBlockListItem[]
+  }
+  static member Create(``type``: string, items: InputRichBlockListItem[]) = 
+    {
+      Type = ``type``
+      Items = items
+    }
+
+/// A block quotation, corresponding to the HTML tag <blockquote>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "blockquote")>] InputRichBlockBlockQuotation =
+  {
+    /// Type of the block, always “blockquote”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Content of the block
+    [<DataMember(Name = "blocks")>]
+    Blocks: InputRichBlock[]
+    /// Credit of the block
+    [<DataMember(Name = "credit")>]
+    Credit: RichText option
+  }
+  static member Create(``type``: string, blocks: InputRichBlock[], ?credit: RichText) = 
+    {
+      Type = ``type``
+      Blocks = blocks
+      Credit = credit
+    }
+
+/// A quotation with centered text, loosely corresponding to the HTML tag <aside>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "pullquote")>] InputRichBlockPullQuotation =
+  {
+    /// Type of the block, always “pullquote”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Text of the block
+    [<DataMember(Name = "text")>]
+    Text: RichText
+    /// Credit of the block
+    [<DataMember(Name = "credit")>]
+    Credit: RichText option
+  }
+  static member Create(``type``: string, text: RichText, ?credit: RichText) = 
+    {
+      Type = ``type``
+      Text = text
+      Credit = credit
+    }
+
+/// A collage, corresponding to the custom HTML tag <tg-collage>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "collage")>] InputRichBlockCollage =
+  {
+    /// Type of the block, always “collage”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Elements of the collage
+    [<DataMember(Name = "blocks")>]
+    Blocks: InputRichBlock[]
+    /// Caption of the block
+    [<DataMember(Name = "caption")>]
+    Caption: RichBlockCaption option
+  }
+  static member Create(``type``: string, blocks: InputRichBlock[], ?caption: RichBlockCaption) = 
+    {
+      Type = ``type``
+      Blocks = blocks
+      Caption = caption
+    }
+
+/// A slideshow, corresponding to the custom HTML tag <tg-slideshow>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "slideshow")>] InputRichBlockSlideshow =
+  {
+    /// Type of the block, always “slideshow”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Elements of the slideshow
+    [<DataMember(Name = "blocks")>]
+    Blocks: InputRichBlock[]
+    /// Caption of the block
+    [<DataMember(Name = "caption")>]
+    Caption: RichBlockCaption option
+  }
+  static member Create(``type``: string, blocks: InputRichBlock[], ?caption: RichBlockCaption) = 
+    {
+      Type = ``type``
+      Blocks = blocks
+      Caption = caption
+    }
+
+/// A table, corresponding to the HTML tag <table>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "table")>] InputRichBlockTable =
+  {
+    /// Type of the block, always “table”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Cells of the table
+    [<DataMember(Name = "cells")>]
+    Cells: RichBlockTableCell[][]
+    /// Pass True if the table has borders
+    [<DataMember(Name = "is_bordered")>]
+    IsBordered: bool option
+    /// Pass True if the table is striped
+    [<DataMember(Name = "is_striped")>]
+    IsStriped: bool option
+    /// Caption of the table
+    [<DataMember(Name = "caption")>]
+    Caption: RichText option
+  }
+  static member Create(``type``: string, cells: RichBlockTableCell[][], ?isBordered: bool, ?isStriped: bool, ?caption: RichText) = 
+    {
+      Type = ``type``
+      Cells = cells
+      IsBordered = isBordered
+      IsStriped = isStriped
+      Caption = caption
+    }
+
+/// An expandable block for details disclosure, corresponding to the HTML tag <details>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "details")>] InputRichBlockDetails =
+  {
+    /// Type of the block, always “details”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Always shown summary of the block
+    [<DataMember(Name = "summary")>]
+    Summary: RichText
+    /// Content of the block
+    [<DataMember(Name = "blocks")>]
+    Blocks: InputRichBlock[]
+    /// Pass True if the content of the block is visible by default
+    [<DataMember(Name = "is_open")>]
+    IsOpen: bool option
+  }
+  static member Create(``type``: string, summary: RichText, blocks: InputRichBlock[], ?isOpen: bool) = 
+    {
+      Type = ``type``
+      Summary = summary
+      Blocks = blocks
+      IsOpen = isOpen
+    }
+
+/// A block with a map, corresponding to the custom HTML tag <tg-map>. The map's width and height must not exceed 10000 in total. The width and height ratio must be at most 20.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "map")>] InputRichBlockMap =
+  {
+    /// Type of the block, always “map”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Location of the center of the map
+    [<DataMember(Name = "location")>]
+    Location: Location
+    /// Map zoom level; 0-24
+    [<DataMember(Name = "zoom")>]
+    Zoom: int64
+    /// Map width; 0-10000
+    [<DataMember(Name = "width")>]
+    Width: int64
+    /// Map height; 0-10000
+    [<DataMember(Name = "height")>]
+    Height: int64
+    /// Caption of the block
+    [<DataMember(Name = "caption")>]
+    Caption: RichBlockCaption option
+  }
+  static member Create(``type``: string, location: Location, zoom: int64, width: int64, height: int64, ?caption: RichBlockCaption) = 
+    {
+      Type = ``type``
+      Location = location
+      Zoom = zoom
+      Width = width
+      Height = height
+      Caption = caption
+    }
+
+/// A block with an animation, corresponding to the HTML tag <video>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "animation")>] InputRichBlockAnimation =
+  {
+    /// Type of the block, always “animation”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// The animation. Caption is ignored.
+    [<DataMember(Name = "animation")>]
+    Animation: InputMediaAnimation
+    /// Caption of the block
+    [<DataMember(Name = "caption")>]
+    Caption: RichBlockCaption option
+  }
+  static member Create(``type``: string, animation: InputMediaAnimation, ?caption: RichBlockCaption) = 
+    {
+      Type = ``type``
+      Animation = animation
+      Caption = caption
+    }
+
+/// A block with a music file, corresponding to the HTML tag <audio>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "audio")>] InputRichBlockAudio =
+  {
+    /// Type of the block, always “audio”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// The audio. Caption is ignored.
+    [<DataMember(Name = "audio")>]
+    Audio: InputMediaAudio
+    /// Caption of the block
+    [<DataMember(Name = "caption")>]
+    Caption: RichBlockCaption option
+  }
+  static member Create(``type``: string, audio: InputMediaAudio, ?caption: RichBlockCaption) = 
+    {
+      Type = ``type``
+      Audio = audio
+      Caption = caption
+    }
+
+/// A block with a photo, corresponding to the HTML tag <img>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "photo")>] InputRichBlockPhoto =
+  {
+    /// Type of the block, always “photo”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// The photo. Caption is ignored.
+    [<DataMember(Name = "photo")>]
+    Photo: InputMediaPhoto
+    /// Caption of the block
+    [<DataMember(Name = "caption")>]
+    Caption: RichBlockCaption option
+  }
+  static member Create(``type``: string, photo: InputMediaPhoto, ?caption: RichBlockCaption) = 
+    {
+      Type = ``type``
+      Photo = photo
+      Caption = caption
+    }
+
+/// A block with a video, corresponding to the HTML tag <video>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "video")>] InputRichBlockVideo =
+  {
+    /// Type of the block, always “video”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// The video. Caption is ignored.
+    [<DataMember(Name = "video")>]
+    Video: InputMediaVideo
+    /// Caption of the block
+    [<DataMember(Name = "caption")>]
+    Caption: RichBlockCaption option
+  }
+  static member Create(``type``: string, video: InputMediaVideo, ?caption: RichBlockCaption) = 
+    {
+      Type = ``type``
+      Video = video
+      Caption = caption
+    }
+
+/// A block with a voice note, corresponding to the HTML tag <audio>.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "voice_note")>] InputRichBlockVoiceNote =
+  {
+    /// Type of the block, always “voice_note”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// The voice note. Caption is ignored.
+    [<DataMember(Name = "voice_note")>]
+    VoiceNote: InputMediaVoiceNote
+    /// Caption of the block
+    [<DataMember(Name = "caption")>]
+    Caption: RichBlockCaption option
+  }
+  static member Create(``type``: string, voiceNote: InputMediaVoiceNote, ?caption: RichBlockCaption) = 
+    {
+      Type = ``type``
+      VoiceNote = voiceNote
+      Caption = caption
+    }
+
+/// A block with a “Thinking…” placeholder, corresponding to the custom HTML tag <tg-thinking>. The block may be used only in sendRichMessageDraft, therefore it can't be received in messages. See https://t.me/addemoji/AIActions for examples of custom emoji that are recommended for usage in the block.
+/// The following methods and objects allow your bot to work in inline mode.
+/// Please see our Introduction to Inline bots for more details.
+/// To enable this option, send the /setinline command to @BotFather and provide the placeholder text that the user will see in the input field after typing your bot's name.
+and [<CLIMutable; Funogram.Types.TelegramTag("type", "thinking")>] InputRichBlockThinking =
+  {
+    /// Type of the block, always “thinking”
+    [<DataMember(Name = "type")>]
+    Type: string
+    /// Text of the block. See https://t.me/addemoji/AIActions for examples of custom emoji that are recommended for usage in the block.
     [<DataMember(Name = "text")>]
     Text: RichText
   }
@@ -7822,7 +8426,7 @@ and [<CLIMutable>] InlineQueryResultPhoto =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Inline keyboard attached to the message
@@ -7889,7 +8493,7 @@ and [<CLIMutable>] InlineQueryResultGif =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Inline keyboard attached to the message
@@ -7957,7 +8561,7 @@ and [<CLIMutable>] InlineQueryResultMpeg4Gif =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Inline keyboard attached to the message
@@ -8016,7 +8620,7 @@ and [<CLIMutable>] InlineQueryResultVideo =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Video width
@@ -8457,7 +9061,7 @@ and [<CLIMutable>] InlineQueryResultCachedPhoto =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Inline keyboard attached to the message
@@ -8506,7 +9110,7 @@ and [<CLIMutable>] InlineQueryResultCachedGif =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Inline keyboard attached to the message
@@ -8554,7 +9158,7 @@ and [<CLIMutable>] InlineQueryResultCachedMpeg4Gif =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Inline keyboard attached to the message
@@ -8681,7 +9285,7 @@ and [<CLIMutable>] InlineQueryResultCachedVideo =
     /// List of special entities that appear in the caption, which can be specified instead of parse_mode
     [<DataMember(Name = "caption_entities")>]
     CaptionEntities: MessageEntity[] option
-    /// Pass True, if the caption must be shown above the message media
+    /// Pass True if the caption must be shown above the message media
     [<DataMember(Name = "show_caption_above_media")>]
     ShowCaptionAboveMedia: bool option
     /// Inline keyboard attached to the message
@@ -8955,7 +9559,7 @@ and [<CLIMutable>] InputInvoiceMessageContent =
     /// The maximum accepted amount for tips in the smallest units of the currency (integer, not float/double). For example, for a maximum tip of US$ 1.45 pass max_tip_amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies). Defaults to 0. Not supported for payments in Telegram Stars.
     [<DataMember(Name = "max_tip_amount")>]
     MaxTipAmount: int64 option
-    /// A JSON-serialized array of suggested amounts of tip in the smallest units of the currency (integer, not float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed max_tip_amount.
+    /// A JSON-serialized Array of suggested amounts of tip in the smallest units of the currency (integer, not float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed max_tip_amount.
     [<DataMember(Name = "suggested_tip_amounts")>]
     SuggestedTipAmounts: int64[] option
     /// A JSON-serialized object for data about the invoice, which will be shared with the payment provider. A detailed description of the required fields should be provided by the payment provider.