Expand description
Mappings of objects received from the API
Modules
Structs
- Represents a
ChatMember
who is an Admin of theChat
. - This object represents an animation file (GIF or H.264/MPEG-4 AVC video without sound).
- This object represents an audio file to be treated as music by the Telegram clients.
- A bot command
- This object represents the bot’s description.
- This object represents the bot’s name.
- This object represents the bot’s short description.
- A placeholder, currently holds no information.
- This object represents an incoming callback query from a callback button in an inline keyboard. If the button that originated the query was attached to a message sent by the bot, the field message will be present. If the button was attached to a message sent via the bot (in inline mode), the field
inline_message_id
will be present. Exactly one of the fields data orgame_short_name
will be present. - A Channel object
- Represents the rights of an administrator in a chat.
- Represents an invite link for a chat.
- Represents a join request sent to a chat.
- Represents a location to which a chat is connected.
- Represents changes in the status of a chat member.
- Describes actions that a non-administrator user is allowed to take in a chat.
- This object represents a chat photo.
- This object contains information about the user whose identifier was shared with the bot using a
KeyboardButtonRequestChat
button. - Represents a result of an inline query that was chosen by the user and sent to their chat partner.
- This object represents a phone contact.
- Represents a
ChatMember
who is the creator or owner of theChat
. - This object represents a dice with a random value from 1 to 6 for currently supported base emoji.
- Contains data required for decrypting and authenticating
EncryptedPassportElement
. See the Telegram Passport Documentation for a complete description of the data decryption and authentication processes. - Contains information about documents or other Telegram Passport elements shared with the bot by the user.
- This object represents a file ready to be downloaded. The file can be downloaded via the link
https://api.telegram.org/file/bot<token>/<file_path>
. It is guaranteed that the link will be valid for at least 1 hour. When the link expires, a new one can be requested by callingget_file
. - 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.
- This object represents a forum topic.
- This object represents a service message about a forum topic closed in the chat. Currently holds no information.
- This object represents a service message about a new forum topic created in the chat.
- This object represents a service message about an edited forum topic.
- This object represents a service message about a forum topic reopened in the chat. Currently holds no information.
- Holds information about the forwarded message
- This object represents a game. Use @BotFather to create and edit games, their short names will act as unique identifiers.
- This object represents one row of the high scores table for a game.
- This object represents a service message about General forum topic hidden in the chat. Currently holds no information.
- This object represents a service message about General forum topic unhidden in the chat. Currently holds no information.
- A Group chat object
- This object represents one button of an inline keyboard. You must use exactly one of the optional fields.
- This object represents an inline keyboard that appears right next to the message it belongs to.
- This object represents an incoming inline query. When the user sends an empty query, your bot could return some default or trending results.
- This object describes a sticker to be added to a sticker set.
- This object contains basic information about an invoice.
- This object represents one button of the reply keyboard. For simple text buttons String can be used instead of this object to specify text of the button.
- This object represents type of a poll, which is allowed to be created and sent when the corresponding button is pressed.
- This object defines the criteria used to request a suitable chat. The identifier of the selected chat will be shared with the bot when the corresponding button is pressed.
- This object defines the criteria used to request a suitable user. The identifier of the selected user will be shared with the bot when the corresponding button is pressed.
- Represents a
ChatMember
who has been kicked from theChat
. - This object represents a portion of the price for goods or services.
- Represents a
ChatMember
who left theChat
. - This object represents a point on the map.
- This object represents a parameter of the inline keyboard button used to automatically authorize a user. Serves as a great replacement for the Telegram Login Widget when the user is coming from Telegram. All the user needs to do is tap/click a button and confirm that they want to log in
- This object describes the position on faces where a mask should be placed by default.
- Represents a
ChatMember
who is a normal member of theChat
without any special powers. - This object represents a message.
- This object represents a service message about a change in auto-delete timer settings.
- This object represents a unique message identifier.
- This object represents information about an order.
- Contains information about Telegram Passport data shared with the bot by the user.
- 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.
- This object represents one size of a photo or a file / sticker thumbnail
- This object contains information about a poll.
- This object represents an answer of a user in a non-anonymous poll.
- This object contains information about one answer option in a poll.
- A monowidth code block
- This object contains information about an incoming pre-checkout query.
- A private chat object, also known as a DM, between the bot and an user
- This object represents the content of a service message, sent whenever a user in the chat triggers a proximity alert set by another user.
- This object represents a custom keyboard with reply options (see Introduction to bots for details and examples).
- 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
). - Represents a restricted
ChatMember
of aChat
. - Describes an inline message sent by a Web App on behalf of a user.
- This object represents a shipping address.
- This object represents one shipping option.
- This object contains information about an incoming shipping query.
- This object represents a sticker.
- This object represents a sticker set.
- This object represents a message about a forwarded story in the chat. Currently holds no information.
- This object contains basic information about a successful payment.
- A supergroup object (a group with more than 200 members)
- This object represents an inline button that switches the current user to inline mode in a chosen chat, with an optional default inline query.
- An object describing a part of a text
- A clickable text URL
- For users without usernames
- This object represents an incoming update
- This object represents a Telegram user or bot.
- This object represent a user’s profile pictures.
- This object contains information about the user whose identifier was shared with the bot using a
KeyboardButtonRequestUser
button. - This object represents a venue.
- This object represents a video file
- This object represents a service message about a voice chat ended in the chat.
- This object represents a service message about new members invited to a voice chat.
- This object represents a service message about a voice chat scheduled in the chat.
- This object represents a service message about a voice chat started in the chat. Currently holds no information.
- This object represents a video message
- This object represents a voice note
- Describes data sent from a Web App to the bot.
- Describes a Web App.
- Contains information about the current status of a webhook.
- This object represents a service message about a user allowing a bot added to the attachment menu to write messages. Currently holds no information.
Enums
- This object represents a chat. It can be a private, group, supergroup or channel chat
- An action indicating to a user what they are about to receive
- This object contains information about one member of a chat.
- The type of chat
- Can be a string or an integer. Often used for the id of a chat, as that can also be the username of a supergroup.
- The part of the face relative to which a mask should be placed
- This object describes the bot’s menu button in a private chat. If a menu button other than Default is set for a private chat, then it is applied in the chat. Otherwise the default menu button is applied. By default, the menu button opens the list of bot commands.
- The content of a
Message
- This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.
- The Bot API supports basic formatting for messages. You can use bold, italic, underlined and strikethrough text, as well as inline links and pre-formatted code in your bots’ messages. Telegram clients will render them accordingly. You can use either markdown-style or HTML-style formatting.
- The type of the
Poll
- Enum object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.
- The type of a telegram passport element
- The content of an
Update