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

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

请求方式： 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": {
		"remind_scope": 1,
		"password": "1234",
		"enable_waiting_room": false,
		"allow_enter_before_host": true,
		"enable_enter_mute": 1,
		"allow_external_user": false,
		"enable_screen_watermark": false,
		"hosts": {
			"userid": ["lisi", "wangwu"]
		},
		"ring_users": {
			"userid": ["zhangsan", "lis"]
		}
	},
	"cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA",
	"reminders": {
		"is_repeat": 1,
		"repeat_type": 0,
		"repeat_until": 1606976813,
		"repeat_interval": 1,
		"remind_before": [0, 900]
	}
}

参数说明：

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

Settings说明：

参数必须说明
password否入会密码，仅可输入4-6位纯数字
enable_waiting_room否是否开启等候室。true:开启等候室；false:不开启等候室；默认不开
allow_enter_before_host否是否允许成员在主持人进会前加入。true:允许；false:不允许。默认允许
remind_scope否会议开始时来电提醒方式，1.不提醒 2.仅提醒主持人 3.提醒所有成员入 4.指定部分成员响铃。默认提醒所有成员
enable_enter_mute否成员入会时静音；1:开启；0:关闭；2:超过6人后自动开启静音。默认超过6人自动开启静音
allow_external_user否true:所有成员可入会；false:仅企业内部成员可入会 。默认所有成员可入会
enable_screen_watermark否是否开启屏幕水印，true:开启；false:不开启。默认不开启
hosts否会议主持人人列表，主持人员最多10个。若包含ceaater_userid,会自动过滤。任何userid不合法，直接报错。
hosts.userid否企业成员userid
ring_users否指定响铃的成员列表。如果remind_scope为4，但是ring_users为空，则全部成员均不响铃。
ring_users.userid否指定响铃成员的userid

 

Reminders说明：

参数必须说明
is_repeat否是否是周期性会议，1：周期性会议 0：非周期性会议。默认为0
repeat_type否周期性会议重复类型，0.每天；1.每周；2.每月；7.每个工作日。默认为0。周期性会议该字段才生效
repeat_until否重复结束时刻。周期性会议该字段才生效。若会议结束时间超出最大结束时间或者未设置，则默认设置为最大结束时间。每天\每个工作日\每周 最多重复200次会议；每两周\每月最多重复50次会议
repeat_interval否重复间隔。目前仅当repeat_type为1时，即周期为周时，支持设置该字段，且值不能大于2。
remind_before否指定会议开始前多久提醒成员，相对于meeting_start前的秒数，默认不提醒。目前仅支持 0：会议开始时提醒；300:5分钟前提醒；900:15分钟前提醒；3600:一小时前提醒；86400一天前提醒。若指定了非支持的值，则表现为会议开始时提醒

 

权限说明：

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

返回结果：

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

参数说明：

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