文档首页/ 云客服/ API参考/ 座席工作台/ 座席双呼/ ITA双呼结果通知(statusnotify)
更新时间:2023-09-27 GMT+08:00

ITA双呼结果通知(statusnotify)

场景描述

提供给ITA侧调用,在呼叫结束后ITA调用此接口向AICC推送双呼话单数据。

接口方法

POST

接口URI

https://域名/apiaccess/rest/cc-management/v1/ita/twopartiescall/statusnotify,例如域名是service.besclouds.com

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

AppKey

string

False

ITA侧的appKey字段,用户标识

2

Host

string

True

指定请求资源的Internet主机和端口号。

  • hostname:axb服务IP或域名
  • port:端口号。

3

Content-Type

string

True

用于指明发送给接收者(即服务器端)的实体正文的媒体类型。

4

X-Sdk-Date

string

True

发起请求的时间

5

Authorization

string

True

鉴权字段,具体鉴权说明请参见ITA文档

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1

callID

string

True

呼叫唯一标识,下载录音文件使用

2

remark

string

True

来自发起呼叫时的标注。预留字段(当前信息为租间ID)

3

startTime

string

False

发起呼叫时间,精确到秒

格式YYYYMMDDHHmmss

4

finishTime

string

False

通话结束时间

5

callDuration

string

False

通话时长,单位秒,供参考。

以双方通话建立开始计算

6

callerAnswerTime

string

False

主叫应答时间

7

calledAnswerTime

string

False

被叫应答时间

8

releaseCause

string

False

呼叫结束事件携带,原因值

9

appKey

string

False

客户分配资源标识

10

telA

string

False

原主叫号码

11

telX

string

False

落地业务号码

12

telB

string

False

原被叫号码

13

calledDisplay

string

False

被叫号显号码

响应说明

  • 响应状态码: 200

    收到消息后返回200 OK, 务必保证响应Content-Type为 application/json; charset=UTF-8

  • 响应状态码: 400

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

  • 响应状态码: 401

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

  • 响应状态码: 404

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

  • 响应状态码: 500

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

错误码

无。

报文样例

请求消息样例:

POST /twopartiescall/statusnotify HTTP/1.1
Request:
AppKey: CMCCGX_0001
X-Sdk-Date: 20210512T115430Z
Content-Type: application/json;charset=UTF-8
Host: 10.10.10.10:9003
Authorization: SDK-HMAC-SHA256 Access=1******2F4J8Q5T, SignedHeaders=appkey;content-type;host;x-sdk-date, Signature=77c4******62f48bcb4873e1d9ad9c1acc34b9b

{
	"appKey": "CMCCGX_0001",
        "remark": "2022091800",
	"telA": "1580****001",
	"telX": "184****0497",
	"telB": "158****0002",
	"calleeDisplay": "158****0001",
	"startTime": "20210512115422",
	"callerAnswerTime": "20210512115422",
	"calledAnswerTime": "20210512115422",
	"finishTime": "20210512115430",
	"callID": "cmccgx20210512195422",
	"releaseCause": "1",
	"callDuration": 8
} 

响应消息样例:

HTTP/1.1 200 OK 
Date: Mon, 12 Nov 2007 15:55:01 GMT 
Content-Length: xxx 
Content-Type: application/json; charset=UTF-8 
{ 
}