# 查询呼叫信息 #### 前置条件 - 座席已签入 #### 场景描述 座席签入后，查询呼叫信息。 #### 接口方法 置成"GET"。该接口仅支持GET方法，不支持PUT、POST和DELETE等方法。 #### 接口URI https://ip:port/agentgateway/resource/calldata/{agentid}/callinfo?isNoContainLastCall={isNoContainLastCall} ![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png) 如果CC-Gateway单机部署，IP地址为CC-Gateway服务器地址，port为CC-Gateway服务器的HTTPS端口号，默认值为8043；如果CC-Gateway采用集群模式部署，IP请配置为NSLB地址， Port请配置为默认值8043。 NSLB上的CC-Gateway端口号，请以nslb用户登录任意一个NSLB节点，执行./nslbctl l查询，查询结果中，如下端口表示CC-Gateway通过NSLB面向第三方系统开放的端口。 ![](https://support.huaweicloud.com/api-ccfs-cec/figure/zh-cn_image_0000002204207349.png) SaaS场景下请咨询运维人员获取IP和Port。 表1URI中携带的参数说明 | 序号 | 参数名 | 数据类型 | 选取原则 | 说明 | |:---|:---|:---|:---|:---| | 1 | agentid | string | True | 座席的工号，取值范围：101～999999。 | | 2 | isNoContainLastCall | boolean | False | 当前座席无呼叫时，是否查询上一通呼叫信息。取值范围： - true：查询 - false：不查询 | #### 日志中的方法名 queryCallInfo #### 请求说明 - 消息头 表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 | object | 查询成功后，返回呼叫信息对象。 该对象的参数说明请参见[表4]。 | 表4result对象参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 3.1 | callfeature | int | 呼叫类型，请参考[呼叫类型](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0582.html#ZH-CN_TOPIC_0000002513233643) | | 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 | 随路数据 该接口查询的信息来源于呼叫缓存而非实时查询，若呼叫中随路数据发生变更则该接口无法获取最新值，可通过[根据呼叫CallID查询呼叫信息](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0424.html#ZH-CN_TOPIC_0000002481273648)接口查询。 | | 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 | 呼叫轨迹扩展属性，请参见[表5] | 表5trace 对象参数说明 | 序号 | 名称 | 参数类型 | 说明 | |:---|:---|:---|:---| | 3.17.1 | waitBeginTime | long | 等待开始时间，时间戳（毫秒） | | 3.17.2 | waitEndTime | long | 等待结束时间，时间戳（毫秒），不支持查上一通的呼叫信息 | | 3.17.3 | answerBeginTime | long | 应答开始时间，时间戳（毫秒） | | 3.17.4 | answerEndTime | long | 应答结束时间，时间戳（毫秒），不支持查上一通的呼叫信息 | | 3.17.5 | talkBeginTime | long | 谈话开始时间，时间戳（毫秒） | | 3.17.6 | talkEndTime | long | 谈话结束时间，时间戳（毫秒），不支持查上一通的呼叫信息 | | 3.17.7 | deviceNo | int | 设备编号 | | 3.17.8 | deviceType | int | 设备类型。取值如下 - 1：呼叫队列 - 2：人工座席 - 3：自动流程 - 4：会场资源 - 5：成对呼叫 - 6：座席队列 - 7：普通电话 | | 3.17.9 | callDirectMode | string | 此设备的处理方式，即离开设备的原因。取值如下 - NORMAL_DIRECT：正常离开 - KEEP_DIRECT：保持 - WAIT_DIRECT：等待 - RELEASE_DIRECT：释放 | | 3.17.10 | enterReason | int | 进入此设备的原因，参见[表6] | | 3.17.11 | enterReasonDesc | string | 进入此设备的原因描述 | | 3.17.12 | leaveReason | int | 离开此设备的原因，参见[表6]，不支持查上一通的呼叫信息 | | 3.17.13 | leaveReasonDesc | string | 离开此设备的原因描述，不支持查上一通的呼叫信息 | | 3.17.14 | vdnId | int | VDN ID | 表6原因码 | 原因码 | 含义 | |:---|:---| | 0 | 普通接入/转移 | | 1 | 溢出转 | | 2 | 超时转 | | 3 | 无人上班转 | | 4 | 取消排队转移 | | 5 | 座席久不应答转 | | 6 | 挂起恢复 | | 7 | 连接保持 | | 8 | 三方求助 | | 9 | 取保持 | | 10 | 三方通话 | | 11 | 内部求助，求助方释放 | | 12 | 拦截 | | 13 | 代答 | | 14 | 呼叫的被叫分析未配置 | | 15 | 用户主动释放 | | 16 | 座席释放 | | 17 | 转出 | | 18 | 保持 | | 19 | 内部处理错误 | | 20 | 被叫忙 | | 21 | 线路忙 | | 22 | 手机关机 | | 23 | 手机不在服务区 | | 24 | 空号 | | 25 | 排队机无资源 | | 26 | 用户不应答 | | 27 | 被叫拒绝 | | 28 | 成功转队列 | | 29 | 三方转队列 | | 30 | 成功转队列超时 | | 31 | 三方转队列超时 | | 34 | 超时/溢出/遇忙网呼失败排队 | | 35 | 网呼回原中心排队 | | 36 | 排队的呼叫重路由 | | 37 | 由呼入路由进入 CDN | | 38 | 由座席咨询进入 CDN | | 39 | CDN 正常返回路由结果 | | 40 | CDN 路由超时 | | 41 | 咨询时座席取消 | | 42 | 由 CDN 路由超时进入 PGR | | 43 | 由 CDN 正常返回路由进入 PGR | | 44 | 由呼入路由进入 PGR | | 45 | 由座席咨询进入 PGR | | 46 | 座席不可达，CDN 重路由 | | 47 | 呼叫在多个队列排队 | | 48 | 在从队列中接听主队列呼叫 | | 50 | 座席拒绝呼叫 | | 51 | 用户呼叫进入电话会议 | | 52 | 会议主席主动释放会议，或 CSS 异常导致会议释放 | | 53 | 与会者被请出会议 | | 54 | 接通率低于阀值转接 | | 88 | 座席接通后，用户挂机 | | 89 | 座席应答后，用户挂机 | #### 触发事件 - 无 #### 错误结果码 - 100-006 #### 报文样例 - 消息头 ``` Content-Type:application/json; charset=UTF-8 Guid：xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.AgentGateway1 ``` - 请求参数 无 - 响应参数 ``` { "message": "", "retcode": "0", "result": { "callfeature": 0, "callid": "1476838963-224", "caller": "70004", "called": "60015", "callskill": "voice", "callskillid": 20011, "orgicallednum": "", "calldata": "", "begintime": 1476838963000, "endtime": null, "userPriority": 0, "trunkNo": 65535, "logontimes": 0, "mediaType": 5, "mediaAbility": 1, "waitTime": 0, "trace": { "waitBeginTime": 1626179227000, "waitEndTime": 1626179227000, "answerBeginTime": 1626179227000, "answerEndTime": 1626179227000, "talkBeginTime": 1626179227000, "talkEndTime": 1626179227000, "deviceNo": 2005, "deviceType": 2, "callDirectMode": "NORMAL_DIRECT", "enterReason": 0, "enterReasonDesc": "Normal reason", "leaveReason": 0, "leaveReasonDesc": "Normal reason", "vdnId": 214 } } } ```