Use this method to send general files

POST /sendDocument

Use this method to send general files. On success, the sent Message is returned. Bots can currently send files of any type of up to 50 MB in size, this limit may be changed in the future.

Body Required

chat_id integer | string Required

Any of:
integer-1 integer string-2 string

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

Unique identifier for the target chat or username of the target channel (in the format @channelusername)
document string Required

Any of:
InputFile string-2 string

This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.

File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More info on Sending Files »
thumb string

Any of:
InputFile string-2 string

This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.

Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://” if the thumbnail was uploaded using multipart/form-data under . More info on Sending Files »
caption string

Document caption (may also be used when resending documents by file_id), 0-1024 characters after entities parsing
parse_mode string

Mode for parsing entities in the document caption. See formatting options for more details.
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
disable_content_type_detection boolean

Disables automatic server-side content type detection for files uploaded using multipart/form-data
disable_notification boolean

Sends the message silently. Users will receive a notification with no sound.
reply_to_message_id integer

If the message is a reply, ID of the original message
allow_sending_without_reply boolean

Pass True, if the message should be sent even if the specified replied-to message is not found
reply_markup object
Any of:
InlineKeyboardMarkup object ReplyKeyboardMarkup object ReplyKeyboardRemove object ForceReply object
This object represents an inline keyboard that appears right next to the message it belongs to.
Hide attribute Show attribute

Array of button rows, each represented by an Array of InlineKeyboardButton objects
This object represents a custom keyboard with reply options (see Introduction to bots for details and examples).
Hide attributes Show attributes

Array of button rows, each represented by an Array of KeyboardButton objects

resize_keyboard boolean

Optional. Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). Defaults to false, in which case the custom keyboard is always of the same height as the app's standard keyboard.

Default value is false.

one_time_keyboard boolean

Optional. Requests clients to hide the keyboard as soon as it's been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat – the user can press a special button in the input field to see the custom keyboard again. Defaults to false.

Default value is false.

selective boolean

Optional. Use this parameter if you want to show the keyboard to specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot's message is a reply (has reply_to_message_id), sender of the original message.

Example: A user requests to change the bot's language, bot replies to the request with a keyboard to select the new language. Other users in the group don't see the keyboard.
Upon receiving a message with this object, Telegram clients will remove the current custom keyboard and display the default letter-keyboard. By default, custom keyboards are displayed until a new keyboard is sent by a bot. An exception is made for one-time keyboards that are hidden immediately after the user presses a button (see ReplyKeyboardMarkup).
Hide attributes Show attributes

remove_keyboard boolean Required

Requests clients to remove the custom keyboard (user will not be able to summon this keyboard; if you want to hide the keyboard from sight but keep it accessible, use one_time_keyboard in ReplyKeyboardMarkup)

selective boolean

Optional. Use this parameter if you want to remove the keyboard for specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot's message is a reply (has reply_to_message_id), sender of the original message.

Example: A user votes in a poll, bot returns confirmation message in reply to the vote and removes the keyboard for that user, while still showing the keyboard with poll options to users who haven't voted yet.
Upon receiving a message with this object, Telegram clients will display a reply interface to the user (act as if the user has selected the bot's message and tapped 'Reply'). This can be extremely useful if you want to create user-friendly step-by-step interfaces without having to sacrifice privacy mode.
Hide attributes Show attributes

force_reply boolean Required

Shows reply interface to the user, as if they manually selected the bot's message and tapped 'Reply'

selective boolean

Optional. Use this parameter if you want to force reply from specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot's message is a reply (has reply_to_message_id), sender of the original message.

Responses

200
Hide response attributes Show response attributes object
- ok boolean Required
  
  Default value is true.
- result object Required
  
  This object represents a message.
  
  Hide result attributes Show result 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
  
  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
  
  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
  
  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
  
  Array of button rows, each represented by an Array of InlineKeyboardButton objects
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

POST /sendDocument

curl \
 -X POST https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/sendDocument \
 -H "Content-Type: multipart/form-data" \
 -F "chat_id=42" \
 -F "caption=string" \
 -F "parse_mode=string" \
 -F "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"}" \
 -F "disable_content_type_detection=true" \
 -F "disable_notification=true" \
 -F "reply_to_message_id=42" \
 -F "allow_sending_without_reply=true" \
 -F 'reply_markup={"":[[{}]]}'

Request example

{
  "chat_id": 42,
  "caption": "string",
  "parse_mode": "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"
    }
  ],
  "disable_content_type_detection": true,
  "disable_notification": true,
  "reply_to_message_id": 42,
  "allow_sending_without_reply": true,
  "reply_markup": {
    "": [
      [
        {}
      ]
    ]
  }
}

Request examples

{
  "chat_id": 42,
  "caption": "string",
  "parse_mode": "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"
    }
  ],
  "disable_content_type_detection": true,
  "disable_notification": true,
  "reply_to_message_id": 42,
  "allow_sending_without_reply": true,
  "reply_markup": {
    "": [
      [
        {}
      ]
    ]
  }
}

Response examples (200)

{
  "ok": true,
  "result": {
    "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": {
      "": [
        [
          {}
        ]
      ]
    }
  }
}

Response examples (200)

{
  "ok": true,
  "result": {
    "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": {
      "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"
        }
      },
      "currency": "string",
      "total_amount": 42,
      "invoice_payload": "string",
      "shipping_option_id": "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": {
      "": [
        [
          {}
        ]
      ]
    }
  }
}

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
  }
}

Use this method to send general files

Body Required

chat_id integer | string Required

document string Required

thumb string

reply_markup object

Responses