企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
会议
预约会议高级管理
获取实时会中成员列表
获取实时会中成员列表
最后更新:2023/04/25

获取当前会中成员列表,仅包括会中的成员。如果成员已离会,则不返回。

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

请求包体:

{
	"meetingid":"meetingid11234",
	"sub_meetingid":"submeetingid11111",
	"cursort":"NGIEMG",
	"limit":50
}

参数说明:

参数必须类型说明
access_tokenstring调用接口凭证。获取方法查看“获取access_token
meetingidstring会议id
sub_meetingidstring周期性会议子会议 ID。
说明:可通过查询成员的会议列表、查询会议接口获取返回的子会议 ID,即 current_sub_meeting_id。如果是周期性会议,此参数必传。
cursorstring分页查询用,将上一个请求返回的next_cursor字段传入。第一次查询时可不传值
limituint32单次查询返回的数量,最大50条。
注意:
limit参数必须与首次调用获得cursor时传入的limit一致。

权限说明

  • 仅配置在“可调用接口的应用”列表中的自建应用可调用
  • 仅允许获取该应用创建的会议的数据
  • 仅返回在应用可见范围内的成员

 

返回结果:

{
	"errcode": 0,
	"errmsg": "ok",
	"status": "1",
	"has_more": true,
	"next_cursor": "JGIEGNOE",
	"attendees": [{
		"userid": "lisi",
		"tmp_openid": "111111",
		"join_time": "166666666",
		"instance_id": 1,
		"role": 0,
		"join_type": 0,
		"audio_state": true,
		"video_state":true,
		"screen_shared_state": true
	}]
}

 

参数说明

参数类型说明
errcodeint32返回码
errmsgstring对返回码的文本描述内容
has_morebool是否还有更多的成员列表
next_cursorstring分页用,下一次拉取列表将该字段填入cursor字段
attendeesobject[]参会人列表,详见Attendee

 

Attendee说明

参数类型说明
useridstring企业内参会成员userid
tmp_useridstring外部联系人临时ID
join_timestring参会者加入会议时间戳(单位秒)。
instance_iduint32成员的终端设备类型:
0:PSTN
1:PC
2:Mac
3:Android
4:iOS
5:Web
6:iPad
7:Android Pad
8:小程序
9:voip、sip 设备(即MRA设备)
10:linux
20:Rooms for Touch Windows
21:Rooms for Touch MacOS
22:Rooms for Touch Android
30:Controller for Touch Windows
32:Controller for Touch Android
33:Controller for Touch iOS/iPadOS
roleuint32成员角色:
0:普通成员角色
1:创建者角色
2:主持人
3:创建者+主持人
4:游客
5:游客+主持人
6:联席主持人
7:创建者+联席主持人
join_typeuint32入会方式:
0:PSTN 普通用户,标准的手机或固话类型
1:普通 VOIP 用户
2:附属投屏 VOIP
3:linux sdk for VOIP
4:附属语音 PSTN
5:附属视频 PSTN
6:linux sdk for PSTN
audio_statebool麦克风状态:
true:开启
false:关闭
video_statebool摄像头状态:
true:开启
false:关闭
screen_shared_statebool屏幕共享状态:
true:开启
false:关闭
上一篇获取用户专属参会链接
下一篇获取已参会成员列表
    本节内容
服务端API
基础
连接微信
办公
会议
会议统计管理
客户端API
小程序
基础
连接微信
办公
WECOM-JSSDK
JS-SDK
基础
连接微信
办公
更新日志
联系我们