机器人数据推送接口

机器人数据推送接口

此接口用于推送任务到第三方集成系统

请求地址

http://{第三方应用地址}/ ***/*** /

请求参数

请求方法

PUT

请求header参数

请求HTTP头信息

Content-Type: application/json

_{事件回调返回结果字段描述}

事件回调返回数据

_{接口调用样例}

API路径
[https://{第三](https://xn--%7B-t28dk77r/)方地址}/ **/*** 此api路径为第三方回调地址路径

请求方法
PUT
Content-Type: application/json

请求Body参数
{
"userId" : "sdafssafd", #第三方系统用户唯一ID
"taskName" : "任务1", #当前任务名称
"happen_time": 1563441201133,
"customers" : [
{
"skbId" : "", #推送任务记录唯一ID
"name" : "", #联系人姓名
"phone" : "", #电话号码
"companyName" : "", #公司名称
"url" : "", #网址
"callbackUrl" : "", #回调地址
"accessible" : true, #是否是实号
},
...
]
}

 返回结果

 JSON示例
{
"code" : "0", # 0 表示成功，1表示失败
"message" : "" # 当code为1时，此为错误消息
}

2.任务结果汇报接口

    ^{此接口用于第三方集成系统汇报任务执行结果}

请求地址

[https://](https://xn--3d2a/)搜客宝域名/api/task/receiveRobotResult?token=${token} 这个地址来自于推送任务时，"callbackUrl"这个属性的值。

请求参数

请求方法

POST

请求HTTP头信息

Content-Type: application/json

_{接口调用样例}

返回HTTP状态码200表示成功，否则表示失败。如果失败，请5分钟后重试。

API路径

 [https://](https://xn--3d2a/)搜客宝域名/api/task/receiveRobotResult?token=${token} 这个地址来自于推送任务时，"callbackUrl"这个属性的值。

请求方法
POST
Content-Type: application/json

请求Body参数

{
"userId" : "sdafssafd", #第三方系统用户唯一ID
"customers" : [
{
"callid" : "", #外呼id，唯一标识外呼记录的ID
"phone_number" : "", #呼叫号码
"skbId" : "", #推送任务记录唯一ID
"record_name" : "", #录音文件地址
"state" : 1, #通话状态（1为接通，0为未接通）
"duration" :180, #通话时长（秒）
"start_time" : 12323231, #呼叫发起时间unixtimestamp (毫秒)
"answerDatetime" :12323231, #接听时间unixtimestamp (毫秒)
"end_time" :12323231, #结束时间unixtimestamp (毫秒)
"conversations" : [
"ask" : "你有兴趣吗？"
"answer" : "有的"
]

},
...
]
}