|  开放平台
批量任务下发接口
1
接口调用请求说明

http请求方式: POST

url: https://ziker-open.yun.pingan.com/oauth/api/task_pool/task/batch/add?access_token={your_access_token}

2
POST body说明
参数 描述 是否可为空
missionWay 任务派发方式:"auto"(自动下发任务给坐席), "manual"(需手动在页面触发下发给坐席)
source 调用来源:"FIN_TECH":金科
businessType 业务类型
taskPoolName 任务池名字:"系统任务池", "客户生日关怀任务池", "网站断点客户拦截任务池", "客户意向探测任务池"
taskPoolType 任务池类型: "COMMON":通用类型, "MARKETING_PLAN":营销计划
tasks 任务列表,一次最多支持10000条任务
3
tasks任务列表中任务的结构(最多500条)
属性 描述 是否可为空
custInfo 客户详情信息,具体结构请见下方
productInfo 产品详情信息,具体结构请见下方
orderInfo 订单详情信息,具体结构请见下方
extendField 任务扩展信息,具体结构为json格式:[{"key":"XX","value":"XX"},{"key":"XX","value":"XX"}]
4
custInfo客户详情信息结构
属性 描述 是否可为空
telno 手机号
name 客户姓名
age 年龄
sex 性别
cid 客户账号
mobile2 手机号2
mobile3 手机号3
province 省的名字
city 市的名字
area 区县的名字
address 详细地址
nativePlace 籍贯
occupation 职业
remark 备注
idType 证件类型
idNo 证件编码
email email
liveLimit 居住年限
annualSalary 年收入
listInfoTagList 名单标签集合
5
productInfo产品信息结构
属性 描述 是否可为空
productCode 产品编号
productName 产品名称
6
orderInfo订单信息结构
属性 描述 是否可为空
orderId 订单号
tradeTime 交易时间
proxy 代理或者商户
expTip 异常和提示
channel 渠道
reinsureURL 订单原链接
orderNo 订单编号
amount 订单金额
quantity 贷款期限
unit 单位
7
header参数说明
参数 描述 是否可为空
enterpriseId 密文的企业ID
8
输出参数说明
参数 描述 是否可为空
resultCode 状态码 '000000'
resultMesg 状态消息 '请求处理成功'
data 任务下发详情
9
错误码集合
错误码(resultCode) 描述(resultMesg)
-1 系统异常!请联系系统管理员
010000 请求参数错误
010001 企业不存在
060402 任务池添加失败
060403 任务池添加任务失败
060404 下发任务失败
060408 任务派工失败
060409 任务池不允许只有类型而没有名字
030301 获取懂客新增手动外呼任务的extendField的配置信息失败
060416 添加名单与标签的关联信息失败
10
headers:

示例如下

headers:

{

  "Content-Type": "application/json",

  "enterpriseId":"{your_enterprise_id}"

}

11
POST数据示例如下

例:

{
    "missionWay":"manual",
    "source":"",
    "businessType":"",
    "taskPoolType":"COMMON",
    "taskPoolName":"系统任务池",
    "tasks":[
    {
        "custInfo":
        {
            "telno":"13111111111",
            "cid":"1000001",
            "name":"111",
            "mobile2":"13111111111",
            "mobile3":"13222222222",
            "province": "上海市",
            "city": "市辖区",
            "area": "浦东新区",
            "address": "上海市浦东新区xxx路xxx号",
            "email":"",
            "liveLimit":"",
            "annualSalary":"",
            "idNo":"10102020320",
            "sex":"male",
            "idType":"身份证",
            "occupation":"程序猿",
            "age":29,
            "remark":"",
            "nativePlace":"上海",
            "listInfoTagList":["架构师","有车"]
        },
            "productInfo":
        {
            "productCode":"",
            "productName":""
        },
            "orderInfo":
        {
            "orderId":"",
            "tradeTime":"",
            "proxy":"",
            "expTip":"",
            "channel":"",
            "reinsureURL":"",
            "orderNo":"",
            "amount":"",
            "quantity":"",
            "unit":""
        },
            "extendField":
            "[         {\"title\":\"标题\",\"value\":\"一号111标题\"} ,
            {\"title\":\"remark_string_10\",\"value\":\"1000001\"} ]"
        }
    ]
}

正确返回:

{
    "resultCode": "000000",
    "resultMesg": "请求处理成功",
    "data": {
    "unAddedTaskCount": 0,
    "taskPoolNameSet": [],
    "hasTaskExist": false,
    "successTaskList": [
    {
        "id": 1000047,
        "updatedBy": "wlzvseGn0FmSgb671Fg2",
        "createdBy": "wlzvseGn0FmSgb671Fg2",
        "listInfoId": 2000054,
        "taskPoolId": 1000029,
        "currentHandlerId": 1000001,
        "source": "system",
        "extendInfo": "实例文档"
    }
    ],
    "success": true,
    "addAll": true,
    "assignSuccess": true
}
自动外呼任务活动创建和接收数据接口
1
接口调用请求说明

http请求方式: POST

url: https://ziker-open.yun.pingan.com/oauth/api/task_pool/task/auto_outbound/batch/add?access_token={your_access_token}

2
POST body说明
参数 描述 是否可为空
missionWay 任务派发方式
source 调用来源
businessType 业务类型
taskPoolName 任务池名
taskPoolType 任务池类型
tasks 任务列表
campaignCode 活动编码
releaseTime 发布时间
beginDate 开始时间
endDate 结束时间
autoOBRuleInfo 自动外呼规则域
3
tasks任务列表中任务的结构
参数 描述 是否可为空
custInfo 客户详情信息,具体结构请见下方
extendField 扩展字段信息
4
custInfo客户详情信息结构
参数 描述 是否可为空
telno 手机号
name 客户姓名
age 年龄
sex 性别
cid 客户账号
sex 性别
mobile2 手机号2
mobile3 手机号3
province 省的名字
city 市的名字
area 区县的名字
address 详细地址
nativePlace 籍贯
occupation 职业
remark 备注
idType 证件类型
idNo 证件编码
email email
5
autoOBRuleInfo 自动外呼规则域的数据结构
属性 描述 是否可为空
maxTime 最大振铃时间
dispatchMode 自动外呼派工模式
exNum 外显号码
reDialRule 重播规则
reDialTimes 失败重播次数
reDialIntervals 失败重播间隔时间
obPeriods 自动外呼时间端
answerTmr 接听坐席
excludeRepeatRule 除重规则
6
extendField 客户信息扩展字段数据结构 (以下为懂客调接口所使用的扩展信息数据结构)
属性 描述 是否可为空
list_no ID
remark_string_10 管户人
mobile1 手机号
remark_string_1 本人邀请码
remark_string_2 推荐码
remark_string_7 客户身份
sex 性别
age 年龄
remark_string_8 IP所在地
remark_string_3 黑白名单标记
remark_string_9 星级
remark_date_1 注册时间
remark_date_2 首投时间
remark_money_1 历史最高投资额
remark_num_4 历史投资笔数
remark_money_2 当前余额
remark_date_3 最近一笔到期日期
remark_money_3 最近一笔到期金额
remark_num_2 本月到期债权笔数
remark_money_4 本月到期债权金额
remark_num_3 本月到期未开自动续投债权笔数
remark_money_5 本月到期未开自动续投债权金额
remark_date_4 本月未开自动续投债权,第一笔到期日
remark_money_6 本月第一笔到期未开自动续投债权金额
remark_string_4 当前是否有未使用红包
remark_string_5 当前是否有未使用Ycode
maxTime 最大振铃次数
7
excludeRepeatRule 除重规则的数据结构
属性 描述 是否可为空
ruleCode 规则编码
vars 规则参数
8
vars 规则参数的数据结构
参数 描述 是否可为空
innerDays 时间范围
campaignCode 活动编码
9
header参数说明
参数 描述 是否可为空
enterpriseId 密文的企业ID
10
输出参数说明
参数 描述 是否可为空
resultCode 状态码 '000000'
resultMesg 状态消息 '请求处理成功'
data null
success null
assignSuccess null
addAll null
11
错误码集合
错误码 描述
-1 系统异常!请联系系统管理员
060413 无可拨打的客户,不能创建活动
060403 任务池添加任务失败
12
Header数据

示例如下

headers:

{

  "Content-Type": "application/json",

  "enterpriseId":"{your_access_token}"

}

13
POST数据示例如下

示例如下

{
    "missionWay": "auto",
    "source": "system",
    "businessType": "",
    "taskPoolName": "自动外呼任务池",
    "campaignCode": "1111001",
    "releaseTime": "2017-01-22 12:59:59",
    "beginDate": "2017-01-22",
    "endDate": "2017-01-23",
    "activeCode": "1000002",
    "taskPoolType": "AUTO_OUTBOUND",
    "tasks": [
        {
           "custInfo": {
           "id": "100001",
           "cid": " YJS0001",
           "name": "李某7",
           "sex":"F",
           "age":"28",
           "mobile1": "18000001111",
           "mobile2": "18000001112",
           "mobile3": "18000001113",
           "province": "上海市",
           "city": "市辖区",
           "area": "浦东新区",
           "address": "这是地址",
           "nativePlace": "上海",
           "occupation": "码农",
           "label": "XXX",
           "remark": "这是remark",
           "listNo":" YJS0001",
           "telno":"18000001111",
           "idType":"身份证",
           "idNo":"43143424254235",
           "email":"1234@qq.com",
           "wechatNo":"XXX"
               },
          "extendField":"{\"list_no\":\"YX010101\",\"remark_string_10\":\"管户人\",\"mobile1\":\"13910254055\",\"remark_string_1\":\"本人邀请码\",\"remark_string_2\":\"推荐码\",\"remark_string_7\":\"客户身份\",\"sex\":\"性别\",\"remark_string_8\":\"IP所在地\",\"remark_string_3\":\"黑白名单标记\",\"remark_string_9\":\"星级\",\"remark_date_1\":\"注册时间\",\"remark_date_2\":\"首投时间\",\"remark_money_1\":\"历史最高投资额\",\"remark_num_4\":\"历史投资笔数\",\"remark_money_2\":\"当前余额\",\"remark_date_3\":\"最近一笔到期日期\",\"remark_money_3\":\"最近一笔到期金额\",\"remark_num_2\":\"本月到期债权笔数\",\"remark_money_4\":\"本月到期债权金额\",\"remark_num_3\":\"本月到期未开自动续投债权笔数\",\"remark_money_5\":\"本月到期未开自动续投债权金额\",\"remark_date_4\":\"本月未开自动续投债权,第一笔到期日\",\"remark_money_6\":\"本月第一笔到期未开自动续投债权金额\",\"remark_string_4\":\"当前是否有未使用红包\",\"remark_string_5\":\"当前是否有未使用Ycode\","\maxTime\":"\最大振铃时间\"}"
        }
          ],
          "autoOBRuleInfo": {
          "dispatchMode": "auto",
          "reDialRule": "01",
          "exNum": "110",
          "answerTmr": [
          "1000001",
          "1000002",
          "1000003"
          ],
          "reDialTimes": 10,
          "reDialIntervals": 4,
          "obPeriods": [
          "09:59:59-12:59:59",
          "13:59:59-17:59:59",
          "18:59:59-21:59:59"
          ],
          "excludeRepeatRule": {
          "ruleCode": "1",
          "vars":{
          "campaignCode":"KEY",
          "innerDays":"VALUE"
          }
      }
  }
}

示例如下

{
    "resultCode": "000000",
    "resultMesg": "请求处理成功",
     "data": {
        "unAddedTaskCount": 0,
        "taskPoolNameSet": null,
        "successSystemTask": null,
        "hasTaskExist": false,
        "successTaskList": [
        {
            "id": 1000084,
            "updatedBy": "component.winker",
            "createdBy": "component.winker",
            "createdTime": null,
            "updatedTime": null,
            "listInfoId": 2000084,
            "taskPoolId": 1000040,
            "currentHandlerId": 0,
            "active": null,
            "taskCreateTime": null,
            "assignTime": null,
            "appointTime": null,
            "contactResult": null,
            "remark": null,
            "source": "system",
            "extendInfo": null,
            "status": null,
            "customFieldInfo": null,
            "orderInfo": null
        }
        ],
        "success": true,
        "assignSuccess": false,
        "addAll": true
    }

}