自动外呼任务接口

创建自动外呼任务

该接口用于创建自动外呼任务

请求方法

POST /cc_ad_tasks

请求参数

参数名 类型 必填 说明
name 字符串 外呼任务名称
description 字符串 外呼任务描述
task_type 整型 外呼任务类型,参见任务类型说明
user_group_id 整型 外呼任务客服组id
force_policy_id 整型 路由策略ID,决定该电话使用那个智能路由。 默认路由
priority 整型 优先级 (1-100) 默认10
working_time_id 整型 任务执行时间段工作时间ID
recall_policy 字符串 发起重呼的通话结果的类型列表,参见数据结构-通话结果类型列表
recall_count 整型 重呼次数 默认0
recall_interval 字符串 重呼间隔 格式 "1,2,3" 第1次60秒 第2次120秒 第3次180秒 默认600秒
follow_on_policy 字符串 发起续播的通话结果类型,参见数据结构-通话结果类型列表

返回结果

属性名 类型 说明
code 整型 执行结果码,1000代表成功
id 整型 外呼任务ID

示例

curl http://demo.udesk.cn/open_api_v1/cc_ad_tasks?email=admin@udesk.cn&timestamp=1494474404&sign=2f4c2c3d0b4c24cfa4feca76e237da0c368a00d8 \
-X POST \
-H 'content-type: application/json' \
-d '
{
    "name": "外呼任务",
    "description": "这是外呼任务",
    "task_type": 1,
    "user_group_id": 100,
    "force_policy_id": 1,
    "priority": 10,
    "working_time_id": 1,
    "recall_policy": "customer_missed",
    "recall_count": 6,
    "recall_interval": "1,2,3,4,5,6",
    "follow_on_policy": "customer_missed"

}'

返回

{
  "code": 1000,
  "id": 1
}

更新自动外呼任务

该接口用于更新自动外呼任务名称和描述

请求方法

PUT /cc_ad_tasks/:id

请求参数


参数名 必填 说明
name 外呼任务名称
description 外呼任务描述

返回结果

属性名 类型 说明
code 整型 执行结果码,1000代表成功

示例

curl http://demo.udesk.cn/open_api_v1/cc_ad_tasks/1?email=admin@udesk.cn&timestamp=1494474404&sign=2f4c2c3d0b4c24cfa4feca76e237da0c368a00d8 \
-X PUT \
-H 'content-type: application/json' \
-d '
{
    "name": "外呼任务修改",
    "description": "这是要修改外呼任务"

}'

返回

{
  "code": 1000,
}

获取自动外呼任务列表

该接口用于获取自动外呼任务列表

请求方法

GET /cc_ad_tasks

请求参数


参数名 必填 类型 说明 限制
page 整型 页码,从1开始,默认为1
per_page 整型 每页数量,默认10,最大100

返回结果

属性名 类型 说明
code 整型 执行结果码,1000代表成功
cc_ad_tasks 数组 外呼任务信息,参见数据结构-自动外呼任务
meta 对象 分页信息,详见通用数据

示例

curl http://demo.udesk.cn/open_api_v1/cc_ad_tasks?page=1&per_page=10&email=admin@udesk.cn&timestamp=1494474404&sign=2f4c2c3d0b4c24cfa4feca76e237da0c368a00d8

返回

{
  "code": "1000",
  "cc_ad_tasks": [
  {
    "id": 1,
    "name": "自动外呼",
    "description": "自动外呼任务描述",
    "task_type": 2,
    "user_group_id": 100,
    "customer_count": 100000,
    "created_at": "2017-10-21 11:22:33",
    "status": 1,
    "execute_customer_count": 100000,
    "customer_answer_count": 100000,
    "agent_answer_count": 100000,
    "call_success_rate": "1.0",
    "agent_answer_rate": "1.0",
    "agent_use_rate": "1.0",
    "disturb_rate": "0.0",
    "minute_call_rate": "1.0",
    "minute_agent_use_rate": "1.0",
    "minute_disturb_rate": "0.0"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages":1,
    "total_entries": 1
    }
}

为自动外呼任务导入号码

该接口用于为指定的自动外呼任务添加号码,每次最多导入 300 条,调用频率不得超过 1 次/秒

请求方法

POST /cc_ad_tasks/add_numbers

Content Type

application/json

请求参数

参数名 必填 类型 说明
id 整型 自动外呼任务id
numbers 数组 要添加的号码数组,详见数据结构-导入自动外呼号码的结构

返回结果

属性名 类型 说明
code 整型 执行结果码,1000代表成功
successful_count 整型 成功导入的号码数量
unsuccessful_count 整型 导入失败的号码数量
unsuccessful_numbers 数组 导入失败的号码列表,结构详见数据结构-导入失败的号码结构

示例

curl http://demo.udesk.cn/open_api_v1/cc_ad_tasks/add_numbers?email=admin@udesk.cn&timestamp=1494474404&sign=2f4c2c3d0b4c24cfa4feca76e237da0c368a00d8 \
-X POST \
-H 'content-type: application/json' \
-d '
{
  "id": 1,
  "numbers": [
    {"cellphone": "13223004567", "name": "测试号码1", "description": "号码描述信息1"},
    {"cellphone": "13223004568", "name": "测试号码2", "description": "号码描述信息2"},
    {"cellphone": "13223004569", "name": "测试号码3", "description": "号码描述信息3",
     "custom": {"公司": "Udesk", "地址": "北京市"}
    },
    {"cellphone": "13223004570", "name": "测试号码4", "description": "号码描述信息4"}
  ]
}'

如果有3条记录均导入成功,1条失败,则返回

{
  "code": 1000,
  "successful_count": 3,
  "unsuccessful_count": 1,
  "unsuccessful_numbers": [
    {"cellphone": "13223004570", "name": "测试号码4", "description": "号码描述信息4", "reason": "该任务已经有号码13223004570"}
  ]
}

注意事项

curl http://demo.udesk.cn/open_api_v1/cc_ad_tasks/add_numbers?email=admin@udesk.cn&timestamp=1494474404&sign=2f4c2c3d0b4c24cfa4feca76e237da0c368a00d8 \
-X POST \
-H 'content-type: application/json' \
-d '
{
  "id": 1,
  "numbers": [
    {"cellphone": "13223004567", "name": "测试号码1", "description": "号码描述信息1"},
    {"cellphone": "13223004567", "name": "测试号码2", "description": "号码描述信息2"},
    {"cellphone": "13223004569", "name": "测试号码3", "description": "号码描述信息3"},
    {"cellphone": "13223004570", "name": "测试号码4", "description": "号码描述信息4"}
  ]
}'

则返回异常

{
  "code": 501012,
  "code_message": "numbers参数中包含重复的cellphone,请先去重再导入",
  "exceptions": {
    "message": "numbers参数中包含重复的cellphone,请先去重再导入",
    "backtrace": ["xxx", "xxx"]
  }
}

获取自动外呼任务的号码池

该接口用于返回指定的自动外呼任务的号码池列表,每次最多返回500条记录

请求方法

GET /cc_ad_tasks/numbers

请求参数

参数名 必填 类型 说明
id 整型 自动外呼任务id
start_number_id 整型 起始的号码池号码ID,默认为0

返回结果

属性名 类型 说明
code 整型 执行结果码,1000代表成功
numbers 数组 返回的号码列表详情,结构详见数据结构-号码池结构
meta 对象 额外信息,结构详见数据结构-号码池额外信息

示例

curl http://demo.udesk.cn/open_api_v1/cc_ad_tasks/numbers?email=admin@udesk.cn&timestamp=1494474404&sign=2f4c2c3d0b4c24cfa4feca76e237da0c368a00d8
-X GET \
-H 'content-type: application/json' \
-d '
{
  "id": 1,
  "start_number_id": 2
}'

返回

{
  "code": 1000,
  "numbers": [
    {
      "id": 3,
      "name": "测试号码3",
      "cellphone": "13989001200",
      "description": "号码3的描述",
      "call_count": 0,
      "customer_answer_count": 0,
      "agent_answer_count": 0
    },
    {
      "id": 14,
      "name": "测试号码14",
      "cellphone": "13989001201",
      "description": "号码14的描述",
      "call_count": 0,
      "customer_answer_count": 0,
      "agent_answer_count": 0
    }
  ],
  "meta": {
    "record_size": 2,
    "max_number_id": 14
  }
}

自动外呼任务号码重播

请求方法

POST /cc_ad_tasks/recall

请求参数


参数名 必填 类型 说明
id 整型 外呼任务ID
number 字符串 重播的电话号码
after_at 字符串 重播的开始时间 格式 YYYY-MM-DDTHH:MM:SSZ

返回结果

属性名 类型 说明
code 整型 执行结果码,1000代表成功
message 字符串 执行结果说明

示例

curl http://demo.udesk.cn/open_api_v1/cc_ad_tasks/recall?email=admin@udesk.cn&timestamp=1494474404&sign=2f4c2c3d0b4c24cfa4feca76e237da0c368a00d8 \
-X POST \
-H 'content-type: application/json' \
-d '
{
    "id": 1,
    "number": "13223004570",
    "after_at": "2018-04-21T16:34:52+08:00"
}'

返回

{
  "code": 1000,
  "message": "重播成功"
}

自动外呼任务号码续播

请求方法

POST /cc_ad_tasks/follow_on

请求参数


参数名 必填 类型 说明
id 整型 外呼任务ID
called 字符串 已经拨打的电话号码

返回结果

属性名 类型 说明
code 整型 执行结果码,1000代表成功
message 字符串 执行结果说明

示例

curl http://demo.udesk.cn/open_api_v1/cc_ad_tasks/follow_on?email=admin@udesk.cn&timestamp=1494474404&sign=2f4c2c3d0b4c24cfa4feca76e237da0c368a00d8 \
-X POST \
-H 'content-type: application/json' \
-d '
{
    "id": 1,
    "called": "13223004570"
}'

返回

{
  "code": 1000,
  "message": "续播成功"
}

自动外呼任务启动/关闭

请求方法

POST /cc_ad_tasks/:id/open

请求参数


参数名 必填 类型 说明
open 布尔型 true/false

返回结果

属性名 类型 说明
code 整型 执行结果码,1000代表成功
message 字符串 执行结果说明

示例

curl http://demo.udesk.cn/open_api_v1/cc_ad_tasks/1/open?email=admin@udesk.cn&timestamp=1494474404&sign=2f4c2c3d0b4c24cfa4feca76e237da0c368a00d8 \
-X POST \
-H 'content-type: application/json' \
-d '
{
    "open": true/false
}'

返回

{
  "code": 1000
}

数据结构-自动外呼任务

属性 说明 示例 类型
id 任务id 1 整型
name 任务名称 '自动外呼' 字符串
description 任务描述 '这是自动外呼任务' 字符串
task_type 任务类型 1 整型
user_group_id 客服组id 100 整型
customer_count 客户数量 100000 整型
created_at 创建时间 '2017-11-22 10:32:33' 日期时间
status 状态 1 整型
execute_customer_count 执行数量 100000 整型
customer_answer_count 客户接听数 100000 整型
agent_answer_count 客服接听数 100000 整型
call_success_rate 外呼成功率 '0.67' 字符串
agent_answer_count 坐席接听率 '0.32' 字符串
disturb_rate 骚扰率 '0.0' 字符串
agent_use_rate 坐席使用率 '1.0' 字符串
minute_call_rate 10分钟接通率 '1.0' 字符串
minute_agent_use_rate 10分钟骚扰率 '1.0' 字符串
minute_disturb_rate 10分钟坐席使用率 '1.0' 字符串

任务类型说明(task_type)

取值 中文名称
1 精准外呼
2 比例外呼
3 预测外呼
4 简单IVR(语音播报,不入队)

状态说明(status)

取值 中文名称
1 开启
2 关闭
3 停止中

数据结构-导入自动外呼号码的结构

属性 类型 说明 必填
cellphone 字符串 电话号,支持多号码使用逗号分隔
name 字符串 姓名
description 字符串 描述
custom 字符串 自定义数据,结构详见数据结构-导入自动外呼号码的自定义数据

数据结构-导入失败的号码结构

属性 类型 说明
cellphone 字符串 电话号
name 字符串 姓名
description 字符串 描述
custom 字符串 自定义数据
reason 字符串 失败原因

数据结构-号码池结构

属性 类型 说明
id 整型 号码ID
name 字符串 姓名
cellphone 字符串 电话号
description 字符串 描述
call_count 整型 呼叫次数
customer_answer_count 整型 客户接听次数
agent_answer_count 整型 客服接听次数

数据结构-号码池额外信息

属性 类型 说明
record_size 整型 本次请求返回的号码数量
max_number_id 整型 本次请求返回的最大号码ID(当 record_size 为0时,该值为 null),可作为下次请求的start_number_id

数据结构-导入自动外呼号码的自定义数据

自定义字段的数量不能超过10个

属性 类型 说明 必填
字段1 字符串 字段名称可以自定义
字段2 字符串 字段名称可以自定义
字段3 字符串 字段名称可以自定义
.... 字符串 字段名称可以自定义
字段10 字符串 字段名称可以自定义

数据结构-通话结果类型列表

取值 中文名称
customer_missed 客户未接
agent_missed 客服未接
customer_breakout 客户速挂
phone_outline 话机离线
phone_busy 话机占线