wecomcli-create-meeting

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

企业微信会议创建技能

WeCom Meeting Creation Skill

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

wecom-cli
is a command-line program provided by WeCom, all operations are completed by executing
wecom-cli
commands.

概述

Overview

wecomcli-create-meeting 提供企业微信预约会议的创建能力, 支持设置会议参数, 邀请参与人等.

wecomcli-create-meeting provides the capability to create WeCom scheduled meetings, supporting setting meeting parameters, inviting participants and other functions.

命令调用方式

Command Invocation Method

执行指定命令：

bash

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

Execute the specified command:

bash

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

命令详细说明

Detailed Command Description

创建预约会议 (create_meeting)

Create Scheduled Meeting (create_meeting)

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

Create a scheduled meeting, supporting configuration of meeting parameters and other settings.

执行命令

Execution Command

bash

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

bash

wecom-cli meeting create_meeting '{"title": "<meeting title>", "meeting_start_datetime": "<meeting start time>", "meeting_duration": <meeting duration (seconds)>}'

入参说明

Parameter Description

参数	类型	必填	说明
`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-lookup-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-lookup-contact
技能获取

Parameter	Type	Required	Description
`title`	string	Yes	Meeting title
`meeting_start_datetime`	string	Yes	Meeting start time, format: `YYYY-MM-DD HH:mm`
`meeting_duration`	integer	Yes	Meeting duration (seconds), e.g. 3600 = 1 hour
`description`	string	No	Meeting description
`location`	string	No	Meeting location
`invitees`	object	Yes	Invitees, format: `{"userid": ["lisi", "wangwu"]}`
`settings`	object	No	Meeting settings (see details below)

Invitee userid is obtained through the
wecomcli-lookup-contact
skill

settings field:

Parameter	Type	Description
`password`	string	Meeting password
`enable_waiting_room`	boolean	Whether to enable waiting room
`allow_enter_before_host`	boolean	Whether to allow members to join before the host enters
`enable_enter_mute`	integer	Mute setting when joining the meeting (enum: 0: off, 1: on)
`allow_external_user`	boolean	Whether to allow external users to join the meeting
`enable_screen_watermark`	boolean	Whether to enable screen watermark
`remind_scope`	integer	Reminder scope (1: no reminder, 2: only remind the host, 3: remind all members, 4: ring for designated people, default only remind the host)
`ring_users`	object	Users to ring, format: `{"userid": ["lisi"]}`

Ring user userid is obtained through the
wecomcli-lookup-contact
skill

返回参数

Return Parameters

json

{
  "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, 仅在购买会议专业版企业由于部分参会人无有效会议账号时返回

json

{
  "errcode": 0,
  "errmsg": "ok",
  "meetingid": "meeting ID string",
  "meeting_code": "meeting number string",
  "meeting_link": "meeting link URL",
  "excess_users": ["userid of invalid meeting accounts"]
}

Field	Type	Description
`meetingid`	string	Meeting ID
`meeting_code`	string	Meeting number, when displayed to users, it needs to be shown in a separate plain text line at the beginning of the reply, format `#Meeting number: xxx-xxx-xxx` (separated by `-` every 3 digits)
`meeting_link`	string	Meeting link
`excess_users`	array	Userid of members with invalid meeting accounts among participants, only returned when some participants of enterprises that have purchased the professional version of the meeting service do not have valid meeting accounts

典型工作流

Typical Workflows

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

Workflow 1: Simplest Creation (No Invitees)

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

步骤:

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

bash

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

展示结果:

#会议号: <会议号>

✅ 会议创建成功!

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

User intent: "Help me book a meeting at 3 PM tomorrow, the theme is weekly meeting, duration 1 hour"

Steps:

Parse user intent: Time and theme are already available, if invitees are not mentioned, leave them blank by default and create directly.
Call creation command:

bash

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

Display results:

#Meeting number: <meeting number>

✅ Meeting created successfully!

📅 <Meeting title>
🕐 Time: <Start time>, Duration <Duration>
🔗 Meeting link: <Meeting link>

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

Workflow 2: With Invitees + Location + Description

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

步骤:

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

bash

wecom-cli contact get_userlist '{}'

在返回的

userlist

中筛选

name

包含 "张三" 和 "李四" 的成员, 获取其

userid

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

bash

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

展示结果:

#会议号: <会议号>

✅ 会议创建成功!

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

User intent: "Help me book a meeting at 3 PM tomorrow, the theme is technical solution review, invite Zhang San and Li Si, location is 3rd floor meeting room, duration 1 hour"

Steps:

Parse user intent: There are invitees, you need to query the address book first to get userid.
Address book query: Call the
```
wecomcli-lookup-contact
```
skill to get address book members, filter out the userid of participants by name.

bash

wecom-cli contact get_userlist '{}'

Filter members whose

name

contains "Zhang San" and "Li Si" from the returned

userlist

, and get their

userid

Information is sufficient, call the creation command directly (Do not expose internal IDs):

bash

wecom-cli meeting create_meeting '{"title": "Technical Solution Review", "meeting_start_datetime": "2026-03-18 15:00", "meeting_duration": 3600, "location": "3rd Floor Meeting Room", "invitees": {"userid": ["zhangsan", "lisi"]}}'

Display results:

#Meeting number: <meeting number>

✅ Meeting created successfully!

📅 <Meeting title>
🕐 Time: <Start time>, Duration <Duration>
👥 Participants: <List of participant names>
🔗 Meeting link: <Meeting link>

复杂场景样例

Complex Scenario Examples

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

文件	适用场景
references/example-security.md	会议密码, 等候室, 外部用户限制
references/example-reminder.md	响铃提醒, 指定部分人响铃
references/example-full.md	全参数综合场景 (含静音, 屏幕水印, 等候室等设置)

Load on demand according to scenarios to avoid introducing too many irrelevant examples at one time:

File	Applicable Scenario
references/example-security.md	Meeting password, waiting room, external user restrictions
references/example-reminder.md	Ring reminder, ring for designated people
references/example-full.md	Full parameter comprehensive scenario (including mute, screen watermark, waiting room and other settings)

注意事项

Notes

信息追问: 缺少时间或主题时, 简洁追问用户; 未提及邀请人则默认留空
通讯录查询: 涉及参与人时, 需先通过
```
wecomcli-lookup-contact
```
技能的
```
get_userlist
```
接口获取全量通讯录成员, 再按姓名/别名本地筛选匹配出对应的
```
userid
```
. 该接口无入参, 返回当前用户可见范围内的成员列表 (含
```
userid
```
,
```
name
```
,
```
alias
```
)
直接创建: 时间 + 主题已知即可直接创建, 邀请人有则带上, 无则留空; 无论信息是一次性提供还是上下文可推断, 非必要则均不请求确认, 直接创建即可
时间格式: 统一使用
```
YYYY-MM-DD HH:mm
```
格式

Information follow-up: When time or theme is missing, ask the user concisely; if invitees are not mentioned, leave them blank by default
Address book query: When participants are involved, you need to first obtain the full list of address book members 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 visible range of the current user (including
```
userid
```
,
```
name
```
,
```
alias
```
)
Direct creation: You can create directly when time and theme are known, add invitees if there are any, leave them blank if not; no matter whether the information is provided at one time or can be inferred from the context, do not request confirmation unless necessary, just create directly
Time format: Use
```
YYYY-MM-DD HH:mm
```
format uniformly