文档首页/ 云客服/ API参考/ 电销外呼/ 外呼数据接口/ 新增外呼号码（v2）
更新时间：2024-09-24 GMT+08:00
查看PDF
分享

新增外呼号码（v2）

场景描述

调用该接口为指定外呼活动新增外呼号码。

使用说明

  • 前提条件
    • 已经申请了开发者账号。
    • 外呼活动已经创建。
  • 使用限制
    • 外呼活动未完成的外呼记录数不超过20W。
    • 同一个外呼任务，默认每次增加20条，修改配置参数isales.api.calldata.max可调整每次添加的值，且前后接口调用时间不能小于1秒。建议不超过2000，且配置参数isales.api.uncomplate.count设置为false，否则接口调用可能会超过1S。
    • 每次追加的同一个sessionId下的被叫号码不能有重复。
    • 每次追加的被叫号码中不能存在黑名单号码，或者被叫号码在黑名单号码中并为其配置了限制周期和限制次数（但外呼次数不能超过限制周期内的限制次数）。
    • 已完成的任务不允许追加号码。
    • 执行中的任务不允许新增外呼号码。

接口方法

该接口仅支持POST方法。

接口URI

https://ip:port/rest/isales/v2/openapi/campaigns/{vdnId}/calldata/{campaignId}

其中，ip为CC-iSales服务器地址，port为CC-iSales服务器的HTTPS端口号。

表1 URL中携带的参数说明

序号

参数名

参数类型

是否必选

说明

1

vdnId

int

True

虚拟呼叫中心ID。

取值的类型为整数，取值范围为1～9999。

2

campaignId

int

True

外呼活动的ID。

请求说明

表2 请求消息头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定填 application/json; charset=UTF-8。

2

Authorization

String

True

生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。
表3 请求消息体参数说明

序号

参数名

参数类型

是否必选

说明

1

callDataList

List

True

新增数据列表，最多20条。

该对象的参数说明请参见表4。
表4 callDataList参数说明

序号

参数名

参数类型

是否必选

说明

1.1

sessionId

String

False

标识用户的ID，外呼结果中会回传用户。

最大长度为32个字符。

1.2

called

List

True

客户号码信息。

1.3

caller

String

False

主叫号码。

最大长度为24个字符。

1.4

customField

String

False

用户自定义字段，最大长度200，不允许出现特殊字符`~!@#$%^&*()+=|{}'":;<>/?.\[\]！￥…（）—【】‘；：" "’,、？。

1.5

recycleTime

String

False

回收时间，格式为yyyy-mm-dd hh:mm:ss。

1.6

callData

String

False

随路数据，最大长度1024，建议JSON格式。

注意：
  • 当自动外呼涉及到智能IVR流程时，该参数格式只支持JSON格式。

    智能IVR流程使用JSON格式调用图元对JSON格式的随路数据进行解析和赋值操作，图元的具体实现和使用方式请参见JSON数据调用图元。

  • JSON格式请参照如下，其中斜体部分可自定义，其余参数和格式请保持固定：

    "callData":"{\\\"fullName\\\":\\\"林子航\\\",\\\"date\\\":\\\"二零二二年三月三十一日\\\",\\\"riskName\\\":\\\"交强险\\\"}"
表5 called参数说明

序号

参数名

参数类型

是否必选

说明

1.2.1

calledNo

String

True

客户被叫号码。

最大长度为24个字符，有效字符为：0~9、*、#。

1.2.2

delayTime

String

False

客户每个号码呼叫的间隔时间，单位秒，范围0~86400，默认值0。

1.2.3

type

String

False

客户号码类型。

  • 新增外呼活动时，当“外呼结果策略”的策略类型配置为“号码分类匹配策略”，该参数必填。
  • 新增外呼活动时，当“呼叫策略”的呼叫方式为“按轮次”，该参数必填。

    填写时，内容自定义，取值范围：最大长度20字符，不包含特殊字符。

响应说明

表6 消息体参数说明

序号

参数名

参数类型

说明

1

resultCode

String

原因码。0200000表示成功，其他表示失败。

具体见表9。

2

resultDesc

String

描述。

3

returnCode

String

原因码。0200000表示成功，其他表示失败。

具体见表9。

4

returnDesc

String

描述。

5

returnObject

Object

参见表7。
表7 returnObject参数说明

序号

参数名

参数类型

说明

5.1

totalSize

int

当前系统需要外呼的数据总数。

5.1

datalist

Object

参见表15 datalist参数说明。
表8 datalist参数说明

序号

参数名

参数类型

说明

5.1

called

String

新增的外呼号码。

5.1

dataId

String

新增外呼号码及其对应的dataId。

触发事件

无

错误结果码

表9 错误原因码说明

序号

错误码

说明

1

0200001

参数异常，异常详情在resultDesc中描述。

2

0200006

数据库操作异常。

3

0200007

外呼活动不存在。

4

0200018

存在重复的号码。

5

0200019

当前状态不允许追加号码。

6

0200020

号码数量超过了最大规格20w条。

7

0200022

接口调用太快。

8

0200024

添加的号码中存在黑名单号码。

9

0200029

超过了每次添加允许的最大值。

10

0200030

时间格式不正确。

11

02000001

参数值为空

12

02000002

参数包含非法字符

13

02000003

参数长度不能大于规定长度

14

02000004

参数长度不能小于规定长度

15

02000005

参数长度需要介于规定长度之间

16

02000006

参数值类型不正确

17

02000007

参数值大小不正确

18

02000008

参数转换异常，请检查请求参数

19

02000009

参数组合不正确，请检查请求参数

20

02000010

hour和minute必须同时存在

21

02000011

参数个数不能大于规定个数

报文样例

  • 该接口的请求消息体举例如下： 
    {
    "callDataList": [
        {
            "sessionId": "00750",
            "called": [
               {"calledNo":"88880088","delayTime":"0","type":"ST"},
               {"calledNo":"88880089","delayTime":"1","type":"SA"}
            ]
        },
        {
            "sessionId": "00850",
            "called": [
               {"calledNo":"88880080","delayTime":"0","type":"ST"}
            ]
        }

    ]
}
  • 该接口的响应消息体举例如下： 
    {
  "returnCode": "0200000",
  "returnObject": {
    "totalSize": 2,
    "dataIdList": [
      {
        "called": "88880399",
        "dataId": "1803096731904991234"
      },
      {
        "called": "88880399",
        "dataId": "1803096731997265922"
      }
    ]
  },
  "resultCode": "0200000",
  "resultDesc": "create data succeeded",
  "returnDesc": "create data succeeded"
}
父主题： 外呼数据接口

相关文档