setMyDefaultAdministratorRights

设置 Bot 被添加为管理员时的默认权限。

请求

POST /:token/setmydefaultadministratorrights

参数

参数	类型	必填	描述
rights	ChatAdministratorRights	否	Bot 的默认管理员权限对象。如果不指定，则清除已设置的默认权限
for_channels	Boolean	否	如果设为 true，则设置频道中的默认管理员权限；否则设置群组和超级群组中的默认管理员权限。默认值为 false

ChatAdministratorRights 对象

字段	类型	描述
is_anonymous	Boolean	是否允许管理员匿名操作
can_manage_chat	Boolean	是否可以管理聊天
can_delete_messages	Boolean	是否可以删除消息
can_manage_video_chats	Boolean	是否可以管理视频聊天
can_restrict_members	Boolean	是否可以限制成员
can_promote_members	Boolean	是否可以提升成员为管理员
can_change_info	Boolean	是否可以修改聊天信息
can_invite_users	Boolean	是否可以邀请用户
can_post_messages	Boolean	是否可以在频道中发布消息（仅频道）
can_edit_messages	Boolean	是否可以编辑频道中的消息（仅频道）
can_pin_messages	Boolean	是否可以置顶消息（仅群组和超级群组）

响应

成功时返回 Boolean 值 true。

{
  "ok": true,
  "result": true
}

错误码

错误码	描述
400	请求参数错误，如 rights 格式不正确
401	Token 无效或已过期
500	服务器内部错误

示例

cURL

设置群组默认管理员权限

curl -X POST "https://api.example.com/<token>/setmydefaultadministratorrights" \
  -H "Content-Type: application/json" \
  -d '{
    "rights": {
      "is_anonymous": false,
      "can_manage_chat": true,
      "can_delete_messages": true,
      "can_manage_video_chats": false,
      "can_restrict_members": true,
      "can_promote_members": false,
      "can_change_info": false,
      "can_invite_users": true,
      "can_pin_messages": true
    }
  }'

设置频道默认管理员权限

curl -X POST "https://api.example.com/<token>/setmydefaultadministratorrights" \
  -H "Content-Type: application/json" \
  -d '{
    "rights": {
      "is_anonymous": false,
      "can_manage_chat": true,
      "can_delete_messages": true,
      "can_post_messages": true,
      "can_edit_messages": true,
      "can_invite_users": true
    },
    "for_channels": true
  }'

清除默认管理员权限

curl -X POST "https://api.example.com/<token>/setmydefaultadministratorrights" \
  -H "Content-Type: application/json" \
  -d '{}'