Wecomcli Meeting

企业微信会议技能

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": <会议持续时长(秒)>}'

入参说明

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

settings 字段:

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

返回参数

{
  "errcode": 0,
  "errmsg": "ok",
  "meetingid": "会议ID字符串",
  "meeting_code": "会议号码字符串",
  "meeting_link": "会议链接URL",
  "excess_users": ["无效会议账号的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}'

入参说明

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

返回参数

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

---

3. 获取会议详情 (get_meeting_info)

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

执行命令

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

入参说明

返回参数

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

核心字段速览:

---

4. 取消会议 (cancel_meeting)

取消指定的预约会议。

执行命令

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

入参说明

返回参数

{
  "errcode": 0,
  "errmsg": "ok"
}

---

5. 更新会议受邀成员 (set_invite_meeting_members)

更新会议的受邀成员列表（全量覆盖）。

执行命令

wecom-cli meeting set_invite_meeting_members '{"meetingid": "<会议id>", "invitees": [{"userid": "lisi"}, {"userid": "wangwu"}]}'

入参说明

注意: invitees 为全量覆盖，传入的列表将替换现有成员列表。

invitees 的 userid 通过 wecomcli-contact 技能获取

返回参数

{
  "errcode": 0,
  "errmsg": "ok"
}

---

典型工作流

工作流 1: 最简创建 (无邀请人)

用户意图: "帮我约一个明天下午3点的会议，主题是周例会，时长1小时"

步骤:

1. 解析用户意图: 时间 + 主题已有，邀请人未提及则默认留空，直接创建。 2. 调用创建命令:

wecom-cli meeting create_meeting '{"title": "周例会", "meeting_start_datetime": "2026-03-18 15:00", "meeting_duration": 3600}'

3. 展示结果:

#会议号: <会议号>

✅ 会议创建成功!

📅 <会议标题>
🕐 时间: <开始时间>，时长 <时长>
🔗 会议链接: <会议链接>

工作流 2: 带邀请人 + 地点 + 描述创建

用户意图: "帮我约一个明天下午3点的会议，主题是技术方案评审，邀请张三和李四，地点在3楼会议室，时长1小时"

步骤:

1. 解析用户意图: 有邀请人，需先查询通讯录获取 userid。 2. 通讯录查询: 调用 wecomcli-contact 技能获取通讯录成员，按姓名筛选出参与者的 userid。

wecom-cli contact get_userlist '{}'

在返回的 userlist 中筛选 name 包含 "张三" 和 "李四" 的成员，获取其 userid。

3. 信息已充分，直接调用创建命令 (禁止暴露内部 ID):

wecom-cli meeting create_meeting '{"title": "技术方案评审", "meeting_start_datetime": "2026-03-18 15:00", "meeting_duration": 3600, "location": "3楼会议室", "invitees": {"userid": ["zhangsan", "lisi"]}}'

4. 展示结果:

#会议号: <会议号>

✅ 会议创建成功!

📅 <会议标题>
🕐 时间: <开始时间>，时长 <时长>
👥 参与人: <参与者姓名列表>
🔗 会议链接: <会议链接>

---

工作流 3: 查询会议列表

示例: 用户说 "帮我查一下本周有哪些会议"

步骤:

1. 确定时间范围: 根据当前日期计算本周的起止时间。 2. 查询会议 ID 列表:

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

3. 逐个查询会议详情 (对返回的每个 meetingid):

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

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

4. 汇总展示:

📋 本周会议列表 (共 3 场):

1. 📅 技术方案评审
   🕐 2026-03-17 10:00 - 11:00
   👥 张三，李四，王五

2. 📅 产品需求沟通
   🕐 2026-03-18 14:00 - 15:00
   👥 赵六，钱七

3. 📅 周五周会
   🕐 2026-03-21 09:00 - 10:00
   👥 全组成员

分页处理: 如果 next_cursor 不为空，使用 cursor 参数继续拉取下一页。

---

工作流 4: 获取会议详情

示例: 用户说 "帮我看下技术方案评审会议的详情"

步骤:

1. 定位会议: 先通过会议列表查询找到目标会议的 meetingid (按关键词匹配)。 2. 查询详情:

wecom-cli meeting get_meeting_info '{"meetingid": "<target_meetingid>"}'

3. 展示结果:

#会议号: <会议号>

📅 <会议标题>

🕐 时间: <开始时间>，时长 <时长>
📍 地点: <会议地点>
📝 描述: <会议描述>
👤 创建者: <创建者姓名>
👥 参与者: <参与者姓名列表>
🔗 会议链接: <会议链接>

---

工作流 5: 根据关键词查找会议

示例: 用户说 "技术评审会议是什么时候?"

查询策略:

1. 确定查询范围: 默认查当日前后 30 天 (接口限制范围)。 2. 拉取会议列表:

wecom-cli meeting list_user_meetings '{"begin_datetime": "2026-02-15 00:00", "end_datetime": "2026-04-16 23:59", "limit": 100}'

3. 逐个查询详情并匹配标题关键词。 4. 找到匹配后停止查询，展示结果:

#会议号: <会议号>

✅ 找到会议: "<会议标题>"

📅 时间: <开始时间>，时长 <时长>
📍 地点: <会议地点>
👥 参与者: <参与者姓名列表>
🔗 会议链接: <会议链接>

5. 未找到处理: 告知用户在前后 30 天范围内未找到匹配会议，请确认会议名称。

---

工作流 6: 取消会议

示例: 用户说 "帮我取消明天的技术方案评审会议"

步骤:

1. 定位会议: 通过 list_user_meetings + get_meeting_info 查询会议列表 + 关键词匹配找到目标会议。 2. 直接执行取消:

wecom-cli meeting cancel_meeting '{"meetingid": "<target_meetingid>"}'

3. 展示结果:

✅ 会议已取消: 技术方案评审

---

工作流 7: 更新会议成员

示例: 用户说 "把王五加到技术方案评审会议里"

步骤:

1. 定位会议: 通过 list_user_meetings + get_meeting_info 查询会议列表 + 匹配找到目标会议。 2. 获取当前受邀成员: set_invite_meeting_members 为全量覆盖，必须先通过 get_meeting_info 获取会议详情，获取现有成员后再合并。 3. 通讯录查询: 调用 wecomcli-contact 技能获取通讯录成员，按姓名筛选出王五的 userid。

wecom-cli contact get_userlist '{}'

在返回的 userlist 中筛选 name 包含 "王五" 的成员，获取其 userid。

4. 合并成员列表: 将现有成员 + 新增成员合并 (全量覆盖)。 5. 执行更新:

wecom-cli meeting set_invite_meeting_members '{"meetingid": "<target_meetingid>", "invitees": [{"userid": "zhangsan"}, {"userid": "lisi"}, {"userid": "wangwu"}]}'

6. 展示结果:

✅ 会议成员已更新: 技术方案评审
👥 当前成员: 张三，李四，王五

---

复杂场景样例

按场景按需加载，避免一次性引入过多无关示例:

---

注意事项

• 信息追问: 缺少时间或主题时，简洁追问用户；未提及邀请人则默认留空
• 通讯录查询: 涉及参与人时，需先通过 wecomcli-contact 技能的 get_userlist 接口获取全量通讯录成员，再按姓名/别名本地筛选匹配出对应的 userid。该接口无入参，返回当前用户可见范围内的成员列表 (含 userid，name，alias)
• 直接创建: 时间 + 主题已知即可直接创建，邀请人有则带上，无则留空；无论信息是一次性提供还是上下文可推断，非必要则均不请求确认，直接创建即可
• 时间格式: 统一使用 YYYY-MM-DD HH:mm 格式
• 会议列表时间范围限制: 仅支持查询当日及前后 30 天内的会议
• 查询详情需两步: 先通过 list_user_meetings 获取会议 ID 列表，再通过 get_meeting_info 逐个获取详情
• 定位会议: 取消会议和更新成员等管理操作需先通过查询定位到目标会议的 meetingid
• 成员更新为全量覆盖: set_invite_meeting_members 传入的列表将替换现有成员列表，需先获取当前成员再合并
• 参与人仅支持企业内成员，不支持外部人员

创建会议 - 全参数综合场景示例

场景 : 高规格会议 (全参数)

用户意图: "帮我创建一个高规格的季度战略会议: 下周一上午9点，时长4小时，邀请全团队，设置密码，开启等候室，开启屏幕水印，全员静音"

{
  "title": "Q2季度战略规划会",
  "meeting_start_datetime": "2026-03-23 09:00",
  "meeting_duration": 14400,
  "description": "Q2季度战略规划，请各部门负责人提前准备汇报材料",
  "location": "总部大会议室",
  "invitees": {
    "userid": ["zhangsan", "lisi", "wangwu", "zhaoliu", "sunqi"]
  },
  "settings": {
    "password": "2026",
    "enable_waiting_room": true,
    "allow_enter_before_host": false,
    "enable_enter_mute": 1,
    "allow_external_user": false,
    "enable_screen_watermark": true,
    "remind_scope": 3,
    "ring_users": {
      "userid": ["zhangsan", "lisi", "wangwu", "zhaoliu", "sunqi"]
    }
  }
}

创建会议 - 响铃提醒场景示例

场景 1: 仅提醒主持人

用户意图: "帮我创建一个会议，只提醒主持人，其他人不要响铃"

{
  "title": "项目启动会",
  "meeting_start_datetime": "2026-03-21 10:00",
  "meeting_duration": 3600,
  "invitees": {
    "userid": ["zhangsan", "lisi"]
  },
  "settings": {
    "remind_scope": 2
  }
}

---

场景 2: 指定部分人响铃 (remind_scope=4)

用户意图: "帮我创建一个会议，只响铃提醒张三和李四，其他人不提醒"

{
  "title": "紧急故障复盘",
  "meeting_start_datetime": "2026-03-18 20:00",
  "meeting_duration": 3600,
  "invitees": {
    "userid": ["zhangsan", "lisi", "wangwu", "zhaoliu"]
  },
  "settings": {
    "remind_scope": 4,
    "ring_users": {
      "userid": ["zhangsan", "lisi"]
    },
    "allow_enter_before_host": true
  }
}

创建会议 - 安全设置场景示例

场景 : 会议密码 + 等候室 + 主持人设置

用户意图: "帮我创建一个重要的客户汇报会议，需要设置密码1234，开启等候室，不允许外部人员入会"

{
  "title": "客户汇报会议",
  "meeting_start_datetime": "2026-03-19 14:00",
  "meeting_duration": 5400,
  "invitees": {
    "userid": ["zhangsan", "lisi", "wangwu"]
  },
  "settings": {
    "password": "1234",
    "enable_waiting_room": true,
    "allow_enter_before_host": false,
    "allow_external_user": false
  }
}

获取会议详情 (get_meeting_info) - 返回参数

返回参数

{
  "errcode": 0,
  "errmsg": "ok",
  "creator_userid": "创建者userid",
  "admin_userid": "会议管理userid (与 creator_userid 有且仅返回一个)",
  "title": "会议标题",
  "meeting_start_datetime": "YYYY-MM-DD HH:mm",
  "meeting_duration": "会议时长秒数",
  "description": "会议描述文本",
  "location": "会议地点文本",
  "main_department": "创建者主部门ID",
  "status": "会议状态枚举值",
  "meeting_type": "会议类型枚举值",
  "attendees": {
    "member": [
      {
        "userid": "内部成员userid",
        "status": "与会状态枚举值",
        "first_join_datetime": "YYYY-MM-DD HH:mm",
        "last_quit_datetime": "YYYY-MM-DD HH:mm",
        "total_join_count": "加入次数",
        "cumulative_time": "累计在会时长秒数"
      }
    ],
    "tmp_external_user": [
      {
        "tmp_external_userid": "外部临时用户ID",
        "status": "与会状态枚举值",
        "first_join_datetime": "YYYY-MM-DD HH:mm",
        "last_quit_datetime": "YYYY-MM-DD HH:mm",
        "total_join_count": "加入次数",
        "cumulative_time": "累计在会时长秒数"
      }
    ]
  },
  "settings": {
    "remind_scope": "提醒范围枚举值",
    "need_password": "是否需要密码布尔值",
    "password": "会议密码",
    "enable_waiting_room": "是否启用等候室布尔值",
    "allow_enter_before_host": "是否允许提前入会布尔值",
    "enable_enter_mute": "入会静音枚举值",
    "allow_unmute_self": "是否允许自我解除静音布尔值",
    "allow_external_user": "是否允许外部用户布尔值",
    "enable_screen_watermark": "是否开启水印布尔值",
    "watermark_type": "水印类型枚举值",
    "auto_record_type": "录制类型枚举字符串",
    "attendee_join_auto_record": "参会者加入自动录制布尔值",
    "enable_host_pause_auto_record": "主持人可暂停录制布尔值",
    "enable_doc_upload_permission": "允许上传文档布尔值",
    "enable_enroll": "是否开启报名布尔值",
    "enable_host_key": "是否启用主持人密钥布尔值",
    "host_key": "主持人密钥字符串",
    "hosts": {"userid": ["主持人userid列表"]},
    "current_hosts": {"userid": ["当前主持人userid列表"]},
    "co_hosts": {"userid": ["联席主持人userid列表"]},
    "ring_users": {"userid": ["响铃用户userid列表"]}
  },
  "meeting_code": "会议号码字符串",
  "meeting_link": "会议链接URL",
  "has_vote": "是否有投票布尔值",
  "has_more_sub_meeting": "是否还有更多子会议枚举值",
  "remain_sub_meetings": "剩余子会议场数",
  "current_sub_meetingid": "当前子会议ID",
  "guests": [
    {
      "area": "国际区号",
      "phone_number": "手机号字符串",
      "guest_name": "嘉宾姓名"
    }
  ],
  "reminders": {
    "is_repeat": "是否周期性枚举值",
    "repeat_type": "重复类型枚举值",
    "repeat_until_type": "结束类型枚举值",
    "repeat_until_count": "限定次数",
    "repeat_until_datetime": "YYYY-MM-DD HH:mm",
    "repeat_interval": "重复间隔数值",
    "is_custom_repeat": "是否自定义重复枚举值",
    "repeat_day_of_week": ["星期几数组"],
    "repeat_day_of_month": ["日期数组"],
    "remind_before": ["提醒秒数数组"]
  },
  "sub_meetings": [
    {
      "sub_meetingid": "子会议ID",
      "status": "子会议状态枚举值",
      "start_datetime": "YYYY-MM-DD HH:mm",
      "end_datetime": "YYYY-MM-DD HH:mm",
      "title": "子会议标题",
      "repeat_id": "周期性会议分段ID"
    }
  ],
  "sub_repeat_list": [
    {
      "repeat_id": "周期性会议分段ID",
      "repeat_type": "重复类型枚举值",
      "repeat_until_type": "结束类型枚举值",
      "repeat_until_count": "限定次数",
      "repeat_until_datetime": "YYYY-MM-DD HH:mm",
      "repeat_interval": "重复间隔数值",
      "is_custom_repeat": "是否自定义重复枚举值",
      "repeat_day_of_week": ["星期几数组"],
      "repeat_day_of_month": ["日期数组"]
    }
  ]
}

关键返回字段