Sticker

class telegram.Sticker(file_id, file_unique_id, width, height, is_animated, is_video, type, emoji=None, file_size=None, set_name=None, mask_position=None, premium_animation=None, custom_emoji_id=None, thumbnail=None, needs_repainting=None, *, api_kwargs=None)

Bases: telegram.TelegramObject

This object represents a sticker.

Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their file_unique_id is equal.

Note

As of v13.11 is_video is a required argument and therefore the order of the arguments had to be changed. Use keyword arguments to make sure that the arguments are passed correctly.

Use In

• telegram.Bot.delete_sticker_from_set()

• telegram.Bot.get_file()

• telegram.Bot.replace_sticker_in_set()

• telegram.Bot.send_sticker()

• telegram.Bot.set_sticker_emoji_list()

• telegram.Bot.set_sticker_keywords()

• telegram.Bot.set_sticker_mask_position()

• telegram.Bot.set_sticker_position_in_set()

Available In

• telegram.BusinessIntro.sticker

• telegram.ExternalReplyInfo.sticker

• telegram.Gift.sticker

• telegram.Message.sticker

• telegram.StickerSet.stickers

Changed in version 20.5: Removed the deprecated argument and attribute thumb.

Parameters:

• file_id (str) – Identifier for this file, which can be used to download or reuse the file.

• file_unique_id (str) – Unique identifier for this file, which is supposed to be the same over time and for different bots. Can’t be used to download or reuse the file.

• width (int) – Sticker width.

• height (int) – Sticker height.

• is_animated (bool) – True, if the sticker is animated.

• is_video (bool) –

  True, if the sticker is a video sticker.

  Added in version 13.11.

• type (str) –

  Type of the sticker. Currently one of REGULAR, MASK, CUSTOM_EMOJI. The type of the sticker is independent from its format, which is determined by the fields is_animated and is_video.

  Added in version 20.0.

• emoji (str, optional) – Emoji associated with the sticker

• set_name (str, optional) – Name of the sticker set to which the sticker belongs.

• mask_position (telegram.MaskPosition, optional) – For mask stickers, the position where the mask should be placed.

• file_size (int, optional) – File size in bytes.

• premium_animation (telegram.File, optional) –

  For premium regular stickers, premium animation for the sticker.

  Added in version 20.0.

• custom_emoji_id (str, optional) –

  For custom emoji stickers, unique identifier of the custom emoji.

  Added in version 20.0.

• thumbnail (telegram.PhotoSize, optional) –

  Sticker thumbnail in the .WEBP or .JPG format.

  Added in version 20.2.

• needs_repainting (bool, optional) –

  True, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places.

  Added in version 20.2.

file_id

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

Type:

str

file_unique_id

Unique identifier for this file, which is supposed to be the same over time and for different bots. Can’t be used to download or reuse the file.

Type:

str

width

Sticker width.

Type:

int

height

Sticker height.

Type:

int

is_animated

True, if the sticker is animated.

Type:

bool

is_video

True, if the sticker is a video sticker.

Added in version 13.11.

Type:

bool

type

Type of the sticker. Currently one of REGULAR, MASK, CUSTOM_EMOJI. The type of the sticker is independent from its format, which is determined by the fields is_animated and is_video.

Added in version 20.0.

Type:

str

emoji

Optional. Emoji associated with the sticker.

Type:

str

set_name

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

Type:

str

mask_position

Optional. For mask stickers, the position where the mask should be placed.

Type:

telegram.MaskPosition

file_size

Optional. File size in bytes.

Type:

int

premium_animation

Optional. For premium regular stickers, premium animation for the sticker.

Added in version 20.0.

Type:

telegram.File

custom_emoji_id

Optional. For custom emoji stickers, unique identifier of the custom emoji.

Added in version 20.0.

Type:

str

thumbnail

Optional. Sticker thumbnail in the .WEBP or .JPG format.

Added in version 20.2.

Type:

telegram.PhotoSize

needs_repainting

Optional. True, if the sticker must be repainted to a text color in messages, the color of the Telegram Premium badge in emoji status, white color on chat photos, or another appropriate color in other places.

Added in version 20.2.

Type:

bool

CUSTOM_EMOJI = 'custom_emoji'

telegram.constants.StickerType.CUSTOM_EMOJI

MASK = 'mask'

telegram.constants.StickerType.MASK

REGULAR = 'regular'

telegram.constants.StickerType.REGULAR

classmethod de_json(data, bot=None)

See telegram.TelegramObject.de_json().

async get_file(*, read_timeout=None, write_timeout=None, connect_timeout=None, pool_timeout=None, api_kwargs=None)

Convenience wrapper over telegram.Bot.get_file()

For the documentation of the arguments, please see telegram.Bot.get_file().

Returns:

telegram.File

Raises:

telegram.error.TelegramError –