第三方应用开发
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
第三方应用开发
服务端API
会议
获取会议详情
获取会议详情
最后更新:2024/06/13

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

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

请求包体:

{
   "meetingid": "XXXXXXXXX"
}

参数说明:

参数必须说明
access_token调用接口凭证。获取方法查看“获取access_token
meetingid会议id

 

权限说明:

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

返回结果:

{
	"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,
	"agentid": 1000014,
	"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,
		"password": "1234",
		"enable_waiting_room": false,
		"allow_enter_before_host": true,
		"enable_enter_mute": true,
		"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": [5, 10]
	},
	"meeting_code":"123456789",
	"meeting_link":"https://wecomm.com/znigeot"
}

参数说明:

参数说明
errcode返回码
errmsg对返回码的文本描述内容
admin_userid会议管理员的userId
title会议的标题,最大60个字节
meeting_start会议开始时间的unix时间戳
meeting_duration会议时长
description会议的描述,最大600字节
location会议地点,最多128个字符
main_department发起人所在部门
status会议的状态,1:待开始,2:会议中,3:已结束,4:已取消,5:已过期
attendees会议成员。快速会议仅返回已参与成员列表。
attendees.member企业内部成员
attendees.member.userid企业内部成员的userid
attendees.member.status与会状态。1为已参与,2为未参与。
attendees.member.first_join_time参会人首次加入会议时间的unix时间戳
attendees.member.last_quit_time参会人最后一次离开会议时间的unix时间戳
attendees.member.total_join_count参会人入会次数
attendees.member.cumulative_time参会人累计参会时长,单位为秒
attendees.tmp_external_user会中参会的外部联系人
注意:微信入会的用户不会返回
attendees.tmp_external_user.tmp_external_userid会中入会的外部用户临时id。同一个用户在不同会议中返回的该id不一致。
可进一步通过tmp_external_userid的转换接口转换成external_userid,方便识别外部参会人身份。
attendees.tmp_external_user.status与会状态。1为已参与,2为未参与
attendees.tmp_external_user.first_join_time参会人首次进入会议时间的unix时间戳
attendees.tmp_external_user.last_quit_time参会人最后一次离开会议时间的unix时间戳
attendees.tmp_external_user.total_join_count参会人入会次数
attendees.tmp_external_user.cumulative_time参会人累计参会时长,单位为秒
settings会议配置,详见Settings
reminders重复会议相关配置,详见Reminders
meeting_code会议号
meeting_link入会链接

 

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_usertrue:所有成员可入会;false:仅企业内部成员可入会 。默认所有成员可入会
enable_screen_watermark是否开启屏幕水印,true:开启;false:不开启。默认不开启
hosts会议主持人人列表,主持人员最多10个。若包含ceaater_userid,会自动过滤。任何userid不合法,直接报错。
hosts.userid企业成员userid
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为2时,即周期为周时,支持设置该字段,且值不能大于2。
remind_before指定会议开始前多久提醒成员,相对于meeting_start前的秒数,默认不提醒。目前仅支持 0:会议开始时提醒;300:5分钟前提醒;900:15分钟前提醒;3600:一小时前提醒;86400一天前提醒。若指定了非支持的值,则表现为会议开始时提醒
上一篇获取成员会议ID列表
下一篇回调通知
    本节内容
服务端API
基础
数据与智能专区
应用接收专区通知
连接微信
客户联系
办公
小程序接入对外收款
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们