接口描述
描述:查询会议的等候室欢迎语。当有用户进入等候室时,会收到来自会议主办方的私聊消息引导。
请求方式:GET
鉴权方式:AK/SK 鉴权、OAuth 鉴权。
权限点:查看会议
接口请求域名:
https://api.meeting.qq.com/v1/meeting/{meeting_id}/waiting-room-welcome-message
输入参数
参数名称 | 参数类型 | 是否必须 | 参数描述 |
operator_id | String | 必须 | 操作者 ID,设置等候室欢迎语的用户。会议的创建者、主持人、联席主持人,企业管理平台有会控权限的用户可以设置。 operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 |
operator_id_type | Number | 必须 | 操作者 ID 的类型: 1:企业内用户 userid 2:open_id |
输出参数
参数名称 | 参数类型 | 参数描述 |
welcome_text | String | 欢迎语,文本类型,最大长度1000字符。欢迎语中如果传入占位符%NICKNAME%(大小写敏感),则该占位符会被替换为被私聊用户的会中昵称。一条消息中支持多个占位符。 |
enable_welcome | Boolean | 是否开启等候室欢迎语能力。 |
错误码列表
状态码 | 错误码 | 错误描述 |
500 | 9042 | 无权限进行该操作,建议检查操作者身份或资源归属。 |
500 | 190001 | 存在未注册的用户。 |
400 | 190457 | 会议不存在, 请核对 meeting_id。 |
400 | 9042 | 无权限进行该操作,建议检查操作者身份或资源归属。 |
400 | 190004 | 参数非法,请对照接口文档检查您的参数。 |
示例
输入示例
GET https://api.meeting.qq.com/v1/meeting/100001/waiting-room-welcome-message?operator_id=user1&operator_id_type=1
输出示例
{"welcome_text": "欢迎大家","enable_welcome": true}