注意,本接口的使用需要进行接口鉴权

云电销外呼任务接口对接

外呼任务接口简介: 提供查询未完成外呼任务的能力,并能够通过接口导入外呼任务数据

1.查询未完成外呼任务接口

  • HTTP请求方式:POST

  • 请求地址:{HOST}/v20170704/dianxiao/queryOutboundTask/{ACCOUNTID}?sig={sig}

  • 请求时请将{HOST}换成对接数据查询中获取到的请求域名,{ACCOUNTID}替换为账户编号,{SIG}是根据鉴权规则生成的,请看鉴权文档,查看具体的生成规则

  • 鉴权文档:接口鉴权

  • 请求示例:

http://apis.7moor.com/v20170704/dianxiao/queryOutboundTask/account?sig=xxx=41276A8E7767352A0FE7456D20F03D3

返回值:

返回值 含义
success 是否请求成功
message 响应信息
data 返回的数据,json格式
taskName 外呼任务名字
taskId 外呼任务id
memo 外呼任务号码总数
phoneTotal 外呼任务号码总数
agentsNum 外呼任务参与座席个数
createTime 外呼任务创建时间
source 外呼任务客户数据来源
lastTime 外呼任务最后更新时间
  • 返回成功示例:
{
    "message": "there are dealing task",
    "success": true,
    "data": [
            {
            "taskName": "20171129_b",
            "taskId": "9e656890-d4b3-11e7-82ff-cbd9805b4059",
            "memo": "",
            "phoneTotal": 5,
            "agentsNum": 1,
            "createTime": "2017-11-29 11:15:57",
            "lastTime": "2017-11-29 12:02:04",
            "source": "网络"
            }
        ]
}

2.外呼任务导入数据接口

  • HTTP请求方式:POST

  • 请求地址:{HOST}/v20170704/dianxiao/insertOutboundTaskData/{ACCOUNTID}?sig={sig}

  • 请求时请将{HOST}换成对接数据查询中获取到的请求域名,{ACCOUNTID}替换为账户编号,{SIG}是根据鉴权规则生成的,请看鉴权文档,查看具体的生成规则

  • 鉴权文档:接口鉴权

  • 请求示例:

https://apis.7moor.com/v20170704/dianxiao/insertOutboundTaskData/N00000000013
?sig=41276A8E7767352A0FE7456D20F03D3
  • 请求体:
{
    "exten" : "8002",
    "isPhone" : "plan",
    "taskId" : "c371dbe0-c938-11e7-9bd0-a35d26d86723",
    "numbers" : [
        {
            "phone":"15210105523",
            "name" :"容联七陌",
            "title" :"test1"
        },
        {
            "phone":"13785127283",
            "name" :"容联七陌",
            "title" :"test2",
        }
    ]
}

请求体字段解说明:

字段 类型 是否必须 备注
exten String 坐席号,创建本次导入号码任务的坐席
isPhone String 号码晒重方式:global(全局,包括所有的任务、客户数据),allPlan(所有任务,所有未归档的任务),plan(当前任务,当前操作的任务)
taskId String 任务ID
numbers List 导入的数据,此值类型为List,长度不得超过10000, 单位元素结构为 {phone:xxx,name:xxx,title:xxx} phone ----联系电话 name ----客户名称 title ----描述

返回值:

  • 外呼任务创建成功返回示例:
{
    "success": true,
    "code": 200,
    "message": "200 OK"
}
  • 外呼任务创建失败返回示例:
{
    "success": false,
    "message": "please check your parametes!",
    "code": 400
}