Promote chat member
The telegram_bot_api-promote-chat-member tool enables chat administrators to efficiently manage user privileges within Telegram supergroups and channels. It allows promoting or demoting users by assigning specific administrative rights, ensuring streamlined community management.
Features
- Promote or demote users in Telegram supergroups and channels based on required permissions.
- Assign precise administrative rights such as changing chat info, posting messages, editing, deleting, and pinning messages.
- Control user invitation privileges to manage new member access.
- Manage member restrictions including banning and unbanning chat members.
- Facilitate hierarchical admin control by allowing promotion or demotion of other administrators within permitted limits.
Benefits
- Simplifies chat management by providing granular control over user permissions.
- Enhances security by restricting sensitive actions to trusted administrators.
- Improves community engagement through better moderation tools.
- Saves time with automated promotion and demotion capabilities via API integration.
- Supports scalable management of large groups and channels with complex admin hierarchies.
Description
Use this method to promote or demote a user in a supergroup or a channel. See the docs for more information
Parameters
10 parameters
| Name | Type | Description |
|---|---|---|
| chatIdrequired | string | Enter the unique identifier for the target chat (e.g. |
| userId | string | Enter the unique identifier of the target user. |
| can_change_info | boolean | Pass True, if the administrator can change chat title, photo and other settings. |
| can_post_messages | boolean | Pass True, if the administrator can create channel posts [channels only]. |
| can_edit_messages | boolean | Pass True, if the administrator can edit messages of other users and can pin messages [channels only]. |
| can_delete_messages | boolean | Pass True, if the administrator can delete messages of other users [channels only]. |
| can_invite_users | boolean | Pass True, if the administrator can invite new users to the chat. |
| can_restrict_members | boolean | Pass True, if the administrator can restrict, ban or unban chat members. |
| can_pin_messages | boolean | Pass True, if the administrator can pin messages [supergroups only]. |
| can_promote_members | boolean | 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 them). |
