企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
会议
预约会议高级管理
获取会议详情
获取会议详情
最后更新:2024/06/13

该接口用于获取指定会议的详情内容。

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

请求包体:

{
   "meetingid": "XXXXXXXXX",
   "meeting_code":"meetingcodexxx"
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证。获取方法查看“获取access_token
meetingidstring会议id。注意:meetingid和meeting_code必须填一个
meeting_codestring入会码。注意:meetingid和meeting_code必须填一个

权限说明:

  • 只能拉取该应用创建的会议
  • 自建应用需要配置在“可调用接口的应用”列表

返回结果:

{
	"errcode": 0,
	"errmsg": "ok",
	"admin_userid": "zhangsan",
	"title": "title",
	"meeting_start": 1600000007,
	"meeting_duration": 1800,
	"description": "test meeting description",
	"location": "广州媒体港",
	"main_department": 1,
	"status": 1,
	"meeting_type": 1,
	"attendees": {
		"member": [{
			"userid": "lisi",
			"status": 1,
			"first_join_time": 166666666,
			"last_quit_time": 166666666,
			"total_join_count": 5,
			"cumulative_time": 300
		}, {
			"userid": "zhangsan",
			"status": 2,
			"first_join_time": 166666666,
			"last_quit_time": 166666666,
			"total_join_count": 5,
			"cumulative_time": 300
		}],
		"tmp_external_user": [{
			"tmp_external_userid": "woabc",
			"status": 3,
			"first_join_time": 166666666,
			"last_quit_time": 166666666,
			"total_join_count": 5,
			"cumulative_time": 300
		}, {
			"tmp_external_userid": "woefd",
			"status": 4,
			"first_join_time": 166666666,
			"last_quit_time": 166666666,
			"total_join_count": 5,
			"cumulative_time": 300
		}]
	},
	"settings": {
		"remind_scope": 4,
		"need_password": true,
		"password": "1234",
		"enable_waiting_room": false,
		"allow_enter_before_host": true,
		"enable_enter_mute": 1,
		"enable_enter_mute_type": 2,
		"allow_unmute_self": true,
		"allow_external_user": false,
		"enable_screen_watermark": false,
		"watermark_type": 1,
		"auto_record_type": "none",
		"participant_join_auto_record": false,
		"enable_host_pause_auto_record": false,
		"enable_doc_upload_permission": true,
		"enable_enroll": true,
		"enable_host_key": true,
		"host_key": "meetinghostkey",
		"hosts": {
			"userid": ["lisi", "wangwu"]
		},
		"current_hosts": {
			"userid": ["wangwu", "lisi"]
		},
		"co_hosts": {
			"userid": ["zhangsan", "lisi"]
		},
		"ring_users": {
			"userid": ["zhangsan", "lis"]
		}
	},
	"cal_id": "wcjgewCwAAqeJcPI1d8Pwbjt7nttzAAA",
	"reminders": {
		"is_repeat": 1,
		"repeat_type": 0,
		"repeat_until_type": 1,
		"repeat_until_count": 10,
		"repeat_until": 1606976813,
		"repeat_interval": 1,
		"is_custom_repeat": 1,
		"repeat_day_of_week": [3, 7],
		"repeat_day_of_month": [10, 21],
		"remind_before": [0, 900]
	},
	"meeting_code": "123456789",
	"meeting_link": "https://wecomm.com/znigeot",
	"has_vote": true,
	"has_more_sub_meeting": 1,
	"remain_sub_meetings": 2,
	"current_sub_meetingid": "cursubmeetingid",
	"sub_meetings": [{
		"sub_meetingid": "sub_meetingid",
		"status": 0,
		"start_time": 16888888888,
		"end_time": 179888888888,
		"title": "子会议标题",
		"repeat_id": "123-cjig-gmeihue"
	}],
	"guests": [{
		"area": "86",
		"phone_number": "135123454321",
		"guest_name": "lisi"
	}],
	"sub_repeat_list": [{
		"repeat_id": "jmbioe-1249021-bmjg",
		"repeat_type": 0,
		"repeat_until_type": 1,
		"repeat_until_count": 10,
		"repeat_until": 1606976813,
		"repeat_interval": 1,
		"is_custom_repeat": 1,
		"repeat_day_of_week": [3, 7],
		"repeat_day_of_month": [10, 21]
	}]
}

参数说明:

参数类型说明
errcodeint32返回码
errmsgstring对返回码的文本描述内容
admin_useridstring会议管理员的userId
titlestring会议的标题,最大40个字节
meeting_startuint32会议开始时间的unix时间戳
meeting_durationuint32会议时长
descriptionstring会议的描述,最大600字节
locationstring会议地点,最多128个字符
main_departmentuint32发起人所在部门
statusuint32会议的状态。
1:待开始
2:会议中
3:已结束
4:已取消
5:已过期
meeting_typeuint32会议类型。
0:一次性会议
1:周期性会议
2:微信专属会议
3:Rooms 投屏会议
5:个人会议号会议
6:网络研讨会
attendeesobject[]参会成员。
attendees.memberobject企业内部成员
attendees.member.useridstring企业内部成员的userid
attendees.member.statusuint32与会状态。
1为已参与
2为未参与。
attendees.member.first_join_timeuint32参会人首次加入会议时间的unix时间戳
attendees.member.last_quit_timeuint32参会人最后一次离开会议时间的unix时间戳
attendees.member.total_join_countuint32参会人入会次数
attendees.member.cumulative_timeuint32参会人累计参会时长,单位为秒
attendees.tmp_external_userobject会中参会的外部联系人
注意:微信入会的用户不会返回
attendees.tmp_external_user.tmp_external_useridstring会中入会的外部用户临时id。同一个用户在不同会议中返回的该id不一致。
attendees.tmp_external_user.statusuint32与会状态。
1为已参与
2为未参与
attendees.tmp_external_user.first_join_timeuint32参会人首次进入会议时间的unix时间戳
attendees.tmp_external_user.last_quit_timeuint32参会人最后一次离开会议时间的unix时间戳
attendees.tmp_external_user.total_join_countuint32参会人入会次数
attendees.tmp_external_user.cumulative_timeuint32参会人累计参会时长,单位为秒
guestsobject会议嘉宾列表,详见Guest
settingsobject会议配置,详见Settings
remindersobject重复会议相关配置,详见Reminders
meeting_codestring会议号
meeting_linkstring入会链接
has_votebool是否有投票(会议创建人和主持人才有权限查询)。
sub_meetingsobject周期性子会议列表,详见SubMeeting
has_more_sub_meetinguint32是否还有更多子会议特例。
0:无更多
1:有更多子会议特例
remain_sub_meetingsuint32剩余子会议场数
current_sub_meetingidstring当前子会议ID(进行中/即将开始)
sub_repeat_listobject[]周期性会议分段信息。企业微信客户端可以对周期性会议中某一场子会议进行『修改此会议』和『修改此及后续会议』操作,修改之后会议可能会被分裂成不同的分段,每个分段有不同的重复规则,可以通过该字段获取所有的分段信息,详见SubRepeatInfo

Guest说明:

参数类型说明
areastring国家/地区代码(例如:中国传86,不是+86,也不是0086)。
phone_numberstring手机号。
guest_namestring会议嘉宾姓名。

Settings说明:

参数类型说明
passwordbool入会密码
enable_waiting_roombool是否开启等候室。
true:开启等候室
false:不开启等候室
allow_enter_before_hostbool是否允许成员在主持人进会前加入。
true:允许
false:不允许
remind_scopeuint32会议开始时来电提醒方式。
1:不提醒
2:仅提醒主持人
3:提醒所有成员入
4:指定部分人响铃
enable_enter_muteuint32是否开启成员入会静音选项。
1:开启
0:关闭
2:超过6人后自动开启静音
allow_unmute_selfbool是否允许参会者取消静音。
true:允许
false:不允许
watermark_typeuint32水印样式。
0:单排
1:多排
auto_record_typestring自动会议录制类型。
none:禁用,表示不开启自动会议录制
local:本地录制,表示主持人入会后自动开启本地录制
cloud:云录制,表示主持人入会后自动开启云录制
participant_join_auto_recordbool是否在有参会成员入会时立即开启云录制
enable_host_pause_auto_recordbool是否允许主持人暂停或者停止云录制
enable_doc_upload_permissionbool是否允许成员上传文档
enable_enrollbool是否激活报名。
enable_host_keybool是否开启主持人密钥。
true:开启
false:关闭
host_keystring主持人密钥。
allow_external_userbool是否允许企业外部成员入会。
true:所有成员可入会
false:仅企业内部成员可入会
enable_screen_watermarkbool是否开启屏幕水印。
true:开启
false:不开启
hostsobject会议主持人人列表
hosts.useridstring[]主持人userid
current_hostsobject会议当前主持人列表
current_host.useridstring[]当前主持人userid
co_hostsobject联席主持人列表
co_hosts.useridstring[]联席主持人userid
ring_usersobject指定响铃的成员列表。
ring_users.useridstring[]指定响铃的成员userid

Reminders说明:

参数类型说明
is_repeatuint32是否是周期性会议。
1:周期性会议
0:非周期性会议
repeat_typeuint32重复类型。
0 - 每日
1 - 每周
2 - 每月
7 - 工作日
is_custom_repeatuint32是否自定义重复设置。
0-否
1-是
repeat_intervaluint32周期间隔
该字段随repeat_type不同而含义不同
例如:
repeat_interval指定为3,repeat_type指定为每周重复,那么每3周重复一次;
repeat_interval指定为3,repeat_type指定为每月重复,那么每3个月重复一次
repeat_day_of_weekuint32[]每周周几重复
取值范围:1 ~ 7,分别表示周一至周日
repeat_day_of_monthuint32[]每月哪几天重复
取值范围:1 ~ 31,分别表示1~31号
repeat_until_typeuint32周期性会议结束类型。
0:按日期结束重复
1:按次数结束重复
repeat_until_countuint32周期会议限定次数
repeat_untiluint32周期会议结束时刻。repeat_until_type=0时该字段才返回
remind_beforeuint32[]会议开始前多久提醒成员,相对于meeting_start前的秒数。
0:会议开始时提醒
300:5分钟前提醒
900:15分钟前提醒
3600:一小时前提醒
86400:一天前提醒

SubMeeting:

参数类型说明
sub_meetingidstring子会议 ID。
statusuint32子会议状态。
0:默认(存在)
1:已删除
start_timeuint32子会议开始时间(UTC 秒)
end_timeuint32子会议结束时间(UTC 秒)
titlestring子会议标题
repeat_idstring周期性会议分段ID,通过该字段可以关联子会议所属的分段

SubRepeatInfo:

参数类型说明
repeat_idstring分段ID
repeat_typeuint32重复类型。
0 - 每日
1 - 每周
2 - 每月
7 - 工作日
is_custom_repeatuint32是否自定义重复设置。
0-否
1-是
repeat_intervaluint32周期间隔
该字段随repeat_type不同而含义不同
例如:
repeat_interval指定为3,repeat_type指定为每周重复,那么每3周重复一次;
repeat_interval指定为3,repeat_type指定为每月重复,那么每3个月重复一次
repeat_day_of_weekuint32[]每周周几重复
取值范围:1 ~ 7,分别表示周一至周日
repeat_day_of_monthuint32[]每月哪几天重复
取值范围:1 ~ 31,分别表示1~31号
repeat_until_typeuint32周期性会议结束类型。
0:按日期结束重复
1:按次数结束重复
repeat_until_countuint32分段的重复截止次数,repeat_until_type=1时返回
repeat_untiluint32分段的重复截止时间,repeat_until_type=0时该字段才返回
上一篇取消预约会议
下一篇获取会议受邀成员列表
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们