- 最新动态
- 产品介绍
- 快速入门
-
用户指南
- 云控制台操作指南
-
租户管理员指南
- 认识您的租间
- 配置员工中心
- 启用人工服务
- 配置移动客服
- 配置多媒体渠道
-
机器人管理配置指南
- 快速入门
-
配置智能机器人
- 概述
- 配置一个预约挂号机器人(任务型对话机器人)
- 添加问答型对话机器人
- 其他操作
-
相关参考
- 图元
- 参数
-
TUC接口
- /chatbot/rest/tuc/v1/nlp/detectRegularEntity
- /chatbot/rest/tuc/v1/nlp/identify
- /chatbot/rest/tuc/v1/recommendFaq
- /chatbot/rest/tuc/v1/qualityInspection/qiOnline/recognize
- /chatbot/rest/tuc/v1/nlp/feedback
- /chatbot/rest/tuc/v1/nlp/textClassify
- /chatbot/rest/tuc/v1/nlp/detectEntity
- /chatbot/rest/tuc/v1/qualityInspection
- 内置函数
- 常见问题
- 操作员:配置普通IVR
- 配置预置流程
- IVR Journey分析
- 外呼风险监控
- 管理工单配置
- 质检管理
- 管理通知中心
- 管理客户中心
- 配置智能外呼
- 管理问卷
- 管理智能实训
- 配置知识库
- 配置公共资源
- 业务故障放通管理
- 护航浏览
- 社交媒体运营
- 绩效管理
- 客服座席指南
- 质检员指南
- 价格说明
-
开发指南
- 开发概述
- 用户接入——VOIP音视频接入
- 用户接入——网页版客户端集成 (RESTful)
- 用户接入——网页版轻量级客户端集成 (JS)
- 座席集成——座席轻量级接续块集成(JS)
- 座席集成——座席呼叫处理 (RESTful)
-
座席集成——Openeye H5 软电话接口集成
- 修订记录
- OpenEye H5软电话接口概述
- OpenEye软电话安装指导
- 座席侧集成H5软电话开发指导
- 音频呼叫接口
-
音视频呼叫接口扩展
- 音视频呼叫
-
设备管理
- getMediaDevices(获取设备列表)
- setMicIndex(设置麦克风)
- mediaGetMicIndex(查询当前使用的麦克风)
- setSpeakIndex (设置扬声器)
- mediaGetSpeakIndex (查询当前使用的扬声器)
- setMicVol(设置麦克风音量)
- getMicVol(查询麦克风当前音量)
- setSpkVol(设置扬声器音量)
- getSpkVol(查询扬声器当前音量)
- setVideoWindowParam(设置视频窗口位置和宽高)
- setVideoLayoutMode(设置视频窗口画面排列模式)
- setVideoDisplayMode(设置视频窗口画面裁剪模式)
- openCamera(打开摄像头)
- closeCamera(关闭摄像头)
- 屏幕共享
- 截屏
- 录屏
- 错误码列表
- 运营管理——座席工作台集成第三方Web页面
-
API参考
- 接口概述
- 相关术语
- 修改记录
- 接口鉴权方式
-
呼叫中心配置类
-
座席管理
- 单个创建座席业务账号(agentAccount/create)
- 单个删除指定座席业务账号(agentAccount/delete)
- 单个修改座席业务账号信息(agentAccount/update)
- 查询座席业务账号信息(agentAccount/query)
- 绑定座席和技能队列(addSkillsToAgent)
- 解绑座席某技能队列(releaseAgentBySkillId)
- 通过技能队列ID查询座席信息(queryAgentInfoBySkillId)
- 修改座席软电话号码登录密码(updateSipPhonePassword)
- 查询所有座席的软电话信息 (不包含业务账号) (querySysInfo)
- 查询所有座席的软电话信息 (包含业务账号) (queryAgentInfo)
- 查询账号登录结果 (queryAgentLoginParams)
- 根据登录账号查询座席信息 (queryAgentInfoByAccount)
- 按客户号码清理数据 (cleancustpersonaldata)
- 技能队列管理
- 号码管理
- IVR流程管理
-
座席管理
-
座席工作台
- 座席控制
-
座席双呼
- 创建双呼呼叫 (V1.0.0) (createCall)
- 创建双呼呼叫 (V3.0.0) (createCall)
- 查询呼叫历史记录 (queryCallDetailRecord)
- 查询呼叫状态 (queryCallState)
- 获取录音文件地址 (getRecordingAddress)
- 查询分配的软电话号码 (V1.0.0) (queryPhone)
- 查询分配的软电话号码 (V2.0.0) (queryPhone)
- 获取呼叫目的设备信息 (getCalledInfo)
- 创建语音外呼(V1.0.0)(createVoiceNotification)
- 创建语音外呼(V2.0.0)(createVoiceNotification)
- 查询当前会话客户的最近历史接触记录(queryUserContactLimit)
- 查询通话信息(queryCallInfoByCallId)
- ITA双呼结果通知(statusnotify)
- 回调接口
- 订阅语音识别结果接口
- App个人设置
- 附录
- 电销外呼
- 调查问卷
- 知识库管理
- 机器人管理
-
网页客户端接入
- 接口调用流程
- 第三方请求鉴权 (applyToken)
- 查询排队信息 (queryQueueInfo)
- 主动轮询座席侧发送的信息 (poll)
- 保存客户提交的满意度评价结果 (saveSatisfaction)
- 发送消息 (send)
- 客户发送文件 (uploadFileStream)
- 客户接收文件 (downloadFileStream)
- 根据客户输入联想常用语 (queryPhraseByKeyword)
- 检查当前租间是否支持点击通话 (checkClickToCallSupport)
- 创建点击通话 (createClickToCall)
- 获取点击通话事件 (getClickToCallEvents)
- 释放点击通话 (dropClickToCall)
- 创建匿名通话 (createcall)
- 客户提交留言 (doLeaveMessage)
- 提交客户对机器人满意度评价结果 (feedbacksatisfaction)
- 查询历史消息 (queryHistoryChatMessage)
- 丢弃邮件(chat_dropMail)
- 提供whatsapp发送下行消息(sendWhatsappMessage)
- 查询在线交谈工作台当前交谈的消息(getUserInfoBycallId)
- 查询满意度调查配置(getSatisfactionSurveyMode)
-
质检/监控/统计类
- 实时质检:qualitycontrol
-
智能质检
- 质检评分接口 (scoresetting)
- 句子管理接口 (sentencemanagement)
- 敏感词管理接口 (sensitiveWordManage)
- 话术接口 (conversationspecific)
- 句子、敏感词训练接口 (SemanticKeywordTraining)
- 对话逻辑接口 (conversationflow)
- 对话规则接口 (conversationrules)
- 抢插话规则接口 (interposalrules)
- 静默规则接口 (silencerule)
- 语速规则接口 (speedrule)
- 质检场景管理接口 (scenariomanage)
- 通话质检接口 (qualitycheckmanage)
- 人工抽检任务接口 (regularQualityTask)
- 质检任务接口 (qualitytask)
- 质检任务详情接口 (qualitytaskdetail)
- 质检申诉接口 (qualityitem)
- 第三方录音质检接口 (asrtrans)
-
监控/统计
-
实时数据查询类接口
-
VDN维度实时接口
- 查询指定VDN下的系统接入码信息
- 查询指定VDN下的座席休息情况
- 查询指定VDN下的座席电话号码
- 查询指定VDN下的所有座席信息
- 查询指定VDN下的所有座席的当前状态信息
- 查询指定VDN下的所有座席的静态配置信息
- 查询指定VDN下的IVR详细状态信息
- 查询指定VDN下的IVR流程接入码信息
- 查询指定VDN下的各技能队列相关信息
- 查询指定VDN所有休息原因码
- 查询指定接入码编号的呼叫信息
- 查询指定VDN下的呼叫信息
- 查询指定VDN下的呼叫信息(v2)
- 查询指定VDN下的通话轨迹数据
- 查询指定VDN下的所有座席的静态配置信息(CTI3.6版本不支持)
- 查询指定VDN下的所有座席信息(CTI3.6版本不支持)
- 获取VDN实时监控指标
- 技能队列维度实时接口
- 座席维度实时接口
- 呼叫明细维度实时接口
-
VDN维度实时接口
- 历史数据查询类接口
- 配置数据查询类接口
- 质检关系维护接口
- 外呼任务列表查询接口
- 系统指标查询接口
- 健康检查接口
- 附录
-
实时数据查询类接口
- 录音/话单类
- 语音通知
- OMA接口参考
- Case2.0接口参考
- DataProcess接口参考
- 其他类接口参考
- 常见问题
- 文档下载
- 通用参考
链接复制成功!
获取通话的状态及ASR结果
场景描述
获取通话的状态及ASR结果接口
接口方法
POST
接口URI
https://域名/apiaccess/CCSQM/rest/ccisqm/v1/appraisecall/details,例如域名是service.besclouds.com
请求说明
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1 |
Content-Type |
string |
False |
固定填 application/json; charset=UTF-8。 |
2 |
x-app-key |
string |
False |
appKey标识 |
3 |
Authorization |
string |
True |
鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格) |
4 |
x-UserId |
string |
True |
操作员标识 可在登录后,进入员工管理页面,查看接口返回的userId |
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1.1 |
call_from |
number |
False |
通话起始时间 :时间戳,单位秒 |
1.2 |
call_to |
number |
False |
通话结束时间 :时间戳,单位秒 |
1.3 |
call_types |
array[integer] |
True |
通话文件类型
|
1.4 |
limit |
integer |
True |
每页查询总数 |
1.5 |
page |
integer |
True |
查询页数 |
1.6 |
status |
array[integer] |
True |
质检状态:
|
1.7 |
keyword |
string |
False |
对话关键词 |
1.8 |
staff_id |
string |
False |
座席人员的userId 可在登录后,进入座席管理页面,查看接口返回的accountId |
1.9 |
staff_name |
string |
False |
座席姓名 |
1.10 |
upload_from |
number |
True |
通话上传起始时间 |
1.11 |
upload_to |
number |
True |
通话上传结束时间 |
1.12 |
duration_min |
integer |
False |
通话时长范围最小值 |
1.13 |
duration_max |
integer |
False |
通话时长范围最大值 |
响应说明
- 响应状态码: 200
序号 |
名称 |
参数类型 |
是否必选 |
说明 |
---|---|---|---|---|
1.1 |
paging |
object |
False |
页码信息 |
1.1.1 |
total |
number |
False |
通话总数量 |
1.2 |
data |
array[object] |
False |
通话信息列表 |
1.2.1 |
calls |
array[object] |
False |
多通通话信息 |
1.2.1.1 |
call_id |
string |
False |
会话标识 |
1.2.1.2 |
call_time |
number |
False |
通话时间 |
1.2.1.3 |
call_type |
number |
False |
文件类型 |
1.2.1.4 |
call_uuid |
string |
False |
会话uuid |
1.2.1.5 |
deal |
number |
False |
业务是否成交 |
1.2.1.6 |
duration |
number |
False |
通话时长 |
1.2.1.7 |
file_name |
string |
False |
文件名称 |
1.2.1.8 |
left_channel |
string |
False |
渠道信息,标识客户或者座席 |
1.2.1.9 |
left_silence_time |
number |
False |
静音时间 |
1.2.1.10 |
left_speech_ratio |
number |
False |
左声道通话比例,发话方取决于left_channel字段。 |
1.2.1.11 |
left_speed |
number |
False |
左声道语速 |
1.2.1.12 |
right_channel |
string |
False |
渠道信息,标识客户或者座席 |
1.2.1.13 |
right_silence_time |
number |
False |
静音时间 |
1.2.1.14 |
right_speech_ratio |
number |
False |
右声道通话比例 |
1.2.1.15 |
right_speed |
number |
False |
右声道语速 |
1.2.1.16 |
staff_id |
string |
False |
座席人员的userId 可在登录后,进入座席管理页面,查看接口返回的accountId |
1.2.1.17 |
status |
number |
False |
状态
|
1.2.1.18 |
upload_time |
number |
False |
通话上传时间 |
1.2.1.19 |
staff_name |
string |
False |
座席姓名 |
1.2.2 |
call_group_id |
string |
False |
呼叫组 ID |
- 响应状态码: 400
错误的请求:请检查请求路径及参数。
- 响应状态码: 401
未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
- 响应状态码: 404
请求的内容未找到:请检查请求的路径。
- 响应状态码: 500
业务失败:请依次确认您请求中各参数的取值。
错误码
无。
报文样例
- 场景描述:获取通话的状态及ASR结果接口
x-app-key:************************************ X-UserID:1611917095665261978 Authorization:Bearer ********************************
请求参数:
{ "limit": 10, "page": 1, "call_types": [0, 2], "staff_id": null, "upload_from": 1621333149, "upload_to": 1623925149, "status": [2] }
响应参数:
{ "data": [{ "calls": [{ "staff_name": "*****", "create_time": 1622633782, "left_speed": 241.552, "left_speech_ratio": 0.4613, "file_name": "Consultant", "left_channel": "customer", "right_speech_ratio": 0.3252, "call_time": 1622633782, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "3b9cd7a9-d38c-4aa0-a35d-77f6abb9f497", "left_silence_time": 88.46, "duration": 164.22, "upload_time": 1622633782, "right_silence_time": 110.82, "right_speed": 165.169, "staff_id": "1600226440112042215", "call_uuid": "3b9cd7a9-d38c-4aa0-a35d-77f6abb9f497", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "3b9cd7a9-d38c-4aa0-a35d-77f6abb9f497" }, { "calls": [{ "staff_name": "*****", "create_time": 1622554272, "left_speed": 307.127, "left_speech_ratio": 0.251, "file_name": "myvoice", "left_channel": "customer", "right_speech_ratio": 0.206, "call_time": 1622554272, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "2ef38e9b-36dd-4c1f-97cb-a665a2d9de3a", "left_silence_time": 260.03, "duration": 347.16, "upload_time": 1622554272, "right_silence_time": 275.65, "right_speed": 318.837, "staff_id": "1600226440112042215", "call_uuid": "2ef38e9b-36dd-4c1f-97cb-a665a2d9de3a", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "2ef38e9b-36dd-4c1f-97cb-a665a2d9de3a" }, { "calls": [{ "staff_name": "*****", "create_time": 1622552201, "left_speed": 305.061, "left_speech_ratio": 0.251, "file_name": "myvoice", "left_channel": "customer", "right_speech_ratio": 0.206, "call_time": 1622552201, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "4aca6bb8-13e6-4fd8-ac5b-0402fbb5bef4", "left_silence_time": 260.03, "duration": 347.16, "upload_time": 1622552201, "right_silence_time": 275.65, "right_speed": 319.676, "staff_id": "1600226440112042215", "call_uuid": "4aca6bb8-13e6-4fd8-ac5b-0402fbb5bef4", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "4aca6bb8-13e6-4fd8-ac5b-0402fbb5bef4" }, { "calls": [{ "staff_name": "*****", "create_time": 1622552093, "left_speed": 324.068, "left_speech_ratio": 0.6081, "file_name": "6335", "left_channel": "customer", "right_speech_ratio": 0.185, "call_time": 1622552093, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "4a8507ec-8519-46ab-9ca7-241556a6eb6c", "left_silence_time": 40.8, "duration": 104.12, "upload_time": 1622552093, "right_silence_time": 84.86, "right_speed": 230.53, "staff_id": "1600226440112042215", "call_uuid": "4a8507ec-8519-46ab-9ca7-241556a6eb6c", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "4a8507ec-8519-46ab-9ca7-241556a6eb6c" }, { "calls": [{ "staff_name": "*****", "create_time": 1622528466, "left_speed": 307.127, "left_speech_ratio": 0.251, "file_name": "myvoice", "left_channel": "customer", "right_speech_ratio": 0.206, "call_time": 1622528466, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "ead642de-fa23-4bc0-adf5-f2bac9614b01", "left_silence_time": 260.03, "duration": 347.16, "upload_time": 1622528466, "right_silence_time": 275.65, "right_speed": 321.354, "staff_id": "1600226440112042215", "call_uuid": "ead642de-fa23-4bc0-adf5-f2bac9614b01", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "ead642de-fa23-4bc0-adf5-f2bac9614b01" }, { "calls": [{ "staff_name": "*****", "create_time": 1622513361, "left_speed": 306.439, "left_speech_ratio": 0.251, "file_name": "20208650", "left_channel": "customer", "right_speech_ratio": 0.206, "call_time": 1622513361, "inspect_status": 0, "right_channel": "staff", "complain_status": -1, "call_id": "1e158a1a-2f6d-44f6-ba44-b15d52e21651", "left_silence_time": 260.03, "duration": 347.16, "upload_time": 1622513361, "right_silence_time": 275.65, "right_speed": 320.515, "staff_id": "1600226440112042215", "call_uuid": "1e158a1a-2f6d-44f6-ba44-b15d52e21651", "review_status": -1, "call_type": 0, "status": 2 }], "call_group_id": "1e158a1a-2f6d-44f6-ba44-b15d52e21651" }], "paging": { "total": 6 } }