通话记录查询

服务描述

本接口,可用于查询租户下通话记录,并分页返回通话的数据

开发须知

调用本接口前,请先获取appId

服务地址

GET https://{您的专属域名}/speech/openapi/v1/communicate/pageQuery

请求参数

参数 位置 类型 是否必填 说明
appId header String Y 应用ID
timestamp header String Y 时间戳,毫秒
sign header String Y 签名
Content-Type header String Y application/json
queryMode param Integer N 查询模式(1:所有;2:待提交话务的通话记录,3:已提交话务的通话记录),默认:1
userId param Long N 坐席id;不传时查询租户所有通话记录
callType param Integer N 呼叫类型(1:呼入,2:呼出,3:自动外呼)
startDate param String N 开始日期,例如20200227
endDate param String N 结束日期,例如20200227
callResult param Integer N 呼叫结果(0:未知,1:无法接通,2:已接通,3:无人应答,4:队列放弃,5:非服务时间,6:振铃未接,7:客户速挂,8:IVR中放弃)
evaluationScore param Integer N 满意度(0,1,2,3,4,5)
callNumber param String N 主叫号码或被叫号码
nameOrPhoneOrRelay param String N 客户姓名、客户号码或中继号
pageNum param Integer N 页号,由0开始(默认1)
pageSize param Integer N 每页数据条数(默认20)
请求示例数据:
GET https://abc.xyz/speech/openapi/v1/communicate/pageQuery?pageNum=0&pageSize=10
sign: fo1OWX+JnfeonAFSGau2gwP1GvFa+RTw5czoBWoz+k3AjV8scDl6JnvFRDj8Lgt1nQxLlmcOhIBN4j7pEE/NAzYjXUFSGo308f5V9dHBnmGLYsqKmgma4cQZLBqHp9T43IZfRX8Zh2/Hp2HOmfTgos/L8GN6YPA8fQ2d5tbtJZrrkBuwA/LEezjOJxSRRRCrcS1ZFVvTZ+cIjYeO4QdC5r5I67LLY/nLbFAFUdQsCzUIytO09vUCLGlKierNhPfCtMzTgZSE9dWO5zJ3L2uCsXM7Od6mPROVpddVafF+BueKjtbL10PwDc9f1eBpGTpgmbOy8Bbx3NIyCjDvhc9Mag==
appId: 99845aaaaebd4d61acccc9b776208f12
timestamp: 1586314097995

返回结果

参数 类型 说明
code String 结果码
message String 结果描述
data PageInfo 分页对象
PageInfo
参数 类型 说明
pageNum String 当前页码
pageSize String 页大小
size Integer 当前页记录数
total Integer 总记录数
pages Integer 总页数
list CommunicateBaseVo 数据集合
CommunicateBaseVo
参数 类型 说明
callId String 通话记录ID
callType Integer 通话类型(1:呼入,2:呼出)
evaluationScore Integer 满意度
customerId String 客户ID
customerName String 客户姓名
noteStatus String 话务小结状态(1:待提交,2:已提交)
callTimeStr Integer 通话时间(2019-12-17 10:25:56)
summaryTitles String 通话小结
communicateDurationNum String 通话时长:00:00:00格式
staffId Integer 坐席ID
staffName String 坐席姓名
skillsetName String 技能组名称
callResult Integer 通话结果(0:未知,1:无法接通,2:已接通,3:无人应答,4:队列放弃,5:非服务时间,6:振铃未接,7:客户速挂,8:IVR中放弃)
custNumberAttribution String 客户手机号归属地
custIspName String 客户手机号运营商
communicateNote String 服务记录
customerNumber String 客户号码
relayNumber String 中继号
transferId Integer 转接(0:无转接;1:有转接)
hangUpDirectionType String 挂机方向
realCustomerNo String 真实号码
speechCallResult Integer 通话结果
communicateDuration Integer 通话时长
返回结果示例:
{
    "code": "10000",
    "message": "请求成功",
    "data": {
        "pageNum": 1,
        "pageSize": 20,
        "size": 20,
        "orderBy": null,
        "startRow": 1,
        "endRow": 20,
        "total": 55,
        "pages": 3,
        "list": [{
            "callId": "80a365c4-7f6e-41b5-857b-58041e82a60f",
            "callType": 3,
            "customerId": "080d2bcfedac41c9a0ecc409ab70db3e",
            "noteStatus": 1,
            "customerName": "18328597414",
            "callTimeStr": "2020-03-28 11:18:24",
            "callResult": 2,
            "summaryTitles": "",
            "communicateDurationNum": "00:00:08",
            "staffId": 19881238,
            "staffName": "test156-300003",
            "skillsetName": "",
            "communicateNote": null,
            "custNumberAttribution": "四川成都",
            "custIspName": "中国移动",
            "evaluationScore": 0,
            "relayNumber": "86073759",
            "customerNumber": "18328597414",
            "transferId": "0",
            "hangUpDirectionType": "AGENT_DROPPED_CALL",
            "realCustomerNo": "15308228114",
            "speechCallResult": 2,
            "communicateDuration": "17秒"
        }],
        "firstPage": 1,
        "prePage": 0,
        "nextPage": 2,
        "lastPage": 3,
        "isFirstPage": true,
        "isLastPage": false,
        "hasPreviousPage": false,
        "hasNextPage": true,
        "navigatePages": 8,
        "navigatepageNums": [1, 2, 3]
    }
}
结果码说明
结果码 说明
10000 请求成功
10001 鉴权失败
10002 找不到对应的公钥,请先上传公钥
20001 请求失败
29002 参数错误

``

FAQ:

  • 通话记录查询最大单页支持1000条

results matching ""

    No results matching ""