文档首页/ 云客服/ API参考/ 系统配置类接口参考（API Fabric）/ 其他类接口/ CC-iSales联调CTI-OBS接口/ 外呼结果回写接口
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

外呼结果回写接口

场景描述

用于将呼叫的结果信息写入数据库。

接口方法

Post

接口URI

https://域名/rest/isales/v1/openapi/obs/business/call/result，例如域名是service.besclouds.com。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Authentication

string

True

token鉴权字段，请配置为鉴权接口中返回的refreshToken参数值。

2

Content-Type

String

False

"application/json"
表2 请求体参数

序号

参数

是否必选

类型

描述

1

subCCNo

True

int

呼叫中心ID。

2

vdnId

True

int

虚拟呼叫中心ID：VDNID。

3

uniqueId

True

String

外呼数据唯一标识ID。

4

serviceId

True

String

外呼任务关键字。

5

status

False

String

外呼结果的状态。

6

deviceType

False

int

外呼设备类型。

7

phoneNumber

False

String

当前呼出的电话号码。

8

failCode

False

String

平台返回的呼出原因码。

9

asrResult

False

String

外呼智能检测未接通类型分类结果。

10

fetchTime

False

String

获取呼叫数据时时间

11

writeStartTime

False

String

开始呼叫时时间

12

endCallTime

False

String

呼叫结束时时间

13

callId

False

String

呼叫CallID

响应说明

  • 响应状态码: 200
    表3 响应体参数

    序号

    名称

    参数类型

    说明

    1

    result

    string

    错误码。取值如下：

    0：成功

    非0：失败

错误码

  • 响应状态码: 400

    错误的请求：请检查请求路径及参数。

  • 响应状态码: 401

    未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。

  • 响应状态码: 403

    鉴权失败。

  • 响应状态码: 404

    请求的内容未找到：请检查请求的路径。

  • 响应状态码: 500

    业务失败：请依次确认您请求中各参数的取值。

报文样例

  • 请求头：
Authentication:Bearer e3fca9398eaa5cef4b57b523b9c75fae
Content-Type:application/json

  • 请求消息：
{
	"subCCNo": 1,
	"vdnId": 88,
	"uniqueId": "21713676089219765504",
	"serviceId": "1251250797",
	"status": "",
	"deviceType": 2,
	"phoneNumber": "88889156",
	"failCode": "",
	"asrResult": "",
	"fetchTime": "",
	"writeStartTime": "",
	"endCallTime": "",
	"callId": ""
}

  • 响应消息： 
    {
"result":0, // 0：成功，其他失败
}