promote_chat_member

template<class Agent>
api_result<boolean_t, Agent&&> promote_chat_member(Agent &&agent, promote_chat_member_args_t args)

template<class Agent, class F>
void promote_chat_member(Agent &&agent, promote_chat_member_args_t args, F &&callback)

agent is any object satisfying agent concept.

callback is any callable object accepting expected<boolean_t>.

Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administrator in the chat for this to work and must have the appropriate administrator rights. Pass False for all boolean parameters to demote a user. Returns True on success.

struct promote_chat_member_args_t

Arguments that should be passed to promote_chat_member().

variant_t<integer_t, string_t> chat_id

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

integer_t user_id

Unique identifier of the target user

optional_t<boolean_t> is_anonymous

Pass True if the administrator’s presence in the chat is hidden

optional_t<boolean_t> can_manage_chat

Pass True if the administrator can access the chat event log, get boost list, see hidden supergroup and channel members, report spam messages and ignore slow mode. Implied by any other administrator privilege.

optional_t<boolean_t> can_delete_messages

Pass True if the administrator can delete messages of other users

optional_t<boolean_t> can_manage_video_chats

Pass True if the administrator can manage video chats

optional_t<boolean_t> can_restrict_members

Pass True if the administrator can restrict, ban or unban chat members, or access supergroup statistics

optional_t<boolean_t> can_promote_members

Pass True if the administrator can add new administrators with a subset of their own privileges or demote administrators that they have promoted, directly or indirectly (promoted by administrators that were appointed by him)

optional_t<boolean_t> can_change_info

Pass True if the administrator can change chat title, photo and other settings

optional_t<boolean_t> can_invite_users

Pass True if the administrator can invite new users to the chat

optional_t<boolean_t> can_post_stories

Pass True if the administrator can post stories to the chat

optional_t<boolean_t> can_edit_stories

Pass True if the administrator can edit stories posted by other users, post stories to the chat page, pin chat stories, and access the chat’s story archive

optional_t<boolean_t> can_delete_stories

Pass True if the administrator can delete stories posted by other users

optional_t<boolean_t> can_post_messages

Pass True if the administrator can post messages in the channel, or access channel statistics; for channels only

optional_t<boolean_t> can_edit_messages

Pass True if the administrator can edit messages of other users and can pin messages; for channels only

optional_t<boolean_t> can_pin_messages

Pass True if the administrator can pin messages; for supergroups only

optional_t<boolean_t> can_manage_topics

Pass True if the user is allowed to create, rename, close, and reopen forum topics; for supergroups only