开发者中心
首页
教程
接口
社区
工具
企业内部开发
快速入门 服务端API 客户端API 附录 更新日志 联系我们
企业内部开发 服务端API 会议 预约会议高级管理 修改预约会议
修改预约会议
最后更新：2023/11/14
可联系渠道经理采购或代理智慧硬件接口已支持设备 联系渠道经理
修改预约会议
最后更新：2023/11/14

该接口用于修改一个指定的预约会议。

请求方式： POST（HTTPS）
请求地址： https://qyapi.weixin.qq.com/cgi-bin/meeting/update?access_token=ACCESS_TOKEN

请求包体：

{
	"meetingid": "hyxxx",
	"title": "新建会议",
	"meeting_start": 1600000000,
	"meeting_duration": 3600,
	"description": "新建会议描述",
	"location":"广州媒体港",
	"invitees": {
		"userid": ["lisi", "wangwu"]
	},
	"settings": {
		"password": "1234",
		"enable_waiting_room": false,
		"allow_enter_before_host": true,
		"enable_enter_mute": 1,
		"allow_unmute_self":true,
		"mute_all":false,
		"allow_external_user": false,
		"enable_screen_watermark": false,
		"watermark_type":1,
		"auto_record_type":"none",
		"attendee_join_auto_record":false,
		"enable_host_pause_auto_record":false,
		"enable_enroll":true,
		"enable_host_key":true,
		"host_key":"meetinghostkey",
		"hosts": {
			"userid": ["lisi", "wangwu"]
		},
		"remind_scope": 4,
		"ring_users": {
			"userid": ["zhangsan", "lis"]
		}
	},
	"cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA",
	"reminders": {
		"is_repeat": 1,
		"repeat_type": 0,
		"is_custom_repeat":1,
		"repeat_until_type":1,
		"repeat_until_count":10,
		"repeat_until": 1606976813,
		"repeat_interval": 1,
		"repeat_day_of_week": [3, 7],
		"repeat_day_of_month": [10, 21],
		"remind_before": [0, 900]
	}
}

参数说明：

参数必须类型说明
access_token是string调用接口凭证。获取方法查看“获取access_token”
meetingid是string会议id，仅允许修改预约状态下的会议
title否string会议的标题（1~255位字符长度）
meeting_start否uint32会议开始时间的unix时间戳。需大于当前时间。
注意：修改该字段时必须同时指定meeting_duration
meeting_duration否uint32会议持续时间单位秒，最小300秒 。
注意：修改该字段时，必须同时指定meeting_start
description否string会议的描述，最多支持500个字节或者utf8字符
location否string会议地点。最长支持18个汉字或36个英文字母。
invitees否object参与会议的成员。会议人数上限，以指定的「管理员」可预约的人数上限来校验，普通企业与会人员最多100；付费企业根据企业选购的在线会议室容量，但最多不能超过300人，若超过300人请调用更新会议受邀成员列表接口。任何userid不合法或者不在应用可见范围，直接报错。
invitees.userid否userid参与会议的企业成员userid
cal_id否string会议所属日历ID。该日历必须是access_token所对应应用所创建的日历。
注意，若参与人在日历分享范围内，则插入到该日历（同时会插入会议参与人的默认日历），若不在分享范围内，否则仅插入到参与者默认日历；
如果不填，那么插入到参与者的默认日历上。
第三方应用必须指定cal_id
不多于64字节
settings否object会议配置，详见Settings
reminders否object重复会议相关配置，详见Reminders

Settings说明：

参数必须类型说明
password否string入会密码，仅可输入4-6位纯数字
enable_waiting_room否bool是否开启等候室。
true：开启等候室
false：不开启等候室
allow_enter_before_host否bool是否允许成员在主持人进会前加入。
true：允许
false：不允许
enable_enter_mute否uint32成员入会时静音选项。
1：开启
0：关闭
2：超过6人后自动开启静音
allow_unmute_self否bool允许参会者取消静音。
true：允许
false：不允许
mute_all否bool是否全体静音。该字段单独使用不生效，当设置allow_unmute_self为false时，需要指定mute_all=true
watermark_type否uint32水印样式，默认为单排。
0：单排
1：多排
auto_record_type否string自动会议录制类型。
none：禁用，表示不开启自动会议录制
local：本地录制，表示主持人入会后自动开启本地录制
cloud：云录制，表示主持人入会后自动开启云录制。
attendee_join_auto_record否bool是否在有参会成员入会时立即开启云录制。
关闭时，主持人入会自动开启云录制
开启时，有参会成员入会自动开启云录制
enable_host_pause_auto_record否bool是否允许主持人暂停或者停止云录制。
允许时，主持人可以暂停和停止云录制
当设置为不允许，则主持人不能暂停和关闭云录制。
enable_enroll否bool是否激活报名
enable_host_key否bool是否开启主持人密钥。
true：开启
false：关闭
host_key否string主持人密钥，仅支持6位数字。如开启主持人密钥后没有填写此项，将自动分配一个6位数字的密钥。
allow_external_user否bool是否允许企业外部成员入会。
true：所有成员可入会
false：仅企业内部成员可入会 。默认所有成员可入会
enable_screen_watermark否bool是否开启屏幕水印。
true：开启
false：不开启
hosts否object会议主持人列表，最多10个。若包含admin_userid会自动过滤。任何userid不合法，直接报错。
hosts.userid否string[]企业成员userid
remind_scope否uint32会议开始时来电提醒方式，1.不提醒 2.仅提醒主持人 3.提醒所有成员入 4.指定部分人响铃。默认仅提醒主持人
ring_users否object指定响铃的成员列表。如果remind_scope为4，但是ring_users为空，则全部成员均不响铃。
ring_users.userid否string[]指定响铃的成员userid

Reminders说明：

参数必须类型说明
is_repeat否uint32周期性会议设置。
1：周期性会议
0：非周期性会议
repeat_type否uint32重复类型，当is_repeat为1时有效。目前支持如下类型：
0 - 每日
1 - 每周
2 - 每月
7 - 工作日
当指定为自定义重复时，仅能选择按每日、每周或者每月重复
is_custom_repeat否uint32是否自定义周期性会议重复设置。
0：否
1：是
当is_repeat为1时有效
repeat_interval否uint32重复间隔
当指定为自定义重复时必填
该字段随repeat_type不同而含义不同
例如：
repeat_interval指定为3，repeat_type指定为每周重复，那么每3周重复一次；
repeat_interval指定为3，repeat_type指定为每月重复，那么每3个月重复一次
repeat_day_of_week否uint32[]每周周几重复
仅当指定为自定义重复且重复类型为每周时有效
取值范围：1 ~ 7，分别表示周一至周日。
注意：自定义按周重复时，会议开始时间对应的那天需要包含在该数组中。例如：开始时间是周一，则该数组需要包含1，如果开发者没有指定，后台会补上
repeat_day_of_month否uint32[]每月哪几天重复
仅当指定为自定义重复且重复类型为每月时有效
取值范围：1 ~ 31，分别表示1~31号。
注意：自定义按月重复时，会议开始时间对应的那天需要包含在该数组中。例如：开始时间是某月1号，则该数组需要包含1，如果开发者没有指定，后台会补上
repeat_until_type否uint32结束重复类型，默认值为0。0：按日期结束重复；1：按次数结束重复
repeat_until_count否uint32周期会议限定次数。
说明：
1-每天、每个工作日、每周最大支持200场子会议
2-每月最大支持50场子会议
repeat_until否uint32周期会议结束时刻。repeat_until_type=0时该字段才生效。若会议结束时间超出最大结束时间或者未设置，则默认设置为最大结束时间。每天\每个工作日\每周 最多重复200次会议；每月最多重复50次会议
remind_before否uint32[]指定会议开始前多久提醒成员，相对于meeting_start前的秒数。目前仅支持
0：会议开始时提醒
300：5分钟前提醒
900：15分钟前提醒
3600：一小时前提醒
86400：一天前提醒
若指定了非支持的值，则表现为会议开始时提醒

权限说明：

  • 发起人和企业内部参与人必须在应用可见范围内
  • 仅允许修改当前应用创建的会议
  • 自建应用需要配置在“可调用接口的应用”列表

返回结果：

{
   "errcode": 0,
   "errmsg": "ok",
   "excess_users":["lisi","wangwu"]
}

参数说明：

参数类型说明
errcodeint32返回码
errmsgstring对返回码的文本描述内容
excess_usersstring参会人中包含无效会议账号的userid，仅在购买会议专业版企业由于所购账号不足导致部分参会人无有效会议账号时返回
注：若会议为指定创建者的老会议，修改会议时，则不允许指定应用身份创建的新日历。
上一篇
创建预约会议
下一篇
取消预约会议