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.

Note

Though not stated explicitly in the offical 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.

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