有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

接口描述

描述
会议创建者、主持人、联席主持人可以批量外呼电话入会。
在拨打后,立刻返回,无需等待,客户通过查询接口和 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"
}
]
}