wecomcli-edit-meeting

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

企业微信会议管理技能

WeCom Meeting Management Skill

wecom-cli
是企业微信提供的命令行程序,所有操作通过执行
wecom-cli
命令完成。
wecom-cli
is a command-line program provided by WeCom, all operations are completed by executing the
wecom-cli
command.

概述

Overview

wecomcli-edit-meeting 提供企业微信会议管理能力, 包含以下功能:
  1. 取消会议 - 取消指定的预约会议
  2. 更新会议受邀成员 - 修改会议的参与人列表
wecomcli-edit-meeting provides WeCom meeting management capabilities, including the following functions:
  1. Cancel meeting - Cancel a specified scheduled meeting
  2. Update meeting invited members - Modify the participant list of a meeting

命令调用方式

Command Calling Method

调用指定命令:
bash
wecom-cli meeting <tool_name> '<json_params>'

Call the specified command:
bash
wecom-cli meeting <tool_name> '<json_params>'

命令详细说明

Detailed Command Description

1. 取消会议 (cancel_meeting)

1. Cancel meeting (cancel_meeting)

取消指定的预约会议.
Cancel the specified scheduled meeting.

调用命令

Calling Command

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

入参说明

Parameter Description

参数类型必填说明
meetingid
string会议 ID, 通过
wecomcli-get-meeting
技能获取
ParameterTypeRequiredDescription
meetingid
stringYesMeeting ID, obtained through the
wecomcli-get-meeting
skill

返回参数

Return Parameters

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

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

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

2. Update meeting invited members (set_invite_meeting_members)

更新会议的受邀成员列表 (全量覆盖).
Update the invited member list of the meeting (full coverage).

调用命令

Calling Command

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

入参说明

Parameter Description

参数类型必填说明
meetingid
string会议 ID, 通过
wecomcli-get-meeting
技能获取
invitees
array受邀成员列表, 每项包含
userid
字段
注意: invitees 为全量覆盖, 传入的列表将替换现有成员列表. invitees 的 userid 通过
wecomcli-lookup-contact
技能获取
ParameterTypeRequiredDescription
meetingid
stringYesMeeting ID, obtained through the
wecomcli-get-meeting
skill
invitees
arrayNoList of invited members, each item contains the
userid
field
Note: invitees is full coverage, the incoming list will replace the existing member list. The userid of invitees is obtained through the
wecomcli-lookup-contact
skill

返回参数

Return Parameters

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

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

典型工作流

Typical Workflows

工作流 1: 取消会议

Workflow 1: Cancel a meeting

示例: 用户说 "帮我取消明天的技术方案评审会议"
步骤:
  1. 定位会议: 通过
    wecomcli-get-meeting
    技能查询会议列表 + 关键词匹配找到目标会议.
  2. 直接执行取消:
bash
wecom-cli meeting cancel_meeting '{"meetingid": "<target_meetingid>"}'
  1. 展示结果:
✅ 会议已取消: 技术方案评审

Example: User says "Help me cancel tomorrow's technical solution review meeting"
Steps:
  1. Locate the meeting: Query the meeting list through the
    wecomcli-get-meeting
    skill + keyword matching to find the target meeting.
  2. Directly execute cancellation:
bash
wecom-cli meeting cancel_meeting '{"meetingid": "<target_meetingid>"}'
  1. Display result:
✅ Meeting has been canceled: Technical Solution Review

工作流 2: 更新会议成员

Workflow 2: Update meeting members

示例: 用户说 "把王五加到技术方案评审会议里"
步骤:
  1. 定位会议: 通过
    wecomcli-get-meeting
    技能查询会议列表 + 匹配找到目标会议.
  2. 获取当前受邀成员:
    set_invite_members
    为全量覆盖, 必须先通过
    wecomcli-get-meeting
    技能的
    get_meeting_info
    获取会议详情, 获取现有成员后再合并.
  3. 通讯录查询: 调用
    wecomcli-lookup-contact
    技能获取通讯录成员, 按姓名筛选出王五的 userid.
bash
wecom-cli contact get_userlist '{}'
在返回的
userlist
中筛选
name
包含 "王五" 的成员, 获取其
userid
.
  1. 合并成员列表: 将现有成员 + 新增成员合并 (全量覆盖).
  2. 执行更新:
bash
wecom-cli meeting set_invite_meeting_members '{"meetingid": "<target_meetingid>", "invitees": [{"userid": "zhangsan"}, {"userid": "lisi"}, {"userid": "wangwu"}]}'
  1. 展示结果:
✅ 会议成员已更新: 技术方案评审
👥 当前成员: 张三, 李四, 王五

Example: User says "Add Wang Wu to the technical solution review meeting"
Steps:
  1. Locate the meeting: Query the meeting list through the
    wecomcli-get-meeting
    skill + matching to find the target meeting.
  2. Get current invited members:
    set_invite_members
    is full coverage, you must first get the meeting details through the
    get_meeting_info
    of the
    wecomcli-get-meeting
    skill, get the existing members and then merge.
  3. Address book query: Call the
    wecomcli-lookup-contact
    skill to get address book members, filter out Wang Wu's userid by name.
bash
wecom-cli contact get_userlist '{}'
Filter members whose
name
contains "Wang Wu" in the returned
userlist
to get their
userid
.
  1. Merge member list: Merge existing members + new members (full coverage).
  2. Execute update:
bash
wecom-cli meeting set_invite_meeting_members '{"meetingid": "<target_meetingid>", "invitees": [{"userid": "zhangsan"}, {"userid": "lisi"}, {"userid": "wangwu"}]}'
  1. Display result:
✅ Meeting members have been updated: Technical Solution Review
👥 Current members: Zhang San, Li Si, Wang Wu

注意事项

Notes

  • 参与人仅支持企业内成员, 不支持外部人员
  • 通讯录查询: 涉及参与人时, 需先通过
    wecomcli-lookup-contact
    技能的
    get_userlist
    接口获取全量通讯录成员, 再按姓名/别名本地筛选匹配出对应的
    userid
    . 该接口无入参, 返回当前用户可见范围内的成员列表 (含
    userid
    ,
    name
    ,
    alias
    )
  • 定位会议: 管理操作需先通过
    wecomcli-get-meeting
    技能查询到目标会议的 meetingid
  • 成员更新为全量覆盖:
    set_invite_members
    传入的列表将替换现有成员列表, 需先获取当前成员再合并
  • Participants only support internal enterprise members, external personnel are not supported
  • Address book query: When involving participants, you need to first obtain the full address book member list through the
    get_userlist
    interface of the
    wecomcli-lookup-contact
    skill, and then filter and match the corresponding
    userid
    locally by name/alias. This interface has no input parameters and returns the list of members within the current user's visible range (including
    userid
    ,
    name
    ,
    alias
    )
  • Locate meeting: Management operations need to first query the meetingid of the target meeting through the
    wecomcli-get-meeting
    skill
  • Member update is full coverage: The list passed in
    set_invite_members
    will replace the existing member list, you need to get the current members first and then merge