Hide navigation sidebar
Hide table of contents sidebar
Skip to content
Back to top
View this page
Toggle table of contents sidebar

# telegram.constants Module

This module contains several constants that are relevant for working with the Bot API.

Unless noted otherwise, all constants in this module were extracted from the Telegram Bots FAQ and Telegram Bots API.

Most of the following constants are related to specific classes or topics and are grouped into enums. If they are related to a specific class, then they are also available as attributes of those classes.

Changed in version 20.0:

- Most of the constants in this module are grouped into enums.

class telegram.constants.AccentColor(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `Enum`

  This enum contains the available accent colors for `telegram.ChatFullInfo.accent_color_id`. The members of this enum are named tuples with the following attributes:

  - `identifier` (`int`): The identifier of the accent color.

  - `name` (`str`): Optional. The name of the accent color.

  - `light_colors` (tuple[`str`]): Optional. The light colors of the accent color as HEX value.

  - `dark_colors` (tuple[`str`]): Optional. The dark colors of the accent color as HEX value.

  Since Telegram gives no exact specification for the accent colors, future accent colors might have a different data type.

  Added in version 20.8.

  COLOR_000 = (0, 'red', (), ())

    Accent color 0. This color can be customized by app themes.

  COLOR_001 = (1, 'orange', (), ())

    Accent color 1. This color can be customized by app themes.

  COLOR_002 = (2, 'purple/violet', (), ())

    Accent color 2. This color can be customized by app themes.

  COLOR_003 = (3, 'green', (), ())

    Accent color 3. This color can be customized by app themes.

  COLOR_004 = (4, 'cyan', (), ())

    Accent color 4. This color can be customized by app themes.

  COLOR_005 = (5, 'blue', (), ())

    Accent color 5. This color can be customized by app themes.

  COLOR_006 = (6, 'pink', (), ())

    Accent color 6. This color can be customized by app themes.

  COLOR_007 = (7, None, (14766162, 16363107), (16749440, 10039095))

    Accent color 7. This contains two light colors

    and two dark colors

  COLOR_008 = (8, None, (14712875, 16434484), (15511630, 12801812))

    Accent color 8. This contains two light colors

    and two dark colors

  COLOR_009 = (9, None, (10510323, 16027647), (13015039, 6173128))

    Accent color 9. This contains two light colors

    and two dark colors

  COLOR_010 = (10, None, (2599184, 11000919), (11004782, 1474093))

    Accent color 10. This contains two light colors

    and two dark colors

  COLOR_011 = (11, None, (2600142, 8579286), (4249808, 285823))

    Accent color 11. This contains two light colors

    and two dark colors

  COLOR_012 = (12, None, (3379668, 8246256), (5423103, 742548))

    Accent color 12. This contains two light colors

    and two dark colors

  COLOR_013 = (13, None, (14500721, 16760479), (16746150, 9320046))

    Accent color 13. This contains two light colors

    and two dark colors

  COLOR_014 = (14, None, (2391021, 15747158, 16777215), (4170494, 15024719, 16777215))

    Accent color 14. This contains three light colors

    and three dark colors

  COLOR_015 = (15, None, (14055202, 2007057, 16777215), (16748638, 3319079, 16777215))

    Accent color 15. This contains three light colors

    and three dark colors

  COLOR_016 = (16, None, (1547842, 15223359, 16777215), (6738788, 13976655, 16777215))

    Accent color 16. This contains three light colors

    and three dark colors

  COLOR_017 = (17, None, (2659503, 7324758, 16777215), (2276578, 4039232, 16777215))

    Accent color 17. This contains three light colors

    and three dark colors

  COLOR_018 = (18, None, (826035, 16756117, 16770741), (2276578, 16750456, 16767595))

    Accent color 18. This contains three light colors

    and three dark colors

  COLOR_019 = (19, None, (7821270, 16225808, 16768654), (9933311, 15889181, 16767833))

    Accent color 19. This contains three light colors

    and three dark colors

  COLOR_020 = (20, None, (1410511, 15903517, 16777215), (4040427, 15639837, 16777215))

    Accent color 20. This contains three light colors

    and three dark colors

telegram.constants.BOT_API_VERSION = '8.2'

  Telegram Bot API version supported by this version of python-telegram-bot. Also available as `telegram.__bot_api_version__`.

  Added in version 13.4.

  Type:

    `str`

telegram.constants.BOT_API_VERSION_INFO = (8, 2)

  The components can also be accessed by name, so `BOT_API_VERSION_INFO[0]` is equivalent to `BOT_API_VERSION_INFO.major` and so on. Also available as `telegram.__bot_api_version_info__`.

  Added in version 20.0.

class telegram.constants.BackgroundFillLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.BackgroundFillGradient`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 21.2.

  MAX_ROTATION_ANGLE = 359

    Maximum value allowed for: `rotation_angle` parameter of `telegram.BackgroundFillGradient`

    Type:

      `int`

class telegram.constants.BackgroundFillType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.BackgroundFill`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 21.2.

  FREEFORM_GRADIENT = 'freeform_gradient'

    A `telegram.BackgroundFill` with freeform_gradient fill.

    Type:

      `str`

  GRADIENT = 'gradient'

    A `telegram.BackgroundFill` with gradient fill.

    Type:

      `str`

  SOLID = 'solid'

    A `telegram.BackgroundFill` with solid fill.

    Type:

      `str`

class telegram.constants.BackgroundTypeLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.BackgroundTypeFill`, `telegram.BackgroundTypeWallpaper` and `telegram.BackgroundTypePattern`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 21.2.

  MAX_DIMMING = 100

    Maximum value allowed for:

    - `dark_theme_dimming` parameter of

        `telegram.BackgroundTypeFill`

    - `dark_theme_dimming` parameter of

        `telegram.BackgroundTypeWallpaper`

    Type:

      `int`

  MAX_INTENSITY = 100

    Maximum value allowed for `intensity` parameter of `telegram.BackgroundTypePattern`

    Type:

      `int`

class telegram.constants.BackgroundTypeType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.BackgroundType`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 21.2.

  CHAT_THEME = 'chat_theme'

    A `telegram.BackgroundType` with chat_theme background.

    Type:

      `str`

  FILL = 'fill'

    A `telegram.BackgroundType` with fill background.

    Type:

      `str`

  PATTERN = 'pattern'

    A `telegram.BackgroundType` with pattern background.

    Type:

      `str`

  WALLPAPER = 'wallpaper'

    A `telegram.BackgroundType` with wallpaper background.

    Type:

      `str`

class telegram.constants.BotCommandLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.BotCommand` and `telegram.Bot.set_my_commands()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_COMMAND = 32

    Maximum value allowed for `command` parameter of `telegram.BotCommand`.

    Type:

      `int`

  MAX_COMMAND_NUMBER = 100

    Maximum number of bot commands passed in a `list` to the `commands` parameter of `telegram.Bot.set_my_commands()`.

    Type:

      `int`

  MAX_DESCRIPTION = 256

    Maximum value allowed for `description` parameter of `telegram.BotCommand`.

    Type:

      `int`

  MIN_COMMAND = 1

    Minimum value allowed for `command` parameter of `telegram.BotCommand`.

    Type:

      `int`

  MIN_DESCRIPTION = 1

    Minimum value allowed for `description` parameter of `telegram.BotCommand`.

    Type:

      `int`

class telegram.constants.BotCommandScopeType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.BotCommandScope`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  ALL_CHAT_ADMINISTRATORS = 'all_chat_administrators'

    The type of `telegram.BotCommandScopeAllChatAdministrators`.

    Type:

      `str`

  ALL_GROUP_CHATS = 'all_group_chats'

    The type of `telegram.BotCommandScopeAllGroupChats`.

    Type:

      `str`

  ALL_PRIVATE_CHATS = 'all_private_chats'

    The type of `telegram.BotCommandScopeAllPrivateChats`.

    Type:

      `str`

  CHAT = 'chat'

    The type of `telegram.BotCommandScopeChat`.

    Type:

      `str`

  CHAT_ADMINISTRATORS = 'chat_administrators'

    The type of `telegram.BotCommandScopeChatAdministrators`.

    Type:

      `str`

  CHAT_MEMBER = 'chat_member'

    The type of `telegram.BotCommandScopeChatMember`.

    Type:

      `str`

  DEFAULT = 'default'

    The type of `telegram.BotCommandScopeDefault`.

    Type:

      `str`

class telegram.constants.BotDescriptionLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for the methods `telegram.Bot.set_my_description()` and `telegram.Bot.set_my_short_description()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.2.

  MAX_DESCRIPTION_LENGTH = 512

    Maximum length for the parameter `description` of `telegram.Bot.set_my_description()`

    Type:

      `int`

  MAX_SHORT_DESCRIPTION_LENGTH = 120

    Maximum length for the parameter `short_description` of `telegram.Bot.set_my_short_description()`

    Type:

      `int`

class telegram.constants.BotNameLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for the methods `telegram.Bot.set_my_name()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.3.

  MAX_NAME_LENGTH = 64

    Maximum length for the parameter `name` of `telegram.Bot.set_my_name()`

    Type:

      `int`

class telegram.constants.BulkRequestLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Bot.delete_messages()`, `telegram.Bot.forward_messages()` and `telegram.Bot.copy_messages()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.8.

  MAX_LIMIT = 100

    Maximum number of messages required for bulk actions.

    Type:

      `int`

  MIN_LIMIT = 1

    Minimum number of messages required for bulk actions.

    Type:

      `int`

class telegram.constants.CallbackQueryLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.CallbackQuery`/ `telegram.Bot.answer_callback_query()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  ANSWER_CALLBACK_QUERY_TEXT_LENGTH = 200

    Maximum number of characters in a `str` passed as the `text` parameter of `telegram.Bot.answer_callback_query()`.

    Type:

      `int`

class telegram.constants.ChatAction(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available chat actions for `telegram.Bot.send_chat_action()`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  CHOOSE_STICKER = 'choose_sticker'

    Chat action indicating that the bot is selecting a sticker.

    Type:

      `str`

  FIND_LOCATION = 'find_location'

    Chat action indicating that the bot is selecting a location.

    Type:

      `str`

  RECORD_VIDEO = 'record_video'

    Chat action indicating that the bot is recording a video.

    Type:

      `str`

  RECORD_VIDEO_NOTE = 'record_video_note'

    Chat action indicating that the bot is recording a video note.

    Type:

      `str`

  RECORD_VOICE = 'record_voice'

    Chat action indicating that the bot is recording a voice message.

    Type:

      `str`

  TYPING = 'typing'

    A chat indicating the bot is typing.

    Type:

      `str`

  UPLOAD_DOCUMENT = 'upload_document'

    Chat action indicating that the bot is uploading a document.

    Type:

      `str`

  UPLOAD_PHOTO = 'upload_photo'

    Chat action indicating that the bot is uploading a photo.

    Type:

      `str`

  UPLOAD_VIDEO = 'upload_video'

    Chat action indicating that the bot is uploading a video.

    Type:

      `str`

  UPLOAD_VIDEO_NOTE = 'upload_video_note'

    Chat action indicating that the bot is uploading a video note.

    Type:

      `str`

  UPLOAD_VOICE = 'upload_voice'

    Chat action indicating that the bot is uploading a voice message.

    Type:

      `str`

class telegram.constants.ChatBoostSources(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available sources for a `Telegram chat boost`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.8.

  GIFT_CODE = 'gift_code'

    The source of the chat boost was a Telegram Premium gift code.

    Type:

      `str`

  GIVEAWAY = 'giveaway'

    The source of the chat boost was a Telegram Premium giveaway.

    Type:

      `str`

  PREMIUM = 'premium'

    The source of the chat boost was a Telegram Premium subscription/gift.

    Type:

      `str`

class telegram.constants.ChatID(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains some special chat IDs. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  ANONYMOUS_ADMIN = 1087968824

    User ID in groups for messages sent by anonymous admins. Telegram chat: @GroupAnonymousBot.

    Note

    `telegram.Message.from_user` will contain this ID for backwards compatibility only. It’s recommended to use `telegram.Message.sender_chat` instead.

    Type:

      `int`

  FAKE_CHANNEL = 136817688

    User ID in groups when message is sent on behalf of a channel, or when a channel votes on a poll. Telegram chat: @Channel_Bot.

    Note

    - `telegram.Message.from_user` will contain this ID for backwards compatibility only. It’s recommended to use `telegram.Message.sender_chat` instead.

    - `telegram.PollAnswer.user` will contain this ID for backwards compatibility only. It’s recommended to use `telegram.PollAnswer.voter_chat` instead.

    Type:

      `int`

  SERVICE_CHAT = 777000

    Telegram service chat, that also acts as sender of channel posts forwarded to discussion groups. Telegram chat: Telegram.

    Note

    `telegram.Message.from_user` will contain this ID for backwards compatibility only. It’s recommended to use `telegram.Message.sender_chat` instead.

    Type:

      `int`

class telegram.constants.ChatInviteLinkLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.ChatInviteLink`/ `telegram.Bot.create_chat_invite_link()`/`telegram.Bot.edit_chat_invite_link()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_MEMBER_LIMIT = 99999

    Maximum value allowed for the `member_limit` parameter of `telegram.Bot.create_chat_invite_link()` and `member_limit` of `telegram.Bot.edit_chat_invite_link()`.

    Type:

      `int`

  MIN_MEMBER_LIMIT = 1

    Minimum value allowed for the `member_limit` parameter of `telegram.Bot.create_chat_invite_link()` and `member_limit` of `telegram.Bot.edit_chat_invite_link()`.

    Type:

      `int`

  NAME_LENGTH = 32

    Maximum number of characters in a `str` passed as the `name` parameter of `telegram.Bot.create_chat_invite_link()` and `name` of `telegram.Bot.edit_chat_invite_link()`.

    Type:

      `int`

class telegram.constants.ChatLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Bot.set_chat_administrator_custom_title()`, `telegram.Bot.set_chat_description()`, and `telegram.Bot.set_chat_title()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  CHAT_ADMINISTRATOR_CUSTOM_TITLE_LENGTH = 16

    Maximum length of a `str` passed as the `custom_title` parameter of `telegram.Bot.set_chat_administrator_custom_title()`.

    Type:

      `int`

  CHAT_DESCRIPTION_LENGTH = 255

    Maximum number of characters in a `str` passed as the `description` parameter of `telegram.Bot.set_chat_description()`.

    Type:

      `int`

  MAX_CHAT_TITLE_LENGTH = 128

    Maximum length of a `str` passed as the `title` parameter of `telegram.Bot.set_chat_title()`.

    Type:

      `int`

  MIN_CHAT_TITLE_LENGTH = 1

    Minimum length of a `str` passed as the `title` parameter of `telegram.Bot.set_chat_title()`.

    Type:

      `int`

class telegram.constants.ChatMemberStatus(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available states for `telegram.ChatMember`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  ADMINISTRATOR = 'administrator'

    A `telegram.ChatMember` who is administrator of the chat.

    Type:

      `str`

  BANNED = 'kicked'

    A `telegram.ChatMember` who was banned in the chat.

    Type:

      `str`

  LEFT = 'left'

    A `telegram.ChatMember` who has left the chat.

    Type:

      `str`

  MEMBER = 'member'

    A `telegram.ChatMember` who is a member of the chat.

    Type:

      `str`

  OWNER = 'creator'

    A `telegram.ChatMember` who is the owner of the chat.

    Type:

      `str`

  RESTRICTED = 'restricted'

    A `telegram.ChatMember` who was restricted in this chat.

    Type:

      `str`

class telegram.constants.ChatPhotoSize(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.ChatPhoto`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  BIG = 640

    Width and height of a big chat photo, ID of which is passed in `big_file_id` and `big_file_unique_id` parameters of `telegram.ChatPhoto`.

    Type:

      `int`

  SMALL = 160

    Width and height of a small chat photo, ID of which is passed in `small_file_id` and `small_file_unique_id` parameters of `telegram.ChatPhoto`.

    Type:

      `int`

class telegram.constants.ChatSubscriptionLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Bot.create_chat_subscription_invite_link.subscription_period` and `telegram.Bot.create_chat_subscription_invite_link.subscription_price`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 21.5.

  MAX_PRICE = 2500

    Amount of stars a user pays, maximum amount the subscription can be set to.

    Type:

      `int`

  MIN_PRICE = 1

    Amount of stars a user pays, minimum amount the subscription can be set to.

    Type:

      `int`

  SUBSCRIPTION_PERIOD = 2592000

    The number of seconds the subscription will be active.

    Type:

      `int`

class telegram.constants.ChatType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.Chat`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  CHANNEL = 'channel'

    A `telegram.Chat` that is a channel.

    Type:

      `str`

  GROUP = 'group'

    A `telegram.Chat` that is a group.

    Type:

      `str`

  PRIVATE = 'private'

    A `telegram.Chat` that is private.

    Type:

      `str`

  SENDER = 'sender'

    A `telegram.Chat` that represents the chat of a `telegram.User` sending an `telegram.InlineQuery`.

    Type:

      `str`

  SUPERGROUP = 'supergroup'

    A `telegram.Chat` that is a supergroup.

    Type:

      `str`

class telegram.constants.ContactLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.InlineQueryResultContact`, `telegram.InputContactMessageContent`, and `telegram.Bot.send_contact()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  VCARD = 2048

    Maximum value allowed for:

    - `vcard` parameter of `send_contact()`

    - `vcard` parameter of `InlineQueryResultContact`

    - `vcard` parameter of `InputContactMessageContent`

    Type:

      `int`

class telegram.constants.CustomEmojiStickerLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Bot.get_custom_emoji_stickers()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  CUSTOM_EMOJI_IDENTIFIER_LIMIT = 200

    Maximum amount of custom emoji identifiers which can be specified for the `custom_emoji_ids` parameter of `telegram.Bot.get_custom_emoji_stickers()`.

    Type:

      `int`

class telegram.constants.DiceEmoji(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available emoji for `telegram.Dice`/ `telegram.Bot.send_dice()`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  BASKETBALL = '🏀'

    A `telegram.Dice` with the emoji `🏀`.

    Type:

      `str`

  BOWLING = '🎳'

    A `telegram.Dice` with the emoji `🎳`.

    Type:

      `str`

  DARTS = '🎯'

    A `telegram.Dice` with the emoji `🎯`.

    Type:

      `str`

  DICE = '🎲'

    A `telegram.Dice` with the emoji `🎲`.

    Type:

      `str`

  FOOTBALL = '⚽'

    A `telegram.Dice` with the emoji `⚽`.

    Type:

      `str`

  SLOT_MACHINE = '🎰'

    A `telegram.Dice` with the emoji `🎰`.

    Type:

      `str`

class telegram.constants.DiceLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Dice`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_VALUE_BASKETBALL = 5

    Maximum value allowed for `value` parameter of `telegram.Dice` if `emoji` is `'🏀'`.

    Type:

      `int`

  MAX_VALUE_BOWLING = 6

    Maximum value allowed for `value` parameter of `telegram.Dice` if `emoji` is `'🎳'`.

    Type:

      `int`

  MAX_VALUE_DARTS = 6

    Maximum value allowed for `value` parameter of `telegram.Dice` if `emoji` is `'🎯'`.

    Type:

      `int`

  MAX_VALUE_DICE = 6

    Maximum value allowed for `value` parameter of `telegram.Dice` if `emoji` is `'🎲'`.

    Type:

      `int`

  MAX_VALUE_FOOTBALL = 5

    Maximum value allowed for `value` parameter of `telegram.Dice` if `emoji` is `'⚽'`.

    Type:

      `int`

  MAX_VALUE_SLOT_MACHINE = 64

    Maximum value allowed for `value` parameter of `telegram.Dice` if `emoji` is `'🎰'`.

    Type:

      `int`

  MIN_VALUE = 1

    Minimum value allowed for `value` parameter of `telegram.Dice` (any emoji).

    Type:

      `int`

class telegram.constants.FileSizeLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations regarding the upload and download of files. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  FILESIZE_DOWNLOAD = 20000000

    Bots can download files of up to 20MB in size.

    Type:

      `int`

  FILESIZE_DOWNLOAD_LOCAL_MODE = 9223372036854775807

    Bots can download files without a size limit when using a local bot API server.

    Type:

      `int`

  FILESIZE_UPLOAD = 50000000

    Bots can upload non-photo files of up to 50MB in size.

    Type:

      `int`

  FILESIZE_UPLOAD_LOCAL_MODE = 2000000000

    Bots can upload non-photo files of up to 2000MB in size when using a local bot API server.

    Type:

      `int`

  PHOTOSIZE_UPLOAD = 10000000

    Bots can upload photo files of up to 10MB in size.

    Type:

      `int`

  VOICE_NOTE_FILE_SIZE = 1000000

    File size limit for the `send_voice()` method of `telegram.Bot`. Bots can send audio/ogg files of up to 1MB in size as a voice note. Larger voice notes (up to 20MB) will be sent as files.

    Type:

      `int`

class telegram.constants.FloodLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations regarding flood limits. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MESSAGES_PER_MINUTE_PER_GROUP = 20

    The number of messages that can roughly be sent to a particular group within one minute.

    Type:

      `int`

  MESSAGES_PER_SECOND = 30

    The number of messages that can roughly be sent in an interval of 30 seconds across all chats.

    Type:

      `int`

  MESSAGES_PER_SECOND_PER_CHAT = 1

    The number of messages that can be sent per second in a particular chat. Telegram may allow short bursts that go over this limit, but eventually you’ll begin receiving 429 errors.

    Type:

      `int`

  PAID_MESSAGES_PER_SECOND = 1000

    The number of messages that can be sent per second when paying with the bot’s Telegram Star balance. See e.g. parameter `allow_paid_broadcast` of `send_message()`.

    Added in version 21.7.

    Type:

      `int`

class telegram.constants.ForumIconColor(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains the available colors for use in `telegram.Bot.create_forum_topic.icon_color`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  BLUE = 7322096

    An icon with a color which corresponds to blue (`0x6FB9F0`).

    Type:

      `int`

  GREEN = 9367192

    An icon with a color which corresponds to green (`0x8EEE98`).

    Type:

      `int`

  PINK = 16749490

    An icon with a color which corresponds to pink (`0xFF93B2`).

    Type:

      `int`

  PURPLE = 13338331

    An icon with a color which corresponds to purple (`0xCB86DB`).

    Type:

      `int`

  RED = 16478047

    An icon with a color which corresponds to red (`0xFB6F5F`).

    Type:

      `int`

  YELLOW = 16766590

    An icon with a color which corresponds to yellow (`0xFFD67E`).

    Type:

      `int`

class telegram.constants.ForumTopicLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Bot.create_forum_topic.name` and `telegram.Bot.edit_forum_topic.name`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_NAME_LENGTH = 128

    Maximum length of a `str` passed as:

    - `name` parameter of `telegram.Bot.create_forum_topic()`

    - `name` parameter of `telegram.Bot.edit_forum_topic()`

    - `name` parameter of `telegram.Bot.edit_general_forum_topic()`

    Type:

      `int`

  MIN_NAME_LENGTH = 1

    Minimum length of a `str` passed as:

    - `name` parameter of `telegram.Bot.create_forum_topic()`

    - `name` parameter of `telegram.Bot.edit_forum_topic()`

    - `name` parameter of `telegram.Bot.edit_general_forum_topic()`

    Type:

      `int`

class telegram.constants.GiftLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `send_gift()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 21.8.

  MAX_TEXT_LENGTH = 255

    Maximum number of characters in a `str` passed as the `text` parameter of `send_gift()`.

    Type:

      `int`

class telegram.constants.GiveawayLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Giveaway` and related classes. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.8.

  MAX_WINNERS = 100

    Maximum number of winners allowed for `telegram.GiveawayWinners.winners`.

    Type:

      `int`

class telegram.constants.InlineKeyboardButtonLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.InlineKeyboardButton`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_CALLBACK_DATA = 64

    Maximum length allowed for `callback_data` parameter of `telegram.InlineKeyboardButton`

    Type:

      `int`

  MAX_COPY_TEXT = 256

    Maximum length allowed for `text` parameter of `telegram.CopyTextButton`

    Type:

      `int`

  MIN_CALLBACK_DATA = 1

    Minimum length allowed for `callback_data` parameter of `telegram.InlineKeyboardButton`

    Type:

      `int`

  MIN_COPY_TEXT = 1

    Minimum length allowed for `text` parameter of `telegram.CopyTextButton`

    Type:

      `int`

class telegram.constants.InlineKeyboardMarkupLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.InlineKeyboardMarkup`/ `telegram.Bot.send_message()` & friends. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  BUTTONS_PER_ROW = 8

    Maximum number of buttons that can be attached to a message per row.

    Note

    This value is undocumented and might be changed by Telegram.

    Type:

      `int`

  TOTAL_BUTTON_NUMBER = 100

    Maximum number of buttons that can be attached to a message.

    Note

    This value is undocumented and might be changed by Telegram.

    Type:

      `int`

class telegram.constants.InlineQueryLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.InlineQuery`/ `telegram.Bot.answer_inline_query()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_OFFSET_LENGTH = 64

    Maximum number of bytes in a `str` passed as the `next_offset` parameter of `telegram.Bot.answer_inline_query()`.

    Type:

      `int`

  MAX_QUERY_LENGTH = 256

    Maximum number of characters in a `str` passed as the `query` parameter of `telegram.InlineQuery`.

    Type:

      `int`

  MAX_SWITCH_PM_TEXT_LENGTH = 64

    Maximum number of characters in a `str` passed as the `switch_pm_parameter` parameter of `telegram.Bot.answer_inline_query()`.

    Deprecated since version 20.3: Deprecated in favor of `InlineQueryResultsButtonLimit.MAX_START_PARAMETER_LENGTH`.

    Type:

      `int`

  MIN_SWITCH_PM_TEXT_LENGTH = 1

    Minimum number of characters in a `str` passed as the `switch_pm_parameter` parameter of `telegram.Bot.answer_inline_query()`.

    Deprecated since version 20.3: Deprecated in favor of `InlineQueryResultsButtonLimit.MIN_START_PARAMETER_LENGTH`.

    Type:

      `int`

  RESULTS = 50

    Maximum number of results that can be passed to `telegram.Bot.answer_inline_query()`.

    Type:

      `int`

class telegram.constants.InlineQueryResultLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.InlineQueryResult` and its subclasses. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_ID_LENGTH = 64

    Maximum number of bytes in a `str` passed as the `id` parameter of `telegram.InlineQueryResult` and its subclasses

    Type:

      `int`

  MIN_ID_LENGTH = 1

    Minimum number of bytes in a `str` passed as the `id` parameter of `telegram.InlineQueryResult` and its subclasses

    Type:

      `int`

class telegram.constants.InlineQueryResultType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.InlineQueryResult`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  ARTICLE = 'article'

    Type of `telegram.InlineQueryResultArticle`.

    Type:

      `str`

  AUDIO = 'audio'

    Type of `telegram.InlineQueryResultAudio` and `telegram.InlineQueryResultCachedAudio`.

    Type:

      `str`

  CONTACT = 'contact'

    Type of `telegram.InlineQueryResultContact`.

    Type:

      `str`

  DOCUMENT = 'document'

    Type of `telegram.InlineQueryResultDocument` and `telegram.InlineQueryResultCachedDocument`.

    Type:

      `str`

  GAME = 'game'

    Type of `telegram.InlineQueryResultGame`.

    Type:

      `str`

  GIF = 'gif'

    Type of `telegram.InlineQueryResultGif` and `telegram.InlineQueryResultCachedGif`.

    Type:

      `str`

  LOCATION = 'location'

    Type of `telegram.InlineQueryResultLocation`.

    Type:

      `str`

  MPEG4GIF = 'mpeg4_gif'

    Type of `telegram.InlineQueryResultMpeg4Gif` and `telegram.InlineQueryResultCachedMpeg4Gif`.

    Type:

      `str`

  PHOTO = 'photo'

    Type of `telegram.InlineQueryResultPhoto` and `telegram.InlineQueryResultCachedPhoto`.

    Type:

      `str`

  STICKER = 'sticker'

    Type of and `telegram.InlineQueryResultCachedSticker`.

    Type:

      `str`

  VENUE = 'venue'

    Type of `telegram.InlineQueryResultVenue`.

    Type:

      `str`

  VIDEO = 'video'

    Type of `telegram.InlineQueryResultVideo` and `telegram.InlineQueryResultCachedVideo`.

    Type:

      `str`

  VOICE = 'voice'

    Type of `telegram.InlineQueryResultVoice` and `telegram.InlineQueryResultCachedVoice`.

    Type:

      `str`

class telegram.constants.InlineQueryResultsButtonLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.InlineQueryResultsButton`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.3.

  MAX_START_PARAMETER_LENGTH = 64

    Maximum number of characters in a `str` passed as the `start_parameter` parameter of `telegram.InlineQueryResultsButton()`.

    Type:

      `int`

  MIN_START_PARAMETER_LENGTH = 1

    Minimum number of characters in a `str` passed as the `start_parameter` parameter of `telegram.InlineQueryResultsButton()`.

    Type:

      `int`

class telegram.constants.InputMediaType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.InputMedia`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  ANIMATION = 'animation'

    Type of `telegram.InputMediaAnimation`.

    Type:

      `str`

  AUDIO = 'audio'

    Type of `telegram.InputMediaAudio`.

    Type:

      `str`

  DOCUMENT = 'document'

    Type of `telegram.InputMediaDocument`.

    Type:

      `str`

  PHOTO = 'photo'

    Type of `telegram.InputMediaPhoto`.

    Type:

      `str`

  VIDEO = 'video'

    Type of `telegram.InputMediaVideo`.

    Type:

      `str`

class telegram.constants.InputPaidMediaType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.InputPaidMedia`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 21.4.

  PHOTO = 'photo'

    Type of `telegram.InputMediaPhoto`.

    Type:

      `str`

  VIDEO = 'video'

    Type of `telegram.InputMediaVideo`.

    Type:

      `str`

class telegram.constants.InvoiceLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.InputInvoiceMessageContent`, `telegram.Bot.send_invoice()`, and `telegram.Bot.create_invoice_link()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_DESCRIPTION_LENGTH = 255

    Maximum number of characters in a `str` passed as:

    - `description` parameter of `telegram.InputInvoiceMessageContent`

    - `description` parameter of `telegram.Bot.send_invoice()`.

    - `description` parameter of `telegram.Bot.create_invoice_link()`.

    Type:

      `int`

  MAX_PAYLOAD_LENGTH = 128

    Maximum amount of bytes in a `str` passed as:

    - `payload` parameter of `telegram.InputInvoiceMessageContent`

    - `payload` parameter of `telegram.Bot.send_invoice()`.

    - `payload` parameter of `telegram.Bot.create_invoice_link()`.

    - `payload` parameter of `telegram.Bot.send_paid_media()`.

    Type:

      `int`

  MAX_STAR_COUNT = 2500

    Maximum amount of starts that must be paid to buy access to a paid media passed as `star_count` parameter of `telegram.Bot.send_paid_media()`.

    Added in version 21.6.

    Type:

      `int`

  MAX_TIP_AMOUNTS = 4

    Maximum length of a `Sequence` passed as:

    - `suggested_tip_amounts` parameter of `telegram.Bot.send_invoice()`.

    - `suggested_tip_amounts` parameter of `telegram.Bot.create_invoice_link()`.

    Type:

      `int`

  MAX_TITLE_LENGTH = 32

    Maximum number of characters in a `str` passed as:

    - `title` parameter of `telegram.InputInvoiceMessageContent`

    - `title` parameter of `telegram.Bot.send_invoice()`.

    - `title` parameter of `telegram.Bot.create_invoice_link()`.

    Type:

      `int`

  MIN_DESCRIPTION_LENGTH = 1

    Minimum number of characters in a `str` passed as:

    - `description` parameter of `telegram.InputInvoiceMessageContent`

    - `description` parameter of `telegram.Bot.send_invoice()`.

    - `description` parameter of `telegram.Bot.create_invoice_link()`.

    Type:

      `int`

  MIN_PAYLOAD_LENGTH = 1

    Minimum amount of bytes in a `str` passed as:

    - `payload` parameter of `telegram.InputInvoiceMessageContent`

    - `payload` parameter of `telegram.Bot.send_invoice()`.

    - `payload` parameter of `telegram.Bot.create_invoice_link()`.

    Type:

      `int`

  MIN_STAR_COUNT = 1

    Minimum amount of starts that must be paid to buy access to a paid media passed as `star_count` parameter of `telegram.Bot.send_paid_media()`.

    Added in version 21.6.

    Type:

      `int`

  MIN_TITLE_LENGTH = 1

    Minimum number of characters in a `str` passed as:

    - `title` parameter of `telegram.InputInvoiceMessageContent`

    - `title` parameter of `telegram.Bot.send_invoice()`.

    - `title` parameter of `telegram.Bot.create_invoice_link()`.

    Type:

      `int`

  SUBSCRIPTION_MAX_PRICE = 2500

    The maximum price of a subscription created wtih `telegram.Bot.create_invoice_link()`.

    Added in version 21.9.

    Type:

      `int`

  SUBSCRIPTION_PERIOD = 2592000

    The period of time for which the subscription is active before the next payment, passed as `subscription_period` parameter of `telegram.Bot.create_invoice_link()`.

    Added in version 21.8.

    Type:

      `int`

class telegram.constants.KeyboardButtonRequestUsersLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.KeyboardButtonRequestUsers`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.8.

  MAX_QUANTITY = 10

    Maximum value allowed for `max_quantity` parameter of `telegram.KeyboardButtonRequestUsers`.

    Type:

      `int`

  MIN_QUANTITY = 1

    Minimum value allowed for `max_quantity` parameter of `telegram.KeyboardButtonRequestUsers`.

    Type:

      `int`

class telegram.constants.LocationLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Location`/`telegram.ChatLocation`/ `telegram.Bot.edit_message_live_location()`/`telegram.Bot.send_location()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  HORIZONTAL_ACCURACY = 1500

    Maximum value allowed for:

    - `horizontal_accuracy` parameter of `telegram.Location`

    - `horizontal_accuracy` parameter of `telegram.InlineQueryResultLocation`

    - `horizontal_accuracy` parameter of `telegram.InputLocationMessageContent`

    - `horizontal_accuracy` parameter of `telegram.Bot.edit_message_live_location()`

    - `horizontal_accuracy` parameter of `telegram.Bot.send_location()`

    Type:

      `int`

  LIVE_PERIOD_FOREVER = 2147483647

    Value for live locations that can be edited indefinitely. Passed in:

    - `live_period` parameter of `telegram.InlineQueryResultLocation`

    - `live_period` parameter of `telegram.InputLocationMessageContent`

    - `live_period` parameter of `telegram.Bot.edit_message_live_location()`

    - `live_period` parameter of `telegram.Bot.send_location()`

    Added in version 21.2.

    Type:

      `int`

  MAX_CHAT_LOCATION_ADDRESS = 64

    Minimum value allowed for `address` parameter of `telegram.ChatLocation`

    Type:

      `int`

  MAX_HEADING = 360

    Maximum value allowed for:

    - `heading` parameter of `telegram.Location`

    - `heading` parameter of `telegram.InlineQueryResultLocation`

    - `heading` parameter of `telegram.InputLocationMessageContent`

    - `heading` parameter of `telegram.Bot.edit_message_live_location()`

    - `heading` parameter of `telegram.Bot.send_location()`

    Type:

      `int`

  MAX_LIVE_PERIOD = 86400

    Maximum value allowed for:

    - `live_period` parameter of `telegram.InlineQueryResultLocation`

    - `live_period` parameter of `telegram.InputLocationMessageContent`

    - `live_period` parameter of `telegram.Bot.edit_message_live_location()`

    - `live_period` parameter of `telegram.Bot.send_location()`

    Type:

      `int`

  MAX_PROXIMITY_ALERT_RADIUS = 100000

    Maximum value allowed for:

    - `proximity_alert_radius` parameter of `telegram.InlineQueryResultLocation`

    - `proximity_alert_radius` parameter of `telegram.InputLocationMessageContent`

    - `proximity_alert_radius` parameter of `telegram.Bot.edit_message_live_location()`

    - `proximity_alert_radius` parameter of `telegram.Bot.send_location()`

    Type:

      `int`

  MIN_CHAT_LOCATION_ADDRESS = 1

    Minimum value allowed for `address` parameter of `telegram.ChatLocation`

    Type:

      `int`

  MIN_HEADING = 1

    Minimum value allowed for:

    - `heading` parameter of `telegram.Location`

    - `heading` parameter of `telegram.InlineQueryResultLocation`

    - `heading` parameter of `telegram.InputLocationMessageContent`

    - `heading` parameter of `telegram.Bot.edit_message_live_location()`

    - `heading` parameter of `telegram.Bot.send_location()`

    Type:

      `int`

  MIN_LIVE_PERIOD = 60

    Minimum value allowed for:

    - `live_period` parameter of `telegram.InlineQueryResultLocation`

    - `live_period` parameter of `telegram.InputLocationMessageContent`

    - `live_period` parameter of `telegram.Bot.edit_message_live_location()`

    - `live_period` parameter of `telegram.Bot.send_location()`

    Type:

      `int`

  MIN_PROXIMITY_ALERT_RADIUS = 1

    Minimum value allowed for:

    - `proximity_alert_radius` parameter of `telegram.InlineQueryResultLocation`

    - `proximity_alert_radius` parameter of `telegram.InputLocationMessageContent`

    - `proximity_alert_radius` parameter of `telegram.Bot.edit_message_live_location()`

    - `proximity_alert_radius` parameter of `telegram.Bot.send_location()`

    Type:

      `int`

class telegram.constants.MaskPosition(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available positions for `telegram.MaskPosition`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  CHIN = 'chin'

    Mask position for a sticker on the chin.

    Type:

      `str`

  EYES = 'eyes'

    Mask position for a sticker on the eyes.

    Type:

      `str`

  FOREHEAD = 'forehead'

    Mask position for a sticker on the forehead.

    Type:

      `str`

  MOUTH = 'mouth'

    Mask position for a sticker on the mouth.

    Type:

      `str`

class telegram.constants.MediaGroupLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Bot.send_media_group()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_MEDIA_LENGTH = 10

    Maximum length of a `list` passed as the `media` parameter of `telegram.Bot.send_media_group()`.

    Type:

      `int`

  MIN_MEDIA_LENGTH = 2

    Minimum length of a `list` passed as the `media` parameter of `telegram.Bot.send_media_group()`.

    Type:

      `int`

class telegram.constants.MenuButtonType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.MenuButton`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  COMMANDS = 'commands'

    The type of `telegram.MenuButtonCommands`.

    Type:

      `str`

  DEFAULT = 'default'

    The type of `telegram.MenuButtonDefault`.

    Type:

      `str`

  WEB_APP = 'web_app'

    The type of `telegram.MenuButtonWebApp`.

    Type:

      `str`

class telegram.constants.MessageAttachmentType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.Message` that can be seen as attachment. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  ANIMATION = 'animation'

    Messages with `telegram.Message.animation`.

    Type:

      `str`

  AUDIO = 'audio'

    Messages with `telegram.Message.audio`.

    Type:

      `str`

  CONTACT = 'contact'

    Messages with `telegram.Message.contact`.

    Type:

      `str`

  DICE = 'dice'

    Messages with `telegram.Message.dice`.

    Type:

      `str`

  DOCUMENT = 'document'

    Messages with `telegram.Message.document`.

    Type:

      `str`

  GAME = 'game'

    Messages with `telegram.Message.game`.

    Type:

      `str`

  INVOICE = 'invoice'

    Messages with `telegram.Message.invoice`.

    Type:

      `str`

  LOCATION = 'location'

    Messages with `telegram.Message.location`.

    Type:

      `str`

  PAID_MEDIA = 'paid_media'

    Messages with `telegram.Message.paid_media`.

    Added in version 21.4.

    Type:

      `str`

  PASSPORT_DATA = 'passport_data'

    Messages with `telegram.Message.passport_data`.

    Type:

      `str`

  PHOTO = 'photo'

    Messages with `telegram.Message.photo`.

    Type:

      `str`

  POLL = 'poll'

    Messages with `telegram.Message.poll`.

    Type:

      `str`

  STICKER = 'sticker'

    Messages with `telegram.Message.sticker`.

    Type:

      `str`

  STORY = 'story'

    Messages with `telegram.Message.story`.

    Type:

      `str`

  SUCCESSFUL_PAYMENT = 'successful_payment'

    Messages with `telegram.Message.successful_payment`.

    Type:

      `str`

  VENUE = 'venue'

    Messages with `telegram.Message.venue`.

    Type:

      `str`

  VIDEO = 'video'

    Messages with `telegram.Message.video`.

    Type:

      `str`

  VIDEO_NOTE = 'video_note'

    Messages with `telegram.Message.video_note`.

    Type:

      `str`

  VOICE = 'voice'

    Messages with `telegram.Message.voice`.

    Type:

      `str`

class telegram.constants.MessageEntityType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.MessageEntity`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  BLOCKQUOTE = 'blockquote'

    Message entities representing a block quotation.

    Added in version 20.8.

    Type:

      `str`

  BOLD = 'bold'

    Message entities representing bold text.

    Type:

      `str`

  BOT_COMMAND = 'bot_command'

    Message entities representing a bot command.

    Type:

      `str`

  CASHTAG = 'cashtag'

    Message entities representing a cashtag.

    Type:

      `str`

  CODE = 'code'

    Message entities representing monowidth string.

    Type:

      `str`

  CUSTOM_EMOJI = 'custom_emoji'

    Message entities representing inline custom emoji stickers.

    Added in version 20.0.

    Type:

      `str`

  EMAIL = 'email'

    Message entities representing a email.

    Type:

      `str`

  EXPANDABLE_BLOCKQUOTE = 'expandable_blockquote'

    Message entities representing collapsed-by-default block quotation.

    Added in version 21.3.

    Type:

      `str`

  HASHTAG = 'hashtag'

    Message entities representing a hashtag.

    Type:

      `str`

  ITALIC = 'italic'

    Message entities representing italic text.

    Type:

      `str`

  MENTION = 'mention'

    Message entities representing a mention.

    Type:

      `str`

  PHONE_NUMBER = 'phone_number'

    Message entities representing a phone number.

    Type:

      `str`

  PRE = 'pre'

    Message entities representing monowidth block.

    Type:

      `str`

  SPOILER = 'spoiler'

    Message entities representing spoiler text.

    Type:

      `str`

  STRIKETHROUGH = 'strikethrough'

    Message entities representing strikethrough text.

    Type:

      `str`

  TEXT_LINK = 'text_link'

    Message entities representing clickable text URLs.

    Type:

      `str`

  TEXT_MENTION = 'text_mention'

    Message entities representing text mention for users without usernames.

    Type:

      `str`

  UNDERLINE = 'underline'

    Message entities representing underline text.

    Type:

      `str`

  URL = 'url'

    Message entities representing a url.

    Type:

      `str`

class telegram.constants.MessageLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Message`/ `telegram.InputTextMessageContent`/ `telegram.Bot.send_message()` & friends. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  CAPTION_LENGTH = 1024

    Maximum number of characters in a `str` passed as:

    - `caption` parameter of `telegram.Message`

    - `caption` parameter of `telegram.InputMedia` and its subclasses

    - `caption` parameter of subclasses of `telegram.InlineQueryResult`

    - `caption` parameter of `telegram.Bot.send_photo()`, `telegram.Bot.send_audio()`, `telegram.Bot.send_document()`, `telegram.Bot.send_video()`, `telegram.Bot.send_animation()`, `telegram.Bot.send_voice()`, `telegram.Bot.edit_message_caption()`, `telegram.Bot.copy_message()`

    Type:

      `int`

  DEEP_LINK_LENGTH = 64

    Maximum number of characters for a deep link.

    Type:

      `int`

  MAX_TEXT_LENGTH = 4096

    Maximum number of characters in a `str` passed as:

    - `text` parameter of `telegram.Game`

    - `text` parameter of `telegram.Message`

    - `message_text` parameter of `telegram.InputTextMessageContent`

    - `text` parameter of `telegram.Bot.send_message()`

    - `text` parameter of `telegram.Bot.edit_message_text()`

    Type:

      `int`

  MESSAGE_ENTITIES = 100

    Maximum number of entities that can be displayed in a message. Further entities will simply be ignored by Telegram.

    Note

    This value is undocumented and might be changed by Telegram.

    Type:

      `int`

  MIN_TEXT_LENGTH = 1

    Minimum number of characters in a `str` passed as the `message_text` parameter of `telegram.InputTextMessageContent` and the `text` parameter of `telegram.Bot.edit_message_text()`.

    Type:

      `int`

class telegram.constants.MessageOriginType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.MessageOrigin`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.8.

  CHANNEL = 'channel'

    A `telegram.MessageOrigin` who is sent by a channel.

    Type:

      `str`

  CHAT = 'chat'

    A `telegram.MessageOrigin` who is sent by a chat.

    Type:

      `str`

  HIDDEN_USER = 'hidden_user'

    A `telegram.MessageOrigin` who is sent by a hidden user.

    Type:

      `str`

  USER = 'user'

    A `telegram.MessageOrigin` who is sent by an user.

    Type:

      `str`

class telegram.constants.MessageType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.Message`. Here, a “type” means a kind of message that is visually distinct from other kinds of messages in the Telegram app. In particular, auxiliary attributes that can be present for multiple types of messages are not considered in this enumeration.

  The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  ANIMATION = 'animation'

    Messages with `telegram.Message.animation`.

    Type:

      `str`

  AUDIO = 'audio'

    Messages with `telegram.Message.audio`.

    Type:

      `str`

  BOOST_ADDED = 'boost_added'

    Messages with `telegram.Message.boost_added`.

    Added in version 21.0.

    Type:

      `str`

  BUSINESS_CONNECTION_ID = 'business_connection_id'

    Messages with `telegram.Message.business_connection_id`.

    Added in version 21.1.

    Type:

      `str`

  CHANNEL_CHAT_CREATED = 'channel_chat_created'

    Messages with `telegram.Message.channel_chat_created`.

    Type:

      `str`

  CHAT_BACKGROUND_SET = 'chat_background_set'

    Messages with `telegram.Message.chat_background_set`.

    Added in version 21.2.

    Type:

      `str`

  CHAT_SHARED = 'chat_shared'

    Messages with `telegram.Message.chat_shared`.

    Added in version 20.8.

    Type:

      `str`

  CONNECTED_WEBSITE = 'connected_website'

    Messages with `telegram.Message.connected_website`.

    Type:

      `str`

  CONTACT = 'contact'

    Messages with `telegram.Message.contact`.

    Type:

      `str`

  DELETE_CHAT_PHOTO = 'delete_chat_photo'

    Messages with `telegram.Message.delete_chat_photo`.

    Type:

      `str`

  DICE = 'dice'

    Messages with `telegram.Message.dice`.

    Type:

      `str`

  DOCUMENT = 'document'

    Messages with `telegram.Message.document`.

    Type:

      `str`

  EFFECT_ID = 'effect_id'

    Messages with `telegram.Message.effect_id`.

    Added in version 21.3.

    Type:

      `str`

  FORUM_TOPIC_CLOSED = 'forum_topic_closed'

    Messages with `telegram.Message.forum_topic_closed`.

    Added in version 20.8.

    Type:

      `str`

  FORUM_TOPIC_CREATED = 'forum_topic_created'

    Messages with `telegram.Message.forum_topic_created`.

    Added in version 20.8.

    Type:

      `str`

  FORUM_TOPIC_EDITED = 'forum_topic_edited'

    Messages with `telegram.Message.forum_topic_edited`.

    Added in version 20.8.

    Type:

      `str`

  FORUM_TOPIC_REOPENED = 'forum_topic_reopened'

    Messages with `telegram.Message.forum_topic_reopened`.

    Added in version 20.8.

    Type:

      `str`

  GAME = 'game'

    Messages with `telegram.Message.game`.

    Type:

      `str`

  GENERAL_FORUM_TOPIC_HIDDEN = 'general_forum_topic_hidden'

    Messages with `telegram.Message.general_forum_topic_hidden`.

    Added in version 20.8.

    Type:

      `str`

  GENERAL_FORUM_TOPIC_UNHIDDEN = 'general_forum_topic_unhidden'

    Messages with `telegram.Message.general_forum_topic_unhidden`.

    Added in version 20.8.

    Type:

      `str`

  GIVEAWAY = 'giveaway'

    Messages with `telegram.Message.giveaway`.

    Added in version 20.8.

    Type:

      `str`

  GIVEAWAY_COMPLETED = 'giveaway_completed'

    Messages with `telegram.Message.giveaway_completed`.

    Added in version 20.8.

    Type:

      `str`

  GIVEAWAY_CREATED = 'giveaway_created'

    Messages with `telegram.Message.giveaway_created`.

    Added in version 20.8.

    Type:

      `str`

  GIVEAWAY_WINNERS = 'giveaway_winners'

    Messages with `telegram.Message.giveaway_winners`.

    Added in version 20.8.

    Type:

      `str`

  GROUP_CHAT_CREATED = 'group_chat_created'

    Messages with `telegram.Message.group_chat_created`.

    Type:

      `str`

  INVOICE = 'invoice'

    Messages with `telegram.Message.invoice`.

    Type:

      `str`

  LEFT_CHAT_MEMBER = 'left_chat_member'

    Messages with `telegram.Message.left_chat_member`.

    Type:

      `str`

  LOCATION = 'location'

    Messages with `telegram.Message.location`.

    Type:

      `str`

  MESSAGE_AUTO_DELETE_TIMER_CHANGED = 'message_auto_delete_timer_changed'

    Messages with `telegram.Message.message_auto_delete_timer_changed`.

    Type:

      `str`

  MIGRATE_TO_CHAT_ID = 'migrate_to_chat_id'

    Messages with `telegram.Message.migrate_to_chat_id`.

    Type:

      `str`

  NEW_CHAT_MEMBERS = 'new_chat_members'

    Messages with `telegram.Message.new_chat_members`.

    Type:

      `str`

  NEW_CHAT_PHOTO = 'new_chat_photo'

    Messages with `telegram.Message.new_chat_photo`.

    Type:

      `str`

  NEW_CHAT_TITLE = 'new_chat_title'

    Messages with `telegram.Message.new_chat_title`.

    Type:

      `str`

  PAID_MEDIA = 'paid_media'

    Messages with `telegram.Message.paid_media`.

    Added in version 21.4.

    Type:

      `str`

  PASSPORT_DATA = 'passport_data'

    Messages with `telegram.Message.passport_data`.

    Type:

      `str`

  PHOTO = 'photo'

    Messages with `telegram.Message.photo`.

    Type:

      `str`

  PINNED_MESSAGE = 'pinned_message'

    Messages with `telegram.Message.pinned_message`.

    Type:

      `str`

  POLL = 'poll'

    Messages with `telegram.Message.poll`.

    Type:

      `str`

  PROXIMITY_ALERT_TRIGGERED = 'proximity_alert_triggered'

    Messages with `telegram.Message.proximity_alert_triggered`.

    Type:

      `str`

  REFUNDED_PAYMENT = 'refunded_payment'

    Messages with `telegram.Message.refunded_payment`.

    Added in version 21.4.

    Type:

      `str`

  REPLY_TO_STORY = 'reply_to_story'

    Messages with `telegram.Message.reply_to_story`.

    Added in version 21.0.

    Type:

      `str`

  SENDER_BOOST_COUNT = 'sender_boost_count'

    Messages with `telegram.Message.sender_boost_count`.

    Added in version 21.0.

    Type:

      `str`

  SENDER_BUSINESS_BOT = 'sender_business_bot'

    Messages with `telegram.Message.sender_business_bot`.

    Added in version 21.1.

    Type:

      `str`

  STICKER = 'sticker'

    Messages with `telegram.Message.sticker`.

    Type:

      `str`

  STORY = 'story'

    Messages with `telegram.Message.story`.

    Type:

      `str`

  SUCCESSFUL_PAYMENT = 'successful_payment'

    Messages with `telegram.Message.successful_payment`.

    Type:

      `str`

  SUPERGROUP_CHAT_CREATED = 'supergroup_chat_created'

    Messages with `telegram.Message.supergroup_chat_created`.

    Type:

      `str`

  TEXT = 'text'

    Messages with `telegram.Message.text`.

    Type:

      `str`

  USERS_SHARED = 'users_shared'

    Messages with `telegram.Message.users_shared`.

    Added in version 20.8.

    Type:

      `str`

  VENUE = 'venue'

    Messages with `telegram.Message.venue`.

    Type:

      `str`

  VIDEO = 'video'

    Messages with `telegram.Message.video`.

    Type:

      `str`

  VIDEO_CHAT_ENDED = 'video_chat_ended'

    Messages with `telegram.Message.video_chat_ended`.

    Type:

      `str`

  VIDEO_CHAT_PARTICIPANTS_INVITED = 'video_chat_participants_invited'

    Messages with `telegram.Message.video_chat_participants_invited`.

    Type:

      `str`

  VIDEO_CHAT_SCHEDULED = 'video_chat_scheduled'

    Messages with `telegram.Message.video_chat_scheduled`.

    Type:

      `str`

  VIDEO_CHAT_STARTED = 'video_chat_started'

    Messages with `telegram.Message.video_chat_started`.

    Type:

      `str`

  VIDEO_NOTE = 'video_note'

    Messages with `telegram.Message.video_note`.

    Type:

      `str`

  VOICE = 'voice'

    Messages with `telegram.Message.voice`.

    Type:

      `str`

  WEB_APP_DATA = 'web_app_data'

    Messages with `telegram.Message.web_app_data`.

    Added in version 20.8.

    Type:

      `str`

  WRITE_ACCESS_ALLOWED = 'write_access_allowed'

    Messages with `telegram.Message.write_access_allowed`.

    Added in version 20.8.

    Type:

      `str`

class telegram.constants.PaidMediaType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.PaidMedia`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 21.4.

  PHOTO = 'photo'

    The type of `telegram.PaidMediaPhoto`.

    Type:

      `str`

  PREVIEW = 'preview'

    The type of `telegram.PaidMediaPreview`.

    Type:

      `str`

  VIDEO = 'video'

    The type of `telegram.PaidMediaVideo`.

    Type:

      `str`

class telegram.constants.ParseMode(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available parse modes. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  HTML = 'HTML'

    HTML parse mode.

    Type:

      `str`

  MARKDOWN = 'Markdown'

    Markdown parse mode.

    Note

    `MARKDOWN` is a legacy mode, retained by Telegram for backward compatibility. You should use `MARKDOWN_V2` instead.

    Type:

      `str`

  MARKDOWN_V2 = 'MarkdownV2'

    Markdown parse mode version 2.

    Type:

      `str`

class telegram.constants.PollLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Poll`/`telegram.PollOption`/ `telegram.Bot.send_poll()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_EXPLANATION_LENGTH = 200

    Maximum number of characters in a `str` passed as the `explanation` parameter of `telegram.Poll` and the `explanation` parameter of `telegram.Bot.send_poll()`.

    Type:

      `int`

  MAX_EXPLANATION_LINE_FEEDS = 2

    Maximum number of line feeds in a `str` passed as the `explanation` parameter of `telegram.Bot.send_poll()` after entities parsing.

    Type:

      `int`

  MAX_OPEN_PERIOD = 600

    Maximum value allowed for the `open_period` parameter of `telegram.Bot.send_poll()`. Also used in the `close_date` parameter of `telegram.Bot.send_poll()`.

    Type:

      `int`

  MAX_OPTION_LENGTH = 100

    Maximum length of each `str` passed in a `list` to the `options` parameter of `telegram.Bot.send_poll()`.

    Type:

      `int`

  MAX_OPTION_NUMBER = 10

    Maximum number of strings passed in a `list` to the `options` parameter of `telegram.Bot.send_poll()`.

    Type:

      `int`

  MAX_QUESTION_LENGTH = 300

    Maximum value allowed for the `question` parameter of `telegram.Poll` and the `question` parameter of `telegram.Bot.send_poll()`.

    Type:

      `int`

  MIN_OPEN_PERIOD = 5

    Minimum value allowed for the `open_period` parameter of `telegram.Bot.send_poll()`. Also used in the `close_date` parameter of `telegram.Bot.send_poll()`.

    Type:

      `int`

  MIN_OPTION_LENGTH = 1

    Minimum length of each `str` passed in a `list` to the `options` parameter of `telegram.Bot.send_poll()`.

    Type:

      `int`

  MIN_OPTION_NUMBER = 2

    Minimum number of strings passed in a `list` to the `options` parameter of `telegram.Bot.send_poll()`.

    Type:

      `int`

  MIN_QUESTION_LENGTH = 1

    Minimum value allowed for the `question` parameter of `telegram.Poll` and the `question` parameter of `telegram.Bot.send_poll()`.

    Type:

      `int`

class telegram.constants.PollType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types for `telegram.Poll`/ `telegram.Bot.send_poll()`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  QUIZ = 'quiz'

    quiz polls.

    Type:

      `str`

  REGULAR = 'regular'

    regular polls.

    Type:

      `str`

class telegram.constants.PollingLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Bot.get_updates.limit`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_LIMIT = 100

    Maximum value allowed for the `limit` parameter of `telegram.Bot.get_updates()`.

    Type:

      `int`

  MIN_LIMIT = 1

    Minimum value allowed for the `limit` parameter of `telegram.Bot.get_updates()`.

    Type:

      `int`

class telegram.constants.ProfileAccentColor(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `Enum`

  This enum contains the available accent colors for `telegram.ChatFullInfo.profile_accent_color_id`. The members of this enum are named tuples with the following attributes:

  - `identifier` (`int`): The identifier of the accent color.

  - `name` (`str`): Optional. The name of the accent color.

  - `light_colors` (tuple[`str`]): Optional. The light colors of the accent color as HEX value.

  - `dark_colors` (tuple[`str`]): Optional. The dark colors of the accent color as HEX value.

  Since Telegram gives no exact specification for the accent colors, future accent colors might have a different data type.

  Added in version 20.8.

  COLOR_000 = (0, None, (12211792,), (10241344,))

    Accent color 0. This contains one light color

    and one dark color

  COLOR_001 = (1, None, (12745790,), (9723436,))

    Accent color 1. This contains one light color

    and one dark color

  COLOR_002 = (2, None, (9792200,), (7426201,))

    Accent color 2. This contains one light color

    and one dark color

  COLOR_003 = (3, None, (4825941,), (3371323,))

    Accent color 3. This contains one light color

    and one dark color

  COLOR_004 = (4, None, (4102061,), (3702407,))

    Accent color 4. This contains one light color

    and one dark color

  COLOR_005 = (5, None, (5935035,), (4682132,))

    Accent color 5. This contains one light color

    and one dark color

  COLOR_006 = (6, None, (12079992,), (9717603,))

    Accent color 6. This contains one light color

    and one dark color

  COLOR_007 = (7, None, (8358805,), (4412001,))

    Accent color 7. This contains one light color

    and one dark color

  COLOR_008 = (8, None, (13194845, 14253143), (10044227, 11294782))

    Accent color 8. This contains two light colors

    and two dark colors

  COLOR_009 = (9, None, (13595204, 13407283), (9393455, 10580530))

    Accent color 9. This contains two light colors

    and two dark colors

  COLOR_010 = (10, None, (9855700, 12150454), (6506129, 9588898))

    Accent color 10. This contains two light colors

    and two dark colors

  COLOR_011 = (11, None, (4036437, 9021008), (2714179, 6262596))

    Accent color 11. This contains two light colors

    and two dark colors

  COLOR_012 = (12, None, (4036026, 5287320), (3173500, 4102270))

    Accent color 12. This contains two light colors

    and two dark colors

  COLOR_013 = (13, None, (5475266, 5089469), (3694988, 4557729))

    Accent color 13. This contains two light colors

    and two dark colors

  COLOR_014 = (14, None, (11554676, 13723245), (8929632, 10900057))

    Accent color 14. This contains two light colors

    and two dark colors

  COLOR_015 = (15, None, (6517890, 8096407), (5464174, 3688020))

    Accent color 15. This contains two light colors

    and two dark colors

class telegram.constants.ReactionEmoji(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available emojis of `telegram.ReactionTypeEmoji`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.8.

  ALIEN_MONSTER = '👾'

    Alien monster

    Type:

      `str`

  BANANA = '🍌'

    Banana

    Type:

      `str`

  BOTTLE_WITH_POPPING_CORK = '🍾'

    Bottle with popping cork

    Type:

      `str`

  BROKEN_HEART = '💔'

    Broken heart

    Type:

      `str`

  CHRISTMAS_TREE = '🎄'

    Christmas tree

    Type:

      `str`

  CLAPPING_HANDS = '👏'

    Clapping Hands

    Type:

      `str`

  CLOWN_FACE = '🤡'

    Clown face

    Type:

      `str`

  CRYING_FACE = '😢'

    Crying face

    Type:

      `str`

  DOVE_OF_PEACE = '🕊'

    Dove of peace

    Type:

      `str`

  EYES = '👀'

    Eyes

    Type:

      `str`

  FACE_SCREAMING_IN_FEAR = '😱'

    Face screaming in fear

    Type:

      `str`

  FACE_THROWING_A_KISS = '😘'

    Face throwing a kiss

    Type:

      `str`

  FACE_WITH_ONE_EYEBROW_RAISED = '🤨'

    Face with one eyebrow raised

    Type:

      `str`

  FACE_WITH_OPEN_MOUTH_VOMITING = '🤮'

    Face with open mouth vomiting

    Type:

      `str`

  FACE_WITH_UNEVEN_EYES_AND_WAVY_MOUTH = '🥴'

    Face with uneven eyes and wavy mouth

    Type:

      `str`

  FATHER_CHRISTMAS = '🎅'

    Father christmas

    Type:

      `str`

  FEARFUL_FACE = '😨'

    Fearful face

    Type:

      `str`

  FIRE = '🔥'

    Fire

    Type:

      `str`

  GHOST = '👻'

    Ghost

    Type:

      `str`

  GRINNING_FACE_WITH_ONE_LARGE_AND_ONE_SMALL_EYE = '🤪'

    Grinning face with one large and one small eye

    Type:

      `str`

  GRINNING_FACE_WITH_SMILING_EYES = '😁'

    Grinning face with smiling eyes

    Type:

      `str`

  GRINNING_FACE_WITH_STAR_EYES = '🤩'

    Grinning face with star eyes

    Type:

      `str`

  HANDSHAKE = '🤝'

    Handshake

    Type:

      `str`

  HEART_ON_FIRE = '❤️\u200d🔥'

    Heart on fire

    Type:

      `str`

  HEART_WITH_ARROW = '💘'

    Heart with arrow

    Type:

      `str`

  HEAR_NO_EVIL_MONKEY = '🙉'

    Hear-no-evil monkey

    Type:

      `str`

  HIGH_VOLTAGE_SIGN = '⚡'

    High voltage sign

    Type:

      `str`

  HOT_DOG = '🌭'

    Hot dog

    Type:

      `str`

  HUGGING_FACE = '🤗'

    Hugging face

    Type:

      `str`

  HUNDRED_POINTS_SYMBOL = '💯'

    Hundred points symbol

    Type:

      `str`

  JACK_O_LANTERN = '🎃'

    Jack-o-lantern

    Type:

      `str`

  KISS_MARK = '💋'

    Kiss mark

    Type:

      `str`

  LOUDLY_CRYING_FACE = '😭'

    Loudly crying face

    Type:

      `str`

  MAN_SHRUGGING = '🤷\u200d♂️'

    Man Shrugging

    Type:

      `str`

  MAN_TECHNOLOGIST = '👨\u200d💻'

    Man Technologist

    Type:

      `str`

  MOYAI = '🗿'

    Moyai

    Type:

      `str`

  NAIL_POLISH = '💅'

    Nail polish

    Type:

      `str`

  NERD_FACE = '🤓'

    Nerd face

    Type:

      `str`

  NEUTRAL_FACE = '😐'

    Neutral face

    Type:

      `str`

  NEW_MOON_WITH_FACE = '🌚'

    New moon with face

    Type:

      `str`

  OK_HAND_SIGN = '👌'

    Ok hand sign

    Type:

      `str`

  PARTY_POPPER = '🎉'

    Party popper

    Type:

      `str`

  PERSON_WITH_FOLDED_HANDS = '🙏'

    Person with folded hands

    Type:

      `str`

  PILE_OF_POO = '💩'

    Pile of poo

    Type:

      `str`

  PILL = '💊'

    Pill

    Type:

      `str`

  POUTING_FACE = '😡'

    Pouting face

    Type:

      `str`

  RED_HEART = '❤'

    Red Heart

    Type:

      `str`

  REVERSED_HAND_WITH_MIDDLE_FINGER_EXTENDED = '🖕'

    Reversed hand with middle finger extended

    Type:

      `str`

  ROLLING_ON_THE_FLOOR_LAUGHING = '🤣'

    Rolling on the floor laughing

    Type:

      `str`

  SALUTING_FACE = '🫡'

    Saluting face

    Type:

      `str`

  SEE_NO_EVIL_MONKEY = '🙈'

    See-no-evil monkey

    Type:

      `str`

  SERIOUS_FACE_WITH_SYMBOLS_COVERING_MOUTH = '🤬'

    Serious face with symbols covering mouth

    Type:

      `str`

  SHOCKED_FACE_WITH_EXPLODING_HEAD = '🤯'

    Shocked face with exploding head

    Type:

      `str`

  SHRUG = '🤷'

    Shrug

    Type:

      `str`

  SLEEPING_FACE = '😴'

    Sleeping face

    Type:

      `str`

  SMILING_FACE_WITH_HALO = '😇'

    Smiling face with halo

    Type:

      `str`

  SMILING_FACE_WITH_HEARTS = '🥰'

    Smiling Face with Hearts

    Type:

      `str`

  SMILING_FACE_WITH_HEART_SHAPED_EYES = '😍'

    Smiling face with heart-shaped eyes

    Type:

      `str`

  SMILING_FACE_WITH_HORNS = '😈'

    Smiling face with horns

    Type:

      `str`

  SMILING_FACE_WITH_SUNGLASSES = '😎'

    Smiling face with sunglasses

    Type:

      `str`

  SNOWMAN = '☃'

    Snowman

    Type:

      `str`

  SPEAK_NO_EVIL_MONKEY = '🙊'

    Speak-no-evil monkey

    Type:

      `str`

  SPOUTING_WHALE = '🐳'

    Spouting whale

    Type:

      `str`

  SQUARED_COOL = '🆒'

    Squared cool

    Type:

      `str`

  STRAWBERRY = '🍓'

    Strawberry

    Type:

      `str`

  THINKING_FACE = '🤔'

    Thinking face

    Type:

      `str`

  THUMBS_DOWN = '👎'

    Thumbs Down

    Type:

      `str`

  THUMBS_UP = '👍'

    Thumbs Up

    Type:

      `str`

  TROPHY = '🏆'

    Trophy

    Type:

      `str`

  UNICORN_FACE = '🦄'

    Unicorn face

    Type:

      `str`

  WOMAN_SHRUGGING = '🤷\u200d♀️'

    Woman Shrugging

    Type:

      `str`

  WRITING_HAND = '✍'

    Writing hand

    Type:

      `str`

  YAWNING_FACE = '🥱'

    Yawning face

    Type:

      `str`

class telegram.constants.ReactionType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.ReactionType`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.8.

  CUSTOM_EMOJI = 'custom_emoji'

    A `telegram.ReactionType` with a custom emoji.

    Type:

      `str`

  EMOJI = 'emoji'

    A `telegram.ReactionType` with a normal emoji.

    Type:

      `str`

  PAID = 'paid'

    A `telegram.ReactionType` with a paid reaction.

    Added in version 21.5.

    Type:

      `str`

class telegram.constants.ReplyLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.ForceReply` and `telegram.ReplyKeyboardMarkup`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_INPUT_FIELD_PLACEHOLDER = 64

    Maximum value allowed for `input_field_placeholder` parameter of `telegram.ForceReply` and `input_field_placeholder` parameter of `telegram.ReplyKeyboardMarkup`

    Type:

      `int`

  MIN_INPUT_FIELD_PLACEHOLDER = 1

    Minimum value allowed for `input_field_placeholder` parameter of `telegram.ForceReply` and `input_field_placeholder` parameter of `telegram.ReplyKeyboardMarkup`

    Type:

      `int`

class telegram.constants.RevenueWithdrawalStateType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.RevenueWithdrawalState`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 21.4.

  FAILED = 'failed'

    A withdrawal failed and the transaction was refunded.

    Type:

      `str`

  PENDING = 'pending'

    A withdrawal in progress.

    Type:

      `str`

  SUCCEEDED = 'succeeded'

    A withdrawal succeeded.

    Type:

      `str`

telegram.constants.SUPPORTED_WEBHOOK_PORTS = [443, 80, 88, 8443]

  Ports supported by `telegram.Bot.set_webhook.url`.

  Type:

    list[`int`]

class telegram.constants.StarTransactions(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `float`, `enum.Enum`

  This enum contains constants for `telegram.StarTransaction`. The enum members of this enumeration are instances of `float` and can be treated as such.

  Added in version 21.9.

  NANOSTAR_VALUE = 1e-09

    The value of one nanostar as used in `telegram.StarTransaction.nanostar_amount`.

    Type:

      `float`

class telegram.constants.StarTransactionsLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Bot.get_star_transactions` and `telegram.StarTransaction`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 21.4.

  MAX_LIMIT = 100

    Maximum value allowed for the `limit` parameter of `telegram.Bot.get_star_transactions()`.

    Type:

      `int`

  MIN_LIMIT = 1

    Minimum value allowed for the `limit` parameter of `telegram.Bot.get_star_transactions()`.

    Type:

      `int`

  NANOSTAR_MAX_AMOUNT = 999999999

    Maximum value allowed for `nanostar_amount` parameter of `telegram.StarTransaction` and `nanostar_amount` parameter of `telegram.AffiliateInfo`.

    Added in version 21.9.

    Type:

      `int`

  NANOSTAR_MIN_AMOUNT = -999999999

    Minimum value allowed for `nanostar_amount` parameter of `telegram.AffiliateInfo`.

    Added in version 21.9.

    Type:

      `int`

class telegram.constants.StickerFormat(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available formats of `telegram.Sticker` in the set. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.2.

  ANIMATED = 'animated'

    Animated sticker.

    Type:

      `str`

  STATIC = 'static'

    Static sticker.

    Type:

      `str`

  VIDEO = 'video'

    Video sticker.

    Type:

      `str`

class telegram.constants.StickerLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for various sticker methods, such as `telegram.Bot.create_new_sticker_set()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_KEYWORD_LENGTH = 64

    Maximum number of characters in a search keyword for a sticker, for each item in `keywords` sequence of `telegram.Bot.set_sticker_keywords()`.

    Added in version 20.2.

    Type:

      `int`

  MAX_NAME_AND_TITLE = 64

    Maximum number of characters in a `str` passed as the `name` parameter or the `title` parameter of `telegram.Bot.create_new_sticker_set()`.

    Type:

      `int`

  MAX_SEARCH_KEYWORDS = 20

    Maximum number of search keywords for a sticker, passed as the `keywords` parameter of `telegram.Bot.set_sticker_keywords()`.

    Added in version 20.2.

    Type:

      `int`

  MAX_STICKER_EMOJI = 20

    Maximum number of emojis associated with a sticker, passed as the `emoji_list` parameter of `telegram.Bot.set_sticker_emoji_list()`.

    Added in version 20.2.

    Type:

      `int`

  MIN_NAME_AND_TITLE = 1

    Minimum number of characters in a `str` passed as the `name` parameter or the `title` parameter of `telegram.Bot.create_new_sticker_set()`.

    Type:

      `int`

  MIN_STICKER_EMOJI = 1

    Minimum number of emojis associated with a sticker, passed as the `emoji_list` parameter of `telegram.Bot.set_sticker_emoji_list()`.

    Added in version 20.2.

    Type:

      `int`

class telegram.constants.StickerSetLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for various sticker set methods, such as `telegram.Bot.create_new_sticker_set()` and `telegram.Bot.add_sticker_to_set()`.

  The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.2.

  MAX_ANIMATED_STICKERS = 50

    Maximum number of stickers allowed in an animated or video sticker set, as given in `telegram.Bot.add_sticker_to_set()`.

    Deprecated since version 21.1: The animated sticker limit is now 120, the same as `MAX_STATIC_STICKERS`.

    Type:

      `int`

  MAX_ANIMATED_THUMBNAIL_SIZE = 32

    Maximum size of the thumbnail if it is a .TGS or .WEBM in kilobytes, as given in `telegram.Bot.set_sticker_set_thumbnail()`.

    Type:

      `int`

  MAX_EMOJI_STICKERS = 200

    Maximum number of stickers allowed in an emoji sticker set, as given in `telegram.Bot.add_sticker_to_set()`.

    Type:

      `int`

  MAX_INITIAL_STICKERS = 50

    Maximum number of stickers allowed while creating a sticker set, passed as the `stickers` parameter of `telegram.Bot.create_new_sticker_set()`.

    Type:

      `int`

  MAX_STATIC_STICKERS = 120

    Maximum number of stickers allowed in a static sticker set, as given in `telegram.Bot.add_sticker_to_set()`.

    Type:

      `int`

  MAX_STATIC_THUMBNAIL_SIZE = 128

    Maximum size of the thumbnail if it is a .WEBP or .PNG in kilobytes, as given in `telegram.Bot.set_sticker_set_thumbnail()`.

    Type:

      `int`

  MIN_INITIAL_STICKERS = 1

    Minimum number of stickers needed to create a sticker set, passed as the `stickers` parameter of `telegram.Bot.create_new_sticker_set()`.

    Type:

      `int`

  STATIC_THUMB_DIMENSIONS = 100

    Exact height and width of the thumbnail if it is a .WEBP or .PNG in pixels, as given in `telegram.Bot.set_sticker_set_thumbnail()`.

    Type:

      `int`

class telegram.constants.StickerType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.Sticker`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  CUSTOM_EMOJI = 'custom_emoji'

    Custom emoji sticker.

    Type:

      `str`

  MASK = 'mask'

    Mask sticker.

    Type:

      `str`

  REGULAR = 'regular'

    Regular sticker.

    Type:

      `str`

class telegram.constants.TransactionPartnerType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.TransactionPartner`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 21.4.

  AFFILIATE_PROGRAM = 'affiliate_program'

    Transaction with Affiliate Program.

    Added in version 21.9.

    Type:

      `str`

  FRAGMENT = 'fragment'

    Withdrawal transaction with Fragment.

    Type:

      `str`

  OTHER = 'other'

    Transaction with unknown source or recipient.

    Type:

      `str`

  TELEGRAM_ADS = 'telegram_ads'

    Transaction with Telegram Ads.

    Type:

      `str`

  TELEGRAM_API = 'telegram_api'

    Transaction with with payment for paid broadcasting.

    ..versionadded:: 21.7

    Type:

      `str`

  USER = 'user'

    Transaction with a user.

    Type:

      `str`

class telegram.constants.UpdateType(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `str`, `enum.Enum`

  This enum contains the available types of `telegram.Update`. The enum members of this enumeration are instances of `str` and can be treated as such.

  Added in version 20.0.

  BUSINESS_CONNECTION = 'business_connection'

    Updates with `telegram.Update.business_connection`.

    Added in version 21.1.

    Type:

      `str`

  BUSINESS_MESSAGE = 'business_message'

    Updates with `telegram.Update.business_message`.

    Added in version 21.1.

    Type:

      `str`

  CALLBACK_QUERY = 'callback_query'

    Updates with `telegram.Update.callback_query`.

    Type:

      `str`

  CHANNEL_POST = 'channel_post'

    Updates with `telegram.Update.channel_post`.

    Type:

      `str`

  CHAT_BOOST = 'chat_boost'

    Updates with `telegram.Update.chat_boost`.

    Added in version 20.8.

    Type:

      `str`

  CHAT_JOIN_REQUEST = 'chat_join_request'

    Updates with `telegram.Update.chat_join_request`.

    Type:

      `str`

  CHAT_MEMBER = 'chat_member'

    Updates with `telegram.Update.chat_member`.

    Type:

      `str`

  CHOSEN_INLINE_RESULT = 'chosen_inline_result'

    Updates with `telegram.Update.chosen_inline_result`.

    Type:

      `str`

  DELETED_BUSINESS_MESSAGES = 'deleted_business_messages'

    Updates with `telegram.Update.deleted_business_messages`.

    Added in version 21.1.

    Type:

      `str`

  EDITED_BUSINESS_MESSAGE = 'edited_business_message'

    Updates with `telegram.Update.edited_business_message`.

    Added in version 21.1.

    Type:

      `str`

  EDITED_CHANNEL_POST = 'edited_channel_post'

    Updates with `telegram.Update.edited_channel_post`.

    Type:

      `str`

  EDITED_MESSAGE = 'edited_message'

    Updates with `telegram.Update.edited_message`.

    Type:

      `str`

  INLINE_QUERY = 'inline_query'

    Updates with `telegram.Update.inline_query`.

    Type:

      `str`

  MESSAGE = 'message'

    Updates with `telegram.Update.message`.

    Type:

      `str`

  MESSAGE_REACTION = 'message_reaction'

    Updates with `telegram.Update.message_reaction`.

    Added in version 20.8.

    Type:

      `str`

  MESSAGE_REACTION_COUNT = 'message_reaction_count'

    Updates with `telegram.Update.message_reaction_count`.

    Added in version 20.8.

    Type:

      `str`

  MY_CHAT_MEMBER = 'my_chat_member'

    Updates with `telegram.Update.my_chat_member`.

    Type:

      `str`

  POLL = 'poll'

    Updates with `telegram.Update.poll`.

    Type:

      `str`

  POLL_ANSWER = 'poll_answer'

    Updates with `telegram.Update.poll_answer`.

    Type:

      `str`

  PRE_CHECKOUT_QUERY = 'pre_checkout_query'

    Updates with `telegram.Update.pre_checkout_query`.

    Type:

      `str`

  PURCHASED_PAID_MEDIA = 'purchased_paid_media'

    Updates with `telegram.Update.purchased_paid_media`.

    Added in version 21.6.

    Type:

      `str`

  REMOVED_CHAT_BOOST = 'removed_chat_boost'

    Updates with `telegram.Update.removed_chat_boost`.

    Added in version 20.8.

    Type:

      `str`

  SHIPPING_QUERY = 'shipping_query'

    Updates with `telegram.Update.shipping_query`.

    Type:

      `str`

class telegram.constants.UserProfilePhotosLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Bot.get_user_profile_photos.limit`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_LIMIT = 100

    Maximum value allowed for `limit` parameter of `telegram.Bot.get_user_profile_photos()`.

    Type:

      `int`

  MIN_LIMIT = 1

    Minimum value allowed for `limit` parameter of `telegram.Bot.get_user_profile_photos()`.

    Type:

      `int`

class telegram.constants.VerifyLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `verify_chat()` and `verify_user()`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 21.10.

  MAX_TEXT_LENGTH = 70

    Maximum number of characters in a `str` passed as the `custom_description` or `custom_description` parameter.

    Type:

      `int`

class telegram.constants.WebhookLimit(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

  Bases: `enum.IntEnum`

  This enum contains limitations for `telegram.Bot.set_webhook.max_connections` and `telegram.Bot.set_webhook.secret_token`. The enum members of this enumeration are instances of `int` and can be treated as such.

  Added in version 20.0.

  MAX_CONNECTIONS_LIMIT = 100

    Maximum value allowed for the `max_connections` parameter of `telegram.Bot.set_webhook()`.

    Type:

      `int`

  MAX_SECRET_TOKEN_LENGTH = 256

    Maximum length of the secret token for the `secret_token` parameter of `telegram.Bot.set_webhook()`.

    Type:

      `int`

  MIN_CONNECTIONS_LIMIT = 1

    Minimum value allowed for the `max_connections` parameter of `telegram.Bot.set_webhook()`.

    Type:

      `int`

  MIN_SECRET_TOKEN_LENGTH = 1

    Minimum length of the secret token for the `secret_token` parameter of `telegram.Bot.set_webhook()`.

    Type:

      `int`

telegram.constants.ZERO_DATE = datetime.datetime(1970, 1, 1, 0, 0, tzinfo=datetime.timezone.utc)

  `datetime.datetime`, value of unix 0. This date literal is used in `telegram.InaccessibleMessage`

  Added in version 20.8.