如何使用whatsapp-web.js实现群组用户promote与demote操作

whatsapp-web.js 稳定版（v1.13及以上）的群组Chat实例原生内置了权限调整方法，不需要自行抓包构造私有请求，具体实现如下：

前置校验 #

• 操作前先校验目标会话属性：chat.isGroup 返回值必须为 true，非群组会话调用群管方法会直接抛出异常
• 确认当前登录账号为目标群组的管理员，无管理员权限调用接口会返回403错误

核心方法调用 #

提升成员为管理员（promote） #

调用群组实例的promoteParticipants方法，支持批量传入待操作的用户ID数组：

// 替换为你实际的群组ID，群组ID格式为 xxxxxxxx@g.us
const groupChat = await client.getChatById('123456789012345678@g.us');
// 待提升的用户ID格式为 国家码+号码@c.us，支持单次传多个
await groupChat.promoteParticipants([
  '8613000000000@c.us',
  '8613100000000@c.us'
]);

取消成员管理员权限（demote） #

对应调用demoteParticipants方法，参数格式和promote操作完全一致：

const groupChat = await client.getChatById('123456789012345678@g.us');
// 传入待降级的用户ID数组即可
await groupChat.demoteParticipants(['8613000000000@c.us']);

注意事项 #

• 不建议自行调用底层client.pupPage或者sendQuery构造群管理请求，版本迭代后群操作接口的加密校验逻辑有更新，私自构造请求极易触发账号风控
• 传入的用户ID不要混用后缀：普通群成员统一使用号码@c.us后缀，群组自身ID使用@g.us后缀，格式错误会返回用户不存在的报错
• 单次批量操作人数不要超过50，短时间频繁调用群管接口会触发临时频控，限制群操作权限

如果你使用的版本低于v1.13，先升级到最新稳定版即可，旧版本确实没有对外暴露这两个群管方法，升级前注意备份本地的.wwebjs_cache目录，避免重新扫码登录。

内容的提问来源于stack exchange，提问作者João Antônio