为外呼任务导入任务号码。
接口说明
按批次导入号码,一次导入一个批次。
限制:一个批次最多 10w 个号码,一个任务最多 100w 个号码,一个企业最多 1000w 个号码。
可创建批次数:≤ 10 万个。 可导入号码数:≤100 万个。 单批次可导入号码数:≤ 10 万个。 超额处理:当触发上述任一限制时,本次请求失败。
提供「删除任务内号码」接口:业务平台可根据实际情况定期自动删除任务内已完成的批次或号码。 删除任务内号码后,平台已呼叫过的通话记录明细、录音文件会继续保留。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| EnterpriseId |
integer |
是 |
呼叫中心 id |
17 |
| Name |
string |
是 |
批次名称 |
批次名称1 |
| TaskId |
integer |
是 |
任务 Id |
25 |
| FileId |
integer |
否 |
批次 Id;传此值表示在批次中增加号码 |
666 |
| Priority |
integer |
否 |
优先级;默认 0,值越大越优先,最大 999999 |
5 |
| IsRepeat |
integer |
否 |
是否排重,默认为 1。
说明
|
1 |
| BridgeVoicePath |
string |
否 |
座席接听时自动在双侧播放开场白语音,指定语音变量值;企业语音库里的语音变量值 |
example |
| BridgeVoiceType |
integer |
否 |
座席接听时自动在双侧播放开场白语音类型,默认为 3。
|
3 |
| TaskTelList |
array<object> |
是 |
任务号码列表;CtiLinkTaskTel 中只有 Tel 是必选字段,长度大小不超过 8MB 注:获取导入失败明细,需配置事件推送 |
|
|
object |
否 |
|||
| ClidGroup |
string |
否 |
使用 clidGroup 需要账号支持按标识路由,使用此参数是 clid 参数无效 |
example |
| Clid |
string |
否 |
电话号对应的外显号码 |
7766551 |
| Priority |
integer |
否 |
优先级,默认为 0,值越大优先级越高,最大 999999 |
38 |
| Tel |
string |
否 |
电话号 |
7455441 |
| Property |
string |
否 |
属性,json 格式 |
{} |
| BackupTels |
string |
否 |
备选号码,tel 呼叫不通时,呼叫备选号码最多支持 8 个,号码之间用英文逗号","分隔 |
7455332 |
| ImportTelAutoStart |
integer |
否 |
是否自动启动任务,默认为 0。
|
0 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| AccessDeniedDetail |
string |
访问被拒绝详细信息。 |
None |
| RequestId |
string |
请求 ID。 |
D9CB3933-9FE3-4870-BA8E-2BEE91B69D23 |
| Message |
string |
返回信息。 |
OK |
| Data |
object |
返回数据。 |
|
| SuccessTotal |
string |
成功导入号码数 |
30 |
| TaskId |
string |
任务 Id |
13322333 |
| ImportTotal |
string |
请求号码总数 |
30 |
| InvalidTotal |
string |
非法号码数 |
0 |
| FileId |
string |
批次 Id |
0 |
| Code |
string |
请求状态码。 |
OK |
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "None",
"RequestId": "D9CB3933-9FE3-4870-BA8E-2BEE91B69D23",
"Message": "OK",
"Data": {
"SuccessTotal": "30",
"TaskId": "13322333",
"ImportTotal": "30",
"InvalidTotal": "0",
"FileId": "0"
},
"Code": "OK"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。