Use this method to receive incoming updates using long polling

POST /getUpdates

Use this method to receive incoming updates using long polling (wiki). An Array of Update objects is returned.

Body Required

  • offset integer

    Identifier of the first update to be returned. Must be greater by one than the highest among the identifiers of previously received updates. By default, updates starting with the earliest unconfirmed update are returned. An update is considered confirmed as soon as getUpdates is called with an offset higher than its update_id. The negative offset can be specified to retrieve updates starting from -offset update from the end of the updates queue. All previous updates will forgotten.

  • limit integer

    Limits the number of updates to be retrieved. Values between 1-100 are accepted. Defaults to 100.

    Minimum value is 1, maximum value is 100. Default value is 100.

  • timeout integer

    Timeout in seconds for long polling. Defaults to 0, i.e. usual short polling. Should be positive, short polling should be used for testing purposes only.

    Default value is 0.

  • allowed_updates array[string]

    A JSON-serialized list of the update types you want your bot to receive. For example, specify [“message”, “edited_channel_post”, “callback_query”] to only receive updates of these types. See Update for a complete list of available update types. Specify an empty list to receive all updates regardless of type (default). If not specified, the previous setting will be used.

    Please note that this parameter doesn't affect updates created before the call to the getUpdates, so unwanted updates may be received for a short period of time.

Responses

  • default
    Hide response attributes Show response attributes object
    • ok boolean Required

      Default value is false.

    • error_code integer Required
    • description string Required
    • parameters object

      Contains information about why a request was unsuccessful.

      Hide parameters attributes Show parameters attributes object
      • migrate_to_chat_id integer

        Optional. The group has been migrated to a supergroup with the specified identifier. This number 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.

      • retry_after integer

        Optional. In case of exceeding flood control, the number of seconds left to wait before the request can be repeated

  • 200
    Hide response attributes Show response attributes object
    • ok boolean Required

      Default value is true.

    • result array[object] Required

      This object represents an incoming update.
      At most one of the optional parameters can be present in any given update.

      Hide result attributes Show result attributes array[object]
      • update_id integer Required

        The update's unique identifier. Update identifiers start from a certain positive number and increase sequentially. This ID becomes especially handy if you're using Webhooks, since it allows you to ignore repeated updates or to restore the correct update sequence, should they get out of order. If there are no new updates for at least a week, then identifier of the next update will be chosen randomly instead of sequentially.

      • message object

        This object represents a message.

        Hide message attributes Show message attributes object
        • message_id integer Required

          Unique message identifier inside this chat

        • from object

          This object represents a Telegram user or bot.

          Hide from attributes Show from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • sender_chat object

          This object represents a chat.

          Hide sender_chat attributes Show sender_chat attributes object
          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • first_name string

            Optional. First name of the other party in a private chat

          • last_name string

            Optional. Last name of the other party in a private chat

          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • date integer Required

          Date the message was sent in Unix time

        • chat object Required

          This object represents a chat.

          Hide chat attributes Show chat attributes object
          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • first_name string

            Optional. First name of the other party in a private chat

          • last_name string

            Optional. Last name of the other party in a private chat

          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • forward_from object

          This object represents a Telegram user or bot.

          Hide forward_from attributes Show forward_from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • forward_from_chat object

          This object represents a chat.

          Hide forward_from_chat attributes Show forward_from_chat attributes object
          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • first_name string

            Optional. First name of the other party in a private chat

          • last_name string

            Optional. Last name of the other party in a private chat

          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • forward_from_message_id integer

          Optional. For messages forwarded from channels, identifier of the original message in the channel

        • forward_signature string

          Optional. For messages forwarded from channels, signature of the post author if present

        • forward_sender_name string

          Optional. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages

        • forward_date integer

          Optional. For forwarded messages, date the original message was sent in Unix time

        • reply_to_message object

          This object represents a message.

        • via_bot object

          This object represents a Telegram user or bot.

          Hide via_bot attributes Show via_bot attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • edit_date integer

          Optional. Date the message was last edited in Unix time

        • media_group_id string

          Optional. The unique identifier of a media message group this message belongs to

        • author_signature string

          Optional. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator

        • text string

          Optional. For text messages, the actual UTF-8 text of the message, 0-4096 characters

        • entities array[object]

          This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

          Hide entities attributes Show entities attributes array[object]
          • type string Required

            Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

            Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

          • offset integer Required

            Offset in UTF-16 code units to the start of the entity

          • length integer Required

            Length of the entity in UTF-16 code units

          • url string

            Optional. For “text_link” only, url that will be opened after user taps on the text

          • user object

            This object represents a Telegram user or bot.

            Hide user attributes Show user attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • language string

            Optional. For “pre” only, the programming language of the entity text

        • animation object

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

          Hide animation attributes Show animation attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Video width as defined by sender

          • height integer Required

            Video height as defined by sender

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original animation filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

        • audio object

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

          Hide audio attributes Show audio attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Duration of the audio in seconds as defined by sender

          • performer string

            Optional. Performer of the audio as defined by sender or by audio tags

          • title string

            Optional. Title of the audio as defined by sender or by audio tags

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

        • document object

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

          Hide document attributes Show document attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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.

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

        • photo array[object]

          This object represents one size of a photo or a file / sticker thumbnail.

          Hide photo attributes Show photo attributes array[object]
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Photo width

          • height integer Required

            Photo height

          • file_size integer

            Optional. File size

        • sticker object

          This object represents a sticker.

          Hide sticker attributes Show sticker attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Sticker width

          • height integer Required

            Sticker height

          • is_animated boolean Required

            True, if the sticker is animated

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • emoji string

            Optional. Emoji associated with the sticker

          • set_name string

            Optional. Name of the sticker set to which the sticker belongs

          • mask_position object

            This object describes the position on faces where a mask should be placed by default.

            Hide mask_position attributes Show mask_position attributes object
            • point string Required

              The part of the face relative to which the mask should be placed. One of “forehead”, “eyes”, “mouth”, or “chin”.

              Values are forehead, eyes, mouth, or chin.

            • x_shift number Required

              Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. For example, choosing -1.0 will place mask just to the left of the default mask position.

            • y_shift number Required

              Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom. For example, 1.0 will place the mask just below the default mask position.

            • scale number Required

              Mask scaling coefficient. For example, 2.0 means double size.

          • file_size integer

            Optional. File size

        • video object

          This object represents a video file.

          Hide video attributes Show video attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Video width as defined by sender

          • height integer Required

            Video height as defined by sender

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. Mime type of a file as defined by sender

          • file_size integer

            Optional. File size

        • video_note object

          This object represents a video message (available in Telegram apps as of v.4.0).

          Hide video_note attributes Show video_note attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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.

          • length integer Required

            Video width and height (diameter of the video message) as defined by sender

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_size integer

            Optional. File size

        • voice object

          This object represents a voice note.

          Hide voice attributes Show voice attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Duration of the audio in seconds as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

        • caption string

          Optional. Caption for the animation, audio, document, photo, video or voice, 0-1024 characters

        • caption_entities array[object]

          This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

          Hide caption_entities attributes Show caption_entities attributes array[object]
          • type string Required

            Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

            Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

          • offset integer Required

            Offset in UTF-16 code units to the start of the entity

          • length integer Required

            Length of the entity in UTF-16 code units

          • url string

            Optional. For “text_link” only, url that will be opened after user taps on the text

          • user object

            This object represents a Telegram user or bot.

            Hide user attributes Show user attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • language string

            Optional. For “pre” only, the programming language of the entity text

        • contact object

          This object represents a phone contact.

          Hide contact attributes Show contact attributes object
          • phone_number string Required

            Contact's phone number

          • first_name string Required

            Contact's first name

          • last_name string

            Optional. Contact's last name

          • user_id integer

            Optional. Contact's user identifier in Telegram

          • vcard string

            Optional. Additional data about the contact in the form of a vCard

        • dice object

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

          Hide dice attributes Show dice attributes object
          • emoji string Required

            Emoji on which the dice throw animation is based

          • value integer Required

            Value of the dice, 1-6 for “🎲” and “🎯” base emoji, 1-5 for “🏀” and “⚽” base emoji, 1-64 for “🎰” base emoji

        • game object

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

          Hide game attributes Show game attributes object
          • title string Required

            Title of the game

          • description string Required

            Description of the game

          • photo array[object] Required

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide photo attributes Show photo attributes array[object]
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • text string

            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 array[object]

            This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

            Hide text_entities attributes Show text_entities attributes array[object]
            • type string Required

              Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

              Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

            • offset integer Required

              Offset in UTF-16 code units to the start of the entity

            • length integer Required

              Length of the entity in UTF-16 code units

            • url string

              Optional. For “text_link” only, url that will be opened after user taps on the text

            • user object

              This object represents a Telegram user or bot.

              Hide user attributes Show user attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • language string

              Optional. For “pre” only, the programming language of the entity text

          • animation object

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

            Hide animation attributes Show animation attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Video width as defined by sender

            • height integer Required

              Video height as defined by sender

            • duration integer Required

              Duration of the video in seconds as defined by sender

            • thumb object

              This object represents one size of a photo or a file / sticker thumbnail.

              Hide thumb attributes Show thumb attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Photo width

              • height integer Required

                Photo height

              • file_size integer

                Optional. File size

            • file_name string

              Optional. Original animation filename as defined by sender

            • mime_type string

              Optional. MIME type of the file as defined by sender

            • file_size integer

              Optional. File size

        • poll object

          This object contains information about a poll.

          Hide poll attributes Show poll attributes object
          • id string Required

            Unique poll identifier

          • question string Required

            Poll question, 1-255 characters

          • options array[object] Required

            This object contains information about one answer option in a poll.

            Hide options attributes Show options attributes array[object]
            • text string Required

              Option text, 1-100 characters

            • voter_count integer Required

              Number of users that voted for this option

          • total_voter_count integer Required

            Total number of users that voted in the poll

          • is_closed boolean Required

            True, if the poll is closed

          • is_anonymous boolean Required

            True, if the poll is anonymous

          • type string Required

            Poll type, currently can be “regular” or “quiz”

          • allows_multiple_answers boolean Required

            True, if the poll allows multiple answers

          • correct_option_id integer

            Optional. 0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the private chat with the bot.

          • explanation string

            Optional. Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters

          • explanation_entities array[object]

            This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

            Hide explanation_entities attributes Show explanation_entities attributes array[object]
            • type string Required

              Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

              Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

            • offset integer Required

              Offset in UTF-16 code units to the start of the entity

            • length integer Required

              Length of the entity in UTF-16 code units

            • url string

              Optional. For “text_link” only, url that will be opened after user taps on the text

            • user object

              This object represents a Telegram user or bot.

              Hide user attributes Show user attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • language string

              Optional. For “pre” only, the programming language of the entity text

          • open_period integer

            Optional. Amount of time in seconds the poll will be active after creation

          • close_date integer

            Optional. Point in time (Unix timestamp) when the poll will be automatically closed

        • venue object

          This object represents a venue.

          Hide venue attributes Show venue attributes object
          • location object Required

            This object represents a point on the map.

            Hide location attributes Show location attributes object
            • longitude number Required

              Longitude as defined by sender

            • latitude number Required

              Latitude as defined by sender

            • horizontal_accuracy number

              Optional. The radius of uncertainty for the location, measured in meters; 0-1500

            • live_period integer

              Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

            • heading integer

              Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

            • proximity_alert_radius integer

              Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

          • title string Required

            Name of the venue

          • address string Required

            Address of the venue

          • foursquare_id string

            Optional. Foursquare identifier of the venue

          • foursquare_type string

            Optional. Foursquare type of the venue. (For example, “arts_entertainment/default”, “arts_entertainment/aquarium” or “food/icecream”.)

          • google_place_id string

            Optional. Google Places identifier of the venue

          • google_place_type string

            Optional. Google Places type of the venue. (See supported types.)

        • location object

          This object represents a point on the map.

          Hide location attributes Show location attributes object
          • longitude number Required

            Longitude as defined by sender

          • latitude number Required

            Latitude as defined by sender

          • horizontal_accuracy number

            Optional. The radius of uncertainty for the location, measured in meters; 0-1500

          • live_period integer

            Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

          • heading integer

            Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

          • proximity_alert_radius integer

            Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

        • new_chat_members array[object]

          This object represents a Telegram user or bot.

          Hide new_chat_members attributes Show new_chat_members attributes array[object]
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • left_chat_member object

          This object represents a Telegram user or bot.

          Hide left_chat_member attributes Show left_chat_member attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • new_chat_title string

          Optional. A chat title was changed to this value

        • new_chat_photo array[object]

          This object represents one size of a photo or a file / sticker thumbnail.

          Hide new_chat_photo attributes Show new_chat_photo attributes array[object]
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Photo width

          • height integer Required

            Photo height

          • file_size integer

            Optional. File size

        • delete_chat_photo boolean

          Optional. Service message: the chat photo was deleted

        • group_chat_created boolean

          Optional. Service message: the group has been created

        • supergroup_chat_created boolean

          Optional. Service message: the supergroup has been created. This field can't be received in a message coming through updates, because bot can't be a member of a supergroup when it is created. It can only be found in reply_to_message if someone replies to a very first message in a directly created supergroup.

        • channel_chat_created boolean

          Optional. Service message: the channel has been created. This field can't be received in a message coming through updates, because bot can't be a member of a channel when it is created. It can only be found in reply_to_message if someone replies to a very first message in a channel.

        • migrate_to_chat_id integer

          Optional. The group has been migrated to a supergroup with the specified identifier. This number 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.

        • migrate_from_chat_id integer

          Optional. The supergroup has been migrated from a group with the specified identifier. This number 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.

        • pinned_message object

          This object represents a message.

        • invoice object

          This object contains basic information about an invoice.

          Hide invoice attributes Show invoice attributes object
          • title string Required

            Product name

          • description string Required

            Product description

          • start_parameter string Required

            Unique bot deep-linking parameter that can be used to generate this invoice

          • currency string Required

            Three-letter ISO 4217 currency code

          • total_amount integer Required

            Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass 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).

        • successful_payment object

          This object contains basic information about a successful payment.

          Hide successful_payment attributes Show successful_payment attributes object
          • currency string Required

            Three-letter ISO 4217 currency code

          • total_amount integer Required

            Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass 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).

          • invoice_payload string Required

            Bot specified invoice payload

          • shipping_option_id string

            Optional. Identifier of the shipping option chosen by the user

          • order_info object

            This object represents information about an order.

            Hide order_info attributes Show order_info attributes object
            • name string

              Optional. User name

            • phone_number string

              Optional. User's phone number

            • email string

              Optional. User email

            • shipping_address object

              This object represents a shipping address.

              Hide shipping_address attributes Show shipping_address attributes object
              • country_code string Required

                ISO 3166-1 alpha-2 country code

              • state string Required

                State, if applicable

              • city string Required

                City

              • street_line1 string Required

                First line for the address

              • street_line2 string Required

                Second line for the address

              • post_code string Required

                Address post code

          • telegram_payment_charge_id string Required

            Telegram payment identifier

          • provider_payment_charge_id string Required

            Provider payment identifier

        • connected_website string

          Optional. The domain name of the website on which the user has logged in. More about Telegram Login »

        • passport_data object

          Contains information about Telegram Passport data shared with the bot by the user.

          Hide passport_data attributes Show passport_data attributes object
          • data array[object] Required

            Contains information about documents or other Telegram Passport elements shared with the bot by the user.

            Hide data attributes Show data attributes array[object]
            • type string Required

              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”.

              Values are personal_details, passport, driver_license, identity_card, internal_passport, address, utility_bill, bank_statement, rental_agreement, passport_registration, temporary_registration, phone_number, or email.

            • data string

              Optional. Base64-encoded encrypted Telegram Passport element data provided by the user, available for “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport” and “address” types. Can be decrypted and verified using the accompanying EncryptedCredentials.

            • phone_number string

              Optional. User's verified phone number, available only for “phone_number” type

            • email string

              Optional. User's verified email address, available only for “email” type

            • files array[object]

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide files attributes Show files attributes array[object]
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • front_side object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide front_side attributes Show front_side attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • reverse_side object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide reverse_side attributes Show reverse_side attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • selfie object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide selfie attributes Show selfie attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • translation array[object]

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide translation attributes Show translation attributes array[object]
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • hash string Required

              Base64-encoded element hash for using in PassportElementErrorUnspecified

          • credentials object Required

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

            Hide credentials attributes Show credentials attributes object
            • data string Required

              Base64-encoded encrypted JSON-serialized data with unique user's payload, data hashes and secrets required for EncryptedPassportElement decryption and authentication

            • hash string Required

              Base64-encoded data hash for data authentication

            • secret string Required

              Base64-encoded secret, encrypted with the bot's public RSA key, required for data decryption

        • proximity_alert_triggered object

          This object represents the content of a service message, sent whenever a user in the chat triggers a proximity alert set by another user.

          Hide proximity_alert_triggered attributes Show proximity_alert_triggered attributes object
          • traveler object Required

            This object represents a Telegram user or bot.

            Hide traveler attributes Show traveler attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • watcher object Required

            This object represents a Telegram user or bot.

            Hide watcher attributes Show watcher attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • distance integer Required

            The distance between the users

        • reply_markup object

          This object represents an inline keyboard that appears right next to the message it belongs to.

          Hide reply_markup attribute Show reply_markup attribute object
      • edited_message object

        This object represents a message.

        Hide edited_message attributes Show edited_message attributes object
        • message_id integer Required

          Unique message identifier inside this chat

        • from object

          This object represents a Telegram user or bot.

          Hide from attributes Show from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • sender_chat object

          This object represents a chat.

          Hide sender_chat attributes Show sender_chat attributes object
          • first_name string

            Optional. First name of the other party in a private chat

          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • last_name string

            Optional. Last name of the other party in a private chat

          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • date integer Required

          Date the message was sent in Unix time

        • chat object Required

          This object represents a chat.

          Hide chat attributes Show chat attributes object
          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • first_name string

            Optional. First name of the other party in a private chat

          • last_name string

            Optional. Last name of the other party in a private chat

          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • forward_from object

          This object represents a Telegram user or bot.

          Hide forward_from attributes Show forward_from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • forward_from_chat object

          This object represents a chat.

          Hide forward_from_chat attributes Show forward_from_chat attributes object
          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • first_name string

            Optional. First name of the other party in a private chat

          • last_name string

            Optional. Last name of the other party in a private chat

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • forward_from_message_id integer

          Optional. For messages forwarded from channels, identifier of the original message in the channel

        • forward_signature string

          Optional. For messages forwarded from channels, signature of the post author if present

        • forward_sender_name string

          Optional. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages

        • forward_date integer

          Optional. For forwarded messages, date the original message was sent in Unix time

        • reply_to_message object

          This object represents a message.

        • via_bot object

          This object represents a Telegram user or bot.

          Hide via_bot attributes Show via_bot attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • edit_date integer

          Optional. Date the message was last edited in Unix time

        • media_group_id string

          Optional. The unique identifier of a media message group this message belongs to

        • author_signature string

          Optional. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator

        • text string

          Optional. For text messages, the actual UTF-8 text of the message, 0-4096 characters

        • entities array[object]

          This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

          Hide entities attributes Show entities attributes array[object]
          • type string Required

            Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

            Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

          • offset integer Required

            Offset in UTF-16 code units to the start of the entity

          • length integer Required

            Length of the entity in UTF-16 code units

          • url string

            Optional. For “text_link” only, url that will be opened after user taps on the text

          • user object

            This object represents a Telegram user or bot.

            Hide user attributes Show user attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • language string

            Optional. For “pre” only, the programming language of the entity text

        • animation object

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

          Hide animation attributes Show animation attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Video width as defined by sender

          • height integer Required

            Video height as defined by sender

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original animation filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

        • audio object

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

          Hide audio attributes Show audio attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Duration of the audio in seconds as defined by sender

          • performer string

            Optional. Performer of the audio as defined by sender or by audio tags

          • title string

            Optional. Title of the audio as defined by sender or by audio tags

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

        • document object

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

          Hide document attributes Show document attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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.

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

        • photo array[object]

          This object represents one size of a photo or a file / sticker thumbnail.

          Hide photo attributes Show photo attributes array[object]
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Photo width

          • height integer Required

            Photo height

          • file_size integer

            Optional. File size

        • sticker object

          This object represents a sticker.

          Hide sticker attributes Show sticker attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Sticker width

          • height integer Required

            Sticker height

          • is_animated boolean Required

            True, if the sticker is animated

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • emoji string

            Optional. Emoji associated with the sticker

          • set_name string

            Optional. Name of the sticker set to which the sticker belongs

          • mask_position object

            This object describes the position on faces where a mask should be placed by default.

            Hide mask_position attributes Show mask_position attributes object
            • point string Required

              The part of the face relative to which the mask should be placed. One of “forehead”, “eyes”, “mouth”, or “chin”.

              Values are forehead, eyes, mouth, or chin.

            • x_shift number Required

              Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. For example, choosing -1.0 will place mask just to the left of the default mask position.

            • y_shift number Required

              Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom. For example, 1.0 will place the mask just below the default mask position.

            • scale number Required

              Mask scaling coefficient. For example, 2.0 means double size.

          • file_size integer

            Optional. File size

        • video object

          This object represents a video file.

          Hide video attributes Show video attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • file_unique_id string Required

            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 integer Required

            Video width as defined by sender

          • height integer Required

            Video height as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. Mime type of a file as defined by sender

          • file_size integer

            Optional. File size

        • video_note object

          This object represents a video message (available in Telegram apps as of v.4.0).

          Hide video_note attributes Show video_note attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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.

          • length integer Required

            Video width and height (diameter of the video message) as defined by sender

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_size integer

            Optional. File size

        • voice object

          This object represents a voice note.

          Hide voice attributes Show voice attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Duration of the audio in seconds as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

        • caption string

          Optional. Caption for the animation, audio, document, photo, video or voice, 0-1024 characters

        • caption_entities array[object]

          This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

          Hide caption_entities attributes Show caption_entities attributes array[object]
          • type string Required

            Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

            Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

          • offset integer Required

            Offset in UTF-16 code units to the start of the entity

          • length integer Required

            Length of the entity in UTF-16 code units

          • url string

            Optional. For “text_link” only, url that will be opened after user taps on the text

          • user object

            This object represents a Telegram user or bot.

            Hide user attributes Show user attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • language string

            Optional. For “pre” only, the programming language of the entity text

        • contact object

          This object represents a phone contact.

          Hide contact attributes Show contact attributes object
          • phone_number string Required

            Contact's phone number

          • first_name string Required

            Contact's first name

          • last_name string

            Optional. Contact's last name

          • user_id integer

            Optional. Contact's user identifier in Telegram

          • vcard string

            Optional. Additional data about the contact in the form of a vCard

        • dice object

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

          Hide dice attributes Show dice attributes object
          • emoji string Required

            Emoji on which the dice throw animation is based

          • value integer Required

            Value of the dice, 1-6 for “🎲” and “🎯” base emoji, 1-5 for “🏀” and “⚽” base emoji, 1-64 for “🎰” base emoji

        • game object

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

          Hide game attributes Show game attributes object
          • title string Required

            Title of the game

          • description string Required

            Description of the game

          • photo array[object] Required

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide photo attributes Show photo attributes array[object]
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • text string

            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 array[object]

            This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

            Hide text_entities attributes Show text_entities attributes array[object]
            • type string Required

              Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

              Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

            • offset integer Required

              Offset in UTF-16 code units to the start of the entity

            • length integer Required

              Length of the entity in UTF-16 code units

            • url string

              Optional. For “text_link” only, url that will be opened after user taps on the text

            • user object

              This object represents a Telegram user or bot.

              Hide user attributes Show user attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • language string

              Optional. For “pre” only, the programming language of the entity text

          • animation object

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

            Hide animation attributes Show animation attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Video width as defined by sender

            • height integer Required

              Video height as defined by sender

            • duration integer Required

              Duration of the video in seconds as defined by sender

            • thumb object

              This object represents one size of a photo or a file / sticker thumbnail.

              Hide thumb attributes Show thumb attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Photo width

              • height integer Required

                Photo height

              • file_size integer

                Optional. File size

            • file_name string

              Optional. Original animation filename as defined by sender

            • mime_type string

              Optional. MIME type of the file as defined by sender

            • file_size integer

              Optional. File size

        • poll object

          This object contains information about a poll.

          Hide poll attributes Show poll attributes object
          • id string Required

            Unique poll identifier

          • question string Required

            Poll question, 1-255 characters

          • options array[object] Required

            This object contains information about one answer option in a poll.

            Hide options attributes Show options attributes array[object]
            • text string Required

              Option text, 1-100 characters

            • voter_count integer Required

              Number of users that voted for this option

          • total_voter_count integer Required

            Total number of users that voted in the poll

          • is_closed boolean Required

            True, if the poll is closed

          • is_anonymous boolean Required

            True, if the poll is anonymous

          • type string Required

            Poll type, currently can be “regular” or “quiz”

          • allows_multiple_answers boolean Required

            True, if the poll allows multiple answers

          • correct_option_id integer

            Optional. 0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the private chat with the bot.

          • explanation string

            Optional. Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters

          • explanation_entities array[object]

            This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

            Hide explanation_entities attributes Show explanation_entities attributes array[object]
            • type string Required

              Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

              Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

            • offset integer Required

              Offset in UTF-16 code units to the start of the entity

            • length integer Required

              Length of the entity in UTF-16 code units

            • url string

              Optional. For “text_link” only, url that will be opened after user taps on the text

            • user object

              This object represents a Telegram user or bot.

              Hide user attributes Show user attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • language string

              Optional. For “pre” only, the programming language of the entity text

          • open_period integer

            Optional. Amount of time in seconds the poll will be active after creation

          • close_date integer

            Optional. Point in time (Unix timestamp) when the poll will be automatically closed

        • venue object

          This object represents a venue.

          Hide venue attributes Show venue attributes object
          • location object Required

            This object represents a point on the map.

            Hide location attributes Show location attributes object
            • longitude number Required

              Longitude as defined by sender

            • latitude number Required

              Latitude as defined by sender

            • horizontal_accuracy number

              Optional. The radius of uncertainty for the location, measured in meters; 0-1500

            • live_period integer

              Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

            • heading integer

              Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

            • proximity_alert_radius integer

              Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

          • title string Required

            Name of the venue

          • address string Required

            Address of the venue

          • foursquare_id string

            Optional. Foursquare identifier of the venue

          • foursquare_type string

            Optional. Foursquare type of the venue. (For example, “arts_entertainment/default”, “arts_entertainment/aquarium” or “food/icecream”.)

          • google_place_id string

            Optional. Google Places identifier of the venue

          • google_place_type string

            Optional. Google Places type of the venue. (See supported types.)

        • location object

          This object represents a point on the map.

          Hide location attributes Show location attributes object
          • longitude number Required

            Longitude as defined by sender

          • latitude number Required

            Latitude as defined by sender

          • horizontal_accuracy number

            Optional. The radius of uncertainty for the location, measured in meters; 0-1500

          • live_period integer

            Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

          • heading integer

            Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

          • proximity_alert_radius integer

            Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

        • new_chat_members array[object]

          This object represents a Telegram user or bot.

          Hide new_chat_members attributes Show new_chat_members attributes array[object]
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • left_chat_member object

          This object represents a Telegram user or bot.

          Hide left_chat_member attributes Show left_chat_member attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • new_chat_title string

          Optional. A chat title was changed to this value

        • new_chat_photo array[object]

          This object represents one size of a photo or a file / sticker thumbnail.

          Hide new_chat_photo attributes Show new_chat_photo attributes array[object]
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Photo width

          • height integer Required

            Photo height

          • file_size integer

            Optional. File size

        • delete_chat_photo boolean

          Optional. Service message: the chat photo was deleted

        • group_chat_created boolean

          Optional. Service message: the group has been created

        • supergroup_chat_created boolean

          Optional. Service message: the supergroup has been created. This field can't be received in a message coming through updates, because bot can't be a member of a supergroup when it is created. It can only be found in reply_to_message if someone replies to a very first message in a directly created supergroup.

        • channel_chat_created boolean

          Optional. Service message: the channel has been created. This field can't be received in a message coming through updates, because bot can't be a member of a channel when it is created. It can only be found in reply_to_message if someone replies to a very first message in a channel.

        • migrate_to_chat_id integer

          Optional. The group has been migrated to a supergroup with the specified identifier. This number 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.

        • migrate_from_chat_id integer

          Optional. The supergroup has been migrated from a group with the specified identifier. This number 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.

        • pinned_message object

          This object represents a message.

        • invoice object

          This object contains basic information about an invoice.

          Hide invoice attributes Show invoice attributes object
          • title string Required

            Product name

          • description string Required

            Product description

          • start_parameter string Required

            Unique bot deep-linking parameter that can be used to generate this invoice

          • currency string Required

            Three-letter ISO 4217 currency code

          • total_amount integer Required

            Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass 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).

        • successful_payment object

          This object contains basic information about a successful payment.

          Hide successful_payment attributes Show successful_payment attributes object
          • currency string Required

            Three-letter ISO 4217 currency code

          • total_amount integer Required

            Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass 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).

          • invoice_payload string Required

            Bot specified invoice payload

          • shipping_option_id string

            Optional. Identifier of the shipping option chosen by the user

          • order_info object

            This object represents information about an order.

            Hide order_info attributes Show order_info attributes object
            • name string

              Optional. User name

            • phone_number string

              Optional. User's phone number

            • email string

              Optional. User email

            • shipping_address object

              This object represents a shipping address.

              Hide shipping_address attributes Show shipping_address attributes object
              • country_code string Required

                ISO 3166-1 alpha-2 country code

              • state string Required

                State, if applicable

              • city string Required

                City

              • street_line1 string Required

                First line for the address

              • street_line2 string Required

                Second line for the address

              • post_code string Required

                Address post code

          • telegram_payment_charge_id string Required

            Telegram payment identifier

          • provider_payment_charge_id string Required

            Provider payment identifier

        • connected_website string

          Optional. The domain name of the website on which the user has logged in. More about Telegram Login »

        • passport_data object

          Contains information about Telegram Passport data shared with the bot by the user.

          Hide passport_data attributes Show passport_data attributes object
          • data array[object] Required

            Contains information about documents or other Telegram Passport elements shared with the bot by the user.

            Hide data attributes Show data attributes array[object]
            • type string Required

              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”.

              Values are personal_details, passport, driver_license, identity_card, internal_passport, address, utility_bill, bank_statement, rental_agreement, passport_registration, temporary_registration, phone_number, or email.

            • data string

              Optional. Base64-encoded encrypted Telegram Passport element data provided by the user, available for “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport” and “address” types. Can be decrypted and verified using the accompanying EncryptedCredentials.

            • phone_number string

              Optional. User's verified phone number, available only for “phone_number” type

            • email string

              Optional. User's verified email address, available only for “email” type

            • files array[object]

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide files attributes Show files attributes array[object]
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • front_side object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide front_side attributes Show front_side attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • reverse_side object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide reverse_side attributes Show reverse_side attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • selfie object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide selfie attributes Show selfie attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • translation array[object]

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide translation attributes Show translation attributes array[object]
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • hash string Required

              Base64-encoded element hash for using in PassportElementErrorUnspecified

          • credentials object Required

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

            Hide credentials attributes Show credentials attributes object
            • data string Required

              Base64-encoded encrypted JSON-serialized data with unique user's payload, data hashes and secrets required for EncryptedPassportElement decryption and authentication

            • hash string Required

              Base64-encoded data hash for data authentication

            • secret string Required

              Base64-encoded secret, encrypted with the bot's public RSA key, required for data decryption

        • proximity_alert_triggered object

          This object represents the content of a service message, sent whenever a user in the chat triggers a proximity alert set by another user.

          Hide proximity_alert_triggered attributes Show proximity_alert_triggered attributes object
          • traveler object Required

            This object represents a Telegram user or bot.

            Hide traveler attributes Show traveler attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • watcher object Required

            This object represents a Telegram user or bot.

            Hide watcher attributes Show watcher attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • distance integer Required

            The distance between the users

        • reply_markup object

          This object represents an inline keyboard that appears right next to the message it belongs to.

          Hide reply_markup attribute Show reply_markup attribute object
      • channel_post object

        This object represents a message.

        Hide channel_post attributes Show channel_post attributes object
        • message_id integer Required

          Unique message identifier inside this chat

        • from object

          This object represents a Telegram user or bot.

          Hide from attributes Show from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • sender_chat object

          This object represents a chat.

          Hide sender_chat attributes Show sender_chat attributes object
          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • first_name string

            Optional. First name of the other party in a private chat

          • last_name string

            Optional. Last name of the other party in a private chat

          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • date integer Required

          Date the message was sent in Unix time

        • chat object Required

          This object represents a chat.

          Hide chat attributes Show chat attributes object
          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • first_name string

            Optional. First name of the other party in a private chat

          • last_name string

            Optional. Last name of the other party in a private chat

          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • forward_from object

          This object represents a Telegram user or bot.

          Hide forward_from attributes Show forward_from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • forward_from_chat object

          This object represents a chat.

          Hide forward_from_chat attributes Show forward_from_chat attributes object
          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • first_name string

            Optional. First name of the other party in a private chat

          • last_name string

            Optional. Last name of the other party in a private chat

          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • forward_from_message_id integer

          Optional. For messages forwarded from channels, identifier of the original message in the channel

        • forward_signature string

          Optional. For messages forwarded from channels, signature of the post author if present

        • forward_sender_name string

          Optional. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages

        • forward_date integer

          Optional. For forwarded messages, date the original message was sent in Unix time

        • reply_to_message object

          This object represents a message.

        • via_bot object

          This object represents a Telegram user or bot.

          Hide via_bot attributes Show via_bot attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • edit_date integer

          Optional. Date the message was last edited in Unix time

        • media_group_id string

          Optional. The unique identifier of a media message group this message belongs to

        • author_signature string

          Optional. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator

        • text string

          Optional. For text messages, the actual UTF-8 text of the message, 0-4096 characters

        • entities array[object]

          This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

          Hide entities attributes Show entities attributes array[object]
          • type string Required

            Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

            Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

          • offset integer Required

            Offset in UTF-16 code units to the start of the entity

          • length integer Required

            Length of the entity in UTF-16 code units

          • url string

            Optional. For “text_link” only, url that will be opened after user taps on the text

          • user object

            This object represents a Telegram user or bot.

            Hide user attributes Show user attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • language string

            Optional. For “pre” only, the programming language of the entity text

        • animation object

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

          Hide animation attributes Show animation attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Video width as defined by sender

          • height integer Required

            Video height as defined by sender

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original animation filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

        • audio object

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

          Hide audio attributes Show audio attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Duration of the audio in seconds as defined by sender

          • performer string

            Optional. Performer of the audio as defined by sender or by audio tags

          • title string

            Optional. Title of the audio as defined by sender or by audio tags

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

        • document object

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

          Hide document attributes Show document attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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.

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

        • photo array[object]

          This object represents one size of a photo or a file / sticker thumbnail.

          Hide photo attributes Show photo attributes array[object]
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Photo width

          • height integer Required

            Photo height

          • file_size integer

            Optional. File size

        • sticker object

          This object represents a sticker.

          Hide sticker attributes Show sticker attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Sticker width

          • height integer Required

            Sticker height

          • is_animated boolean Required

            True, if the sticker is animated

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • emoji string

            Optional. Emoji associated with the sticker

          • set_name string

            Optional. Name of the sticker set to which the sticker belongs

          • mask_position object

            This object describes the position on faces where a mask should be placed by default.

            Hide mask_position attributes Show mask_position attributes object
            • point string Required

              The part of the face relative to which the mask should be placed. One of “forehead”, “eyes”, “mouth”, or “chin”.

              Values are forehead, eyes, mouth, or chin.

            • x_shift number Required

              Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. For example, choosing -1.0 will place mask just to the left of the default mask position.

            • y_shift number Required

              Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom. For example, 1.0 will place the mask just below the default mask position.

            • scale number Required

              Mask scaling coefficient. For example, 2.0 means double size.

          • file_size integer

            Optional. File size

        • video object

          This object represents a video file.

          Hide video attributes Show video attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Video width as defined by sender

          • height integer Required

            Video height as defined by sender

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. Mime type of a file as defined by sender

          • file_size integer

            Optional. File size

        • video_note object

          This object represents a video message (available in Telegram apps as of v.4.0).

          Hide video_note attributes Show video_note attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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.

          • length integer Required

            Video width and height (diameter of the video message) as defined by sender

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_size integer

            Optional. File size

        • voice object

          This object represents a voice note.

          Hide voice attributes Show voice attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Duration of the audio in seconds as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

        • caption string

          Optional. Caption for the animation, audio, document, photo, video or voice, 0-1024 characters

        • caption_entities array[object]

          This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

          Hide caption_entities attributes Show caption_entities attributes array[object]
          • type string Required

            Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

            Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

          • offset integer Required

            Offset in UTF-16 code units to the start of the entity

          • length integer Required

            Length of the entity in UTF-16 code units

          • url string

            Optional. For “text_link” only, url that will be opened after user taps on the text

          • user object

            This object represents a Telegram user or bot.

            Hide user attributes Show user attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • language string

            Optional. For “pre” only, the programming language of the entity text

        • contact object

          This object represents a phone contact.

          Hide contact attributes Show contact attributes object
          • phone_number string Required

            Contact's phone number

          • first_name string Required

            Contact's first name

          • last_name string

            Optional. Contact's last name

          • user_id integer

            Optional. Contact's user identifier in Telegram

          • vcard string

            Optional. Additional data about the contact in the form of a vCard

        • dice object

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

          Hide dice attributes Show dice attributes object
          • emoji string Required

            Emoji on which the dice throw animation is based

          • value integer Required

            Value of the dice, 1-6 for “🎲” and “🎯” base emoji, 1-5 for “🏀” and “⚽” base emoji, 1-64 for “🎰” base emoji

        • game object

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

          Hide game attributes Show game attributes object
          • title string Required

            Title of the game

          • description string Required

            Description of the game

          • photo array[object] Required

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide photo attributes Show photo attributes array[object]
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • text string

            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 array[object]

            This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

            Hide text_entities attributes Show text_entities attributes array[object]
            • type string Required

              Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

              Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

            • offset integer Required

              Offset in UTF-16 code units to the start of the entity

            • length integer Required

              Length of the entity in UTF-16 code units

            • url string

              Optional. For “text_link” only, url that will be opened after user taps on the text

            • user object

              This object represents a Telegram user or bot.

              Hide user attributes Show user attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • language string

              Optional. For “pre” only, the programming language of the entity text

          • animation object

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

            Hide animation attributes Show animation attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Video width as defined by sender

            • height integer Required

              Video height as defined by sender

            • duration integer Required

              Duration of the video in seconds as defined by sender

            • thumb object

              This object represents one size of a photo or a file / sticker thumbnail.

              Hide thumb attributes Show thumb attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Photo width

              • height integer Required

                Photo height

              • file_size integer

                Optional. File size

            • file_name string

              Optional. Original animation filename as defined by sender

            • mime_type string

              Optional. MIME type of the file as defined by sender

            • file_size integer

              Optional. File size

        • poll object

          This object contains information about a poll.

          Hide poll attributes Show poll attributes object
          • id string Required

            Unique poll identifier

          • question string Required

            Poll question, 1-255 characters

          • options array[object] Required

            This object contains information about one answer option in a poll.

            Hide options attributes Show options attributes array[object]
            • text string Required

              Option text, 1-100 characters

            • voter_count integer Required

              Number of users that voted for this option

          • total_voter_count integer Required

            Total number of users that voted in the poll

          • is_closed boolean Required

            True, if the poll is closed

          • is_anonymous boolean Required

            True, if the poll is anonymous

          • type string Required

            Poll type, currently can be “regular” or “quiz”

          • allows_multiple_answers boolean Required

            True, if the poll allows multiple answers

          • correct_option_id integer

            Optional. 0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the private chat with the bot.

          • explanation string

            Optional. Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters

          • explanation_entities array[object]

            This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

            Hide explanation_entities attributes Show explanation_entities attributes array[object]
            • type string Required

              Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

              Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

            • offset integer Required

              Offset in UTF-16 code units to the start of the entity

            • length integer Required

              Length of the entity in UTF-16 code units

            • url string

              Optional. For “text_link” only, url that will be opened after user taps on the text

            • user object

              This object represents a Telegram user or bot.

              Hide user attributes Show user attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • language string

              Optional. For “pre” only, the programming language of the entity text

          • open_period integer

            Optional. Amount of time in seconds the poll will be active after creation

          • close_date integer

            Optional. Point in time (Unix timestamp) when the poll will be automatically closed

        • venue object

          This object represents a venue.

          Hide venue attributes Show venue attributes object
          • location object Required

            This object represents a point on the map.

            Hide location attributes Show location attributes object
            • longitude number Required

              Longitude as defined by sender

            • latitude number Required

              Latitude as defined by sender

            • horizontal_accuracy number

              Optional. The radius of uncertainty for the location, measured in meters; 0-1500

            • live_period integer

              Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

            • heading integer

              Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

            • proximity_alert_radius integer

              Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

          • title string Required

            Name of the venue

          • address string Required

            Address of the venue

          • foursquare_id string

            Optional. Foursquare identifier of the venue

          • foursquare_type string

            Optional. Foursquare type of the venue. (For example, “arts_entertainment/default”, “arts_entertainment/aquarium” or “food/icecream”.)

          • google_place_id string

            Optional. Google Places identifier of the venue

          • google_place_type string

            Optional. Google Places type of the venue. (See supported types.)

        • location object

          This object represents a point on the map.

          Hide location attributes Show location attributes object
          • longitude number Required

            Longitude as defined by sender

          • latitude number Required

            Latitude as defined by sender

          • horizontal_accuracy number

            Optional. The radius of uncertainty for the location, measured in meters; 0-1500

          • live_period integer

            Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

          • heading integer

            Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

          • proximity_alert_radius integer

            Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

        • new_chat_members array[object]

          This object represents a Telegram user or bot.

          Hide new_chat_members attributes Show new_chat_members attributes array[object]
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • left_chat_member object

          This object represents a Telegram user or bot.

          Hide left_chat_member attributes Show left_chat_member attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • new_chat_title string

          Optional. A chat title was changed to this value

        • new_chat_photo array[object]

          This object represents one size of a photo or a file / sticker thumbnail.

          Hide new_chat_photo attributes Show new_chat_photo attributes array[object]
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Photo width

          • height integer Required

            Photo height

          • file_size integer

            Optional. File size

        • delete_chat_photo boolean

          Optional. Service message: the chat photo was deleted

        • group_chat_created boolean

          Optional. Service message: the group has been created

        • supergroup_chat_created boolean

          Optional. Service message: the supergroup has been created. This field can't be received in a message coming through updates, because bot can't be a member of a supergroup when it is created. It can only be found in reply_to_message if someone replies to a very first message in a directly created supergroup.

        • channel_chat_created boolean

          Optional. Service message: the channel has been created. This field can't be received in a message coming through updates, because bot can't be a member of a channel when it is created. It can only be found in reply_to_message if someone replies to a very first message in a channel.

        • migrate_to_chat_id integer

          Optional. The group has been migrated to a supergroup with the specified identifier. This number 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.

        • migrate_from_chat_id integer

          Optional. The supergroup has been migrated from a group with the specified identifier. This number 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.

        • pinned_message object

          This object represents a message.

        • invoice object

          This object contains basic information about an invoice.

          Hide invoice attributes Show invoice attributes object
          • title string Required

            Product name

          • description string Required

            Product description

          • start_parameter string Required

            Unique bot deep-linking parameter that can be used to generate this invoice

          • currency string Required

            Three-letter ISO 4217 currency code

          • total_amount integer Required

            Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass 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).

        • successful_payment object

          This object contains basic information about a successful payment.

          Hide successful_payment attributes Show successful_payment attributes object
          • currency string Required

            Three-letter ISO 4217 currency code

          • total_amount integer Required

            Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass 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).

          • invoice_payload string Required

            Bot specified invoice payload

          • shipping_option_id string

            Optional. Identifier of the shipping option chosen by the user

          • order_info object

            This object represents information about an order.

            Hide order_info attributes Show order_info attributes object
            • name string

              Optional. User name

            • phone_number string

              Optional. User's phone number

            • email string

              Optional. User email

            • shipping_address object

              This object represents a shipping address.

              Hide shipping_address attributes Show shipping_address attributes object
              • country_code string Required

                ISO 3166-1 alpha-2 country code

              • state string Required

                State, if applicable

              • city string Required

                City

              • street_line1 string Required

                First line for the address

              • street_line2 string Required

                Second line for the address

              • post_code string Required

                Address post code

          • telegram_payment_charge_id string Required

            Telegram payment identifier

          • provider_payment_charge_id string Required

            Provider payment identifier

        • connected_website string

          Optional. The domain name of the website on which the user has logged in. More about Telegram Login »

        • passport_data object

          Contains information about Telegram Passport data shared with the bot by the user.

          Hide passport_data attributes Show passport_data attributes object
          • data array[object] Required

            Contains information about documents or other Telegram Passport elements shared with the bot by the user.

            Hide data attributes Show data attributes array[object]
            • type string Required

              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”.

              Values are personal_details, passport, driver_license, identity_card, internal_passport, address, utility_bill, bank_statement, rental_agreement, passport_registration, temporary_registration, phone_number, or email.

            • data string

              Optional. Base64-encoded encrypted Telegram Passport element data provided by the user, available for “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport” and “address” types. Can be decrypted and verified using the accompanying EncryptedCredentials.

            • phone_number string

              Optional. User's verified phone number, available only for “phone_number” type

            • email string

              Optional. User's verified email address, available only for “email” type

            • files array[object]

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide files attributes Show files attributes array[object]
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • front_side object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide front_side attributes Show front_side attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • reverse_side object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide reverse_side attributes Show reverse_side attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • selfie object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide selfie attributes Show selfie attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • translation array[object]

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide translation attributes Show translation attributes array[object]
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • hash string Required

              Base64-encoded element hash for using in PassportElementErrorUnspecified

          • credentials object Required

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

            Hide credentials attributes Show credentials attributes object
            • data string Required

              Base64-encoded encrypted JSON-serialized data with unique user's payload, data hashes and secrets required for EncryptedPassportElement decryption and authentication

            • hash string Required

              Base64-encoded data hash for data authentication

            • secret string Required

              Base64-encoded secret, encrypted with the bot's public RSA key, required for data decryption

        • proximity_alert_triggered object

          This object represents the content of a service message, sent whenever a user in the chat triggers a proximity alert set by another user.

          Hide proximity_alert_triggered attributes Show proximity_alert_triggered attributes object
          • traveler object Required

            This object represents a Telegram user or bot.

            Hide traveler attributes Show traveler attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • watcher object Required

            This object represents a Telegram user or bot.

            Hide watcher attributes Show watcher attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • distance integer Required

            The distance between the users

        • reply_markup object

          This object represents an inline keyboard that appears right next to the message it belongs to.

          Hide reply_markup attribute Show reply_markup attribute object
      • edited_channel_post object

        This object represents a message.

        Hide edited_channel_post attributes Show edited_channel_post attributes object
        • message_id integer Required

          Unique message identifier inside this chat

        • from object

          This object represents a Telegram user or bot.

          Hide from attributes Show from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • sender_chat object

          This object represents a chat.

          Hide sender_chat attributes Show sender_chat attributes object
          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • first_name string

            Optional. First name of the other party in a private chat

          • last_name string

            Optional. Last name of the other party in a private chat

          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • date integer Required

          Date the message was sent in Unix time

        • chat object Required

          This object represents a chat.

          Hide chat attributes Show chat attributes object
          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • first_name string

            Optional. First name of the other party in a private chat

          • last_name string

            Optional. Last name of the other party in a private chat

          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • forward_from object

          This object represents a Telegram user or bot.

          Hide forward_from attributes Show forward_from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • forward_from_chat object

          This object represents a chat.

          Hide forward_from_chat attributes Show forward_from_chat attributes object
          • first_name string

            Optional. First name of the other party in a private chat

          • id integer Required

            Unique identifier for this chat. This number 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.

          • type string Required

            Type of chat, can be either “private”, “group”, “supergroup” or “channel”

            Values are private, group, supergroup, or channel.

          • title string

            Optional. Title, for supergroups, channels and group chats

          • username string

            Optional. Username, for private chats, supergroups and channels if available

          • last_name string

            Optional. Last name of the other party in a private chat

          • photo object

            This object represents a chat photo.

            Hide photo attributes Show photo attributes object
            • small_file_id string Required

              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 string Required

              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 string Required

              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 string Required

              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.

          • bio string

            Optional. Bio of the other party in a private chat. Returned only in getChat.

          • description string

            Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

          • invite_link string

            Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

          • pinned_message object

            This object represents a message.

          • permissions object

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

            Hide permissions attributes Show permissions attributes object
            • can_send_messages boolean

              Optional. True, if the user is allowed to send text messages, contacts, locations and venues

            • can_send_media_messages boolean

              Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

            • can_send_polls boolean

              Optional. True, if the user is allowed to send polls, implies can_send_messages

            • can_send_other_messages boolean

              Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

            • can_add_web_page_previews boolean

              Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

            • can_change_info boolean

              Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

            • can_invite_users boolean

              Optional. True, if the user is allowed to invite new users to the chat

            • can_pin_messages boolean

              Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

          • slow_mode_delay integer

            Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

          • sticker_set_name string

            Optional. For supergroups, name of group sticker set. Returned only in getChat.

          • can_set_sticker_set boolean

            Optional. True, if the bot can change the group sticker set. Returned only in getChat.

          • linked_chat_id integer

            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. Returned only in getChat.

          • location object

            Represents a location to which a chat is connected.

            Hide location attributes Show location attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • address string Required

              Location address; 1-64 characters, as defined by the chat owner

        • forward_from_message_id integer

          Optional. For messages forwarded from channels, identifier of the original message in the channel

        • forward_signature string

          Optional. For messages forwarded from channels, signature of the post author if present

        • forward_sender_name string

          Optional. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages

        • forward_date integer

          Optional. For forwarded messages, date the original message was sent in Unix time

        • reply_to_message object

          This object represents a message.

        • via_bot object

          This object represents a Telegram user or bot.

          Hide via_bot attributes Show via_bot attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • edit_date integer

          Optional. Date the message was last edited in Unix time

        • media_group_id string

          Optional. The unique identifier of a media message group this message belongs to

        • author_signature string

          Optional. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator

        • text string

          Optional. For text messages, the actual UTF-8 text of the message, 0-4096 characters

        • entities array[object]

          This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

          Hide entities attributes Show entities attributes array[object]
          • url string

            Optional. For “text_link” only, url that will be opened after user taps on the text

          • type string Required

            Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

            Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

          • offset integer Required

            Offset in UTF-16 code units to the start of the entity

          • length integer Required

            Length of the entity in UTF-16 code units

          • user object

            This object represents a Telegram user or bot.

            Hide user attributes Show user attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • language string

            Optional. For “pre” only, the programming language of the entity text

        • animation object

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

          Hide animation attributes Show animation attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Video width as defined by sender

          • height integer Required

            Video height as defined by sender

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original animation filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

        • audio object

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

          Hide audio attributes Show audio attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Duration of the audio in seconds as defined by sender

          • performer string

            Optional. Performer of the audio as defined by sender or by audio tags

          • title string

            Optional. Title of the audio as defined by sender or by audio tags

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

        • document object

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

          Hide document attributes Show document attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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.

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

          • file_size integer

            Optional. File size

        • photo array[object]

          This object represents one size of a photo or a file / sticker thumbnail.

          Hide photo attributes Show photo attributes array[object]
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Photo width

          • height integer Required

            Photo height

          • file_size integer

            Optional. File size

        • sticker object

          This object represents a sticker.

          Hide sticker attributes Show sticker attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Sticker width

          • height integer Required

            Sticker height

          • is_animated boolean Required

            True, if the sticker is animated

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • emoji string

            Optional. Emoji associated with the sticker

          • set_name string

            Optional. Name of the sticker set to which the sticker belongs

          • mask_position object

            This object describes the position on faces where a mask should be placed by default.

            Hide mask_position attributes Show mask_position attributes object
            • point string Required

              The part of the face relative to which the mask should be placed. One of “forehead”, “eyes”, “mouth”, or “chin”.

              Values are forehead, eyes, mouth, or chin.

            • x_shift number Required

              Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. For example, choosing -1.0 will place mask just to the left of the default mask position.

            • y_shift number Required

              Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom. For example, 1.0 will place the mask just below the default mask position.

            • scale number Required

              Mask scaling coefficient. For example, 2.0 means double size.

          • file_size integer

            Optional. File size

        • video object

          This object represents a video file.

          Hide video attributes Show video attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Video width as defined by sender

          • height integer Required

            Video height as defined by sender

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_name string

            Optional. Original filename as defined by sender

          • mime_type string

            Optional. Mime type of a file as defined by sender

          • file_size integer

            Optional. File size

        • video_note object

          This object represents a video message (available in Telegram apps as of v.4.0).

          Hide video_note attributes Show video_note attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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.

          • length integer Required

            Video width and height (diameter of the video message) as defined by sender

          • duration integer Required

            Duration of the video in seconds as defined by sender

          • thumb object

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide thumb attributes Show thumb attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • file_size integer

            Optional. File size

        • voice object

          This object represents a voice note.

          Hide voice attributes Show voice attributes object
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_size integer

            Optional. File size

          • file_unique_id string Required

            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 integer Required

            Duration of the audio in seconds as defined by sender

          • mime_type string

            Optional. MIME type of the file as defined by sender

        • caption string

          Optional. Caption for the animation, audio, document, photo, video or voice, 0-1024 characters

        • caption_entities array[object]

          This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

          Hide caption_entities attributes Show caption_entities attributes array[object]
          • type string Required

            Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

            Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

          • offset integer Required

            Offset in UTF-16 code units to the start of the entity

          • length integer Required

            Length of the entity in UTF-16 code units

          • url string

            Optional. For “text_link” only, url that will be opened after user taps on the text

          • user object

            This object represents a Telegram user or bot.

            Hide user attributes Show user attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • language string

            Optional. For “pre” only, the programming language of the entity text

        • contact object

          This object represents a phone contact.

          Hide contact attributes Show contact attributes object
          • phone_number string Required

            Contact's phone number

          • first_name string Required

            Contact's first name

          • last_name string

            Optional. Contact's last name

          • user_id integer

            Optional. Contact's user identifier in Telegram

          • vcard string

            Optional. Additional data about the contact in the form of a vCard

        • dice object

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

          Hide dice attributes Show dice attributes object
          • emoji string Required

            Emoji on which the dice throw animation is based

          • value integer Required

            Value of the dice, 1-6 for “🎲” and “🎯” base emoji, 1-5 for “🏀” and “⚽” base emoji, 1-64 for “🎰” base emoji

        • game object

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

          Hide game attributes Show game attributes object
          • title string Required

            Title of the game

          • description string Required

            Description of the game

          • photo array[object] Required

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide photo attributes Show photo attributes array[object]
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • text string

            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 array[object]

            This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

            Hide text_entities attributes Show text_entities attributes array[object]
            • type string Required

              Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

              Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

            • offset integer Required

              Offset in UTF-16 code units to the start of the entity

            • length integer Required

              Length of the entity in UTF-16 code units

            • url string

              Optional. For “text_link” only, url that will be opened after user taps on the text

            • user object

              This object represents a Telegram user or bot.

              Hide user attributes Show user attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • language string

              Optional. For “pre” only, the programming language of the entity text

          • animation object

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

            Hide animation attributes Show animation attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Video width as defined by sender

            • height integer Required

              Video height as defined by sender

            • duration integer Required

              Duration of the video in seconds as defined by sender

            • thumb object

              This object represents one size of a photo or a file / sticker thumbnail.

              Hide thumb attributes Show thumb attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Photo width

              • height integer Required

                Photo height

              • file_size integer

                Optional. File size

            • file_name string

              Optional. Original animation filename as defined by sender

            • mime_type string

              Optional. MIME type of the file as defined by sender

            • file_size integer

              Optional. File size

        • poll object

          This object contains information about a poll.

          Hide poll attributes Show poll attributes object
          • id string Required

            Unique poll identifier

          • question string Required

            Poll question, 1-255 characters

          • options array[object] Required

            This object contains information about one answer option in a poll.

            Hide options attributes Show options attributes array[object]
            • text string Required

              Option text, 1-100 characters

            • voter_count integer Required

              Number of users that voted for this option

          • total_voter_count integer Required

            Total number of users that voted in the poll

          • is_closed boolean Required

            True, if the poll is closed

          • is_anonymous boolean Required

            True, if the poll is anonymous

          • type string Required

            Poll type, currently can be “regular” or “quiz”

          • allows_multiple_answers boolean Required

            True, if the poll allows multiple answers

          • correct_option_id integer

            Optional. 0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the private chat with the bot.

          • explanation string

            Optional. Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters

          • explanation_entities array[object]

            This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

            Hide explanation_entities attributes Show explanation_entities attributes array[object]
            • type string Required

              Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

              Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

            • offset integer Required

              Offset in UTF-16 code units to the start of the entity

            • length integer Required

              Length of the entity in UTF-16 code units

            • url string

              Optional. For “text_link” only, url that will be opened after user taps on the text

            • user object

              This object represents a Telegram user or bot.

              Hide user attributes Show user attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • language string

              Optional. For “pre” only, the programming language of the entity text

          • open_period integer

            Optional. Amount of time in seconds the poll will be active after creation

          • close_date integer

            Optional. Point in time (Unix timestamp) when the poll will be automatically closed

        • venue object

          This object represents a venue.

          Hide venue attributes Show venue attributes object
          • location object Required

            This object represents a point on the map.

            Hide location attributes Show location attributes object
            • longitude number Required

              Longitude as defined by sender

            • latitude number Required

              Latitude as defined by sender

            • horizontal_accuracy number

              Optional. The radius of uncertainty for the location, measured in meters; 0-1500

            • live_period integer

              Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

            • heading integer

              Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

            • proximity_alert_radius integer

              Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

          • title string Required

            Name of the venue

          • address string Required

            Address of the venue

          • foursquare_id string

            Optional. Foursquare identifier of the venue

          • foursquare_type string

            Optional. Foursquare type of the venue. (For example, “arts_entertainment/default”, “arts_entertainment/aquarium” or “food/icecream”.)

          • google_place_id string

            Optional. Google Places identifier of the venue

          • google_place_type string

            Optional. Google Places type of the venue. (See supported types.)

        • location object

          This object represents a point on the map.

          Hide location attributes Show location attributes object
          • longitude number Required

            Longitude as defined by sender

          • latitude number Required

            Latitude as defined by sender

          • horizontal_accuracy number

            Optional. The radius of uncertainty for the location, measured in meters; 0-1500

          • live_period integer

            Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

          • heading integer

            Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

          • proximity_alert_radius integer

            Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

        • new_chat_members array[object]

          This object represents a Telegram user or bot.

          Hide new_chat_members attributes Show new_chat_members attributes array[object]
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • left_chat_member object

          This object represents a Telegram user or bot.

          Hide left_chat_member attributes Show left_chat_member attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • new_chat_title string

          Optional. A chat title was changed to this value

        • new_chat_photo array[object]

          This object represents one size of a photo or a file / sticker thumbnail.

          Hide new_chat_photo attributes Show new_chat_photo attributes array[object]
          • file_id string Required

            Identifier for this file, which can be used to download or reuse the file

          • file_unique_id string Required

            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 integer Required

            Photo width

          • height integer Required

            Photo height

          • file_size integer

            Optional. File size

        • delete_chat_photo boolean

          Optional. Service message: the chat photo was deleted

        • group_chat_created boolean

          Optional. Service message: the group has been created

        • supergroup_chat_created boolean

          Optional. Service message: the supergroup has been created. This field can't be received in a message coming through updates, because bot can't be a member of a supergroup when it is created. It can only be found in reply_to_message if someone replies to a very first message in a directly created supergroup.

        • channel_chat_created boolean

          Optional. Service message: the channel has been created. This field can't be received in a message coming through updates, because bot can't be a member of a channel when it is created. It can only be found in reply_to_message if someone replies to a very first message in a channel.

        • migrate_to_chat_id integer

          Optional. The group has been migrated to a supergroup with the specified identifier. This number 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.

        • migrate_from_chat_id integer

          Optional. The supergroup has been migrated from a group with the specified identifier. This number 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.

        • pinned_message object

          This object represents a message.

        • invoice object

          This object contains basic information about an invoice.

          Hide invoice attributes Show invoice attributes object
          • title string Required

            Product name

          • description string Required

            Product description

          • start_parameter string Required

            Unique bot deep-linking parameter that can be used to generate this invoice

          • currency string Required

            Three-letter ISO 4217 currency code

          • total_amount integer Required

            Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass 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).

        • successful_payment object

          This object contains basic information about a successful payment.

          Hide successful_payment attributes Show successful_payment attributes object
          • currency string Required

            Three-letter ISO 4217 currency code

          • total_amount integer Required

            Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass 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).

          • invoice_payload string Required

            Bot specified invoice payload

          • shipping_option_id string

            Optional. Identifier of the shipping option chosen by the user

          • order_info object

            This object represents information about an order.

            Hide order_info attributes Show order_info attributes object
            • name string

              Optional. User name

            • phone_number string

              Optional. User's phone number

            • email string

              Optional. User email

            • shipping_address object

              This object represents a shipping address.

              Hide shipping_address attributes Show shipping_address attributes object
              • country_code string Required

                ISO 3166-1 alpha-2 country code

              • state string Required

                State, if applicable

              • city string Required

                City

              • street_line1 string Required

                First line for the address

              • street_line2 string Required

                Second line for the address

              • post_code string Required

                Address post code

          • telegram_payment_charge_id string Required

            Telegram payment identifier

          • provider_payment_charge_id string Required

            Provider payment identifier

        • connected_website string

          Optional. The domain name of the website on which the user has logged in. More about Telegram Login »

        • passport_data object

          Contains information about Telegram Passport data shared with the bot by the user.

          Hide passport_data attributes Show passport_data attributes object
          • data array[object] Required

            Contains information about documents or other Telegram Passport elements shared with the bot by the user.

            Hide data attributes Show data attributes array[object]
            • type string Required

              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”.

              Values are personal_details, passport, driver_license, identity_card, internal_passport, address, utility_bill, bank_statement, rental_agreement, passport_registration, temporary_registration, phone_number, or email.

            • data string

              Optional. Base64-encoded encrypted Telegram Passport element data provided by the user, available for “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport” and “address” types. Can be decrypted and verified using the accompanying EncryptedCredentials.

            • phone_number string

              Optional. User's verified phone number, available only for “phone_number” type

            • email string

              Optional. User's verified email address, available only for “email” type

            • files array[object]

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide files attributes Show files attributes array[object]
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • front_side object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide front_side attributes Show front_side attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • reverse_side object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide reverse_side attributes Show reverse_side attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • selfie object

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide selfie attributes Show selfie attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • translation array[object]

              This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

              Hide translation attributes Show translation attributes array[object]
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                File size

              • file_date integer Required

                Unix time when the file was uploaded

            • hash string Required

              Base64-encoded element hash for using in PassportElementErrorUnspecified

          • credentials object Required

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

            Hide credentials attributes Show credentials attributes object
            • data string Required

              Base64-encoded encrypted JSON-serialized data with unique user's payload, data hashes and secrets required for EncryptedPassportElement decryption and authentication

            • hash string Required

              Base64-encoded data hash for data authentication

            • secret string Required

              Base64-encoded secret, encrypted with the bot's public RSA key, required for data decryption

        • proximity_alert_triggered object

          This object represents the content of a service message, sent whenever a user in the chat triggers a proximity alert set by another user.

          Hide proximity_alert_triggered attributes Show proximity_alert_triggered attributes object
          • traveler object Required

            This object represents a Telegram user or bot.

            Hide traveler attributes Show traveler attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • watcher object Required

            This object represents a Telegram user or bot.

            Hide watcher attributes Show watcher attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • distance integer Required

            The distance between the users

        • reply_markup object

          This object represents an inline keyboard that appears right next to the message it belongs to.

          Hide reply_markup attribute Show reply_markup attribute object
      • inline_query object

        This object represents an incoming inline query. When the user sends an empty query, your bot could return some default or trending results.

        Hide inline_query attributes Show inline_query attributes object
        • id string Required

          Unique identifier for this query

        • from object Required

          This object represents a Telegram user or bot.

          Hide from attributes Show from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • location object

          This object represents a point on the map.

          Hide location attributes Show location attributes object
          • longitude number Required

            Longitude as defined by sender

          • latitude number Required

            Latitude as defined by sender

          • horizontal_accuracy number

            Optional. The radius of uncertainty for the location, measured in meters; 0-1500

          • live_period integer

            Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

          • heading integer

            Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

          • proximity_alert_radius integer

            Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

        • query string Required

          Text of the query (up to 256 characters)

        • offset string Required

          Offset of the results to be returned, can be controlled by the bot

      • chosen_inline_result object

        Represents a result of an inline query that was chosen by the user and sent to their chat partner.

        Hide chosen_inline_result attributes Show chosen_inline_result attributes object
        • result_id string Required

          The unique identifier for the result that was chosen

        • from object Required

          This object represents a Telegram user or bot.

          Hide from attributes Show from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • location object

          This object represents a point on the map.

          Hide location attributes Show location attributes object
          • longitude number Required

            Longitude as defined by sender

          • latitude number Required

            Latitude as defined by sender

          • horizontal_accuracy number

            Optional. The radius of uncertainty for the location, measured in meters; 0-1500

          • live_period integer

            Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

          • heading integer

            Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

          • proximity_alert_radius integer

            Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

        • inline_message_id string

          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 string Required

          The query that was used to obtain the result

      • callback_query object

        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.

        Hide callback_query attributes Show callback_query attributes object
        • id string Required

          Unique identifier for this query

        • from object Required

          This object represents a Telegram user or bot.

          Hide from attributes Show from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • message object

          This object represents a message.

          Hide message attributes Show message attributes object
          • message_id integer Required

            Unique message identifier inside this chat

          • from object

            This object represents a Telegram user or bot.

            Hide from attributes Show from attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • sender_chat object

            This object represents a chat.

            Hide sender_chat attributes Show sender_chat attributes object
            • id integer Required

              Unique identifier for this chat. This number 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.

            • type string Required

              Type of chat, can be either “private”, “group”, “supergroup” or “channel”

              Values are private, group, supergroup, or channel.

            • title string

              Optional. Title, for supergroups, channels and group chats

            • username string

              Optional. Username, for private chats, supergroups and channels if available

            • first_name string

              Optional. First name of the other party in a private chat

            • last_name string

              Optional. Last name of the other party in a private chat

            • photo object

              This object represents a chat photo.

              Hide photo attributes Show photo attributes object
              • small_file_id string Required

                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 string Required

                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 string Required

                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 string Required

                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.

            • bio string

              Optional. Bio of the other party in a private chat. Returned only in getChat.

            • description string

              Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

            • invite_link string

              Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

            • pinned_message object

              This object represents a message.

            • permissions object

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

              Hide permissions attributes Show permissions attributes object
              • can_send_messages boolean

                Optional. True, if the user is allowed to send text messages, contacts, locations and venues

              • can_send_media_messages boolean

                Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

              • can_send_polls boolean

                Optional. True, if the user is allowed to send polls, implies can_send_messages

              • can_send_other_messages boolean

                Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

              • can_add_web_page_previews boolean

                Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

              • can_change_info boolean

                Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

              • can_invite_users boolean

                Optional. True, if the user is allowed to invite new users to the chat

              • can_pin_messages boolean

                Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

            • slow_mode_delay integer

              Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

            • sticker_set_name string

              Optional. For supergroups, name of group sticker set. Returned only in getChat.

            • can_set_sticker_set boolean

              Optional. True, if the bot can change the group sticker set. Returned only in getChat.

            • linked_chat_id integer

              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. Returned only in getChat.

            • location object

              Represents a location to which a chat is connected.

              Hide location attributes Show location attributes object
              • location object Required

                This object represents a point on the map.

                Hide location attributes Show location attributes object
                • longitude number Required

                  Longitude as defined by sender

                • latitude number Required

                  Latitude as defined by sender

                • horizontal_accuracy number

                  Optional. The radius of uncertainty for the location, measured in meters; 0-1500

                • live_period integer

                  Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

                • heading integer

                  Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

                • proximity_alert_radius integer

                  Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

              • address string Required

                Location address; 1-64 characters, as defined by the chat owner

          • date integer Required

            Date the message was sent in Unix time

          • chat object Required

            This object represents a chat.

            Hide chat attributes Show chat attributes object
            • id integer Required

              Unique identifier for this chat. This number 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.

            • type string Required

              Type of chat, can be either “private”, “group”, “supergroup” or “channel”

              Values are private, group, supergroup, or channel.

            • title string

              Optional. Title, for supergroups, channels and group chats

            • username string

              Optional. Username, for private chats, supergroups and channels if available

            • first_name string

              Optional. First name of the other party in a private chat

            • last_name string

              Optional. Last name of the other party in a private chat

            • photo object

              This object represents a chat photo.

              Hide photo attributes Show photo attributes object
              • small_file_id string Required

                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 string Required

                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 string Required

                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 string Required

                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.

            • bio string

              Optional. Bio of the other party in a private chat. Returned only in getChat.

            • description string

              Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

            • invite_link string

              Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

            • pinned_message object

              This object represents a message.

            • permissions object

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

              Hide permissions attributes Show permissions attributes object
              • can_send_messages boolean

                Optional. True, if the user is allowed to send text messages, contacts, locations and venues

              • can_send_media_messages boolean

                Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

              • can_send_polls boolean

                Optional. True, if the user is allowed to send polls, implies can_send_messages

              • can_send_other_messages boolean

                Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

              • can_add_web_page_previews boolean

                Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

              • can_change_info boolean

                Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

              • can_invite_users boolean

                Optional. True, if the user is allowed to invite new users to the chat

              • can_pin_messages boolean

                Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

            • slow_mode_delay integer

              Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

            • sticker_set_name string

              Optional. For supergroups, name of group sticker set. Returned only in getChat.

            • can_set_sticker_set boolean

              Optional. True, if the bot can change the group sticker set. Returned only in getChat.

            • linked_chat_id integer

              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. Returned only in getChat.

            • location object

              Represents a location to which a chat is connected.

              Hide location attributes Show location attributes object
              • location object Required

                This object represents a point on the map.

                Hide location attributes Show location attributes object
                • longitude number Required

                  Longitude as defined by sender

                • latitude number Required

                  Latitude as defined by sender

                • horizontal_accuracy number

                  Optional. The radius of uncertainty for the location, measured in meters; 0-1500

                • live_period integer

                  Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

                • heading integer

                  Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

                • proximity_alert_radius integer

                  Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

              • address string Required

                Location address; 1-64 characters, as defined by the chat owner

          • forward_from object

            This object represents a Telegram user or bot.

            Hide forward_from attributes Show forward_from attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • forward_from_chat object

            This object represents a chat.

            Hide forward_from_chat attributes Show forward_from_chat attributes object
            • id integer Required

              Unique identifier for this chat. This number 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.

            • type string Required

              Type of chat, can be either “private”, “group”, “supergroup” or “channel”

              Values are private, group, supergroup, or channel.

            • title string

              Optional. Title, for supergroups, channels and group chats

            • username string

              Optional. Username, for private chats, supergroups and channels if available

            • first_name string

              Optional. First name of the other party in a private chat

            • last_name string

              Optional. Last name of the other party in a private chat

            • photo object

              This object represents a chat photo.

              Hide photo attributes Show photo attributes object
              • small_file_id string Required

                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 string Required

                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 string Required

                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 string Required

                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.

            • bio string

              Optional. Bio of the other party in a private chat. Returned only in getChat.

            • description string

              Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.

            • invite_link string

              Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.

            • pinned_message object

              This object represents a message.

            • permissions object

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

              Hide permissions attributes Show permissions attributes object
              • can_send_messages boolean

                Optional. True, if the user is allowed to send text messages, contacts, locations and venues

              • can_send_media_messages boolean

                Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages

              • can_send_polls boolean

                Optional. True, if the user is allowed to send polls, implies can_send_messages

              • can_send_other_messages boolean

                Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages

              • can_add_web_page_previews boolean

                Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages

              • can_change_info boolean

                Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups

              • can_invite_users boolean

                Optional. True, if the user is allowed to invite new users to the chat

              • can_pin_messages boolean

                Optional. True, if the user is allowed to pin messages. Ignored in public supergroups

            • slow_mode_delay integer

              Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.

            • sticker_set_name string

              Optional. For supergroups, name of group sticker set. Returned only in getChat.

            • can_set_sticker_set boolean

              Optional. True, if the bot can change the group sticker set. Returned only in getChat.

            • linked_chat_id integer

              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. Returned only in getChat.

            • location object

              Represents a location to which a chat is connected.

              Hide location attributes Show location attributes object
              • location object Required

                This object represents a point on the map.

                Hide location attributes Show location attributes object
                • longitude number Required

                  Longitude as defined by sender

                • latitude number Required

                  Latitude as defined by sender

                • horizontal_accuracy number

                  Optional. The radius of uncertainty for the location, measured in meters; 0-1500

                • live_period integer

                  Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

                • heading integer

                  Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

                • proximity_alert_radius integer

                  Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

              • address string Required

                Location address; 1-64 characters, as defined by the chat owner

          • forward_from_message_id integer

            Optional. For messages forwarded from channels, identifier of the original message in the channel

          • forward_signature string

            Optional. For messages forwarded from channels, signature of the post author if present

          • forward_sender_name string

            Optional. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages

          • forward_date integer

            Optional. For forwarded messages, date the original message was sent in Unix time

          • reply_to_message object

            This object represents a message.

          • via_bot object

            This object represents a Telegram user or bot.

            Hide via_bot attributes Show via_bot attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • edit_date integer

            Optional. Date the message was last edited in Unix time

          • media_group_id string

            Optional. The unique identifier of a media message group this message belongs to

          • author_signature string

            Optional. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator

          • text string

            Optional. For text messages, the actual UTF-8 text of the message, 0-4096 characters

          • entities array[object]

            This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

            Hide entities attributes Show entities attributes array[object]
            • type string Required

              Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

              Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

            • offset integer Required

              Offset in UTF-16 code units to the start of the entity

            • length integer Required

              Length of the entity in UTF-16 code units

            • url string

              Optional. For “text_link” only, url that will be opened after user taps on the text

            • user object

              This object represents a Telegram user or bot.

              Hide user attributes Show user attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • language string

              Optional. For “pre” only, the programming language of the entity text

          • animation object

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

            Hide animation attributes Show animation attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Video width as defined by sender

            • height integer Required

              Video height as defined by sender

            • duration integer Required

              Duration of the video in seconds as defined by sender

            • thumb object

              This object represents one size of a photo or a file / sticker thumbnail.

              Hide thumb attributes Show thumb attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Photo width

              • height integer Required

                Photo height

              • file_size integer

                Optional. File size

            • file_name string

              Optional. Original animation filename as defined by sender

            • mime_type string

              Optional. MIME type of the file as defined by sender

            • file_size integer

              Optional. File size

          • audio object

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

            Hide audio attributes Show audio attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Duration of the audio in seconds as defined by sender

            • performer string

              Optional. Performer of the audio as defined by sender or by audio tags

            • title string

              Optional. Title of the audio as defined by sender or by audio tags

            • file_name string

              Optional. Original filename as defined by sender

            • mime_type string

              Optional. MIME type of the file as defined by sender

            • file_size integer

              Optional. File size

            • thumb object

              This object represents one size of a photo or a file / sticker thumbnail.

              Hide thumb attributes Show thumb attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Photo width

              • height integer Required

                Photo height

              • file_size integer

                Optional. File size

          • document object

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

            Hide document attributes Show document attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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.

            • thumb object

              This object represents one size of a photo or a file / sticker thumbnail.

              Hide thumb attributes Show thumb attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Photo width

              • height integer Required

                Photo height

              • file_size integer

                Optional. File size

            • file_name string

              Optional. Original filename as defined by sender

            • mime_type string

              Optional. MIME type of the file as defined by sender

            • file_size integer

              Optional. File size

          • photo array[object]

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide photo attributes Show photo attributes array[object]
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • sticker object

            This object represents a sticker.

            Hide sticker attributes Show sticker attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Sticker width

            • height integer Required

              Sticker height

            • is_animated boolean Required

              True, if the sticker is animated

            • thumb object

              This object represents one size of a photo or a file / sticker thumbnail.

              Hide thumb attributes Show thumb attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Photo width

              • height integer Required

                Photo height

              • file_size integer

                Optional. File size

            • emoji string

              Optional. Emoji associated with the sticker

            • set_name string

              Optional. Name of the sticker set to which the sticker belongs

            • mask_position object

              This object describes the position on faces where a mask should be placed by default.

              Hide mask_position attributes Show mask_position attributes object
              • point string Required

                The part of the face relative to which the mask should be placed. One of “forehead”, “eyes”, “mouth”, or “chin”.

                Values are forehead, eyes, mouth, or chin.

              • x_shift number Required

                Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. For example, choosing -1.0 will place mask just to the left of the default mask position.

              • y_shift number Required

                Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom. For example, 1.0 will place the mask just below the default mask position.

              • scale number Required

                Mask scaling coefficient. For example, 2.0 means double size.

            • file_size integer

              Optional. File size

          • video object

            This object represents a video file.

            Hide video attributes Show video attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Video width as defined by sender

            • height integer Required

              Video height as defined by sender

            • duration integer Required

              Duration of the video in seconds as defined by sender

            • thumb object

              This object represents one size of a photo or a file / sticker thumbnail.

              Hide thumb attributes Show thumb attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Photo width

              • height integer Required

                Photo height

              • file_size integer

                Optional. File size

            • file_name string

              Optional. Original filename as defined by sender

            • mime_type string

              Optional. Mime type of a file as defined by sender

            • file_size integer

              Optional. File size

          • video_note object

            This object represents a video message (available in Telegram apps as of v.4.0).

            Hide video_note attributes Show video_note attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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.

            • length integer Required

              Video width and height (diameter of the video message) as defined by sender

            • duration integer Required

              Duration of the video in seconds as defined by sender

            • thumb object

              This object represents one size of a photo or a file / sticker thumbnail.

              Hide thumb attributes Show thumb attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Photo width

              • height integer Required

                Photo height

              • file_size integer

                Optional. File size

            • file_size integer

              Optional. File size

          • voice object

            This object represents a voice note.

            Hide voice attributes Show voice attributes object
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Duration of the audio in seconds as defined by sender

            • mime_type string

              Optional. MIME type of the file as defined by sender

            • file_size integer

              Optional. File size

          • caption string

            Optional. Caption for the animation, audio, document, photo, video or voice, 0-1024 characters

          • caption_entities array[object]

            This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

            Hide caption_entities attributes Show caption_entities attributes array[object]
            • type string Required

              Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

              Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

            • offset integer Required

              Offset in UTF-16 code units to the start of the entity

            • length integer Required

              Length of the entity in UTF-16 code units

            • url string

              Optional. For “text_link” only, url that will be opened after user taps on the text

            • user object

              This object represents a Telegram user or bot.

              Hide user attributes Show user attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • language string

              Optional. For “pre” only, the programming language of the entity text

          • contact object

            This object represents a phone contact.

            Hide contact attributes Show contact attributes object
            • phone_number string Required

              Contact's phone number

            • first_name string Required

              Contact's first name

            • last_name string

              Optional. Contact's last name

            • user_id integer

              Optional. Contact's user identifier in Telegram

            • vcard string

              Optional. Additional data about the contact in the form of a vCard

          • dice object

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

            Hide dice attributes Show dice attributes object
            • emoji string Required

              Emoji on which the dice throw animation is based

            • value integer Required

              Value of the dice, 1-6 for “🎲” and “🎯” base emoji, 1-5 for “🏀” and “⚽” base emoji, 1-64 for “🎰” base emoji

          • game object

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

            Hide game attributes Show game attributes object
            • title string Required

              Title of the game

            • description string Required

              Description of the game

            • photo array[object] Required

              This object represents one size of a photo or a file / sticker thumbnail.

              Hide photo attributes Show photo attributes array[object]
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Photo width

              • height integer Required

                Photo height

              • file_size integer

                Optional. File size

            • text string

              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 array[object]

              This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

              Hide text_entities attributes Show text_entities attributes array[object]
              • type string Required

                Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

                Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

              • offset integer Required

                Offset in UTF-16 code units to the start of the entity

              • length integer Required

                Length of the entity in UTF-16 code units

              • url string

                Optional. For “text_link” only, url that will be opened after user taps on the text

              • user object

                This object represents a Telegram user or bot.

                Hide user attributes Show user attributes object
                • id integer Required

                  Unique identifier for this user or bot

                • is_bot boolean Required

                  True, if this user is a bot

                • first_name string Required

                  User's or bot's first name

                • last_name string

                  Optional. User's or bot's last name

                • username string

                  Optional. User's or bot's username

                • language_code string

                  Optional. IETF language tag of the user's language

                • can_join_groups boolean

                  Optional. True, if the bot can be invited to groups. Returned only in getMe.

                • can_read_all_group_messages boolean

                  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

                • supports_inline_queries boolean

                  Optional. True, if the bot supports inline queries. Returned only in getMe.

              • language string

                Optional. For “pre” only, the programming language of the entity text

            • animation object

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

              Hide animation attributes Show animation attributes object
              • file_id string Required

                Identifier for this file, which can be used to download or reuse the file

              • file_unique_id string Required

                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 integer Required

                Video width as defined by sender

              • height integer Required

                Video height as defined by sender

              • duration integer Required

                Duration of the video in seconds as defined by sender

              • thumb object

                This object represents one size of a photo or a file / sticker thumbnail.

                Hide thumb attributes Show thumb attributes object
                • file_id string Required

                  Identifier for this file, which can be used to download or reuse the file

                • file_unique_id string Required

                  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 integer Required

                  Photo width

                • height integer Required

                  Photo height

                • file_size integer

                  Optional. File size

              • file_name string

                Optional. Original animation filename as defined by sender

              • mime_type string

                Optional. MIME type of the file as defined by sender

              • file_size integer

                Optional. File size

          • poll object

            This object contains information about a poll.

            Hide poll attributes Show poll attributes object
            • id string Required

              Unique poll identifier

            • question string Required

              Poll question, 1-255 characters

            • options array[object] Required

              This object contains information about one answer option in a poll.

              Hide options attributes Show options attributes array[object]
              • text string Required

                Option text, 1-100 characters

              • voter_count integer Required

                Number of users that voted for this option

            • total_voter_count integer Required

              Total number of users that voted in the poll

            • is_closed boolean Required

              True, if the poll is closed

            • is_anonymous boolean Required

              True, if the poll is anonymous

            • type string Required

              Poll type, currently can be “regular” or “quiz”

            • allows_multiple_answers boolean Required

              True, if the poll allows multiple answers

            • correct_option_id integer

              Optional. 0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the private chat with the bot.

            • explanation string

              Optional. Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters

            • explanation_entities array[object]

              This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

              Hide explanation_entities attributes Show explanation_entities attributes array[object]
              • type string Required

                Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

                Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

              • offset integer Required

                Offset in UTF-16 code units to the start of the entity

              • length integer Required

                Length of the entity in UTF-16 code units

              • url string

                Optional. For “text_link” only, url that will be opened after user taps on the text

              • user object

                This object represents a Telegram user or bot.

                Hide user attributes Show user attributes object
                • id integer Required

                  Unique identifier for this user or bot

                • is_bot boolean Required

                  True, if this user is a bot

                • first_name string Required

                  User's or bot's first name

                • last_name string

                  Optional. User's or bot's last name

                • username string

                  Optional. User's or bot's username

                • language_code string

                  Optional. IETF language tag of the user's language

                • can_join_groups boolean

                  Optional. True, if the bot can be invited to groups. Returned only in getMe.

                • can_read_all_group_messages boolean

                  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

                • supports_inline_queries boolean

                  Optional. True, if the bot supports inline queries. Returned only in getMe.

              • language string

                Optional. For “pre” only, the programming language of the entity text

            • open_period integer

              Optional. Amount of time in seconds the poll will be active after creation

            • close_date integer

              Optional. Point in time (Unix timestamp) when the poll will be automatically closed

          • venue object

            This object represents a venue.

            Hide venue attributes Show venue attributes object
            • location object Required

              This object represents a point on the map.

              Hide location attributes Show location attributes object
              • longitude number Required

                Longitude as defined by sender

              • latitude number Required

                Latitude as defined by sender

              • horizontal_accuracy number

                Optional. The radius of uncertainty for the location, measured in meters; 0-1500

              • live_period integer

                Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

              • heading integer

                Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

              • proximity_alert_radius integer

                Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

            • title string Required

              Name of the venue

            • address string Required

              Address of the venue

            • foursquare_id string

              Optional. Foursquare identifier of the venue

            • foursquare_type string

              Optional. Foursquare type of the venue. (For example, “arts_entertainment/default”, “arts_entertainment/aquarium” or “food/icecream”.)

            • google_place_id string

              Optional. Google Places identifier of the venue

            • google_place_type string

              Optional. Google Places type of the venue. (See supported types.)

          • location object

            This object represents a point on the map.

            Hide location attributes Show location attributes object
            • longitude number Required

              Longitude as defined by sender

            • latitude number Required

              Latitude as defined by sender

            • horizontal_accuracy number

              Optional. The radius of uncertainty for the location, measured in meters; 0-1500

            • live_period integer

              Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.

            • heading integer

              Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.

            • proximity_alert_radius integer

              Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.

          • new_chat_members array[object]

            This object represents a Telegram user or bot.

            Hide new_chat_members attributes Show new_chat_members attributes array[object]
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • left_chat_member object

            This object represents a Telegram user or bot.

            Hide left_chat_member attributes Show left_chat_member attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • new_chat_title string

            Optional. A chat title was changed to this value

          • new_chat_photo array[object]

            This object represents one size of a photo or a file / sticker thumbnail.

            Hide new_chat_photo attributes Show new_chat_photo attributes array[object]
            • file_id string Required

              Identifier for this file, which can be used to download or reuse the file

            • file_unique_id string Required

              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 integer Required

              Photo width

            • height integer Required

              Photo height

            • file_size integer

              Optional. File size

          • delete_chat_photo boolean

            Optional. Service message: the chat photo was deleted

          • group_chat_created boolean

            Optional. Service message: the group has been created

          • supergroup_chat_created boolean

            Optional. Service message: the supergroup has been created. This field can't be received in a message coming through updates, because bot can't be a member of a supergroup when it is created. It can only be found in reply_to_message if someone replies to a very first message in a directly created supergroup.

          • channel_chat_created boolean

            Optional. Service message: the channel has been created. This field can't be received in a message coming through updates, because bot can't be a member of a channel when it is created. It can only be found in reply_to_message if someone replies to a very first message in a channel.

          • migrate_to_chat_id integer

            Optional. The group has been migrated to a supergroup with the specified identifier. This number 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.

          • migrate_from_chat_id integer

            Optional. The supergroup has been migrated from a group with the specified identifier. This number 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.

          • pinned_message object

            This object represents a message.

          • invoice object

            This object contains basic information about an invoice.

            Hide invoice attributes Show invoice attributes object
            • title string Required

              Product name

            • description string Required

              Product description

            • start_parameter string Required

              Unique bot deep-linking parameter that can be used to generate this invoice

            • currency string Required

              Three-letter ISO 4217 currency code

            • total_amount integer Required

              Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass 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).

          • successful_payment object

            This object contains basic information about a successful payment.

            Hide successful_payment attributes Show successful_payment attributes object
            • currency string Required

              Three-letter ISO 4217 currency code

            • total_amount integer Required

              Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass 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).

            • invoice_payload string Required

              Bot specified invoice payload

            • shipping_option_id string

              Optional. Identifier of the shipping option chosen by the user

            • order_info object

              This object represents information about an order.

              Hide order_info attributes Show order_info attributes object
              • name string

                Optional. User name

              • phone_number string

                Optional. User's phone number

              • email string

                Optional. User email

              • shipping_address object

                This object represents a shipping address.

                Hide shipping_address attributes Show shipping_address attributes object
                • country_code string Required

                  ISO 3166-1 alpha-2 country code

                • state string Required

                  State, if applicable

                • city string Required

                  City

                • street_line1 string Required

                  First line for the address

                • street_line2 string Required

                  Second line for the address

                • post_code string Required

                  Address post code

            • telegram_payment_charge_id string Required

              Telegram payment identifier

            • provider_payment_charge_id string Required

              Provider payment identifier

          • connected_website string

            Optional. The domain name of the website on which the user has logged in. More about Telegram Login »

          • passport_data object

            Contains information about Telegram Passport data shared with the bot by the user.

            Hide passport_data attributes Show passport_data attributes object
            • data array[object] Required

              Contains information about documents or other Telegram Passport elements shared with the bot by the user.

              Hide data attributes Show data attributes array[object]
              • type string Required

                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”.

                Values are personal_details, passport, driver_license, identity_card, internal_passport, address, utility_bill, bank_statement, rental_agreement, passport_registration, temporary_registration, phone_number, or email.

              • data string

                Optional. Base64-encoded encrypted Telegram Passport element data provided by the user, available for “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport” and “address” types. Can be decrypted and verified using the accompanying EncryptedCredentials.

              • phone_number string

                Optional. User's verified phone number, available only for “phone_number” type

              • email string

                Optional. User's verified email address, available only for “email” type

              • files array[object]

                This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

                Hide files attributes Show files attributes array[object]
                • file_id string Required

                  Identifier for this file, which can be used to download or reuse the file

                • file_unique_id string Required

                  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 integer Required

                  File size

                • file_date integer Required

                  Unix time when the file was uploaded

              • front_side object

                This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

                Hide front_side attributes Show front_side attributes object
                • file_id string Required

                  Identifier for this file, which can be used to download or reuse the file

                • file_unique_id string Required

                  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 integer Required

                  File size

                • file_date integer Required

                  Unix time when the file was uploaded

              • reverse_side object

                This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

                Hide reverse_side attributes Show reverse_side attributes object
                • file_id string Required

                  Identifier for this file, which can be used to download or reuse the file

                • file_unique_id string Required

                  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 integer Required

                  File size

                • file_date integer Required

                  Unix time when the file was uploaded

              • selfie object

                This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

                Hide selfie attributes Show selfie attributes object
                • file_id string Required

                  Identifier for this file, which can be used to download or reuse the file

                • file_unique_id string Required

                  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 integer Required

                  File size

                • file_date integer Required

                  Unix time when the file was uploaded

              • translation array[object]

                This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.

                Hide translation attributes Show translation attributes array[object]
                • file_id string Required

                  Identifier for this file, which can be used to download or reuse the file

                • file_unique_id string Required

                  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 integer Required

                  File size

                • file_date integer Required

                  Unix time when the file was uploaded

              • hash string Required

                Base64-encoded element hash for using in PassportElementErrorUnspecified

            • credentials object Required

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

              Hide credentials attributes Show credentials attributes object
              • data string Required

                Base64-encoded encrypted JSON-serialized data with unique user's payload, data hashes and secrets required for EncryptedPassportElement decryption and authentication

              • hash string Required

                Base64-encoded data hash for data authentication

              • secret string Required

                Base64-encoded secret, encrypted with the bot's public RSA key, required for data decryption

          • proximity_alert_triggered object

            This object represents the content of a service message, sent whenever a user in the chat triggers a proximity alert set by another user.

            Hide proximity_alert_triggered attributes Show proximity_alert_triggered attributes object
            • traveler object Required

              This object represents a Telegram user or bot.

              Hide traveler attributes Show traveler attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • watcher object Required

              This object represents a Telegram user or bot.

              Hide watcher attributes Show watcher attributes object
              • id integer Required

                Unique identifier for this user or bot

              • is_bot boolean Required

                True, if this user is a bot

              • first_name string Required

                User's or bot's first name

              • last_name string

                Optional. User's or bot's last name

              • username string

                Optional. User's or bot's username

              • language_code string

                Optional. IETF language tag of the user's language

              • can_join_groups boolean

                Optional. True, if the bot can be invited to groups. Returned only in getMe.

              • can_read_all_group_messages boolean

                Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

              • supports_inline_queries boolean

                Optional. True, if the bot supports inline queries. Returned only in getMe.

            • distance integer Required

              The distance between the users

          • reply_markup object

            This object represents an inline keyboard that appears right next to the message it belongs to.

            Hide reply_markup attribute Show reply_markup attribute object
        • inline_message_id string

          Optional. Identifier of the message sent via the bot in inline mode, that originated the query.

        • chat_instance string Required

          Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in games.

        • data string

          Optional. Data associated with the callback button. Be aware that a bad client can send arbitrary data in this field.

        • game_short_name string

          Optional. Short name of a Game to be returned, serves as the unique identifier for the game

      • shipping_query object

        This object contains information about an incoming shipping query.

        Hide shipping_query attributes Show shipping_query attributes object
        • id string Required

          Unique query identifier

        • from object Required

          This object represents a Telegram user or bot.

          Hide from attributes Show from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • invoice_payload string Required

          Bot specified invoice payload

        • shipping_address object Required

          This object represents a shipping address.

          Hide shipping_address attributes Show shipping_address attributes object
          • country_code string Required

            ISO 3166-1 alpha-2 country code

          • state string Required

            State, if applicable

          • city string Required

            City

          • street_line1 string Required

            First line for the address

          • street_line2 string Required

            Second line for the address

          • post_code string Required

            Address post code

      • pre_checkout_query object

        This object contains information about an incoming pre-checkout query.

        Hide pre_checkout_query attributes Show pre_checkout_query attributes object
        • id string Required

          Unique query identifier

        • from object Required

          This object represents a Telegram user or bot.

          Hide from attributes Show from attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • currency string Required

          Three-letter ISO 4217 currency code

        • total_amount integer Required

          Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass 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).

        • invoice_payload string Required

          Bot specified invoice payload

        • shipping_option_id string

          Optional. Identifier of the shipping option chosen by the user

        • order_info object

          This object represents information about an order.

          Hide order_info attributes Show order_info attributes object
          • name string

            Optional. User name

          • phone_number string

            Optional. User's phone number

          • email string

            Optional. User email

          • shipping_address object

            This object represents a shipping address.

            Hide shipping_address attributes Show shipping_address attributes object
            • country_code string Required

              ISO 3166-1 alpha-2 country code

            • state string Required

              State, if applicable

            • city string Required

              City

            • street_line1 string Required

              First line for the address

            • street_line2 string Required

              Second line for the address

            • post_code string Required

              Address post code

      • poll object

        This object contains information about a poll.

        Hide poll attributes Show poll attributes object
        • id string Required

          Unique poll identifier

        • question string Required

          Poll question, 1-255 characters

        • options array[object] Required

          This object contains information about one answer option in a poll.

          Hide options attributes Show options attributes array[object]
          • text string Required

            Option text, 1-100 characters

          • voter_count integer Required

            Number of users that voted for this option

        • total_voter_count integer Required

          Total number of users that voted in the poll

        • is_closed boolean Required

          True, if the poll is closed

        • is_anonymous boolean Required

          True, if the poll is anonymous

        • type string Required

          Poll type, currently can be “regular” or “quiz”

        • allows_multiple_answers boolean Required

          True, if the poll allows multiple answers

        • correct_option_id integer

          Optional. 0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the private chat with the bot.

        • explanation string

          Optional. Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters

        • explanation_entities array[object]

          This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

          Hide explanation_entities attributes Show explanation_entities attributes array[object]
          • type string Required

            Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

            Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

          • offset integer Required

            Offset in UTF-16 code units to the start of the entity

          • length integer Required

            Length of the entity in UTF-16 code units

          • url string

            Optional. For “text_link” only, url that will be opened after user taps on the text

          • user object

            This object represents a Telegram user or bot.

            Hide user attributes Show user attributes object
            • id integer Required

              Unique identifier for this user or bot

            • is_bot boolean Required

              True, if this user is a bot

            • first_name string Required

              User's or bot's first name

            • last_name string

              Optional. User's or bot's last name

            • username string

              Optional. User's or bot's username

            • language_code string

              Optional. IETF language tag of the user's language

            • can_join_groups boolean

              Optional. True, if the bot can be invited to groups. Returned only in getMe.

            • can_read_all_group_messages boolean

              Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

            • supports_inline_queries boolean

              Optional. True, if the bot supports inline queries. Returned only in getMe.

          • language string

            Optional. For “pre” only, the programming language of the entity text

        • open_period integer

          Optional. Amount of time in seconds the poll will be active after creation

        • close_date integer

          Optional. Point in time (Unix timestamp) when the poll will be automatically closed

      • poll_answer object

        This object represents an answer of a user in a non-anonymous poll.

        Hide poll_answer attributes Show poll_answer attributes object
        • poll_id string Required

          Unique poll identifier

        • user object Required

          This object represents a Telegram user or bot.

          Hide user attributes Show user attributes object
          • id integer Required

            Unique identifier for this user or bot

          • is_bot boolean Required

            True, if this user is a bot

          • first_name string Required

            User's or bot's first name

          • last_name string

            Optional. User's or bot's last name

          • username string

            Optional. User's or bot's username

          • language_code string

            Optional. IETF language tag of the user's language

          • can_join_groups boolean

            Optional. True, if the bot can be invited to groups. Returned only in getMe.

          • can_read_all_group_messages boolean

            Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

          • supports_inline_queries boolean

            Optional. True, if the bot supports inline queries. Returned only in getMe.

        • option_ids array[integer] Required

          0-based identifiers of answer options, chosen by the user. May be empty if the user retracted their vote.

POST /getUpdates
curl \
 -X POST https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/getUpdates \
 -H "Content-Type: application/json" \
 -d '{"offset":42,"limit":100,"timeout":0,"allowed_updates":["string"]}'
Request example
{
  "offset": 42,
  "limit": 100,
  "timeout": 0,
  "allowed_updates": [
    "string"
  ]
}
Request examples
{
  "offset": 42,
  "limit": 100,
  "timeout": 0,
  "allowed_updates": [
    "string"
  ]
}
Response examples (default)
{
  "ok": false,
  "error_code": 42,
  "description": "string",
  "parameters": {
    "migrate_to_chat_id": 42,
    "retry_after": 42
  }
}
Response examples (default)
{
  "ok": false,
  "error_code": 42,
  "description": "string",
  "parameters": {
    "migrate_to_chat_id": 42,
    "retry_after": 42
  }
}
Response examples (200)
{
  "ok": true,
  "result": [
    {
      "update_id": 42,
      "message": {
        "message_id": 42,
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "sender_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "date": 42,
        "chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "forward_from_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from_message_id": 42,
        "forward_signature": "string",
        "forward_sender_name": "string",
        "forward_date": 42,
        "reply_to_message": {},
        "via_bot": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "edit_date": 42,
        "media_group_id": "string",
        "author_signature": "string",
        "text": "string",
        "entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "animation": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "audio": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "performer": "string",
          "title": "string",
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        },
        "document": {
          "file_id": "string",
          "file_unique_id": "string",
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "sticker": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "is_animated": true,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "emoji": "string",
          "set_name": "string",
          "mask_position": {
            "point": "forehead",
            "x_shift": 42.0,
            "y_shift": 42.0,
            "scale": 42.0
          },
          "file_size": 42
        },
        "video": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "video_note": {
          "file_id": "string",
          "file_unique_id": "string",
          "length": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_size": 42
        },
        "voice": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "mime_type": "string",
          "file_size": 42
        },
        "caption": "string",
        "caption_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "contact": {
          "phone_number": "string",
          "first_name": "string",
          "last_name": "string",
          "user_id": 42,
          "vcard": "string"
        },
        "dice": {
          "emoji": "string",
          "value": 42
        },
        "game": {
          "title": "string",
          "description": "string",
          "photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "text": "string",
          "text_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "animation": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          }
        },
        "poll": {
          "id": "string",
          "question": "string",
          "options": [
            {
              "text": "string",
              "voter_count": 42
            }
          ],
          "total_voter_count": 42,
          "is_closed": true,
          "is_anonymous": true,
          "type": "string",
          "allows_multiple_answers": true,
          "correct_option_id": 42,
          "explanation": "string",
          "explanation_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "open_period": 42,
          "close_date": 42
        },
        "venue": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "title": "string",
          "address": "string",
          "foursquare_id": "string",
          "foursquare_type": "string",
          "google_place_id": "string",
          "google_place_type": "string"
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "new_chat_members": [
          {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          }
        ],
        "left_chat_member": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "new_chat_title": "string",
        "new_chat_photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "delete_chat_photo": true,
        "group_chat_created": true,
        "supergroup_chat_created": true,
        "channel_chat_created": true,
        "migrate_to_chat_id": 42,
        "migrate_from_chat_id": 42,
        "pinned_message": {},
        "invoice": {
          "title": "string",
          "description": "string",
          "start_parameter": "string",
          "currency": "string",
          "total_amount": 42
        },
        "successful_payment": {
          "currency": "string",
          "total_amount": 42,
          "invoice_payload": "string",
          "shipping_option_id": "string",
          "order_info": {
            "name": "string",
            "phone_number": "string",
            "email": "string",
            "shipping_address": {
              "country_code": "string",
              "state": "string",
              "city": "string",
              "street_line1": "string",
              "street_line2": "string",
              "post_code": "string"
            }
          },
          "telegram_payment_charge_id": "string",
          "provider_payment_charge_id": "string"
        },
        "connected_website": "string",
        "passport_data": {
          "data": [
            {
              "type": "personal_details",
              "data": "string",
              "phone_number": "string",
              "email": "string",
              "files": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "front_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "reverse_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "selfie": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "translation": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "hash": "string"
            }
          ],
          "credentials": {
            "data": "string",
            "hash": "string",
            "secret": "string"
          }
        },
        "proximity_alert_triggered": {
          "traveler": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "watcher": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "distance": 42
        },
        "reply_markup": {
          "": [
            [
              {}
            ]
          ]
        }
      },
      "edited_message": {
        "message_id": 42,
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "sender_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "date": 42,
        "chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "forward_from_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from_message_id": 42,
        "forward_signature": "string",
        "forward_sender_name": "string",
        "forward_date": 42,
        "reply_to_message": {},
        "via_bot": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "edit_date": 42,
        "media_group_id": "string",
        "author_signature": "string",
        "text": "string",
        "entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "animation": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "audio": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "performer": "string",
          "title": "string",
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        },
        "document": {
          "file_id": "string",
          "file_unique_id": "string",
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "sticker": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "is_animated": true,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "emoji": "string",
          "set_name": "string",
          "mask_position": {
            "point": "forehead",
            "x_shift": 42.0,
            "y_shift": 42.0,
            "scale": 42.0
          },
          "file_size": 42
        },
        "video": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "video_note": {
          "file_id": "string",
          "file_unique_id": "string",
          "length": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_size": 42
        },
        "voice": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "mime_type": "string",
          "file_size": 42
        },
        "caption": "string",
        "caption_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "contact": {
          "phone_number": "string",
          "first_name": "string",
          "last_name": "string",
          "user_id": 42,
          "vcard": "string"
        },
        "dice": {
          "emoji": "string",
          "value": 42
        },
        "game": {
          "title": "string",
          "description": "string",
          "photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "text": "string",
          "text_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "animation": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          }
        },
        "poll": {
          "id": "string",
          "question": "string",
          "options": [
            {
              "text": "string",
              "voter_count": 42
            }
          ],
          "total_voter_count": 42,
          "is_closed": true,
          "is_anonymous": true,
          "type": "string",
          "allows_multiple_answers": true,
          "correct_option_id": 42,
          "explanation": "string",
          "explanation_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "open_period": 42,
          "close_date": 42
        },
        "venue": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "title": "string",
          "address": "string",
          "foursquare_id": "string",
          "foursquare_type": "string",
          "google_place_id": "string",
          "google_place_type": "string"
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "new_chat_members": [
          {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          }
        ],
        "left_chat_member": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "new_chat_title": "string",
        "new_chat_photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "delete_chat_photo": true,
        "group_chat_created": true,
        "supergroup_chat_created": true,
        "channel_chat_created": true,
        "migrate_to_chat_id": 42,
        "migrate_from_chat_id": 42,
        "pinned_message": {},
        "invoice": {
          "title": "string",
          "description": "string",
          "start_parameter": "string",
          "currency": "string",
          "total_amount": 42
        },
        "successful_payment": {
          "currency": "string",
          "total_amount": 42,
          "invoice_payload": "string",
          "shipping_option_id": "string",
          "order_info": {
            "name": "string",
            "phone_number": "string",
            "email": "string",
            "shipping_address": {
              "country_code": "string",
              "state": "string",
              "city": "string",
              "street_line1": "string",
              "street_line2": "string",
              "post_code": "string"
            }
          },
          "telegram_payment_charge_id": "string",
          "provider_payment_charge_id": "string"
        },
        "connected_website": "string",
        "passport_data": {
          "data": [
            {
              "type": "personal_details",
              "data": "string",
              "phone_number": "string",
              "email": "string",
              "files": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "front_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "reverse_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "selfie": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "translation": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "hash": "string"
            }
          ],
          "credentials": {
            "data": "string",
            "hash": "string",
            "secret": "string"
          }
        },
        "proximity_alert_triggered": {
          "traveler": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "watcher": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "distance": 42
        },
        "reply_markup": {
          "": [
            [
              {}
            ]
          ]
        }
      },
      "channel_post": {
        "message_id": 42,
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "sender_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "date": 42,
        "chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "forward_from_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from_message_id": 42,
        "forward_signature": "string",
        "forward_sender_name": "string",
        "forward_date": 42,
        "reply_to_message": {},
        "via_bot": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "edit_date": 42,
        "media_group_id": "string",
        "author_signature": "string",
        "text": "string",
        "entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "animation": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "audio": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "performer": "string",
          "title": "string",
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        },
        "document": {
          "file_id": "string",
          "file_unique_id": "string",
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "sticker": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "is_animated": true,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "emoji": "string",
          "set_name": "string",
          "mask_position": {
            "point": "forehead",
            "x_shift": 42.0,
            "y_shift": 42.0,
            "scale": 42.0
          },
          "file_size": 42
        },
        "video": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "video_note": {
          "file_id": "string",
          "file_unique_id": "string",
          "length": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_size": 42
        },
        "voice": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "mime_type": "string",
          "file_size": 42
        },
        "caption": "string",
        "caption_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "contact": {
          "phone_number": "string",
          "first_name": "string",
          "last_name": "string",
          "user_id": 42,
          "vcard": "string"
        },
        "dice": {
          "emoji": "string",
          "value": 42
        },
        "game": {
          "title": "string",
          "description": "string",
          "photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "text": "string",
          "text_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "animation": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          }
        },
        "poll": {
          "id": "string",
          "question": "string",
          "options": [
            {
              "text": "string",
              "voter_count": 42
            }
          ],
          "total_voter_count": 42,
          "is_closed": true,
          "is_anonymous": true,
          "type": "string",
          "allows_multiple_answers": true,
          "correct_option_id": 42,
          "explanation": "string",
          "explanation_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "open_period": 42,
          "close_date": 42
        },
        "venue": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "title": "string",
          "address": "string",
          "foursquare_id": "string",
          "foursquare_type": "string",
          "google_place_id": "string",
          "google_place_type": "string"
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "new_chat_members": [
          {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          }
        ],
        "left_chat_member": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "new_chat_title": "string",
        "new_chat_photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "delete_chat_photo": true,
        "group_chat_created": true,
        "supergroup_chat_created": true,
        "channel_chat_created": true,
        "migrate_to_chat_id": 42,
        "migrate_from_chat_id": 42,
        "pinned_message": {},
        "invoice": {
          "title": "string",
          "description": "string",
          "start_parameter": "string",
          "currency": "string",
          "total_amount": 42
        },
        "successful_payment": {
          "currency": "string",
          "total_amount": 42,
          "invoice_payload": "string",
          "shipping_option_id": "string",
          "order_info": {
            "name": "string",
            "phone_number": "string",
            "email": "string",
            "shipping_address": {
              "country_code": "string",
              "state": "string",
              "city": "string",
              "street_line1": "string",
              "street_line2": "string",
              "post_code": "string"
            }
          },
          "telegram_payment_charge_id": "string",
          "provider_payment_charge_id": "string"
        },
        "connected_website": "string",
        "passport_data": {
          "data": [
            {
              "type": "personal_details",
              "data": "string",
              "phone_number": "string",
              "email": "string",
              "files": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "front_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "reverse_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "selfie": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "translation": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "hash": "string"
            }
          ],
          "credentials": {
            "data": "string",
            "hash": "string",
            "secret": "string"
          }
        },
        "proximity_alert_triggered": {
          "traveler": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "watcher": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "distance": 42
        },
        "reply_markup": {
          "": [
            [
              {}
            ]
          ]
        }
      },
      "edited_channel_post": {
        "message_id": 42,
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "sender_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "date": 42,
        "chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "forward_from_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from_message_id": 42,
        "forward_signature": "string",
        "forward_sender_name": "string",
        "forward_date": 42,
        "reply_to_message": {},
        "via_bot": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "edit_date": 42,
        "media_group_id": "string",
        "author_signature": "string",
        "text": "string",
        "entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "animation": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "audio": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "performer": "string",
          "title": "string",
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        },
        "document": {
          "file_id": "string",
          "file_unique_id": "string",
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "sticker": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "is_animated": true,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "emoji": "string",
          "set_name": "string",
          "mask_position": {
            "point": "forehead",
            "x_shift": 42.0,
            "y_shift": 42.0,
            "scale": 42.0
          },
          "file_size": 42
        },
        "video": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "video_note": {
          "file_id": "string",
          "file_unique_id": "string",
          "length": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_size": 42
        },
        "voice": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "mime_type": "string",
          "file_size": 42
        },
        "caption": "string",
        "caption_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "contact": {
          "phone_number": "string",
          "first_name": "string",
          "last_name": "string",
          "user_id": 42,
          "vcard": "string"
        },
        "dice": {
          "emoji": "string",
          "value": 42
        },
        "game": {
          "title": "string",
          "description": "string",
          "photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "text": "string",
          "text_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "animation": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          }
        },
        "poll": {
          "id": "string",
          "question": "string",
          "options": [
            {
              "text": "string",
              "voter_count": 42
            }
          ],
          "total_voter_count": 42,
          "is_closed": true,
          "is_anonymous": true,
          "type": "string",
          "allows_multiple_answers": true,
          "correct_option_id": 42,
          "explanation": "string",
          "explanation_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "open_period": 42,
          "close_date": 42
        },
        "venue": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "title": "string",
          "address": "string",
          "foursquare_id": "string",
          "foursquare_type": "string",
          "google_place_id": "string",
          "google_place_type": "string"
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "new_chat_members": [
          {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          }
        ],
        "left_chat_member": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "new_chat_title": "string",
        "new_chat_photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "delete_chat_photo": true,
        "group_chat_created": true,
        "supergroup_chat_created": true,
        "channel_chat_created": true,
        "migrate_to_chat_id": 42,
        "migrate_from_chat_id": 42,
        "pinned_message": {},
        "invoice": {
          "title": "string",
          "description": "string",
          "start_parameter": "string",
          "currency": "string",
          "total_amount": 42
        },
        "successful_payment": {
          "currency": "string",
          "total_amount": 42,
          "invoice_payload": "string",
          "shipping_option_id": "string",
          "order_info": {
            "name": "string",
            "phone_number": "string",
            "email": "string",
            "shipping_address": {
              "country_code": "string",
              "state": "string",
              "city": "string",
              "street_line1": "string",
              "street_line2": "string",
              "post_code": "string"
            }
          },
          "telegram_payment_charge_id": "string",
          "provider_payment_charge_id": "string"
        },
        "connected_website": "string",
        "passport_data": {
          "data": [
            {
              "type": "personal_details",
              "data": "string",
              "phone_number": "string",
              "email": "string",
              "files": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "front_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "reverse_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "selfie": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "translation": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "hash": "string"
            }
          ],
          "credentials": {
            "data": "string",
            "hash": "string",
            "secret": "string"
          }
        },
        "proximity_alert_triggered": {
          "traveler": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "watcher": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "distance": 42
        },
        "reply_markup": {
          "": [
            [
              {}
            ]
          ]
        }
      },
      "inline_query": {
        "id": "string",
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "query": "string",
        "offset": "string"
      },
      "chosen_inline_result": {
        "result_id": "string",
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "inline_message_id": "string",
        "query": "string"
      },
      "callback_query": {
        "id": "string",
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "message": {
          "message_id": 42,
          "from": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "sender_chat": {
            "id": 42,
            "type": "private",
            "title": "string",
            "username": "string",
            "first_name": "string",
            "last_name": "string",
            "photo": {
              "small_file_id": "string",
              "small_file_unique_id": "string",
              "big_file_id": "string",
              "big_file_unique_id": "string"
            },
            "bio": "string",
            "description": "string",
            "invite_link": "string",
            "pinned_message": {},
            "permissions": {
              "can_send_messages": true,
              "can_send_media_messages": true,
              "can_send_polls": true,
              "can_send_other_messages": true,
              "can_add_web_page_previews": true,
              "can_change_info": true,
              "can_invite_users": true,
              "can_pin_messages": true
            },
            "slow_mode_delay": 42,
            "sticker_set_name": "string",
            "can_set_sticker_set": true,
            "linked_chat_id": 42,
            "location": {
              "location": {
                "longitude": 42.0,
                "latitude": 42.0,
                "horizontal_accuracy": 42.0,
                "live_period": 42,
                "heading": 42,
                "proximity_alert_radius": 42
              },
              "address": "string"
            }
          },
          "date": 42,
          "chat": {
            "id": 42,
            "type": "private",
            "title": "string",
            "username": "string",
            "first_name": "string",
            "last_name": "string",
            "photo": {
              "small_file_id": "string",
              "small_file_unique_id": "string",
              "big_file_id": "string",
              "big_file_unique_id": "string"
            },
            "bio": "string",
            "description": "string",
            "invite_link": "string",
            "pinned_message": {},
            "permissions": {
              "can_send_messages": true,
              "can_send_media_messages": true,
              "can_send_polls": true,
              "can_send_other_messages": true,
              "can_add_web_page_previews": true,
              "can_change_info": true,
              "can_invite_users": true,
              "can_pin_messages": true
            },
            "slow_mode_delay": 42,
            "sticker_set_name": "string",
            "can_set_sticker_set": true,
            "linked_chat_id": 42,
            "location": {
              "location": {
                "longitude": 42.0,
                "latitude": 42.0,
                "horizontal_accuracy": 42.0,
                "live_period": 42,
                "heading": 42,
                "proximity_alert_radius": 42
              },
              "address": "string"
            }
          },
          "forward_from": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "forward_from_chat": {
            "id": 42,
            "type": "private",
            "title": "string",
            "username": "string",
            "first_name": "string",
            "last_name": "string",
            "photo": {
              "small_file_id": "string",
              "small_file_unique_id": "string",
              "big_file_id": "string",
              "big_file_unique_id": "string"
            },
            "bio": "string",
            "description": "string",
            "invite_link": "string",
            "pinned_message": {},
            "permissions": {
              "can_send_messages": true,
              "can_send_media_messages": true,
              "can_send_polls": true,
              "can_send_other_messages": true,
              "can_add_web_page_previews": true,
              "can_change_info": true,
              "can_invite_users": true,
              "can_pin_messages": true
            },
            "slow_mode_delay": 42,
            "sticker_set_name": "string",
            "can_set_sticker_set": true,
            "linked_chat_id": 42,
            "location": {
              "location": {
                "longitude": 42.0,
                "latitude": 42.0,
                "horizontal_accuracy": 42.0,
                "live_period": 42,
                "heading": 42,
                "proximity_alert_radius": 42
              },
              "address": "string"
            }
          },
          "forward_from_message_id": 42,
          "forward_signature": "string",
          "forward_sender_name": "string",
          "forward_date": 42,
          "reply_to_message": {},
          "via_bot": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "edit_date": 42,
          "media_group_id": "string",
          "author_signature": "string",
          "text": "string",
          "entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "animation": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          },
          "audio": {
            "file_id": "string",
            "file_unique_id": "string",
            "duration": 42,
            "performer": "string",
            "title": "string",
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          },
          "document": {
            "file_id": "string",
            "file_unique_id": "string",
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          },
          "photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "sticker": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "is_animated": true,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "emoji": "string",
            "set_name": "string",
            "mask_position": {
              "point": "forehead",
              "x_shift": 42.0,
              "y_shift": 42.0,
              "scale": 42.0
            },
            "file_size": 42
          },
          "video": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          },
          "video_note": {
            "file_id": "string",
            "file_unique_id": "string",
            "length": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_size": 42
          },
          "voice": {
            "file_id": "string",
            "file_unique_id": "string",
            "duration": 42,
            "mime_type": "string",
            "file_size": 42
          },
          "caption": "string",
          "caption_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "contact": {
            "phone_number": "string",
            "first_name": "string",
            "last_name": "string",
            "user_id": 42,
            "vcard": "string"
          },
          "dice": {
            "emoji": "string",
            "value": 42
          },
          "game": {
            "title": "string",
            "description": "string",
            "photo": [
              {
                "file_id": "string",
                "file_unique_id": "string",
                "width": 42,
                "height": 42,
                "file_size": 42
              }
            ],
            "text": "string",
            "text_entities": [
              {
                "type": "mention",
                "offset": 42,
                "length": 42,
                "url": "string",
                "user": {
                  "id": 42,
                  "is_bot": true,
                  "first_name": "string",
                  "last_name": "string",
                  "username": "string",
                  "language_code": "string",
                  "can_join_groups": true,
                  "can_read_all_group_messages": true,
                  "supports_inline_queries": true
                },
                "language": "string"
              }
            ],
            "animation": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "duration": 42,
              "thumb": {
                "file_id": "string",
                "file_unique_id": "string",
                "width": 42,
                "height": 42,
                "file_size": 42
              },
              "file_name": "string",
              "mime_type": "string",
              "file_size": 42
            }
          },
          "poll": {
            "id": "string",
            "question": "string",
            "options": [
              {
                "text": "string",
                "voter_count": 42
              }
            ],
            "total_voter_count": 42,
            "is_closed": true,
            "is_anonymous": true,
            "type": "string",
            "allows_multiple_answers": true,
            "correct_option_id": 42,
            "explanation": "string",
            "explanation_entities": [
              {
                "type": "mention",
                "offset": 42,
                "length": 42,
                "url": "string",
                "user": {
                  "id": 42,
                  "is_bot": true,
                  "first_name": "string",
                  "last_name": "string",
                  "username": "string",
                  "language_code": "string",
                  "can_join_groups": true,
                  "can_read_all_group_messages": true,
                  "supports_inline_queries": true
                },
                "language": "string"
              }
            ],
            "open_period": 42,
            "close_date": 42
          },
          "venue": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "title": "string",
            "address": "string",
            "foursquare_id": "string",
            "foursquare_type": "string",
            "google_place_id": "string",
            "google_place_type": "string"
          },
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "new_chat_members": [
            {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            }
          ],
          "left_chat_member": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "new_chat_title": "string",
          "new_chat_photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "delete_chat_photo": true,
          "group_chat_created": true,
          "supergroup_chat_created": true,
          "channel_chat_created": true,
          "migrate_to_chat_id": 42,
          "migrate_from_chat_id": 42,
          "pinned_message": {},
          "invoice": {
            "title": "string",
            "description": "string",
            "start_parameter": "string",
            "currency": "string",
            "total_amount": 42
          },
          "successful_payment": {
            "currency": "string",
            "total_amount": 42,
            "invoice_payload": "string",
            "shipping_option_id": "string",
            "order_info": {
              "name": "string",
              "phone_number": "string",
              "email": "string",
              "shipping_address": {
                "country_code": "string",
                "state": "string",
                "city": "string",
                "street_line1": "string",
                "street_line2": "string",
                "post_code": "string"
              }
            },
            "telegram_payment_charge_id": "string",
            "provider_payment_charge_id": "string"
          },
          "connected_website": "string",
          "passport_data": {
            "data": [
              {
                "type": "personal_details",
                "data": "string",
                "phone_number": "string",
                "email": "string",
                "files": [
                  {
                    "file_id": "string",
                    "file_unique_id": "string",
                    "file_size": 42,
                    "file_date": 42
                  }
                ],
                "front_side": {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                },
                "reverse_side": {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                },
                "selfie": {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                },
                "translation": [
                  {
                    "file_id": "string",
                    "file_unique_id": "string",
                    "file_size": 42,
                    "file_date": 42
                  }
                ],
                "hash": "string"
              }
            ],
            "credentials": {
              "data": "string",
              "hash": "string",
              "secret": "string"
            }
          },
          "proximity_alert_triggered": {
            "traveler": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "watcher": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "distance": 42
          },
          "reply_markup": {
            "": [
              [
                {}
              ]
            ]
          }
        },
        "inline_message_id": "string",
        "chat_instance": "string",
        "data": "string",
        "game_short_name": "string"
      },
      "shipping_query": {
        "id": "string",
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "invoice_payload": "string",
        "shipping_address": {
          "country_code": "string",
          "state": "string",
          "city": "string",
          "street_line1": "string",
          "street_line2": "string",
          "post_code": "string"
        }
      },
      "pre_checkout_query": {
        "id": "string",
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "currency": "string",
        "total_amount": 42,
        "invoice_payload": "string",
        "shipping_option_id": "string",
        "order_info": {
          "name": "string",
          "phone_number": "string",
          "email": "string",
          "shipping_address": {
            "country_code": "string",
            "state": "string",
            "city": "string",
            "street_line1": "string",
            "street_line2": "string",
            "post_code": "string"
          }
        }
      },
      "poll": {
        "id": "string",
        "question": "string",
        "options": [
          {
            "text": "string",
            "voter_count": 42
          }
        ],
        "total_voter_count": 42,
        "is_closed": true,
        "is_anonymous": true,
        "type": "string",
        "allows_multiple_answers": true,
        "correct_option_id": 42,
        "explanation": "string",
        "explanation_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "open_period": 42,
        "close_date": 42
      },
      "poll_answer": {
        "poll_id": "string",
        "user": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "option_ids": [
          42
        ]
      }
    }
  ]
}
Response examples (200)
{
  "ok": true,
  "result": [
    {
      "update_id": 42,
      "message": {
        "message_id": 42,
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "sender_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "date": 42,
        "chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "forward_from_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from_message_id": 42,
        "forward_signature": "string",
        "forward_sender_name": "string",
        "forward_date": 42,
        "reply_to_message": {},
        "via_bot": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "edit_date": 42,
        "media_group_id": "string",
        "author_signature": "string",
        "text": "string",
        "entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "animation": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "audio": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "performer": "string",
          "title": "string",
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        },
        "document": {
          "file_id": "string",
          "file_unique_id": "string",
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "sticker": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "is_animated": true,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "emoji": "string",
          "set_name": "string",
          "mask_position": {
            "point": "forehead",
            "x_shift": 42.0,
            "y_shift": 42.0,
            "scale": 42.0
          },
          "file_size": 42
        },
        "video": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "video_note": {
          "file_id": "string",
          "file_unique_id": "string",
          "length": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_size": 42
        },
        "voice": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "mime_type": "string",
          "file_size": 42
        },
        "caption": "string",
        "caption_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "contact": {
          "phone_number": "string",
          "first_name": "string",
          "last_name": "string",
          "user_id": 42,
          "vcard": "string"
        },
        "dice": {
          "emoji": "string",
          "value": 42
        },
        "game": {
          "title": "string",
          "description": "string",
          "photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "text": "string",
          "text_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "animation": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          }
        },
        "poll": {
          "id": "string",
          "question": "string",
          "options": [
            {
              "text": "string",
              "voter_count": 42
            }
          ],
          "total_voter_count": 42,
          "is_closed": true,
          "is_anonymous": true,
          "type": "string",
          "allows_multiple_answers": true,
          "correct_option_id": 42,
          "explanation": "string",
          "explanation_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "open_period": 42,
          "close_date": 42
        },
        "venue": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "title": "string",
          "address": "string",
          "foursquare_id": "string",
          "foursquare_type": "string",
          "google_place_id": "string",
          "google_place_type": "string"
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "new_chat_members": [
          {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          }
        ],
        "left_chat_member": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "new_chat_title": "string",
        "new_chat_photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "delete_chat_photo": true,
        "group_chat_created": true,
        "supergroup_chat_created": true,
        "channel_chat_created": true,
        "migrate_to_chat_id": 42,
        "migrate_from_chat_id": 42,
        "pinned_message": {},
        "invoice": {
          "title": "string",
          "description": "string",
          "start_parameter": "string",
          "currency": "string",
          "total_amount": 42
        },
        "successful_payment": {
          "currency": "string",
          "total_amount": 42,
          "invoice_payload": "string",
          "shipping_option_id": "string",
          "order_info": {
            "name": "string",
            "phone_number": "string",
            "email": "string",
            "shipping_address": {
              "country_code": "string",
              "state": "string",
              "city": "string",
              "street_line1": "string",
              "street_line2": "string",
              "post_code": "string"
            }
          },
          "telegram_payment_charge_id": "string",
          "provider_payment_charge_id": "string"
        },
        "connected_website": "string",
        "passport_data": {
          "data": [
            {
              "type": "personal_details",
              "data": "string",
              "phone_number": "string",
              "email": "string",
              "files": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "front_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "reverse_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "selfie": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "translation": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "hash": "string"
            }
          ],
          "credentials": {
            "data": "string",
            "hash": "string",
            "secret": "string"
          }
        },
        "proximity_alert_triggered": {
          "traveler": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "watcher": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "distance": 42
        },
        "reply_markup": {
          "": [
            [
              {}
            ]
          ]
        }
      },
      "edited_message": {
        "message_id": 42,
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "sender_chat": {
          "first_name": "string",
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "date": 42,
        "chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "forward_from_chat": {
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from_message_id": 42,
        "forward_signature": "string",
        "forward_sender_name": "string",
        "forward_date": 42,
        "reply_to_message": {},
        "via_bot": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "edit_date": 42,
        "media_group_id": "string",
        "author_signature": "string",
        "text": "string",
        "entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "animation": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "audio": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "performer": "string",
          "title": "string",
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        },
        "document": {
          "file_id": "string",
          "file_unique_id": "string",
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "sticker": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "is_animated": true,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "emoji": "string",
          "set_name": "string",
          "mask_position": {
            "point": "forehead",
            "x_shift": 42.0,
            "y_shift": 42.0,
            "scale": 42.0
          },
          "file_size": 42
        },
        "video": {
          "file_id": "string",
          "duration": 42,
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "video_note": {
          "file_id": "string",
          "file_unique_id": "string",
          "length": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_size": 42
        },
        "voice": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "mime_type": "string",
          "file_size": 42
        },
        "caption": "string",
        "caption_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "contact": {
          "phone_number": "string",
          "first_name": "string",
          "last_name": "string",
          "user_id": 42,
          "vcard": "string"
        },
        "dice": {
          "emoji": "string",
          "value": 42
        },
        "game": {
          "title": "string",
          "description": "string",
          "photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "text": "string",
          "text_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "animation": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          }
        },
        "poll": {
          "id": "string",
          "question": "string",
          "options": [
            {
              "text": "string",
              "voter_count": 42
            }
          ],
          "total_voter_count": 42,
          "is_closed": true,
          "is_anonymous": true,
          "type": "string",
          "allows_multiple_answers": true,
          "correct_option_id": 42,
          "explanation": "string",
          "explanation_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "open_period": 42,
          "close_date": 42
        },
        "venue": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "title": "string",
          "address": "string",
          "foursquare_id": "string",
          "foursquare_type": "string",
          "google_place_id": "string",
          "google_place_type": "string"
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "new_chat_members": [
          {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          }
        ],
        "left_chat_member": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "new_chat_title": "string",
        "new_chat_photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "delete_chat_photo": true,
        "group_chat_created": true,
        "supergroup_chat_created": true,
        "channel_chat_created": true,
        "migrate_to_chat_id": 42,
        "migrate_from_chat_id": 42,
        "pinned_message": {},
        "invoice": {
          "title": "string",
          "description": "string",
          "start_parameter": "string",
          "currency": "string",
          "total_amount": 42
        },
        "successful_payment": {
          "currency": "string",
          "total_amount": 42,
          "invoice_payload": "string",
          "shipping_option_id": "string",
          "order_info": {
            "name": "string",
            "phone_number": "string",
            "email": "string",
            "shipping_address": {
              "country_code": "string",
              "state": "string",
              "city": "string",
              "street_line1": "string",
              "street_line2": "string",
              "post_code": "string"
            }
          },
          "telegram_payment_charge_id": "string",
          "provider_payment_charge_id": "string"
        },
        "connected_website": "string",
        "passport_data": {
          "data": [
            {
              "type": "personal_details",
              "data": "string",
              "phone_number": "string",
              "email": "string",
              "files": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "front_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "reverse_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "selfie": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "translation": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "hash": "string"
            }
          ],
          "credentials": {
            "data": "string",
            "hash": "string",
            "secret": "string"
          }
        },
        "proximity_alert_triggered": {
          "traveler": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "watcher": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "distance": 42
        },
        "reply_markup": {
          "": [
            [
              {}
            ]
          ]
        }
      },
      "channel_post": {
        "message_id": 42,
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "sender_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "date": 42,
        "chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "forward_from_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from_message_id": 42,
        "forward_signature": "string",
        "forward_sender_name": "string",
        "forward_date": 42,
        "reply_to_message": {},
        "via_bot": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "edit_date": 42,
        "media_group_id": "string",
        "author_signature": "string",
        "text": "string",
        "entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "animation": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "audio": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "performer": "string",
          "title": "string",
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        },
        "document": {
          "file_id": "string",
          "file_unique_id": "string",
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "sticker": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "is_animated": true,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "emoji": "string",
          "set_name": "string",
          "mask_position": {
            "point": "forehead",
            "x_shift": 42.0,
            "y_shift": 42.0,
            "scale": 42.0
          },
          "file_size": 42
        },
        "video": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "video_note": {
          "file_id": "string",
          "file_unique_id": "string",
          "length": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_size": 42
        },
        "voice": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "mime_type": "string",
          "file_size": 42
        },
        "caption": "string",
        "caption_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "contact": {
          "phone_number": "string",
          "first_name": "string",
          "last_name": "string",
          "user_id": 42,
          "vcard": "string"
        },
        "dice": {
          "emoji": "string",
          "value": 42
        },
        "game": {
          "title": "string",
          "description": "string",
          "photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "text": "string",
          "text_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "animation": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          }
        },
        "poll": {
          "id": "string",
          "question": "string",
          "options": [
            {
              "text": "string",
              "voter_count": 42
            }
          ],
          "total_voter_count": 42,
          "is_closed": true,
          "is_anonymous": true,
          "type": "string",
          "allows_multiple_answers": true,
          "correct_option_id": 42,
          "explanation": "string",
          "explanation_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "open_period": 42,
          "close_date": 42
        },
        "venue": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "title": "string",
          "address": "string",
          "foursquare_id": "string",
          "foursquare_type": "string",
          "google_place_id": "string",
          "google_place_type": "string"
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "new_chat_members": [
          {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          }
        ],
        "left_chat_member": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "new_chat_title": "string",
        "new_chat_photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "delete_chat_photo": true,
        "group_chat_created": true,
        "supergroup_chat_created": true,
        "channel_chat_created": true,
        "migrate_to_chat_id": 42,
        "migrate_from_chat_id": 42,
        "pinned_message": {},
        "invoice": {
          "title": "string",
          "description": "string",
          "start_parameter": "string",
          "currency": "string",
          "total_amount": 42
        },
        "successful_payment": {
          "currency": "string",
          "total_amount": 42,
          "invoice_payload": "string",
          "shipping_option_id": "string",
          "order_info": {
            "name": "string",
            "phone_number": "string",
            "email": "string",
            "shipping_address": {
              "country_code": "string",
              "state": "string",
              "city": "string",
              "street_line1": "string",
              "street_line2": "string",
              "post_code": "string"
            }
          },
          "telegram_payment_charge_id": "string",
          "provider_payment_charge_id": "string"
        },
        "connected_website": "string",
        "passport_data": {
          "data": [
            {
              "type": "personal_details",
              "data": "string",
              "phone_number": "string",
              "email": "string",
              "files": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "front_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "reverse_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "selfie": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "translation": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "hash": "string"
            }
          ],
          "credentials": {
            "data": "string",
            "hash": "string",
            "secret": "string"
          }
        },
        "proximity_alert_triggered": {
          "traveler": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "watcher": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "distance": 42
        },
        "reply_markup": {
          "": [
            [
              {}
            ]
          ]
        }
      },
      "edited_channel_post": {
        "message_id": 42,
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "sender_chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "date": 42,
        "chat": {
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "first_name": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "forward_from_chat": {
          "first_name": "string",
          "id": 42,
          "type": "private",
          "title": "string",
          "username": "string",
          "last_name": "string",
          "photo": {
            "small_file_id": "string",
            "small_file_unique_id": "string",
            "big_file_id": "string",
            "big_file_unique_id": "string"
          },
          "bio": "string",
          "description": "string",
          "invite_link": "string",
          "pinned_message": {},
          "permissions": {
            "can_send_messages": true,
            "can_send_media_messages": true,
            "can_send_polls": true,
            "can_send_other_messages": true,
            "can_add_web_page_previews": true,
            "can_change_info": true,
            "can_invite_users": true,
            "can_pin_messages": true
          },
          "slow_mode_delay": 42,
          "sticker_set_name": "string",
          "can_set_sticker_set": true,
          "linked_chat_id": 42,
          "location": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "address": "string"
          }
        },
        "forward_from_message_id": 42,
        "forward_signature": "string",
        "forward_sender_name": "string",
        "forward_date": 42,
        "reply_to_message": {},
        "via_bot": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "edit_date": 42,
        "media_group_id": "string",
        "author_signature": "string",
        "text": "string",
        "entities": [
          {
            "url": "string",
            "type": "mention",
            "offset": 42,
            "length": 42,
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "animation": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "audio": {
          "file_id": "string",
          "file_unique_id": "string",
          "duration": 42,
          "performer": "string",
          "title": "string",
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        },
        "document": {
          "file_id": "string",
          "file_unique_id": "string",
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "sticker": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "is_animated": true,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "emoji": "string",
          "set_name": "string",
          "mask_position": {
            "point": "forehead",
            "x_shift": 42.0,
            "y_shift": 42.0,
            "scale": 42.0
          },
          "file_size": 42
        },
        "video": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        },
        "video_note": {
          "file_id": "string",
          "file_unique_id": "string",
          "length": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_size": 42
        },
        "voice": {
          "file_id": "string",
          "file_size": 42,
          "file_unique_id": "string",
          "duration": 42,
          "mime_type": "string"
        },
        "caption": "string",
        "caption_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "contact": {
          "phone_number": "string",
          "first_name": "string",
          "last_name": "string",
          "user_id": 42,
          "vcard": "string"
        },
        "dice": {
          "emoji": "string",
          "value": 42
        },
        "game": {
          "title": "string",
          "description": "string",
          "photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "text": "string",
          "text_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "animation": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          }
        },
        "poll": {
          "id": "string",
          "question": "string",
          "options": [
            {
              "text": "string",
              "voter_count": 42
            }
          ],
          "total_voter_count": 42,
          "is_closed": true,
          "is_anonymous": true,
          "type": "string",
          "allows_multiple_answers": true,
          "correct_option_id": 42,
          "explanation": "string",
          "explanation_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "open_period": 42,
          "close_date": 42
        },
        "venue": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "title": "string",
          "address": "string",
          "foursquare_id": "string",
          "foursquare_type": "string",
          "google_place_id": "string",
          "google_place_type": "string"
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "new_chat_members": [
          {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          }
        ],
        "left_chat_member": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "new_chat_title": "string",
        "new_chat_photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "delete_chat_photo": true,
        "group_chat_created": true,
        "supergroup_chat_created": true,
        "channel_chat_created": true,
        "migrate_to_chat_id": 42,
        "migrate_from_chat_id": 42,
        "pinned_message": {},
        "invoice": {
          "title": "string",
          "description": "string",
          "start_parameter": "string",
          "currency": "string",
          "total_amount": 42
        },
        "successful_payment": {
          "currency": "string",
          "total_amount": 42,
          "invoice_payload": "string",
          "shipping_option_id": "string",
          "order_info": {
            "name": "string",
            "phone_number": "string",
            "email": "string",
            "shipping_address": {
              "country_code": "string",
              "state": "string",
              "city": "string",
              "street_line1": "string",
              "street_line2": "string",
              "post_code": "string"
            }
          },
          "telegram_payment_charge_id": "string",
          "provider_payment_charge_id": "string"
        },
        "connected_website": "string",
        "passport_data": {
          "data": [
            {
              "type": "personal_details",
              "data": "string",
              "phone_number": "string",
              "email": "string",
              "files": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "front_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "reverse_side": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "selfie": {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              },
              "translation": [
                {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                }
              ],
              "hash": "string"
            }
          ],
          "credentials": {
            "data": "string",
            "hash": "string",
            "secret": "string"
          }
        },
        "proximity_alert_triggered": {
          "traveler": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "watcher": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "distance": 42
        },
        "reply_markup": {
          "": [
            [
              {}
            ]
          ]
        }
      },
      "inline_query": {
        "id": "string",
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "query": "string",
        "offset": "string"
      },
      "chosen_inline_result": {
        "result_id": "string",
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "inline_message_id": "string",
        "query": "string"
      },
      "callback_query": {
        "id": "string",
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "message": {
          "message_id": 42,
          "from": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "sender_chat": {
            "id": 42,
            "type": "private",
            "title": "string",
            "username": "string",
            "first_name": "string",
            "last_name": "string",
            "photo": {
              "small_file_id": "string",
              "small_file_unique_id": "string",
              "big_file_id": "string",
              "big_file_unique_id": "string"
            },
            "bio": "string",
            "description": "string",
            "invite_link": "string",
            "pinned_message": {},
            "permissions": {
              "can_send_messages": true,
              "can_send_media_messages": true,
              "can_send_polls": true,
              "can_send_other_messages": true,
              "can_add_web_page_previews": true,
              "can_change_info": true,
              "can_invite_users": true,
              "can_pin_messages": true
            },
            "slow_mode_delay": 42,
            "sticker_set_name": "string",
            "can_set_sticker_set": true,
            "linked_chat_id": 42,
            "location": {
              "location": {
                "longitude": 42.0,
                "latitude": 42.0,
                "horizontal_accuracy": 42.0,
                "live_period": 42,
                "heading": 42,
                "proximity_alert_radius": 42
              },
              "address": "string"
            }
          },
          "date": 42,
          "chat": {
            "id": 42,
            "type": "private",
            "title": "string",
            "username": "string",
            "first_name": "string",
            "last_name": "string",
            "photo": {
              "small_file_id": "string",
              "small_file_unique_id": "string",
              "big_file_id": "string",
              "big_file_unique_id": "string"
            },
            "bio": "string",
            "description": "string",
            "invite_link": "string",
            "pinned_message": {},
            "permissions": {
              "can_send_messages": true,
              "can_send_media_messages": true,
              "can_send_polls": true,
              "can_send_other_messages": true,
              "can_add_web_page_previews": true,
              "can_change_info": true,
              "can_invite_users": true,
              "can_pin_messages": true
            },
            "slow_mode_delay": 42,
            "sticker_set_name": "string",
            "can_set_sticker_set": true,
            "linked_chat_id": 42,
            "location": {
              "location": {
                "longitude": 42.0,
                "latitude": 42.0,
                "horizontal_accuracy": 42.0,
                "live_period": 42,
                "heading": 42,
                "proximity_alert_radius": 42
              },
              "address": "string"
            }
          },
          "forward_from": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "forward_from_chat": {
            "id": 42,
            "type": "private",
            "title": "string",
            "username": "string",
            "first_name": "string",
            "last_name": "string",
            "photo": {
              "small_file_id": "string",
              "small_file_unique_id": "string",
              "big_file_id": "string",
              "big_file_unique_id": "string"
            },
            "bio": "string",
            "description": "string",
            "invite_link": "string",
            "pinned_message": {},
            "permissions": {
              "can_send_messages": true,
              "can_send_media_messages": true,
              "can_send_polls": true,
              "can_send_other_messages": true,
              "can_add_web_page_previews": true,
              "can_change_info": true,
              "can_invite_users": true,
              "can_pin_messages": true
            },
            "slow_mode_delay": 42,
            "sticker_set_name": "string",
            "can_set_sticker_set": true,
            "linked_chat_id": 42,
            "location": {
              "location": {
                "longitude": 42.0,
                "latitude": 42.0,
                "horizontal_accuracy": 42.0,
                "live_period": 42,
                "heading": 42,
                "proximity_alert_radius": 42
              },
              "address": "string"
            }
          },
          "forward_from_message_id": 42,
          "forward_signature": "string",
          "forward_sender_name": "string",
          "forward_date": 42,
          "reply_to_message": {},
          "via_bot": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "edit_date": 42,
          "media_group_id": "string",
          "author_signature": "string",
          "text": "string",
          "entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "animation": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          },
          "audio": {
            "file_id": "string",
            "file_unique_id": "string",
            "duration": 42,
            "performer": "string",
            "title": "string",
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          },
          "document": {
            "file_id": "string",
            "file_unique_id": "string",
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          },
          "photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "sticker": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "is_animated": true,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "emoji": "string",
            "set_name": "string",
            "mask_position": {
              "point": "forehead",
              "x_shift": 42.0,
              "y_shift": 42.0,
              "scale": 42.0
            },
            "file_size": 42
          },
          "video": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_name": "string",
            "mime_type": "string",
            "file_size": 42
          },
          "video_note": {
            "file_id": "string",
            "file_unique_id": "string",
            "length": 42,
            "duration": 42,
            "thumb": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            },
            "file_size": 42
          },
          "voice": {
            "file_id": "string",
            "file_unique_id": "string",
            "duration": 42,
            "mime_type": "string",
            "file_size": 42
          },
          "caption": "string",
          "caption_entities": [
            {
              "type": "mention",
              "offset": 42,
              "length": 42,
              "url": "string",
              "user": {
                "id": 42,
                "is_bot": true,
                "first_name": "string",
                "last_name": "string",
                "username": "string",
                "language_code": "string",
                "can_join_groups": true,
                "can_read_all_group_messages": true,
                "supports_inline_queries": true
              },
              "language": "string"
            }
          ],
          "contact": {
            "phone_number": "string",
            "first_name": "string",
            "last_name": "string",
            "user_id": 42,
            "vcard": "string"
          },
          "dice": {
            "emoji": "string",
            "value": 42
          },
          "game": {
            "title": "string",
            "description": "string",
            "photo": [
              {
                "file_id": "string",
                "file_unique_id": "string",
                "width": 42,
                "height": 42,
                "file_size": 42
              }
            ],
            "text": "string",
            "text_entities": [
              {
                "type": "mention",
                "offset": 42,
                "length": 42,
                "url": "string",
                "user": {
                  "id": 42,
                  "is_bot": true,
                  "first_name": "string",
                  "last_name": "string",
                  "username": "string",
                  "language_code": "string",
                  "can_join_groups": true,
                  "can_read_all_group_messages": true,
                  "supports_inline_queries": true
                },
                "language": "string"
              }
            ],
            "animation": {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "duration": 42,
              "thumb": {
                "file_id": "string",
                "file_unique_id": "string",
                "width": 42,
                "height": 42,
                "file_size": 42
              },
              "file_name": "string",
              "mime_type": "string",
              "file_size": 42
            }
          },
          "poll": {
            "id": "string",
            "question": "string",
            "options": [
              {
                "text": "string",
                "voter_count": 42
              }
            ],
            "total_voter_count": 42,
            "is_closed": true,
            "is_anonymous": true,
            "type": "string",
            "allows_multiple_answers": true,
            "correct_option_id": 42,
            "explanation": "string",
            "explanation_entities": [
              {
                "type": "mention",
                "offset": 42,
                "length": 42,
                "url": "string",
                "user": {
                  "id": 42,
                  "is_bot": true,
                  "first_name": "string",
                  "last_name": "string",
                  "username": "string",
                  "language_code": "string",
                  "can_join_groups": true,
                  "can_read_all_group_messages": true,
                  "supports_inline_queries": true
                },
                "language": "string"
              }
            ],
            "open_period": 42,
            "close_date": 42
          },
          "venue": {
            "location": {
              "longitude": 42.0,
              "latitude": 42.0,
              "horizontal_accuracy": 42.0,
              "live_period": 42,
              "heading": 42,
              "proximity_alert_radius": 42
            },
            "title": "string",
            "address": "string",
            "foursquare_id": "string",
            "foursquare_type": "string",
            "google_place_id": "string",
            "google_place_type": "string"
          },
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "new_chat_members": [
            {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            }
          ],
          "left_chat_member": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "new_chat_title": "string",
          "new_chat_photo": [
            {
              "file_id": "string",
              "file_unique_id": "string",
              "width": 42,
              "height": 42,
              "file_size": 42
            }
          ],
          "delete_chat_photo": true,
          "group_chat_created": true,
          "supergroup_chat_created": true,
          "channel_chat_created": true,
          "migrate_to_chat_id": 42,
          "migrate_from_chat_id": 42,
          "pinned_message": {},
          "invoice": {
            "title": "string",
            "description": "string",
            "start_parameter": "string",
            "currency": "string",
            "total_amount": 42
          },
          "successful_payment": {
            "currency": "string",
            "total_amount": 42,
            "invoice_payload": "string",
            "shipping_option_id": "string",
            "order_info": {
              "name": "string",
              "phone_number": "string",
              "email": "string",
              "shipping_address": {
                "country_code": "string",
                "state": "string",
                "city": "string",
                "street_line1": "string",
                "street_line2": "string",
                "post_code": "string"
              }
            },
            "telegram_payment_charge_id": "string",
            "provider_payment_charge_id": "string"
          },
          "connected_website": "string",
          "passport_data": {
            "data": [
              {
                "type": "personal_details",
                "data": "string",
                "phone_number": "string",
                "email": "string",
                "files": [
                  {
                    "file_id": "string",
                    "file_unique_id": "string",
                    "file_size": 42,
                    "file_date": 42
                  }
                ],
                "front_side": {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                },
                "reverse_side": {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                },
                "selfie": {
                  "file_id": "string",
                  "file_unique_id": "string",
                  "file_size": 42,
                  "file_date": 42
                },
                "translation": [
                  {
                    "file_id": "string",
                    "file_unique_id": "string",
                    "file_size": 42,
                    "file_date": 42
                  }
                ],
                "hash": "string"
              }
            ],
            "credentials": {
              "data": "string",
              "hash": "string",
              "secret": "string"
            }
          },
          "proximity_alert_triggered": {
            "traveler": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "watcher": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "distance": 42
          },
          "reply_markup": {
            "": [
              [
                {}
              ]
            ]
          }
        },
        "inline_message_id": "string",
        "chat_instance": "string",
        "data": "string",
        "game_short_name": "string"
      },
      "shipping_query": {
        "id": "string",
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "invoice_payload": "string",
        "shipping_address": {
          "country_code": "string",
          "state": "string",
          "city": "string",
          "street_line1": "string",
          "street_line2": "string",
          "post_code": "string"
        }
      },
      "pre_checkout_query": {
        "id": "string",
        "from": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "currency": "string",
        "total_amount": 42,
        "invoice_payload": "string",
        "shipping_option_id": "string",
        "order_info": {
          "name": "string",
          "phone_number": "string",
          "email": "string",
          "shipping_address": {
            "country_code": "string",
            "state": "string",
            "city": "string",
            "street_line1": "string",
            "street_line2": "string",
            "post_code": "string"
          }
        }
      },
      "poll": {
        "id": "string",
        "question": "string",
        "options": [
          {
            "text": "string",
            "voter_count": 42
          }
        ],
        "total_voter_count": 42,
        "is_closed": true,
        "is_anonymous": true,
        "type": "string",
        "allows_multiple_answers": true,
        "correct_option_id": 42,
        "explanation": "string",
        "explanation_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "open_period": 42,
        "close_date": 42
      },
      "poll_answer": {
        "poll_id": "string",
        "user": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "option_ids": [
          42
        ]
      }
    }
  ]
}