企业微信会议管理技能
wecom-cli是企业微信提供的命令行程序,所有操作通过执行wecom-cli命令完成。
概述
wecomcli-edit-meeting 提供企业微信会议管理能力, 包含以下功能:
- 取消会议 - 取消指定的预约会议
- 更新会议受邀成员 - 修改会议的参与人列表
命令调用方式
调用指定命令:
wecom-cli meeting <tool_name> '<json_params>'
命令详细说明
1. 取消会议 (cancel_meeting)
取消指定的预约会议.
调用命令
wecom-cli meeting cancel_meeting '{"meetingid": "<会议id>"}'
入参说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
meetingid | string | 是 | 会议 ID, 通过 wecomcli-get-meeting 技能获取 |
返回参数
{
"errcode": 0,
"errmsg": "ok"
}
2. 更新会议受邀成员 (set_invite_meeting_members)
更新会议的受邀成员列表 (全量覆盖).
调用命令
wecom-cli meeting set_invite_meeting_members '{"meetingid": "<会议id>", "invitees": [{"userid": "lisi"}, {"userid": "wangwu"}]}'
入参说明
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
meetingid | string | 是 | 会议 ID, 通过 wecomcli-get-meeting 技能获取 |
invitees | array | 否 | 受邀成员列表, 每项包含 userid 字段 |
注意: invitees 为全量覆盖, 传入的列表将替换现有成员列表. invitees 的 userid 通过
wecomcli-lookup-contact技能获取
返回参数
{
"errcode": 0,
"errmsg": "ok"
}
典型工作流
工作流 1: 取消会议
示例: 用户说 "帮我取消明天的技术方案评审会议"
步骤:
- 定位会议: 通过
wecomcli-get-meeting技能查询会议列表 + 关键词匹配找到目标会议. - 直接执行取消:
wecom-cli meeting cancel_meeting '{"meetingid": "<target_meetingid>"}'
- 展示结果:
✅ 会议已取消: 技术方案评审
工作流 2: 更新会议成员
示例: 用户说 "把王五加到技术方案评审会议里"
步骤:
- 定位会议: 通过
wecomcli-get-meeting技能查询会议列表 + 匹配找到目标会议. - 获取当前受邀成员:
set_invite_members为全量覆盖, 必须先通过wecomcli-get-meeting技能的get_meeting_info获取会议详情, 获取现有成员后再合并. - 通讯录查询: 调用
wecomcli-lookup-contact技能获取通讯录成员, 按姓名筛选出王五的 userid.
wecom-cli contact get_userlist '{}'
在返回的 userlist 中筛选 name 包含 "王五" 的成员, 获取其 userid.
- 合并成员列表: 将现有成员 + 新增成员合并 (全量覆盖).
- 执行更新:
wecom-cli meeting set_invite_meeting_members '{"meetingid": "<target_meetingid>", "invitees": [{"userid": "zhangsan"}, {"userid": "lisi"}, {"userid": "wangwu"}]}'
- 展示结果:
✅ 会议成员已更新: 技术方案评审
👥 当前成员: 张三, 李四, 王五
注意事项
- 参与人仅支持企业内成员, 不支持外部人员
- 通讯录查询: 涉及参与人时, 需先通过
wecomcli-lookup-contact技能的get_userlist接口获取全量通讯录成员, 再按姓名/别名本地筛选匹配出对应的userid. 该接口无入参, 返回当前用户可见范围内的成员列表 (含userid,name,alias) - 定位会议: 管理操作需先通过
wecomcli-get-meeting技能查询到目标会议的 meetingid - 成员更新为全量覆盖:
set_invite_members传入的列表将替换现有成员列表, 需先获取当前成员再合并