接口描述
描述:
会议创建者、主持人、联席主持人可以批量外呼电话入会。
在拨打后,立刻返回,无需等待,客户通过查询接口和 Webhook 获得外呼状态。
支持在会议未开始、会中外呼。
每次调用支持批量外呼50路。
支持境外电话号及分机号的外呼。
支持在 Webinar 准备模式下外呼嘉宾,在 Webinar 会中外呼观众。
请求方式:POST
鉴权方式:JWT 鉴权
接口请求域名:
https://api.meeting.qq.com/v1/meeting/{meeting_id}/phone/callout
输入参数
参数名称 | 必选 | 参数类型 | 参数描述 |
operator_id | 是 | String | 操作者 ID。 会议创建者、主持人、联席主持人可以调用该接口。 operator_id 必须与 operator_id_type 配合使用。根据 operator_id_type 的值,operator_id 代表不同类型。 |
operator_id_type | 是 | Number | 操作者 ID 的类型: 1:企业内用户 userid |
phone_numbers | 是 | PhoneNumbers 对象数组 | 外呼的电话号码对象数组。 |
PhoneNumbers 对象
参数名称 | 必选 | 参数类型 | 参数描述 |
area | 是 | Number | 国家/地区代码。(例如:中国是86) |
phone | 是 | String | 电话号码或固定电话总机号。 |
extension_number | 否 | String | 固定电话分机号。 |
nick_name | 否 | String | 入会昵称。 |
输出参数
参数名称 | 必选 | 参数类型 | 参数描述 |
meeting_id | 是 | String | 会议的唯一 ID。 |
phone_numbers | 是 | PhoneNumbers 对象数组 | 成功外呼的电话号码对象数组。 |
invalid_phone_numbers | 是 | InvalidPhoneNumbers 对象数组 | 不合法的外呼电话号码对象数组。 |
PhoneNumbers 对象数组
参数名称 | 必选 | 参数类型 | 参数描述 |
area | 是 | Number | 国家/地区代码。(例如:中国是86) |
phone | 是 | String | 电话号码或固定电话总机号。 |
extension_number | 否 | String | 固定电话分机号。 |
status | 否 | String | 外呼状态。 |
InvalidPhoneNumbers 对象数组
参数名称 | 必选 | 参数类型 | 参数描述 |
area | 是 | Number | 国家/地区代码。(例如:中国是86) |
phone | 是 | String | 电话号码或固定电话总机号。 |
extension_number | 否 | String | 固定电话分机号。 |
error_msg | 是 | String | 错误信息 |
示例
输入示例
{"operator_id":"songe","operator_id_type":2,"phone_numbers":[{"area":86,"phone":"13888888888"}]}
输出示例
{"meeting_id":"1111111111111","phone_numbers":[{"area":86,"phone":"13888888888","status":"",}],"invalid_phone_numbers":[{"area":86,"phone":"13888888888""error_msg":"xxxxxxxxx"}]}