/wecomcli-meeting

name: wecomcli-meeting
description: 企业微信会议技能，支持创建预约会议、查询会议列表、获取会议详情、取消会议、更新会议成员。当用户需要"创建会议"、"预约会议"、"约会议"、"安排会议"、"查看会议"、"查询会议列表"、"会议详情"、"什么时候开会"、"有哪些会议"、"查找会议"、"取消会议"、"删除会议"、"修改会议成员"、"添加会议参与人"、"移除会议成员"时触发。
metadata:
  requires:
    bins: ["wecom-cli"]
  cliHelp: "wecom-cli meeting --help"

企业微信会议技能

> `wecom-cli` 是企业微信提供的命令行程序，所有操作通过执行 `wecom-cli` 命令完成。

概述

wecomcli-meeting 提供企业微信会议的完整管理能力，包含以下功能：

1. **创建预约会议** - 创建会议，支持设置会议参数，邀请参与人等 2. **查询会议列表** - 按用户和时间范围查询会议 ID 列表 (限制: 当日及前后 30 天，上限 100 个) 3. **获取会议详情** - 通过会议 ID 查询完整会议信息 4. **取消会议** - 取消指定的预约会议 5. **更新会议受邀成员** - 修改会议的参与人列表

命令调用方式

执行指定命令：

wecom-cli meeting <tool_name> '<json_params>'

---

命令详细说明

1. 创建预约会议 (create_meeting)

创建一个预约会议，支持设置会议参数配置等。

执行命令

wecom-cli meeting create_meeting '{"title": "<会议标题>", "meeting_start_datetime": "<会议开始时间>", "meeting_duration": <会议持续时长(秒)>}'

入参说明

| 参数 | 类型 | 必填 | 说明 | | -------------------------- | ------- | ---- | ------------------------------------------------- | | `title` | string | 是 | 会议标题 | | `meeting_start_datetime` | string | 是 | 会议开始时间，格式:`YYYY-MM-DD HH:mm` | | `meeting_duration` | integer | 是 | 会议持续时长 (秒)，例如 3600 = 1 小时 | | `description` | string | 否 | 会议描述 | | `location` | string | 否 | 会议地点 | | `invitees` | object | 否 | 被邀请人，格式:`{"userid": ["lisi", "wangwu"]}` | | `settings` | object | 否 | 会议设置 (详见下方) |

> 被邀请人 userid 通过 `wecomcli-contact` 技能获取

**settings 字段:**

| 参数 | 类型 | 说明 | | --------------------------- | ------- | --------------------------------------------- | | `password` | string | 会议密码 | | `enable_waiting_room` | boolean | 是否启用等候室 | | `allow_enter_before_host` | boolean | 是否允许成员在主持人进入前加入 | | `enable_enter_mute` | integer | 入会时静音设置 (枚举: 0: 关闭，1: 开启) | | `allow_external_user` | boolean | 是否允许外部用户入会 | | `enable_screen_watermark` | boolean | 是否开启屏幕水印 | | `remind_scope` | integer | 提醒范围 (1: 不提醒，2: 仅提醒主持人，3: 提醒所有成员，4: 指定部分人响铃，默认仅提醒主持人) | | `ring_users` | object | 响铃用户，格式:`{"userid": ["lisi"]}` |

> 响铃用户 userid 通过 `wecomcli-contact` 技能获取

返回参数

{
  "errcode": 0,
  "errmsg": "ok",
  "meetingid": "会议ID字符串",
  "meeting_code": "会议号码字符串",
  "meeting_link": "会议链接URL",
  "excess_users": ["无效会议账号的userid"]
}

| 字段 | 类型 | 说明 | | ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------ | | `meetingid` | string | 会议 ID | | `meeting_code` | string | 会议号码，向用户展示时需在回复**开头**单独一行纯文字展示，格式 `#会议号: xxx-xxx-xxx` (每3位用 `-` 分隔) | | `meeting_link` | string | 会议链接 | | `excess_users` | array | 参会人中包含无效会议账号的 userid，仅在购买会议专业版企业由于部分参会人无有效会议账号时返回 |

---

2. 查询会议列表 (list_user_meetings)

查询指定用户在时间范围内的会议 ID 列表。

执行命令

wecom-cli meeting list_user_meetings '{"begin_datetime": "2026-03-01 00:00", "end_datetime": "2026-03-31 23:59", "limit": 100}'

入参说明

| 参数 | 类型 | 必填 | 说明 | | ------------------ | ------- | ---- | --------------------------------------- | | `begin_datetime` | string | 否 | 查询起始时间，格式:`YYYY-MM-DD HH:mm` | | `end_datetime` | string | 否 | 查询结束时间，格式:`YYYY-MM-DD HH:mm` | | `cursor` | string | 否 | 分页游标，用于获取下一页数据 | | `limit` | integer | 否 | 每页返回条数，最大 100 |

> **限制**: 时间范围仅支持当日及前后 30 天。

返回参数

{
  "errcode": 0,
  "errmsg": "ok",
  "next_cursor": "分页游标字符串，为空表示无更多",
  "meetingid_list": ["会议ID_1", "会议ID_2"]
}

| 字段 | 类型 | 说明 | | ------------------ | ------ | ------------------------------ | | `meetingid_list` | array | 会议 ID 列表 | | `next_cursor` | string | 下一页游标，为空表示无更多数据 |

---

3. 获取会议详情 (get_meeting_info)

通过会议 ID 查询会议的完整详情。

执行命令

wecom-cli meeting get_meeting_info '{"meetingid": "<会议id>"}'

入参说明

| 参数 | 类型 | 必填 | 说明 | | ----------------- | ------ | ---- | --------------- | | `meetingid` | string | 是 | 会议 ID，通过 `list_user_meetings` 获取 | | `meeting_code` | string | 否 | 会议号码 | | `sub_meetingid` | string | 否 | 子会议 ID |

返回参数

> 完整的返回参数结构和字段说明详见 [references/response-get-meeting-info.md](references/response-get-meeting-info.md)

**核心字段速览:**

| 字段 | 类型 | 说明 | | --- | --- | --- | | `title` | string | 会议标题 | | `meeting_start_datetime` | string | 会议开始时间 | | `meeting_duration` | integer | 会议时长 (秒) | | `status` | integer | 会议状态 (1: 待开始，2: 会议中，3: 已结束，4: 已取消，5: 已过期) | | `meeting_type` | integer | 会议类型 (0: 一次性，1: 周期性，2: 微信专属，3: Rooms 投屏，5: 个人会议号，6: 网络研讨会) | | `meeting_code` | string | 会议号码 | | `meeting_link` | string | 会议链接 | | `description` | string | 会议描述 | | `location` | string | 会议地点 | | `attendees.member[].status` | integer | 与会状态 (1: 已参与，2: 未参与) |

---

4. 取消会议 (cancel_meeting)

取消指定的预约会议。

执行命令

wecom-cli meeting cancel_meeting '{"meetingid": "<会议id>"}'

入参说明

| 参数 | 类型 | 必填 | 说明 | | ----------------- | ------ | ---- | ------------------------