Wecomcli Meeting

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

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

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

```json
{
  "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: 仅提醒主持人

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

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

---

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

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

```json
{
  "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，开启等候室，不允许外部人员入会"

```json
{
  "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) - 返回参数

## 返回参数

```json
{
  "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": "手机号字符串