CloudImportTaskTel - 任务号码导入

更新时间:
复制为 MD 格式

为外呼任务导入任务号码。

接口说明

按批次导入号码,一次导入一个批次。

限制:一个批次最多 10w 个号码,一个任务最多 100w 个号码,一个企业最多 1000w 个号码。

可创建批次数:≤ 10 万个。 可导入号码数:≤100 万个。 单批次可导入号码数:≤ 10 万个。 超额处理:当触发上述任一限制时,本次请求失败。

提供「删除任务内号码」接口:业务平台可根据实际情况定期自动删除任务内已完成的批次或号码。 删除任务内号码后,平台已呼叫过的通话记录明细、录音文件会继续保留。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

EnterpriseId

integer

呼叫中心 id

17

Name

string

批次名称

批次名称1

TaskId

integer

任务 Id

25

FileId

integer

批次 Id;传此值表示在批次中增加号码

666

Priority

integer

优先级;默认 0,值越大越优先,最大 999999

5

IsRepeat

integer

是否排重,默认为 1。

  • 0:不排重

  • 1:任务内排重

  • 2:导入号码排重

  • 3:批次内排重

说明
  • 任务内排重与批次内排重不能同时支持,如果中途切换,则从本次切换开始进行排重。

1

BridgeVoicePath

string

座席接听时自动在双侧播放开场白语音,指定语音变量值;企业语音库里的语音变量值

example

BridgeVoiceType

integer

座席接听时自动在双侧播放开场白语音类型,默认为 3。

  • 1:公共语音库;

  • 2:企业语音库,静态话术;

  • 3:企业语音库,动态话术(座席号),传 bridgeVoicePath 后生效。

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:不自动启动

  • 1:自动启动

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"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情