telegram.ChatPermissions

class telegram.ChatPermissions(can_send_messages=None, can_send_media_messages=None, can_send_polls=None, can_send_other_messages=None, can_add_web_page_previews=None, can_change_info=None, can_invite_users=None, can_pin_messages=None, **_kwargs)

Bases: telegram.base.TelegramObject

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

Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their can_send_messages, can_send_media_messages, can_send_polls, can_send_other_messages, can_add_web_page_previews, can_change_info, can_invite_users and can_pin_messages are equal.

Note

Though not stated explicitly in the official docs, Telegram changes not only the permissions that are set, but also sets all the others to False. However, since not documented, this behaviour may change unbeknown to PTB.

Parameters

  • can_send_messages (bool, optional) – True, if the user is allowed to send text messages, contacts, locations and venues.

  • can_send_media_messages (bool, optional) – True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages.

  • can_send_polls (bool, optional) – True, if the user is allowed to send polls, implies can_send_messages.

  • can_send_other_messages (bool, optional) – True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages.

  • can_add_web_page_previews (bool, optional) – True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages.

  • can_change_info (bool, optional) – True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups.

  • can_invite_users (bool, optional) – True, if the user is allowed to invite new users to the chat.

  • can_pin_messages (bool, optional) – True, if the user is allowed to pin messages. Ignored in public supergroups.

can_send_messages

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

Type

bool

can_send_media_messages

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

Type

bool

can_send_polls

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

Type

bool

can_send_other_messages

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

Type

bool

can_add_web_page_previews

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

Type

bool

can_change_info

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

Type

bool

can_invite_users

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

Type

bool

can_pin_messages

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

Type

bool