更新时间:2023-09-27 GMT+08:00

释放事件回调接口

场景描述

推送释放呼叫事件。

接口方法

POST

接口URL

客户自定义。

双呼的挂机回调URL有两种配置方式:
  • 通过界面配置:租户管理员选择配置中心 > 扩展与集成管理 > 双呼配置,设置“挂机回调url”
  • 通过创建双呼呼叫 (V1.0.0)接口传入:调用创建呼叫 (V1.0.0)接口时传入请求参数callBackUrl。

请求说明

  • 请求头参数:

    无。

  • 请求体参数:
    表1 请求体参数

    序号

    名称

    参数类型

    是否必选

    说明

    1

    callSerialNo

    string

    True

    呼叫流水号。

    长度限制:string(50)。

    2

    serviceNo

    string

    True

    座席工号等。

    3

    called

    string

    True

    客户号码。

    4

    caller

    string

    False

    本次呼叫的座席绑定的电话。

    5

    callerPresent

    string

    False

    外显号码。

    6

    callData

    string

    False

    呼叫数据。

    7

    createCallTime

    string

    False

    发起呼叫时间。

    8

    alertingTime

    string

    False

    用户振铃时间。

    9

    talkingTime

    string

    False

    通话时间。

    10

    releaseTime

    string

    False

    释放时间。

    11

    talkDuration

    string

    False

    通话时长。

    12

    recordfile

    string

    False

    录音路径。

    13

    locationId

    string

    False

    录音节点。

    14

    releaseReason

    string

    False

    释放原因码。

    0:通话结束,被叫挂机

    1:通话结束,主叫挂机

    2:外呼主叫失败

    3:外呼被叫失败

    4:外呼主叫无应答

    5:外呼被叫无应答

    xxx:其他异常

    15

    agentAlertingTime

    string

    False

    座席振铃时间。

    16

    agentTalkingTime

    string

    False

    座席通话时间。

    17

    agentReleaseTime

    string

    False

    座席释放时间。

    18

    agentTalkDuration

    string

    False

    座席通话时长。

响应说明

响应码:200

  • 响应消息
    表2 响应体参数

    序号

    名称

    参数类型

    是否必选

    说明

    1

    retCode

    string

    True

    0,成功,其他为失败。

    2

    retMsg

    string

    True

    失败原因的描述。

报文样例

请求参数:

{
 agentAlertingTime=2022/02/22,10:04:29:004, 
 agentReleaseTime=2022/02/22,10:04:29:004, 
 agentTalkDuration=2022/02/22,10:04:29:004, 
 agentTalkingTime=2022/02/22,10:04:29:004, 
 alertingTime=2022/02/22,10:04:29:004, 
 callData=null, 
 callSerialNo=1197765398201387012, 
 called=88880067, 
 caller=960003, 
 callerPresent=960003, 
 createCallTime=2022/02/22,10:04:28:823, 
 locationId=0, 
 nonce=-1482421808053124529, 
 recordfile=Y:/2/mobileAgent/20220222/1645524268-824.wav, 
 releaseReason=0, 
 releaseTime=2022/02/22,10:04:36:318, 
 serviceNo=null, 
 signature=+lk3***************************tO50=, 
 talkDuration=0, 
 talkingTime=2022/02/22,10:04:30:418, 
 timestamp=1645524163326
 }

响应参数:

{ 
    "retCode": "0",
    "retMsg": "success"
}