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

查询应答来话前呼叫信息

前置条件

  • 座席已签入
  • 座席正在通话中

场景描述

座席签入后,查询应答来话前呼叫信息。

接口方法

设置成“GET”。该接口仅支持GET方法,不支持PUT、POST和DELETE等方法。

接口URI

https://ip:port/agentgateway/resource/calldata/{agentid}/callinfobeforeanswer

其中,ip为CC-Gateway服务器地址,port为CC-Gateway服务器的HTTPS端口号。

表1 URI中携带的参数说明

序号

参数名

数据类型

选取原则

说明

1

agentid

string

True

座席的工号,取值范围:101~59999。

日志中的方法名

queryCallInfoBeforeAnswer

请求说明

  • 消息头
    表2 请求头参数说明

    序号

    名称

    参数类型

    是否必选

    说明

    1

    Content-Type

    string

    True

    消息主体编码方式,缺省值:application/json; charset=UTF-8

    2

    Guid

    string

    True

    静态鉴权(AUTHMODE = 1)签入接口返回的Guid;动态鉴权(AUTHMODE = 2)轮询事件接口返回的Guid。

  • 消息体

响应说明

表3 消息体参数说明

序号

名称

参数类型

说明

1

message

string

描述

2

retcode

string

错误码。取值如下:

0:成功

非0:失败

3

result

list

查询成功后,返回呼叫信息对象。

该对象的参数说明请参见表4

表4 result对象参数说明

序号

名称

参数类型

说明

3.1

callfeature

int

呼叫类型,请参考表1

3.2

callid

string

呼叫ID

3.3

caller

int

主叫号码

3.4

called

int

被叫号码

3.5

callskill

string

呼叫技能描述

3.6

callskillid

int

呼叫技能ID

3.7

orgicallednum

string

未使用该返回参数

3.8

calldata

string

随路数据

3.9

begintime

long

应答开始时间,时间戳(毫秒)

3.10

endtime

long

未使用该返回参数

3.11

userPriority

int

客户优先级

3.12

trunkNo

int

中继号

3.13

logontimes

int

进入总时长(秒)

3.14

mediaType

int

媒体类型。其中:

  • 1:文字交谈
  • 2:点击通话
  • 4:回呼请求
  • 5:普通音视频电话
  • 15:预测呼出
  • 16:预浏览呼出
  • 17:消息呼叫
  • 19:视频普通呼叫
  • 51:多媒体Web Chat
  • 53:Social Chat

3.15

mediaAbility

int

媒体能力。其中:

  • 1:音频
  • 2:视频
  • 3:音视频

3.16

waitTime

long

等待应答时间,时间戳(秒)

3.17

trace

HWCallDeviceTraceEx

呼叫轨迹扩展属性,预留字段,默认为空。

触发事件

错误结果码

  • 100-006

报文样例

  • 消息头
    Content-Type:application/json; charset=UTF-8
    Guid:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1
  • 请求参数

  • 响应参数
    {
        "message": "",
        "retcode": "0",
        "result": {
            "callfeature": 0,
            "callid": "1476070409-38",
            "caller": "70001",
            "called": "10086",
            "callskill": "voice_jst",
            "callskillid": 3,
            "orgicallednum": "12345678",
            "calldata": "",
            "begintime": 1476070413000,
            "endtime": null,
            "userPriority": 0,
            "trunkNo": 65535,
            "logontimes": 0,
            "mediaType": 5,
            "mediaAbility": 1,
    	"waitTime": 0,
            "trace": null
        }
    }