安装
npx skills add https://github.com/wecomteam/wecom-cli --skill wecomcli-get-meeting
- 企业微信会议查询技能
- wecom-cli
- 是企业微信提供的命令行程序，所有操作通过执行
- wecom-cli
- 命令完成。
- 概述
- wecomcli-get-meeting 提供企业微信会议查询能力, 包含以下功能:
- 查询会议列表
- - 按用户和时间范围查询会议 ID 列表 (限制: 当日及前后 30 天, 上限 100 个)
- 获取会议详情
- - 通过会议 ID 查询完整会议信息
- 命令调用方式
- 执行指定命令：
- wecom-cli meeting
- <
- tool_name
- >
- ''
- 命令详细说明
- 1. 查询会议列表 (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
- 下一页游标, 为空表示无更多数据
- 2. 获取会议详情 (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
- 返回参数
- {
- "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"
- :
- [
- 日期数组
- ]
- }
- ]
- }
- 关键返回字段:
- 字段
- 类型
- 说明
- creator_userid
- string
- 创建者 userid, 与
- admin_userid
- 有且仅返回一个
- admin_userid
- string
- 会议管理 userid, 与
- creator_userid
- 有且仅返回一个
- title
- string
- 会议标题
- meeting_start_datetime
- string
- 会议开始时间
- meeting_duration
- integer
- 会议时长 (秒)
- main_department
- integer
- 创建者所属主部门
- status
- integer
- 会议状态 (1: 待开始, 2: 会议中, 3: 已结束, 4: 已取消, 5: 已过期)
- meeting_type
- integer
- 会议类型 (0: 一次性会议, 1: 周期性会议, 2: 微信专属会议, 3: Rooms 投屏会议, 5: 个人会议号会议, 6: 网络研讨会)
- meeting_code
- string
- 会议号码
- meeting_link
- string
- 会议链接
- attendees.member
- array
- 内部参与者列表
- attendees.member[].status
- integer
- 与会状态 (1: 已参与, 2: 未参与)
- attendees.tmp_external_user
- array
- 外部参与者 (临时 ID)
- attendees.tmp_external_user[].status
- integer
- 与会状态 (1: 已参与, 2: 未参与)
- guests
- array
- 外部嘉宾列表, 每项含
- area
- ,
- phone_number
- ,
- guest_name
- current_sub_meetingid
- string
- 当前子会议 ID
- settings.ring_users
- object
- 响铃用户列表
- settings.need_password
- boolean
- 是否需要密码 (只读字段)
- settings.enable_doc_upload_permission
- boolean
- 是否允许成员上传文档
- settings.hosts
- object
- 主持人列表
- settings.current_hosts
- object
- 当前主持人列表
- settings.co_hosts
- object
- 联席主持人列表
- reminders
- object
- 周期性配置
- has_vote
- boolean
- 是否有投票 (仅会议创建人和主持人有权限查询)
- has_more_sub_meeting
- integer
- 是否还有更多子会议特例 (0: 无更多, 1: 有更多)
- remain_sub_meetings
- integer
- 剩余子会议场数
- sub_meetings
- array
- 子会议列表
- sub_meetings[].status
- integer
- 子会议状态 (0: 默认/存在, 1: 已删除)
- sub_meetings[].repeat_id
- string
- 周期性会议分段 ID, 用于关联子会议所属分段
- sub_repeat_list
- array
- 周期性会议分段信息, 修改周期性会议某一场后可能产生不同分段, 各分段有不同重复规则
- 典型工作流
- 工作流 1: 查询会议列表
- 示例
-
- 用户说 "帮我查一下本周有哪些会议"
- 步骤:
- 确定时间范围
-
- 根据当前日期计算本周的起止时间.
- 查询会议 ID 列表
- :
- wecom-cli meeting list_user_meetings
- '{"begin_datetime": "2026-03-16 00:00", "end_datetime": "2026-03-22 23:59", "limit": 100}'
- 逐个查询会议详情
- (对返回的每个 meetingid):
- wecom-cli meeting get_meeting_info
- '{"meetingid": "<会议id1>"}'
- wecom-cli meeting get_meeting_info
- '{"meetingid": "<会议id2>"}'
- 汇总展示
- :
- 📋 本周会议列表 (共 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
- 参数继续拉取下一页.
- 工作流 2: 获取会议详情
- 示例
-
- 用户说 "帮我看下技术方案评审会议的详情"
- 步骤:
- 定位会议
- 先通过会议列表查询找到目标会议的 meetingid (按关键词匹配).
查询详情
:
wecom-cli meeting get_meeting_info
'{"meetingid": ""}'
展示结果
:
会议号: <会议号>
- 📅 <会议标题>
- 🕐 时间: <开始时间>, 时长 <时长>
- 📍 地点: <会议地点>
- 📝 描述: <会议描述>
- 👤 创建者: <创建者姓名>
- 👥 参与者: <参与者姓名列表>
- 🔗 会议链接: <会议链接>
- 工作流 3: 根据关键词查找会议
- 示例
-
- 用户说 "技术评审会议是什么时候?"
- 查询策略:
- 确定查询范围
- 默认查当日前后 30 天 (接口限制范围).
拉取会议列表
:
wecom-cli meeting list_user_meetings
'{"begin_datetime": "2026-02-15 00:00", "end_datetime": "2026-04-16 23:59", "limit": 100}'
逐个查询详情并匹配标题关键词
.
找到匹配后停止查询, 展示结果
:
会议号: <会议号>
- ✅ 找到会议: "<会议标题>"
- 📅 时间: <开始时间>, 时长 <时长>
- 📍 地点: <会议地点>
- 👥 参与者: <参与者姓名列表>
- 🔗 会议链接: <会议链接>
- 未找到处理
-
- 告知用户在前后 30 天范围内未找到匹配会议, 请确认会议名称.
- 注意事项
- 时间格式
-
- 统一使用
- YYYY-MM-DD HH:mm
- 格式
- 会议列表时间范围限制
-
- 仅支持查询当日及前后 30 天内的会议
- 查询详情需两步
- 先通过
list_user_meetings
获取会议 ID 列表, 再通过
get_meeting_info
逐个获取详情
← 返回排行榜