-type 'AcceptedGiftTypes'() ::
          #{unlimited_gifts := boolean(),
            limited_gifts := boolean(),
            unique_gifts := boolean(),
            premium_subscription := boolean(),
            gifts_from_channels := boolean()}.

This object describes the types of gifts that can be gifted to a user or a chat.

• unlimited_gifts - True, if unlimited regular gifts are accepted
• limited_gifts - True, if limited regular gifts are accepted
• unique_gifts - True, if unique gifts or gifts that can be upgraded to unique for free are accepted
• premium_subscription - True, if a Telegram Premium subscription is accepted
• gifts_from_channels - True, if transfers of unique gifts from channels are accepted

-type 'AffiliateInfo'() ::
          #{affiliate_user => 'User'(),
            affiliate_chat => 'Chat'(),
            commission_per_mille := integer(),
            amount := integer(),
            nanostar_amount => integer()}.

Contains information about the affiliate that received a commission via this transaction.

• affiliate_user - Optional. The bot or the user that received an affiliate commission if it was received by a bot or a user
• affiliate_chat - Optional. The chat that received an affiliate commission if it was received by a chat
• commission_per_mille - The number of Telegram Stars received by the affiliate for each 1000 Telegram Stars received by the bot from referred users
• amount - Integer amount of Telegram Stars received by the affiliate from the transaction, rounded to 0; can be negative for refunds
• nanostar_amount - Optional. The number of 1/1000000000 shares of Telegram Stars received by the affiliate; from -999999999 to 999999999; can be negative for refunds

-type 'Animation'() ::
          #{file_id := binary(),
            file_unique_id := binary(),
            width := integer(),
            height := integer(),
            duration := integer(),
            thumbnail => 'PhotoSize'(),
            file_name => binary(),
            mime_type => binary(),
            file_size => integer()}.

This object represents an animation file (GIF or H.264/MPEG-4 AVC video without sound).

• file_id - Identifier for this file, which can be used to download or reuse the file
• file_unique_id - Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
• width - Video width as defined by the sender
• height - Video height as defined by the sender
• duration - Duration of the video in seconds as defined by the sender
• thumbnail - Optional. Animation thumbnail as defined by the sender
• file_name - Optional. Original animation filename as defined by the sender
• mime_type - Optional. MIME type of the file as defined by the sender
• file_size - Optional. File size in bytes. It can be bigger than 2^31 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 value.

-type 'Audio'() ::
          #{file_id := binary(),
            file_unique_id := binary(),
            duration := integer(),
            performer => binary(),
            title => binary(),
            file_name => binary(),
            mime_type => binary(),
            file_size => integer(),
            thumbnail => 'PhotoSize'()}.

This object represents an audio file to be treated as music by the Telegram clients.

• file_id - Identifier for this file, which can be used to download or reuse the file
• file_unique_id - Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
• duration - Duration of the audio in seconds as defined by the sender
• performer - Optional. Performer of the audio as defined by the sender or by audio tags
• title - Optional. Title of the audio as defined by the sender or by audio tags
• file_name - Optional. Original filename as defined by the sender
• mime_type - Optional. MIME type of the file as defined by the sender
• file_size - Optional. File size in bytes. It can be bigger than 2^31 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 value.
• thumbnail - Optional. Thumbnail of the album cover to which the music file belongs

-type 'BackgroundFill'() ::
          'BackgroundFillSolid'() | 'BackgroundFillGradient'() | 'BackgroundFillFreeformGradient'().

This object describes the way a background is filled based on the selected colors.

-type 'BackgroundFillFreeformGradient'() :: #{type := binary(), colors := [integer(), ...]}.

The background is a freeform gradient that rotates after every message in the chat.

• type - Type of the background fill, always freeform_gradient
• colors - A list of the 3 or 4 base colors that are used to generate the freeform gradient in the RGB24 format

-type 'BackgroundFillGradient'() ::
          #{type := binary(),
            top_color := integer(),
            bottom_color := integer(),
            rotation_angle := integer()}.

The background is a gradient fill.

• type - Type of the background fill, always gradient
• top_color - Top color of the gradient in the RGB24 format
• bottom_color - Bottom color of the gradient in the RGB24 format
• rotation_angle - Clockwise rotation angle of the background fill in degrees; 0-359

-type 'BackgroundFillSolid'() :: #{type := binary(), color := integer()}.

The background is filled using the selected color.

• type - Type of the background fill, always solid
• color - The color of the background fill in the RGB24 format

-type 'BackgroundType'() ::
          'BackgroundTypeFill'() |
          'BackgroundTypeWallpaper'() |
          'BackgroundTypePattern'() |
          'BackgroundTypeChatTheme'().

This object describes the type of a background.

-type 'BackgroundTypeChatTheme'() :: #{type := binary(), theme_name := binary()}.

The background is taken directly from a built-in chat theme.

• type - Type of the background, always chat_theme
• theme_name - Name of the chat theme, which is usually an emoji

-type 'BackgroundTypeFill'() ::
          #{type := binary(), fill := 'BackgroundFill'(), dark_theme_dimming := integer()}.

The background is automatically filled based on the selected colors.

• type - Type of the background, always fill
• fill - The background fill
• dark_theme_dimming - Dimming of the background in dark themes, as a percentage; 0-100

-type 'BackgroundTypePattern'() ::
          #{type := binary(),
            document := 'Document'(),
            fill := 'BackgroundFill'(),
            intensity := integer(),
            is_inverted => true,
            is_moving => true}.

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.

• type - Type of the background, always pattern
• document - Document with the pattern
• fill - The background fill that is combined with the pattern
• intensity - Intensity of the pattern when it is shown above the filled background; 0-100
• is_inverted - Optional. True, if the background fill must be applied only to the pattern itself. All other pixels are black in this case. For dark themes only
• is_moving - Optional. True, if the background moves slightly when the device is tilted

-type 'BackgroundTypeWallpaper'() ::
          #{type := binary(),
            document := 'Document'(),
            dark_theme_dimming := integer(),
            is_blurred => true,
            is_moving => true}.

The background is a wallpaper in the JPEG format.

• type - Type of the background, always wallpaper
• document - Document with the wallpaper
• dark_theme_dimming - Dimming of the background in dark themes, as a percentage; 0-100
• is_blurred - Optional. True, if the wallpaper is downscaled to fit in a 450x450 square and then box-blurred with radius 12
• is_moving - Optional. True, if the background moves slightly when the device is tilted

-type 'Birthdate'() :: #{day := integer(), month := integer(), year => integer()}.

Describes the birthdate of a user.

• day - Day of the user's birth; 1-31
• month - Month of the user's birth; 1-12
• year - Optional. Year of the user's birth

-type 'BotCommand'() :: #{command := binary(), description := binary()}.

This object represents a bot command.

• command - Text of the command; 1-32 characters. Can contain only lowercase English letters, digits and underscores.
• description - Description of the command; 1-256 characters.

-type 'BotCommandScope'() ::
          'BotCommandScopeDefault'() |
          'BotCommandScopeAllPrivateChats'() |
          'BotCommandScopeAllGroupChats'() |
          'BotCommandScopeAllChatAdministrators'() |
          'BotCommandScopeChat'() |
          'BotCommandScopeChatAdministrators'() |
          'BotCommandScopeChatMember'().

This object represents the scope to which bot commands are applied.
Currently, the following 7 scopes are supported:

-type 'BotCommandScopeAllChatAdministrators'() :: #{type := binary()}.

Represents the scope of bot commands, covering all group and supergroup chat administrators.

• type - Scope type, must be all_chat_administrators

-type 'BotCommandScopeAllGroupChats'() :: #{type := binary()}.

Represents the scope of bot commands, covering all group and supergroup chats.

• type - Scope type, must be all_group_chats

-type 'BotCommandScopeAllPrivateChats'() :: #{type := binary()}.

Represents the scope of bot commands, covering all private chats.

• type - Scope type, must be all_private_chats

-type 'BotCommandScopeChat'() :: #{type := binary(), chat_id := integer() | binary()}.

Represents the scope of bot commands, covering a specific chat.

• type - Scope type, must be chat
• chat_id - Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername). Channel direct messages chats and channel chats aren't supported.

-type 'BotCommandScopeChatAdministrators'() :: #{type := binary(), chat_id := integer() | binary()}.

Represents the scope of bot commands, covering all administrators of a specific group or supergroup chat.

• type - Scope type, must be chat_administrators
• chat_id - Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername). Channel direct messages chats and channel chats aren't supported.

-type 'BotCommandScopeChatMember'() ::
          #{type := binary(), chat_id := integer() | binary(), user_id := integer()}.

Represents the scope of bot commands, covering a specific member of a group or supergroup chat.

• type - Scope type, must be chat_member
• chat_id - Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername). Channel direct messages chats and channel chats aren't supported.
• user_id - Unique identifier of the target user

-type 'BotCommandScopeDefault'() :: #{type := binary()}.

Represents the default scope of bot commands.
Default commands are used if no commands with a narrower scope are specified for the user.

• type - Scope type, must be default

-type 'BotDescription'() :: #{description := binary()}.

This object represents the bot's description.

• description - The bot's description

-type 'BotName'() :: #{name := binary()}.

This object represents the bot's name.

• name - The bot's name

-type 'BotShortDescription'() :: #{short_description := binary()}.

This object represents the bot's short description.

• short_description - The bot's short description

-type 'BusinessBotRights'() ::
          #{can_reply => true,
            can_read_messages => true,
            can_delete_sent_messages => true,
            can_delete_all_messages => true,
            can_edit_name => true,
            can_edit_bio => true,
            can_edit_profile_photo => true,
            can_edit_username => true,
            can_change_gift_settings => true,
            can_view_gifts_and_stars => true,
            can_convert_gifts_to_stars => true,
            can_transfer_and_upgrade_gifts => true,
            can_transfer_stars => true,
            can_manage_stories => true}.

Represents the rights of a business bot.

• can_reply - Optional. True, if the bot can send and edit messages in the private chats that had incoming messages in the last 24 hours
• can_read_messages - Optional. True, if the bot can mark incoming private messages as read
• can_delete_sent_messages - Optional. True, if the bot can delete messages sent by the bot
• can_delete_all_messages - Optional. True, if the bot can delete all private messages in managed chats
• can_edit_name - Optional. True, if the bot can edit the first and last name of the business account
• can_edit_bio - Optional. True, if the bot can edit the bio of the business account
• can_edit_profile_photo - Optional. True, if the bot can edit the profile photo of the business account
• can_edit_username - Optional. True, if the bot can edit the username of the business account
• can_change_gift_settings - Optional. True, if the bot can change the privacy settings pertaining to gifts for the business account
• can_view_gifts_and_stars - Optional. True, if the bot can view gifts and the amount of Telegram Stars owned by the business account
• can_convert_gifts_to_stars - Optional. True, if the bot can convert regular gifts owned by the business account to Telegram Stars
• can_transfer_and_upgrade_gifts - Optional. True, if the bot can transfer and upgrade gifts owned by the business account
• can_transfer_stars - Optional. True, if the bot can transfer Telegram Stars received by the business account to its own account, or use them to upgrade and transfer gifts
• can_manage_stories - Optional. True, if the bot can post, edit and delete stories on behalf of the business account

-type 'BusinessConnection'() ::
          #{id := binary(),
            user := 'User'(),
            user_chat_id := integer(),
            date := integer(),
            rights => 'BusinessBotRights'(),
            is_enabled := boolean()}.

Describes the connection of the bot with a business account.

• id - Unique identifier of the business connection
• user - Business account user that created the business connection
• user_chat_id - Identifier of a private chat with the user who created the business connection. 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 64-bit integer or double-precision float type are safe for storing this identifier.
• date - Date the connection was established in Unix time
• rights - Optional. Rights of the business bot
• is_enabled - True, if the connection is active

-type 'BusinessIntro'() :: #{title => binary(), message => binary(), sticker => 'Sticker'()}.

Contains information about the start page settings of a Telegram Business account.

• title - Optional. Title text of the business intro
• message - Optional. Message text of the business intro
• sticker - Optional. Sticker of the business intro

-type 'BusinessLocation'() :: #{address := binary(), location => 'Location'()}.

Contains information about the location of a Telegram Business account.

• address - Address of the business
• location - Optional. Location of the business

-type 'BusinessMessagesDeleted'() ::
          #{business_connection_id := binary(), chat := 'Chat'(), message_ids := [integer(), ...]}.

This object is received when messages are deleted from a connected business account.

• business_connection_id - Unique identifier of the business connection
• chat - Information about a chat in the business account. The bot may not have access to the chat or the corresponding user.
• message_ids - The list of identifiers of deleted messages in the chat of the business account

-type 'BusinessOpeningHours'() ::
          #{time_zone_name := binary(), opening_hours := ['BusinessOpeningHoursInterval'(), ...]}.

Describes the opening hours of a business.

• time_zone_name - Unique name of the time zone for which the opening hours are defined
• opening_hours - List of time intervals describing business opening hours

-type 'BusinessOpeningHoursInterval'() :: #{opening_minute := integer(), closing_minute := integer()}.

Describes an interval of time during which a business is open.

• opening_minute - The minute's sequence number in a week, starting on Monday, marking the start of the time interval during which the business is open; 0 - 7 * 24 * 60
• closing_minute - The minute's sequence number in a week, starting on Monday, marking the end of the time interval during which the business is open; 0 - 8 * 24 * 60

-type 'CallbackGame'() :: empty_map().

A placeholder, currently holds no information.
Use BotFather to set up your game.

-type 'CallbackQuery'() ::
          #{id := binary(),
            from := 'User'(),
            message => 'MaybeInaccessibleMessage'(),
            inline_message_id => binary(),
            chat_instance := binary(),
            data => binary(),
            game_short_name => binary()}.

This object represents an incoming callback query from a callback button in an inline keyboard.
If the button that originated the query was attached to a message sent by the bot, the field message will be present.
If the button was attached to a message sent via the bot (in inline mode), the field inline_message_id will be present.
Exactly one of the fields data or game_short_name will be present.
NOTE: After the user presses a callback button, Telegram clients will display a progress bar until you call answerCallbackQuery.
It is, therefore, necessary to react by calling answerCallbackQuery even if no notification to the user is needed (e.g., without specifying any of the optional parameters).

• id - Unique identifier for this query
• from - Sender
• message - Optional. Message sent by the bot with the callback button that originated the query
• inline_message_id - Optional. Identifier of the message sent via the bot in inline mode, that originated the query.
• chat_instance - Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in games.
• data - Optional. Data associated with the callback button. Be aware that the message originated the query can contain no callback buttons with this data.
• game_short_name - Optional. Short name of a Game to be returned, serves as the unique identifier for the game

-type 'Chat'() ::
          #{id := integer(),
            type := binary(),
            title => binary(),
            username => binary(),
            first_name => binary(),
            last_name => binary(),
            is_forum => true,
            is_direct_messages => true}.

This object represents a chat.

• id - Unique identifier for this chat. 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.
• type - Type of the chat, can be either private, group, supergroup or channel
• title - Optional. Title, for supergroups, channels and group chats
• username - Optional. Username, for private chats, supergroups and channels if available
• first_name - Optional. First name of the other party in a private chat
• last_name - Optional. Last name of the other party in a private chat
• is_forum - Optional. True, if the supergroup chat is a forum (has topics enabled)
• is_direct_messages - Optional. True, if the chat is the direct messages chat of a channel

-type 'ChatAdministratorRights'() ::
          #{is_anonymous := boolean(),
            can_manage_chat := boolean(),
            can_delete_messages := boolean(),
            can_manage_video_chats := boolean(),
            can_restrict_members := boolean(),
            can_promote_members := boolean(),
            can_change_info := boolean(),
            can_invite_users := boolean(),
            can_post_stories := boolean(),
            can_edit_stories := boolean(),
            can_delete_stories := boolean(),
            can_post_messages => boolean(),
            can_edit_messages => boolean(),
            can_pin_messages => boolean(),
            can_manage_topics => boolean(),
            can_manage_direct_messages => boolean(),
            can_manage_tags => boolean()}.

Represents the rights of an administrator in a chat.

• is_anonymous - True, if the user's presence in the chat is hidden
• can_manage_chat - True, if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages, ignore slow mode, and send messages to the chat without paying Telegram Stars. Implied by any other administrator privilege.
• can_delete_messages - True, if the administrator can delete messages of other users
• can_manage_video_chats - True, if the administrator can manage video chats
• can_restrict_members - True, if the administrator can restrict, ban or unban chat members, or access supergroup statistics
• can_promote_members - True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by the user)
• can_change_info - True, if the user is allowed to change the chat title, photo and other settings
• can_invite_users - True, if the user is allowed to invite new users to the chat
• can_post_stories - True, if the administrator can post stories to the chat
• can_edit_stories - True, if the administrator can edit stories posted by other users, post stories to the chat page, pin chat stories, and access the chat's story archive
• can_delete_stories - True, if the administrator can delete stories posted by other users
• can_post_messages - Optional. True, if the administrator can post messages in the channel, approve suggested posts, or access channel statistics; for channels only
• can_edit_messages - Optional. True, if the administrator can edit messages of other users and can pin messages; for channels only
• can_pin_messages - Optional. True, if the user is allowed to pin messages; for groups and supergroups only
• can_manage_topics - Optional. True, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only
• can_manage_direct_messages - Optional. True, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only
• can_manage_tags - Optional. 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.

-type 'ChatBackground'() :: #{type := 'BackgroundType'()}.

This object represents a chat background.

• type - Type of the background

-type 'ChatBoost'() ::
          #{boost_id := binary(),
            add_date := integer(),
            expiration_date := integer(),
            source := 'ChatBoostSource'()}.

This object contains information about a chat boost.

• boost_id - Unique identifier of the boost
• add_date - Point in time (Unix timestamp) when the chat was boosted
• expiration_date - Point in time (Unix timestamp) when the boost will automatically expire, unless the booster's Telegram Premium subscription is prolonged
• source - Source of the added boost

-type 'ChatBoostAdded'() :: #{boost_count := integer()}.

This object represents a service message about a user boosting a chat.

• boost_count - Number of boosts added by the user

-type 'ChatBoostRemoved'() ::
          #{chat := 'Chat'(),
            boost_id := binary(),
            remove_date := integer(),
            source := 'ChatBoostSource'()}.

This object represents a boost removed from a chat.

• chat - Chat which was boosted
• boost_id - Unique identifier of the boost
• remove_date - Point in time (Unix timestamp) when the boost was removed
• source - Source of the removed boost

-type 'ChatBoostSource'() ::
          'ChatBoostSourcePremium'() | 'ChatBoostSourceGiftCode'() | 'ChatBoostSourceGiveaway'().

This object describes the source of a chat boost.

-type 'ChatBoostSourceGiftCode'() :: #{source := binary(), user := 'User'()}.

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.

• source - Source of the boost, always gift_code
• user - User for which the gift code was created

-type 'ChatBoostSourceGiveaway'() ::
          #{source := binary(),
            giveaway_message_id := integer(),
            user => 'User'(),
            prize_star_count => integer(),
            is_unclaimed => true}.

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.

• source - Source of the boost, always giveaway
• giveaway_message_id - Identifier of a message in the chat with the giveaway; the message could have been deleted already. May be 0 if the message isn't sent yet.
• user - Optional. User that won the prize in the giveaway if any; for Telegram Premium giveaways only
• prize_star_count - Optional. The number of Telegram Stars to be split between giveaway winners; for Telegram Star giveaways only
• is_unclaimed - Optional. True, if the giveaway was completed, but there was no user to win the prize

-type 'ChatBoostSourcePremium'() :: #{source := binary(), user := 'User'()}.

The boost was obtained by subscribing to Telegram Premium or by gifting a Telegram Premium subscription to another user.

• source - Source of the boost, always premium
• user - User that boosted the chat

-type 'ChatBoostUpdated'() :: #{chat := 'Chat'(), boost := 'ChatBoost'()}.

This object represents a boost added to a chat or changed.

• chat - Chat which was boosted
• boost - Information about the chat boost

-type 'ChatFullInfo'() ::
          #{id := integer(),
            type := binary(),
            title => binary(),
            username => binary(),
            first_name => binary(),
            last_name => binary(),
            is_forum => true,
            is_direct_messages => true,
            accent_color_id := integer(),
            max_reaction_count := integer(),
            photo => 'ChatPhoto'(),
            active_usernames => [binary(), ...],
            birthdate => 'Birthdate'(),
            business_intro => 'BusinessIntro'(),
            business_location => 'BusinessLocation'(),
            business_opening_hours => 'BusinessOpeningHours'(),
            personal_chat => 'Chat'(),
            parent_chat => 'Chat'(),
            available_reactions => ['ReactionType'(), ...],
            background_custom_emoji_id => binary(),
            profile_accent_color_id => integer(),
            profile_background_custom_emoji_id => binary(),
            emoji_status_custom_emoji_id => binary(),
            emoji_status_expiration_date => integer(),
            bio => binary(),
            has_private_forwards => true,
            has_restricted_voice_and_video_messages => true,
            join_to_send_messages => true,
            join_by_request => true,
            description => binary(),
            invite_link => binary(),
            pinned_message => 'Message'(),
            permissions => 'ChatPermissions'(),
            accepted_gift_types := 'AcceptedGiftTypes'(),
            can_send_paid_media => true,
            slow_mode_delay => integer(),
            unrestrict_boost_count => integer(),
            message_auto_delete_time => integer(),
            has_aggressive_anti_spam_enabled => true,
            has_hidden_members => true,
            has_protected_content => true,
            has_visible_history => true,
            sticker_set_name => binary(),
            can_set_sticker_set => true,
            custom_emoji_sticker_set_name => binary(),
            linked_chat_id => integer(),
            location => 'ChatLocation'(),
            rating => 'UserRating'(),
            first_profile_audio => 'Audio'(),
            unique_gift_colors => 'UniqueGiftColors'(),
            paid_message_star_count => integer()}.

This object contains full information about a chat.

• id - Unique identifier for this chat. 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.
• type - Type of the chat, can be either private, group, supergroup or channel
• title - Optional. Title, for supergroups, channels and group chats
• username - Optional. Username, for private chats, supergroups and channels if available
• first_name - Optional. First name of the other party in a private chat
• last_name - Optional. Last name of the other party in a private chat
• is_forum - Optional. True, if the supergroup chat is a forum (has topics enabled)
• is_direct_messages - Optional. True, if the chat is the direct messages chat of a channel
• accent_color_id - Identifier of the accent color for the chat name and backgrounds of the chat photo, reply header, and link preview. See accent colors for more details.
• max_reaction_count - The maximum number of reactions that can be set on a message in the chat
• photo - Optional. Chat photo
• active_usernames - Optional. If non-empty, the list of all active chat usernames; for private chats, supergroups and channels
• birthdate - Optional. For private chats, the date of birth of the user
• business_intro - Optional. For private chats with business accounts, the intro of the business
• business_location - Optional. For private chats with business accounts, the location of the business
• business_opening_hours - Optional. For private chats with business accounts, the opening hours of the business
• personal_chat - Optional. For private chats, the personal channel of the user
• parent_chat - Optional. Information about the corresponding channel chat; for direct messages chats only
• available_reactions - Optional. List of available reactions allowed in the chat. If omitted, then all emoji reactions are allowed.
• background_custom_emoji_id - Optional. Custom emoji identifier of the emoji chosen by the chat for the reply header and link preview background
• profile_accent_color_id - Optional. Identifier of the accent color for the chat's profile background. See profile accent colors for more details.
• profile_background_custom_emoji_id - Optional. Custom emoji identifier of the emoji chosen by the chat for its profile background
• emoji_status_custom_emoji_id - Optional. Custom emoji identifier of the emoji status of the chat or the other party in a private chat
• emoji_status_expiration_date - Optional. Expiration date of the emoji status of the chat or the other party in a private chat, in Unix time, if any
• bio - Optional. Bio of the other party in a private chat
• has_private_forwards - Optional. True, if privacy settings of the other party in the private chat allows to use tg://user?id=<user_id> links only in chats with the user
• has_restricted_voice_and_video_messages - Optional. True, if the privacy settings of the other party restrict sending voice and video note messages in the private chat
• join_to_send_messages - Optional. True, if users need to join the supergroup before they can send messages
• join_by_request - Optional. True, if all users directly joining the supergroup without using an invite link need to be approved by supergroup administrators
• description - Optional. Description, for groups, supergroups and channel chats
• invite_link - Optional. Primary invite link, for groups, supergroups and channel chats
• pinned_message - Optional. The most recent pinned message (by sending date)
• permissions - Optional. Default chat member permissions, for groups and supergroups
• accepted_gift_types - Information about types of gifts that are accepted by the chat or by the corresponding user for private chats
• can_send_paid_media - Optional. True, if paid media messages can be sent or forwarded to the channel chat. The field is available only for channel chats.
• slow_mode_delay - Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unprivileged user; in seconds
• unrestrict_boost_count - Optional. For supergroups, the minimum number of boosts that a non-administrator user needs to add in order to ignore slow mode and chat permissions
• message_auto_delete_time - Optional. The time after which all messages sent to the chat will be automatically deleted; in seconds
• has_aggressive_anti_spam_enabled - Optional. True, if aggressive anti-spam checks are enabled in the supergroup. The field is only available to chat administrators.
• has_hidden_members - Optional. True, if non-administrators can only get the list of bots and administrators in the chat
• has_protected_content - Optional. True, if messages from the chat can't be forwarded to other chats
• has_visible_history - Optional. True, if new chat members will have access to old messages; available only to chat administrators
• sticker_set_name - Optional. For supergroups, name of the group sticker set
• can_set_sticker_set - Optional. True, if the bot can change the group sticker set
• custom_emoji_sticker_set_name - Optional. For supergroups, the name of the group's custom emoji sticker set. Custom emoji from this set can be used by all users and bots in the group.
• linked_chat_id - Optional. Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. This identifier may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.
• location - Optional. For supergroups, the location to which the supergroup is connected
• rating - Optional. For private chats, the rating of the user if any
• first_profile_audio - Optional. For private chats, the first audio added to the profile of the user
• unique_gift_colors - Optional. The color scheme based on a unique gift that must be used for the chat's name, message replies and link previews
• paid_message_star_count - Optional. The number of Telegram Stars a general user have to pay to send a message to the chat

-type 'ChatInviteLink'() ::
          #{invite_link := binary(),
            creator := 'User'(),
            creates_join_request := boolean(),
            is_primary := boolean(),
            is_revoked := boolean(),
            name => binary(),
            expire_date => integer(),
            member_limit => integer(),
            pending_join_request_count => integer(),
            subscription_period => integer(),
            subscription_price => integer()}.

Represents an invite link for a chat.

• invite_link - The invite link. If the link was created by another chat administrator, then the second part of the link will be replaced with ….
• creator - Creator of the link
• creates_join_request - True, if users joining the chat via the link need to be approved by chat administrators
• is_primary - True, if the link is primary
• is_revoked - True, if the link is revoked
• name - Optional. Invite link name
• expire_date - Optional. Point in time (Unix timestamp) when the link will expire or has been expired
• member_limit - Optional. The maximum number of users that can be members of the chat simultaneously after joining the chat via this invite link; 1-99999
• pending_join_request_count - Optional. Number of pending join requests created using this link
• subscription_period - Optional. The number of seconds the subscription will be active for before the next payment
• subscription_price - Optional. The amount of Telegram Stars a user must pay initially and after each subsequent subscription period to be a member of the chat using the link

-type 'ChatJoinRequest'() ::
          #{chat := 'Chat'(),
            from := 'User'(),
            user_chat_id := integer(),
            date := integer(),
            bio => binary(),
            invite_link => 'ChatInviteLink'()}.

Represents a join request sent to a chat.

• chat - Chat to which the request was sent
• from - User that sent the join request
• user_chat_id - Identifier of a private chat with the user who sent the join request. 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 64-bit integer or double-precision float type are safe for storing this identifier. The bot can use this identifier for 5 minutes to send messages until the join request is processed, assuming no other administrator contacted the user.
• date - Date the request was sent in Unix time
• bio - Optional. Bio of the user.
• invite_link - Optional. Chat invite link that was used by the user to send the join request

-type 'ChatLocation'() :: #{location := 'Location'(), address := binary()}.

Represents a location to which a chat is connected.

• location - The location to which the supergroup is connected. Can't be a live location.
• address - Location address; 1-64 characters, as defined by the chat owner

-type 'ChatMember'() ::
          'ChatMemberOwner'() |
          'ChatMemberAdministrator'() |
          'ChatMemberMember'() |
          'ChatMemberRestricted'() |
          'ChatMemberLeft'() |
          'ChatMemberBanned'().

This object contains information about one member of a chat.
Currently, the following 6 types of chat members are supported:

-type 'ChatMemberAdministrator'() ::
          #{status := binary(),
            user := 'User'(),
            can_be_edited := boolean(),
            is_anonymous := boolean(),
            can_manage_chat := boolean(),
            can_delete_messages := boolean(),
            can_manage_video_chats := boolean(),
            can_restrict_members := boolean(),
            can_promote_members := boolean(),
            can_change_info := boolean(),
            can_invite_users := boolean(),
            can_post_stories := boolean(),
            can_edit_stories := boolean(),
            can_delete_stories := boolean(),
            can_post_messages => boolean(),
            can_edit_messages => boolean(),
            can_pin_messages => boolean(),
            can_manage_topics => boolean(),
            can_manage_direct_messages => boolean(),
            can_manage_tags => boolean(),
            custom_title => binary()}.

Represents a chat member that has some additional privileges.

• status - The member's status in the chat, always administrator
• user - Information about the user
• can_be_edited - True, if the bot is allowed to edit administrator privileges of that user
• is_anonymous - True, if the user's presence in the chat is hidden
• can_manage_chat - True, if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages, ignore slow mode, and send messages to the chat without paying Telegram Stars. Implied by any other administrator privilege.
• can_delete_messages - True, if the administrator can delete messages of other users
• can_manage_video_chats - True, if the administrator can manage video chats
• can_restrict_members - True, if the administrator can restrict, ban or unban chat members, or access supergroup statistics
• can_promote_members - True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by the user)
• can_change_info - True, if the user is allowed to change the chat title, photo and other settings
• can_invite_users - True, if the user is allowed to invite new users to the chat
• can_post_stories - True, if the administrator can post stories to the chat
• can_edit_stories - True, if the administrator can edit stories posted by other users, post stories to the chat page, pin chat stories, and access the chat's story archive
• can_delete_stories - True, if the administrator can delete stories posted by other users
• can_post_messages - Optional. True, if the administrator can post messages in the channel, approve suggested posts, or access channel statistics; for channels only
• can_edit_messages - Optional. True, if the administrator can edit messages of other users and can pin messages; for channels only
• can_pin_messages - Optional. True, if the user is allowed to pin messages; for groups and supergroups only
• can_manage_topics - Optional. True, if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only
• can_manage_direct_messages - Optional. True, if the administrator can manage direct messages of the channel and decline suggested posts; for channels only
• can_manage_tags - Optional. 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.
• custom_title - Optional. Custom title for this user

-type 'ChatMemberBanned'() :: #{status := binary(), user := 'User'(), until_date := integer()}.

Represents a chat member that was banned in the chat and can't return to the chat or view chat messages.

• status - The member's status in the chat, always kicked
• user - Information about the user
• until_date - Date when restrictions will be lifted for this user; Unix time. If 0, then the user is banned forever

-type 'ChatMemberLeft'() :: #{status := binary(), user := 'User'()}.

Represents a chat member that isn't currently a member of the chat, but may join it themselves.

• status - The member's status in the chat, always left
• user - Information about the user

-type 'ChatMemberMember'() ::
          #{status := binary(), tag => binary(), user := 'User'(), until_date => integer()}.

Represents a chat member that has no additional privileges or restrictions.

• status - The member's status in the chat, always member
• tag - Optional. Tag of the member
• user - Information about the user
• until_date - Optional. Date when the user's subscription will expire; Unix time

-type 'ChatMemberOwner'() ::
          #{status := binary(), user := 'User'(), is_anonymous := boolean(), custom_title => binary()}.

Represents a chat member that owns the chat and has all administrator privileges.

• status - The member's status in the chat, always creator
• user - Information about the user
• is_anonymous - True, if the user's presence in the chat is hidden
• custom_title - Optional. Custom title for this user

-type 'ChatMemberRestricted'() ::
          #{status := binary(),
            tag => binary(),
            user := 'User'(),
            is_member := boolean(),
            can_send_messages := boolean(),
            can_send_audios := boolean(),
            can_send_documents := boolean(),
            can_send_photos := boolean(),
            can_send_videos := boolean(),
            can_send_video_notes := boolean(),
            can_send_voice_notes := boolean(),
            can_send_polls := boolean(),
            can_send_other_messages := boolean(),
            can_add_web_page_previews := boolean(),
            can_edit_tag := boolean(),
            can_change_info := boolean(),
            can_invite_users := boolean(),
            can_pin_messages := boolean(),
            can_manage_topics := boolean(),
            until_date := integer()}.

Represents a chat member that is under certain restrictions in the chat.
Supergroups only.

• status - The member's status in the chat, always restricted
• tag - Optional. Tag of the member
• user - Information about the user
• is_member - True, if the user is a member of the chat at the moment of the request
• can_send_messages - True, if the user is allowed to send text messages, contacts, giveaways, giveaway winners, invoices, locations and venues
• can_send_audios - True, if the user is allowed to send audios
• can_send_documents - True, if the user is allowed to send documents
• can_send_photos - True, if the user is allowed to send photos
• can_send_videos - True, if the user is allowed to send videos
• can_send_video_notes - True, if the user is allowed to send video notes
• can_send_voice_notes - True, if the user is allowed to send voice notes
• can_send_polls - True, if the user is allowed to send polls and checklists
• can_send_other_messages - True, if the user is allowed to send animations, games, stickers and use inline bots
• can_add_web_page_previews - True, if the user is allowed to add web page previews to their messages
• can_edit_tag - True, if the user is allowed to edit their own tag
• can_change_info - True, if the user is allowed to change the chat title, photo and other settings
• can_invite_users - True, if the user is allowed to invite new users to the chat
• can_pin_messages - True, if the user is allowed to pin messages
• can_manage_topics - True, if the user is allowed to create forum topics
• until_date - Date when restrictions will be lifted for this user; Unix time. If 0, then the user is restricted forever

-type 'ChatMemberUpdated'() ::
          #{chat := 'Chat'(),
            from := 'User'(),
            date := integer(),
            old_chat_member := 'ChatMember'(),
            new_chat_member := 'ChatMember'(),
            invite_link => 'ChatInviteLink'(),
            via_join_request => boolean(),
            via_chat_folder_invite_link => boolean()}.

This object represents changes in the status of a chat member.

• chat - Chat the user belongs to
• from - Performer of the action, which resulted in the change
• date - Date the change was done in Unix time
• old_chat_member - Previous information about the chat member
• new_chat_member - New information about the chat member
• invite_link - Optional. Chat invite link, which was used by the user to join the chat; for joining by invite link events only.
• via_join_request - Optional. True, if the user joined the chat after sending a direct join request without using an invite link and being approved by an administrator
• via_chat_folder_invite_link - Optional. True, if the user joined the chat via a chat folder invite link

-type 'ChatOwnerChanged'() :: #{new_owner := 'User'()}.

Describes a service message about an ownership change in the chat.

• new_owner - The new owner of the chat

-type 'ChatOwnerLeft'() :: #{new_owner => 'User'()}.

Describes a service message about the chat owner leaving the chat.

• new_owner - Optional. The user which will be the new owner of the chat if the previous owner does not return to the chat

-type 'ChatPermissions'() ::
          #{can_send_messages => boolean(),
            can_send_audios => boolean(),
            can_send_documents => boolean(),
            can_send_photos => boolean(),
            can_send_videos => boolean(),
            can_send_video_notes => boolean(),
            can_send_voice_notes => boolean(),
            can_send_polls => boolean(),
            can_send_other_messages => boolean(),
            can_add_web_page_previews => boolean(),
            can_edit_tag => boolean(),
            can_change_info => boolean(),
            can_invite_users => boolean(),
            can_pin_messages => boolean(),
            can_manage_topics => boolean()}.

Describes actions that a non-administrator user is allowed to take in a chat.

• can_send_messages - Optional. True, if the user is allowed to send text messages, contacts, giveaways, giveaway winners, invoices, locations and venues
• can_send_audios - Optional. True, if the user is allowed to send audios
• can_send_documents - Optional. True, if the user is allowed to send documents
• can_send_photos - Optional. True, if the user is allowed to send photos
• can_send_videos - Optional. True, if the user is allowed to send videos
• can_send_video_notes - Optional. True, if the user is allowed to send video notes
• can_send_voice_notes - Optional. True, if the user is allowed to send voice notes
• can_send_polls - Optional. True, if the user is allowed to send polls and checklists
• can_send_other_messages - Optional. True, if the user is allowed to send animations, games, stickers and use inline bots
• can_add_web_page_previews - Optional. True, if the user is allowed to add web page previews to their messages
• can_edit_tag - Optional. True, if the user is allowed to edit their own tag
• can_change_info - Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups
• can_invite_users - Optional. True, if the user is allowed to invite new users to the chat
• can_pin_messages - Optional. True, if the user is allowed to pin messages. Ignored in public supergroups
• can_manage_topics - Optional. True, if the user is allowed to create forum topics. If omitted defaults to the value of can_pin_messages

-type 'ChatPhoto'() ::
          #{small_file_id := binary(),
            small_file_unique_id := binary(),
            big_file_id := binary(),
            big_file_unique_id := binary()}.

This object represents a chat photo.

• small_file_id - File identifier of small (160x160) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.
• small_file_unique_id - Unique file identifier of small (160x160) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
• big_file_id - File identifier of big (640x640) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.
• big_file_unique_id - Unique file identifier of big (640x640) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.

-type 'ChatShared'() ::
          #{request_id := integer(),
            chat_id := integer(),
            title => binary(),
            username => binary(),
            photo => ['PhotoSize'(), ...]}.

This object contains information about a chat that was shared with the bot using a KeyboardButtonRequestChat button.

• request_id - Identifier of the request
• chat_id - Identifier of the shared chat. 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 64-bit integer or double-precision float type are safe for storing this identifier. The bot may not have access to the chat and could be unable to use this identifier, unless the chat is already known to the bot by some other means.
• title - Optional. Title of the chat, if the title was requested by the bot.
• username - Optional. Username of the chat, if the username was requested by the bot and available.
• photo - Optional. Available sizes of the chat photo, if the photo was requested by the bot

-type 'Checklist'() ::
          #{title := binary(),
            title_entities => ['MessageEntity'(), ...],
            tasks := ['ChecklistTask'(), ...],
            others_can_add_tasks => true,
            others_can_mark_tasks_as_done => true}.

Describes a checklist.

• title - Title of the checklist
• title_entities - Optional. Special entities that appear in the checklist title
• tasks - List of tasks in the checklist
• others_can_add_tasks - Optional. True, if users other than the creator of the list can add tasks to the list
• others_can_mark_tasks_as_done - Optional. True, if users other than the creator of the list can mark tasks as done or not done

-type 'ChecklistTask'() ::
          #{id := integer(),
            text := binary(),
            text_entities => ['MessageEntity'(), ...],
            completed_by_user => 'User'(),
            completed_by_chat => 'Chat'(),
            completion_date => integer()}.

Describes a task in a checklist.

• id - Unique identifier of the task
• text - Text of the task
• text_entities - Optional. Special entities that appear in the task text
• completed_by_user - Optional. User that completed the task; omitted if the task wasn't completed by a user
• completed_by_chat - Optional. Chat that completed the task; omitted if the task wasn't completed by a chat
• completion_date - Optional. Point in time (Unix timestamp) when the task was completed; 0 if the task wasn't completed

-type 'ChecklistTasksAdded'() :: #{checklist_message => 'Message'(), tasks := ['ChecklistTask'(), ...]}.

Describes a service message about tasks added to a checklist.

• checklist_message - Optional. 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.
• tasks - List of tasks added to the checklist

-type 'ChecklistTasksDone'() ::
          #{checklist_message => 'Message'(),
            marked_as_done_task_ids => [integer(), ...],
            marked_as_not_done_task_ids => [integer(), ...]}.

Describes a service message about checklist tasks marked as done or not done.

• checklist_message - Optional. 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.
• marked_as_done_task_ids - Optional. Identifiers of the tasks that were marked as done
• marked_as_not_done_task_ids - Optional. Identifiers of the tasks that were marked as not done

-type 'ChosenInlineResult'() ::
          #{result_id := binary(),
            from := 'User'(),
            location => 'Location'(),
            inline_message_id => binary(),
            query := binary()}.

Represents a result of an inline query that was chosen by the user and sent to their chat partner.
Note: It is necessary to enable inline feedback via @BotFather in order to receive these objects in updates.

• result_id - The unique identifier for the result that was chosen
• from - The user that chose the result
• location - Optional. Sender location, only for bots that require user location
• inline_message_id - Optional. Identifier of the sent inline message. Available only if there is an inline keyboard attached to the message. Will be also received in callback queries and can be used to edit the message.
• query - The query that was used to obtain the result

-type 'Contact'() ::
          #{phone_number := binary(),
            first_name := binary(),
            last_name => binary(),
            user_id => integer(),
            vcard => binary()}.

This object represents a phone contact.

• phone_number - Contact's phone number
• first_name - Contact's first name
• last_name - Optional. Contact's last name
• user_id - Optional. Contact's user identifier in Telegram. 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 64-bit integer or double-precision float type are safe for storing this identifier.
• vcard - Optional. Additional data about the contact in the form of a vCard

-type 'CopyTextButton'() :: #{text := binary()}.

This object represents an inline keyboard button that copies specified text to the clipboard.

• text - The text to be copied to the clipboard; 1-256 characters

-type 'Dice'() :: #{emoji := binary(), value := integer()}.

This object represents an animated emoji that displays a random value.

• emoji - Emoji on which the dice throw animation is based
• value - Value of the dice, 1-6 for 🎲, 🎯 and 🎳 base emoji, 1-5 for 🏀 and ⚽ base emoji, 1-64 for 🎰 base emoji

-type 'DirectMessagePriceChanged'() ::
          #{are_direct_messages_enabled := boolean(), direct_message_star_count => integer()}.

Describes a service message about a change in the price of direct messages sent to a channel chat.

• are_direct_messages_enabled - True, if direct messages are enabled for the channel chat; false otherwise
• direct_message_star_count - Optional. 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.

-type 'DirectMessagesTopic'() :: #{topic_id := integer(), user => 'User'()}.

Describes a topic of a direct messages chat.

• topic_id - Unique identifier of the topic. 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 64-bit integer or double-precision float type are safe for storing this identifier.
• user - Optional. Information about the user that created the topic. Currently, it is always present

-type 'Document'() ::
          #{file_id := binary(),
            file_unique_id := binary(),
            thumbnail => 'PhotoSize'(),
            file_name => binary(),
            mime_type => binary(),
            file_size => integer()}.

This object represents a general file (as opposed to photos, voice messages and audio files).

• file_id - Identifier for this file, which can be used to download or reuse the file
• file_unique_id - Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
• thumbnail - Optional. Document thumbnail as defined by the sender
• file_name - Optional. Original filename as defined by the sender
• mime_type - Optional. MIME type of the file as defined by the sender
• file_size - Optional. File size in bytes. It can be bigger than 2^31 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 value.

-type 'EncryptedCredentials'() :: #{data := binary(), hash := binary(), secret := binary()}.

Describes data required for decrypting and authenticating EncryptedPassportElement.
See the Telegram Passport Documentation for a complete description of the data decryption and authentication processes.

• data - Base64-encoded encrypted JSON-serialized data with unique user's payload, data hashes and secrets required for EncryptedPassportElement decryption and authentication
• hash - Base64-encoded data hash for data authentication
• secret - Base64-encoded secret, encrypted with the bot's public RSA key, required for data decryption

-type 'EncryptedPassportElement'() ::
          #{type := binary(),
            data => binary(),
            phone_number => binary(),
            email => binary(),
            files => ['PassportFile'(), ...],
            front_side => 'PassportFile'(),
            reverse_side => 'PassportFile'(),
            selfie => 'PassportFile'(),
            translation => ['PassportFile'(), ...],
            hash := binary()}.

Describes documents or other Telegram Passport elements shared with the bot by the user.

• type - Element type. One of personal_details, passport, driver_license, identity_card, internal_passport, address, utility_bill, bank_statement, rental_agreement, passport_registration, temporary_registration, phone_number, email.
• data - Optional. Base64-encoded encrypted Telegram Passport element data provided by the user; available only for personal_details, passport, driver_license, identity_card, internal_passport and address types. Can be decrypted and verified using the accompanying EncryptedCredentials.
• phone_number - Optional. User's verified phone number; available only for phone_number type
• email - Optional. User's verified email address; available only for email type
• files - Optional. Array of encrypted files with documents provided by the user; available only for utility_bill, bank_statement, rental_agreement, passport_registration and temporary_registration types. Files can be decrypted and verified using the accompanying EncryptedCredentials.
• front_side - Optional. Encrypted file with the front side of the document, provided by the user; available only for passport, driver_license, identity_card and internal_passport. The file can be decrypted and verified using the accompanying EncryptedCredentials.
• reverse_side - Optional. Encrypted file with the reverse side of the document, provided by the user; available only for driver_license and identity_card. The file can be decrypted and verified using the accompanying EncryptedCredentials.
• selfie - Optional. Encrypted file with the selfie of the user holding a document, provided by the user; available if requested for passport, driver_license, identity_card and internal_passport. The file can be decrypted and verified using the accompanying EncryptedCredentials.
• translation - Optional. Array of encrypted files with translated versions of documents provided by the user; available if requested for passport, driver_license, identity_card, internal_passport, utility_bill, bank_statement, rental_agreement, passport_registration and temporary_registration types. Files can be decrypted and verified using the accompanying EncryptedCredentials.
• hash - Base64-encoded element hash for using in PassportElementErrorUnspecified

-type 'ExternalReplyInfo'() ::
          #{origin := 'MessageOrigin'(),
            chat => 'Chat'(),
            message_id => integer(),
            link_preview_options => 'LinkPreviewOptions'(),
            animation => 'Animation'(),
            audio => 'Audio'(),
            document => 'Document'(),
            paid_media => 'PaidMediaInfo'(),
            photo => ['PhotoSize'(), ...],
            sticker => 'Sticker'(),
            story => 'Story'(),
            video => 'Video'(),
            video_note => 'VideoNote'(),
            voice => 'Voice'(),
            has_media_spoiler => true,
            checklist => 'Checklist'(),
            contact => 'Contact'(),
            dice => 'Dice'(),
            game => 'Game'(),
            giveaway => 'Giveaway'(),
            giveaway_winners => 'GiveawayWinners'(),
            invoice => 'Invoice'(),
            location => 'Location'(),
            poll => 'Poll'(),
            venue => 'Venue'()}.

This object contains information about a message that is being replied to, which may come from another chat or forum topic.

• origin - Origin of the message replied to by the given message
• chat - Optional. Chat the original message belongs to. Available only if the chat is a supergroup or a channel.
• message_id - Optional. Unique message identifier inside the original chat. Available only if the original chat is a supergroup or a channel.
• link_preview_options - Optional. Options used for link preview generation for the original message, if it is a text message
• animation - Optional. Message is an animation, information about the animation
• audio - Optional. Message is an audio file, information about the file
• document - Optional. Message is a general file, information about the file
• paid_media - Optional. Message contains paid media; information about the paid media
• photo - Optional. Message is a photo, available sizes of the photo
• sticker - Optional. Message is a sticker, information about the sticker
• story - Optional. Message is a forwarded story
• video - Optional. Message is a video, information about the video
• video_note - Optional. Message is a video note, information about the video message
• voice - Optional. Message is a voice message, information about the file
• has_media_spoiler - Optional. True, if the message media is covered by a spoiler animation
• checklist - Optional. Message is a checklist
• contact - Optional. Message is a shared contact, information about the contact
• dice - Optional. Message is a dice with random value
• game - Optional. Message is a game, information about the game. More about games »
• giveaway - Optional. Message is a scheduled giveaway, information about the giveaway
• giveaway_winners - Optional. A giveaway with public winners was completed
• invoice - Optional. Message is an invoice for a payment, information about the invoice. More about payments »
• location - Optional. Message is a shared location, information about the location
• poll - Optional. Message is a native poll, information about the poll
• venue - Optional. Message is a venue, information about the venue

-type 'File'() ::
          #{file_id := binary(),
            file_unique_id := binary(),
            file_size => integer(),
            file_path => binary()}.

This object represents a file ready to be downloaded.
The file can be downloaded via the link https://api.telegram.org/file/bot<token>/<file_path>.
It is guaranteed that the link will be valid for at least 1 hour.
When the link expires, a new one can be requested by calling getFile.
The maximum file size to download is 20 MB

• file_id - Identifier for this file, which can be used to download or reuse the file
• file_unique_id - Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
• file_size - Optional. File size in bytes. It can be bigger than 2^31 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 value.
• file_path - Optional. File path. Use https://api.telegram.org/file/bot<token>/<file_path> to get the file.

-type 'ForceReply'() ::
          #{force_reply := true, input_field_placeholder => binary(), selective => boolean()}.

Upon receiving a message with this object, Telegram clients will display a reply interface to the user (act as if the user has selected the bot's message and tapped 'Reply').
This can be extremely useful if you want to create user-friendly step-by-step interfaces without having to sacrifice privacy mode.
Not supported in channels and for messages sent on behalf of a Telegram Business account.
Example: A poll bot for groups runs in privacy mode (only receives commands, replies to its messages and mentions).
There could be two ways to create a new poll: Explain the user how to send a command with parameters (e.g.
/newpoll question answer1 answer2).
May be appealing for hardcore users but lacks modern day polish.
Guide the user through a step-by-step process.
'Please send me your question', 'Cool, now let's add the first answer option', 'Great.
Keep adding answer options, then send /done when you're ready'.
The last option is definitely more attractive.
And if you use ForceReply in your bot's questions, it will receive the user's answers even if it only receives replies, commands and mentions - without any extra work for the user.

• force_reply - Shows reply interface to the user, as if they manually selected the bot's message and tapped 'Reply'
• input_field_placeholder - Optional. The placeholder to be shown in the input field when the reply is active; 1-64 characters
• selective - Optional. Use this parameter if you want to force reply from specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot's message is a reply to a message in the same chat and forum topic, sender of the original message.

-type 'ForumTopic'() ::
          #{message_thread_id := integer(),
            name := binary(),
            icon_color := integer(),
            icon_custom_emoji_id => binary(),
            is_name_implicit => true}.

This object represents a forum topic.

• message_thread_id - Unique identifier of the forum topic
• name - Name of the topic
• icon_color - Color of the topic icon in RGB format
• icon_custom_emoji_id - Optional. Unique identifier of the custom emoji shown as the topic icon
• is_name_implicit - Optional. True, if the name of the topic wasn't specified explicitly by its creator and likely needs to be changed by the bot

-type 'ForumTopicClosed'() :: empty_map().

This object represents a service message about a forum topic closed in the chat.
Currently holds no information.

-type 'ForumTopicCreated'() ::
          #{name := binary(),
            icon_color := integer(),
            icon_custom_emoji_id => binary(),
            is_name_implicit => true}.

This object represents a service message about a new forum topic created in the chat.

• name - Name of the topic
• icon_color - Color of the topic icon in RGB format
• icon_custom_emoji_id - Optional. Unique identifier of the custom emoji shown as the topic icon
• is_name_implicit - Optional. True, if the name of the topic wasn't specified explicitly by its creator and likely needs to be changed by the bot

-type 'ForumTopicEdited'() :: #{name => binary(), icon_custom_emoji_id => binary()}.

This object represents a service message about an edited forum topic.

• name - Optional. New name of the topic, if it was edited
• icon_custom_emoji_id - Optional. New identifier of the custom emoji shown as the topic icon, if it was edited; an empty string if the icon was removed

-type 'ForumTopicReopened'() :: empty_map().

This object represents a service message about a forum topic reopened in the chat.
Currently holds no information.

-type file_attach_name() :: atom().

File to send, parameter name must match the name in attach://<file_attach_name>

-type 'Game'() ::
          #{title := binary(),
            description := binary(),
            photo := ['PhotoSize'(), ...],
            text => binary(),
            text_entities => ['MessageEntity'(), ...],
            animation => 'Animation'()}.

This object represents a game.
Use BotFather to create and edit games, their short names will act as unique identifiers.

• title - Title of the game
• description - Description of the game
• photo - Photo that will be displayed in the game message in chats.
• text - Optional. Brief description of the game or high scores included in the game message. Can be automatically edited to include current high scores for the game when the bot calls setGameScore, or manually edited using editMessageText. 0-4096 characters.
• text_entities - Optional. Special entities that appear in text, such as usernames, URLs, bot commands, etc.
• animation - Optional. Animation that will be displayed in the game message in chats. Upload via BotFather

-type 'GameHighScore'() :: #{position := integer(), user := 'User'(), score := integer()}.

This object represents one row of the high scores table for a game.

• position - Position in high score table for the game
• user - User
• score - Score

-type 'GeneralForumTopicHidden'() :: empty_map().

This object represents a service message about General forum topic hidden in the chat.
Currently holds no information.

-type 'GeneralForumTopicUnhidden'() :: empty_map().

This object represents a service message about General forum topic unhidden in the chat.
Currently holds no information.