1.1 接口说明
在优音云客服系统中,可通过设置–>开发者中心,查看租户ID:tenant_id。
可通过 9.3查询通话记录V2.0 查询session_id。
根据tenant_id以及session_id进行呼叫会话记录详情查询
1.2 调用形式
1.3 调用方式
GET
1.4 传入参数
非必填参数,调用接口时请传递参数名,参数值可为空
序号 | 名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|---|
1 | session_id | String | 是 | 呼叫会话记录id |
2 | call_type | int | 否 | call_type=5对应云客服中语音通话高级搜索中呼叫类型为“API语音通知”筛选条件 |
3 | ver=1 | int | 是 | ver=1回应参数增加:hangup_reason字段、hangup_party字段; |
1.5 回应参数
序号 | 名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|---|
1 | errcode | Number | 是 | 状态码:0成功,及其他非0错误码,详见错误码列表 |
2 | errmsg | String | 是 | 状态说明 |
3 | data | Object数组 | 是 | 结果集 |
3.1 | session_id | String | 是 | 呼叫会话记录id |
3.2 | tags | String | 否 | 通话标签:无值为null,有值为具体JSON数据,举例: “tags”: { “tags”: [[“992c7700f52e5ca72a46a357d46599e5”],[ “895e681f1595de8bec31b6cbc702309a”,”8803ff165bd907013322b768542adc6c” ] ]} |
3.3 | summary | String | 否 | 备注 |
3.4 | call_direction | String | 是 | 呼叫方向:呼入 call in / 1 呼出 call out |
3.5 | ignore_times | Number | 是 | 连续未接来电次数,只有呼入(call in)有值(值为大于等于0);呼出值为null |
3.6 | satisfaction | String | 否 | 值范围:1/2/3/4,对应通话详情页面显示值,-2未进入满意度;-1进入满意度未按键 |
3.7 | record_file | String | 否 | 无值为null,有值为具体录音文件地址 |
3.8 | lists | String | 否 | 呼叫会话记录数据中包含的各呼叫片段数据 |
3.8.1 | id | String | 否 | 呼叫片段id |
3.8.2 | customer_id | String | 否 | 无关联的客户时为null |
3.8.3 | truename | String | 是 | 客户名称,场景1、customer_id为空, 当multi_match=true时, 为“多个匹配客户”,否则“未知客户”; 场景2、customer_id不为空,关联的客户姓名为空则为“未知客户”,不为空则为客户名称 |
3.8.4 | app_type | String | 否 | 应用类型 loginout:机呼入签入签出业务 callmemory:外呼来电记忆业务 app:IVR业务 queue:技能组业务 agent:座席业务 |
3.8.5 | service_type | String | 否 | 服务类型(IVR: IVR, queue:技能组,agent:座席,loginout:登出) |
3.8.6 | bussiness_num | String | 是 | 业务号码 |
3.8.7 | alterting_time | String | 否 | 来电(外呼)开始处理的时间点 |
3.8.8 | service_time | String | 否 | 服务时长(秒) |
3.8.9 | service_start_time | String | 否 | 服务开始时间 |
3.8.10 | service_stop_time | String | 否 | 服务结束时间 |
3.8.11 | queue_time | Number | 是 | 排队时长,单位秒,大于等于0的值 |
3.8.12 | ringing_time | Number | 是 | 振铃时间(秒) |
3.8.13 | answer_time | String | 是 | 接听时间 |
3.8.14 | ani | String | 否 | 主叫手机号查询 |
3.8.15 | ani_place | String | 否 | 主叫号码归属地 |
3.8.16 | dnis | String | 否 | 被叫手机号查询 |
3.8.17 | dnis_place | String | 否 | 被叫号码归属地 |
3.8.18 | call_direction | String | 否 | 呼叫方向:呼入 call in / 1 呼出 call out |
3.8.19 | title | String | 否 | 服务品质标签 |
3.8.20 | agent_num | String | 否 | 座席工号 |
3.8.21 | agent_name | String | 否 | 座席名称 |
3.9 | app_node_list | Object数组 | 否 | 呼叫轨迹。举例: “app_node_list”: { “rows”: [{“recDesc”: “响铃”, “starttime”: “2023-03-10 18:14:18”,”command”: “座席:张三(1001)[1001]”},{“recDesc”: “接听”,”color”: “#0bbd87”,”starttime”: “2023-03-10 18:14:25”,”command”: “座席:张三(1001)[1001]”},{“recDesc”: “挂机”,”starttime”: “2023-03-10 18:15:48”,”command”: “挂机”}]} |
3.10 | is_repeat | Boolean | 是 | 是否重复:true/false |
3.11 | cycle_period | Number | 是 | 重复来电周期:无值时为null,有值为具体数字,如0 / 24 / 48 |
3.12 | call_in_today_num | Number | 是 | 当日呼入次数 |
3.13 | call_in_all_num | Number | 是 | 总呼入次数 |
3.14 | associate_datas | Object数组 | 否 | 随录数据,无值为空数组[];有值时为JSON数组;举例: “associate_datas”: [{“agent_num”: 1001,”agent_name”: “张三(1001)”,”remark”: “电话测试备注2”,”submit_at”: “2023-03-10 11:33:42”},{“agent_num”: 1001,”agent_name”: “张三(1001)”,”remark”: “电话测试”,”submit_at”: “2023-03-10 11:33:28”} |
3.15 | hangup_reason | Number | 是 | 挂机原因: 1 有座席已接听来电(不代表转接的座席也接听来电); -1 振铃未接听来电;-2 黑名单导致来电挂断; 2 排队放弃; 3 已留言; 4 IVR; 5 外呼失败 当接听状态为空号时,hangup_reason为以下值: 点击查看详情
|
3.16 | hangup_party | String | 否 | 挂断方:1-客户挂断、2-坐席挂断、4-系统挂断 无值默认空字符串 |
3.17 | remark | String | 否 | remark |
3.18 | record_text_file | Object数组 | 否 | 点击查看详情
|
1.6 使用样例
调用
请求
响应
{
"errcode": 0,
"errmsg": "success",
"data": {
"session_id": "09cf9b7e-d89b-123d-099d-00163e10e4c6",
"call_type": "",
"hangup_reason": 1,
"hangup_party": "1",
"tags": null,
"remark": "",
"summary": "",
"call_direction": "call in",
"ignore_times": 0,
"satisfaction": null,
"record_file": "https://ipphone-cnsh-aliyun00-cti.uincall.com/ykfRecord?url=2024/08/19/4000159618/4000159618_09cf9b7e-d89b-123d-099d-00163e10e4c6_02985790636_09314222494__20240819145647_dr.wav",
"record_text_file": {
"msg": [
{
"bg": "1700",
"speaker": "0",
"onebest": "你好啊你好,录音转文字,录音转文字看一下。",
"ed": "7020"
},
{
"bg": "7260",
"speaker": "0",
"onebest": "看一下转文字的效果怎么样。",
"ed": "11640"
},
{
"bg": "10360",
"speaker": "1",
"onebest": "你好。",
"ed": "10980"
},
{
"bg": "15680",
"speaker": "1",
"onebest": "喂喂喂。",
"ed": "16900"
},
{
"bg": "20720",
"speaker": "1",
"onebest": "喂喂喂喂喂喂。",
"ed": "22599"
},
{
"bg": "24980",
"speaker": "1",
"onebest": "坐席在说话,坐席再说话。",
"ed": "28000"
},
{
"bg": "25320",
"speaker": "0",
"onebest": "我今天。",
"ed": "26540"
},
{
"bg": "29540",
"speaker": "1",
"onebest": "拜拜拜拜。",
"ed": "30960"
},
{
"bg": "36440",
"speaker": "0",
"onebest": "嗯,这是谁在说话呀?",
"ed": "39976"
},
{
"bg": "39976",
"speaker": "0",
"onebest": "这是。",
"ed": "40860"
},
{
"bg": "41180",
"speaker": "0",
"onebest": "本课本课是主教。",
"ed": "45120"
},
{
"bg": "43640",
"speaker": "1",
"onebest": "主线。",
"ed": "44640"
},
{
"bg": "45500",
"speaker": "1",
"onebest": "访客。",
"ed": "46400"
},
{
"bg": "45620",
"speaker": "0",
"onebest": "访客是主教,主教打的坐席。",
"ed": "50156"
},
{
"bg": "47700",
"speaker": "1",
"onebest": "去吧。",
"ed": "48340"
},
{
"bg": "50157",
"speaker": "0",
"onebest": "坐席是被教。",
"ed": "52220"
},
{
"bg": "59260",
"speaker": "1",
"onebest": "被叫是坐席。",
"ed": "61490"
},
{
"bg": "61490",
"speaker": "1",
"onebest": "被叫是坐席。",
"ed": "63720"
},
{
"bg": "67280",
"speaker": "1",
"onebest": "挂了吧。",
"ed": "68320"
}
],
"duration": 72,
"code": 200,
"op_answer_time": "2024-08-19 14:56:47",
"status": "01"
},
"lists": [
{
"id": "c2eba707-de97-401f-c0fb-48f8cd5425bd",
"customer_id": "691ec31b8dcd9b0b8d92e0ea10e68ba6",
"truename": "杨梅算",
"app_type": "agent",
"service_type": "agent",
"bussiness_num": "4000159618",
"alterting_time": "2024-08-19 14:56:45",
"service_time": 72,
"service_start_time": "2024-08-19 14:56:45",
"service_stop_time": "2024-08-19 14:57:59",
"queue_time": 0,
"ringing_time": 2,
"answer_time": "2024-08-19 14:56:47",
"ani": "02985790636",
"ani_place": "陕西西安",
"dnis": "09314222494",
"dnis_place": "甘肃兰州",
"call_direction": "call in",
"title": null,
"agent_num": "8004",
"agent_name": "小洁"
}
],
"app_node_list": {
"rows": [
{
"recDesc": "8004技能组",
"starttime": "2024-08-19 14:56:45",
"command": "技能组"
},
{
"recDesc": "响铃",
"starttime": "2024-08-19 14:56:45",
"command": "座席:小洁[8004]"
},
{
"recDesc": "接听",
"color": "#0bbd87",
"starttime": "2024-08-19 14:56:47",
"command": "座席:小洁[8004]"
},
{
"recDesc": "挂机",
"starttime": "2024-08-19 14:57:59",
"command": "挂机"
}
]
},
"is_repeat": true,
"cycle_period": 24,
"call_in_today_num": 0,
"call_in_all_num": 0,
"associate_datas": []
}
}
文档更新时间: 2024-09-24 14:36 作者:admin