登录
基础
连接微信
办公
企业内部开发 服务端API 会议室 会议室管理
会议室管理
最后更新：2023/11/30
目录
权限说明
调用会议室相关接口的应用有如下的权限要求：
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 配置到「应用管理 - 会议室 - 可调用接口的应用」中 |
| 代开发应用 | 暂不支持 |
| 第三方应用 | 暂不支持 |
注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情
添加会议室
企业可通过此接口添加一个会议室。
请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/oa/meetingroom/add?access_token=ACCESS_TOKEN
请求示例：
{
"name":"18F-会议室",
"capacity":10,
"city":"深圳",
"building":"腾讯大厦",
"floor":"18F",
"equipment":[1,2,3],
"coordinate":
{
"latitude":"22.540503",
"longitude":"113.934528"
},
"range":
{
"user_list":["zhangsan","lisi"],
"department_list":[1]
}
}参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| name | 是 | 会议室名称，最多30个字符 |
| capacity | 是 | 会议室所能容纳的人数 |
| city | 否 | 会议室所在城市 |
| building | 否 | 会议室所在楼宇 |
| floor | 否 | 会议室所在楼层 |
| equipment | 否 | 会议室支持的设备列表,参数详细含义见附录 |
| coordinate.latitude | 否 | 会议室所在建筑纬度,可通过腾讯地图坐标拾取器获取 |
| coordinate.longitude | 否 | 会议室所在建筑经度,可通过腾讯地图坐标拾取器获取 |
| range.user_list | 否 | 会议室使用范围的userid列表，最多指定1000个成员 |
| range.department_list | 否 | 会议室使用范围的部门id列表，最多指定1000个部门 |
如果不填写range参数，则默认为全公司可用。
如果需要为会议室设置位置信息，则必须同时填写城市（city），楼宇（building）和楼层(floor)三个参数。
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"meetingroom_id":1
}参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| meetingroom_id | 会议室的id |
查询会议室
企业可通过此接口查询满足条件的会议室。
请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/oa/meetingroom/list?access_token=ACCESS_TOKEN
请求示例：
{
"city":"深圳",
"building":"腾讯大厦",
"floor":"18F",
"equipment":[1,2,3]
}参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| city | 否 | 会议室所在城市 |
| building | 否 | 会议室所在楼宇 |
| floor | 否 | 会议室所在楼层 |
| equipment | 否 | 会议室支持的设备列表,参数详细含义见附录 |
如果需要使用某个位置信息进行查询，则需要保证其上一级的位置信息已填写，即如需使用楼宇进行过滤，则必须同时填写城市字段。
返回结果：
{
"errcode": 0,
"errmsg": "ok",
"meetingroom_list":
[
{
"meetingroom_id":1,
"name":"18F-会议室",
"capacity":10,
"city":"深圳",
"building":"腾讯大厦",
"floor":"18F",
"equipment":[1,2,3],
"coordinate":
{
"latitude":"22.540503",
"longitude":"113.934528"
},
"need_approval":1
},
{
"meetingroom_id":2,
"name":"19F-会议室",
"capacity":20,
"city":"深圳",
"building":"腾讯大厦",
"floor":"19F",
"equipment":[2,3],
"coordinate":
{
"latitude":"22.540503",
"longitude":"113.934528"
},
"range":
{
"user_list":["zhangsan","lisi"],
"department_list":[1]
}
},
]
}参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| meetingroom_list | 满足条件的会议室列表 |
| meetingroom_list.meetingroom_id | 会议室id |
| meetingroom_list.name | 会议室名称 |
| meetingroom_list.capacity | 会议室容纳人数 |
| meetingroom_list.city | 会议室所在城市 |
| meetingroom_list.building | 会议室所在楼宇 |
| meetingroom_list.floor | 会议室所在楼层 |
| meetingroom_list.equipment | 会议室支持的设备列表 |
| meetingroom_list.coordinate.latitude | 会议室所在楼宇的纬度 |
| meetingroom_list.coordinate.longitude | 会议室所在楼宇的经度 |
| meetingroom_list.need_approval | 是否需要审批 0-无需审批 1-需要审批 |
| range.user_list | 会议室使用范围的userid列表（仅会议室系统应用查询时返回） |
| range.department_list | 会议室使用范围的部门id列表，（仅会议室系统应用查询时返回） |
编辑会议室
企业可通过此接口编辑相关会议室的基本信息。
注意，会议室使用范围(range)为覆盖操作，而非增量添加。
请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/oa/meetingroom/edit?access_token=ACCESS_TOKEN
请求示例：
{
"meetingroom_id":2,
"name":"18F-会议室",
"capacity":10,
"city":"深圳",
"building":"腾讯大厦",
"floor":"18F",
"equipment":[1,2,3],
"coordinate":
{
"latitude":"22.540503",
"longitude":"113.934528"
},
"range":
{
"user_list":["zhangsan","lisi"],
"department_list":[1]
}
}参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| meetingroom_id | 是 | 会议室的id |
| name | 否 | 会议室名称，最多30个字符 |
| capacity | 否 | 会议室所能容纳的人数 |
| city | 否 | 会议室所在城市 |
| building | 否 | 会议室所在楼宇 |
| floor | 否 | 会议室所在楼层 |
| equipment | 否 | 会议室支持的设备列表,参数详细含义见附录 |
| coordinate.latitude | 否 | 会议室所在建筑纬度,可通过腾讯地图坐标拾取器获取 |
| coordinate.longitude | 否 | 会议室所在建筑经度,可通过腾讯地图坐标拾取器获取 |
| range.user_list | 否 | 会议室使用范围的userid列表，最多指定1000个成员，填写后将覆盖整个使用范围 |
| range.department_list | 否 | 会议室使用范围的部门id列表，最多指定1000个部门，填写后将覆盖整个使用范围 |
如果需要修改位置信息，请同时输入城市，楼宇和楼层三个参数，已经生成的建筑，暂不支持修改经纬度。
返回结果：
{
"errcode": 0,
"errmsg": "ok",
}参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
删除会议室
企业可通过此接口删除指定的会议室。
请求方式：POST（HTTPS）
请求地址：https://qyapi.weixin.qq.com/cgi-bin/oa/meetingroom/del?access_token=ACCESS_TOKEN
请求示例：
{
"meetingroom_id":1,
}参数说明：
| 参数 | 必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| meetingroom_id | 是 | 会议室的id |
返回结果：
{
"errcode": 0,
"errmsg": "ok",
}参数说明：
| 参数 | 说明 |
|---|---|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
附录
当前支持的会议室设备如下
| 设备id | 设备名称 |
|---|---|
| 1 | 电视 |
| 2 | 电话 |
| 3 | 投影 |
| 4 | 白板 |
| 5 | 视频 |
