$npx -y skills add WecomTeam/wecom-cli --skill wecomcli-meeting企业微信会议技能,支持创建预约会议、查询会议列表、获取会议详情、取消会议、更新会议成员。当用户需要"创建会议"、"预约会议"、"约会议"、"安排会议"、"查看会议"、"查询会议列表"、"会议详情"、"什么时候开会"、"有哪些会议"、"查找会议"、"取消会议"、"删除会议"、"修改会议成员"、"添加会议参与人"、"移除会议成员"时触发。
| 1 | # 企业微信会议技能 |
| 2 | |
| 3 | > `wecom-cli` 是企业微信提供的命令行程序,所有操作通过执行 `wecom-cli` 命令完成。 |
| 4 | |
| 5 | ## 概述 |
| 6 | |
| 7 | wecomcli-meeting 提供企业微信会议的完整管理能力,包含以下功能: |
| 8 | |
| 9 | 1. **创建预约会议** - 创建会议,支持设置会议参数,邀请参与人等 |
| 10 | 2. **查询会议列表** - 按用户和时间范围查询会议 ID 列表 (限制: 当日及前后 30 天,上限 100 个) |
| 11 | 3. **获取会议详情** - 通过会议 ID 查询完整会议信息 |
| 12 | 4. **取消会议** - 取消指定的预约会议 |
| 13 | 5. **更新会议受邀成员** - 修改会议的参与人列表 |
| 14 | |
| 15 | ## 命令调用方式 |
| 16 | |
| 17 | 执行指定命令: |
| 18 | ```bash |
| 19 | wecom-cli meeting <tool_name> '<json_params>' |
| 20 | ``` |
| 21 | |
| 22 | --- |
| 23 | |
| 24 | ## 命令详细说明 |
| 25 | |
| 26 | ### 1. 创建预约会议 (create_meeting) |
| 27 | |
| 28 | 创建一个预约会议,支持设置会议参数配置等。 |
| 29 | |
| 30 | #### 执行命令 |
| 31 | |
| 32 | ```bash |
| 33 | wecom-cli meeting create_meeting '{"title": "<会议标题>", "meeting_start_datetime": "<会议开始时间>", "meeting_duration": <会议持续时长(秒)>}' |
| 34 | ``` |
| 35 | |
| 36 | #### 入参说明 |
| 37 | |
| 38 | | 参数 | 类型 | 必填 | 说明 | |
| 39 | | -------------------------- | ------- | ---- | ------------------------------------------------- | |
| 40 | | `title` | string | 是 | 会议标题 | |
| 41 | | `meeting_start_datetime` | string | 是 | 会议开始时间,格式:`YYYY-MM-DD HH:mm` | |
| 42 | | `meeting_duration` | integer | 是 | 会议持续时长 (秒),例如 3600 = 1 小时 | |
| 43 | | `description` | string | 否 | 会议描述 | |
| 44 | | `location` | string | 否 | 会议地点 | |
| 45 | | `invitees` | object | 否 | 被邀请人,格式:`{"userid": ["lisi", "wangwu"]}` | |
| 46 | | `settings` | object | 否 | 会议设置 (详见下方) | |
| 47 | |
| 48 | > 被邀请人 userid 通过 `wecomcli-contact` 技能获取 |
| 49 | |
| 50 | **settings 字段:** |
| 51 | |
| 52 | | 参数 | 类型 | 说明 | |
| 53 | | --------------------------- | ------- | --------------------------------------------- | |
| 54 | | `password` | string | 会议密码 | |
| 55 | | `enable_waiting_room` | boolean | 是否启用等候室 | |
| 56 | | `allow_enter_before_host` | boolean | 是否允许成员在主持人进入前加入 | |
| 57 | | `enable_enter_mute` | integer | 入会时静音设置 (枚举: 0: 关闭,1: 开启) | |
| 58 | | `allow_external_user` | boolean | 是否允许外部用户入会 | |
| 59 | | `enable_screen_watermark` | boolean | 是否开启屏幕水印 | |
| 60 | | `remind_scope` | integer | 提醒范围 (1: 不提醒,2: 仅提醒主持人,3: 提醒所有成员,4: 指定部分人响铃,默认仅提醒主持人) | |
| 61 | | `ring_users` | object | 响铃用户,格式:`{"userid": ["lisi"]}` | |
| 62 | |
| 63 | > 响铃用户 userid 通过 `wecomcli-contact` 技能获取 |
| 64 | |
| 65 | #### 返回参数 |
| 66 | |
| 67 | ```json |
| 68 | { |
| 69 | "errcode": 0, |
| 70 | "errmsg": "ok", |
| 71 | "meetingid": "会议ID字符串", |
| 72 | "meeting_code": "会议号码字符串", |
| 73 | "meeting_link": "会议链接URL", |
| 74 | "excess_users": ["无效会议账号的userid"] |
| 75 | } |
| 76 | ``` |
| 77 | |
| 78 | | 字段 | 类型 | 说明 | |
| 79 | | ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------ | |
| 80 | | `meetingid` | string | 会议 ID | |
| 81 | | `meeting_code` | string | 会议号码,向用户展示时需在回复**开头**单独一行纯文字展示,格式 `#会议号: xxx-xxx-xxx` (每3位用 `-` 分隔) | |
| 82 | | `meeting_link` | string | 会议链接 | |
| 83 | | `excess_users` | array | 参会人中包含无效会议账号的 userid,仅在购买会议专业版企业由于部分参会人无有效会议账号时返回 | |
| 84 | |
| 85 | --- |
| 86 | |
| 87 | ### 2. 查询会议列表 (list_user_meetings) |
| 88 | |
| 89 | 查询指定用户在时间范围内的会议 ID 列表。 |
| 90 | |
| 91 | #### 执行命令 |
| 92 | |
| 93 | ```bash |
| 94 | wecom-cli meeting list_user_meetings '{"begin_datetime": "2026-03-01 00:00", "end_datetime": "2026-03-31 23:59", "limit": 100}' |
| 95 | ``` |
| 96 | |
| 97 | #### 入参说明 |
| 98 | |
| 99 | | 参数 | 类型 | 必填 | 说明 | |
| 100 | | ------------------ | ------- | ---- | --------------------------------------- | |
| 101 | | `begin_datetime` | string | 否 | 查询起始时间,格式:`YYYY-MM-DD HH:mm` | |
| 102 | | `end_datetime` | string | 否 | 查询结束时间,格式:`YYYY-MM-DD HH:mm` | |
| 103 | | `cursor` | string | 否 | 分页游标,用于获取下一页数据 | |
| 104 | | `limit` | integer | 否 | 每页返回条数,最大 100 | |
| 105 | |
| 106 | > **限制**: 时间范围仅支持当日及前后 30 天。 |
| 107 | |
| 108 | #### 返回参数 |
| 109 | |
| 110 | ```json |
| 111 | { |
| 112 | "errcode": 0, |
| 113 | "errmsg": "ok", |
| 114 | "next_cursor": "分页游标字符串,为空表示无更多", |
| 115 | "meetingid_list": ["会议ID_1", "会议ID_2"] |
| 116 | } |
| 117 | ``` |
| 118 | |
| 119 | | 字段 | 类型 | 说明 | |
| 120 | | ------------------ | ------ | ------------------------------ | |
| 121 | | `meetingid_list` | array | 会议 ID 列表 | |
| 122 | | `next_cursor` | string | 下一页游标,为空表示无更多数据 | |
| 123 | |
| 124 | --- |
| 125 | |
| 126 | ### 3. 获取会议详情 (get_meeting_info) |
| 127 | |
| 128 | 通过会议 ID 查询会议的完整详情。 |
| 129 | |
| 130 | #### 执行命令 |
| 131 | |
| 132 | ```bash |
| 133 | wecom-cli meeting get_meeting_info '{"meetingid": "<会议id>"}' |
| 134 | ``` |
| 135 | |
| 136 | #### 入参说明 |
| 137 | |
| 138 | | 参数 | 类型 | 必填 | 说明 | |
| 139 | | ----------------- | ------ | ---- | --------------- | |
| 140 | | `meetingid` | string | 是 | 会议 ID,通过 `list_user_meetings` 获取 | |
| 141 | | `meeting_ |