实时语音质检接入_智能对话分析(SCA)-阿里云帮助中心

阅读提示

请先阅读：实时语音质检对接方案

示例代码

sca-real-voice-sample.zip

示例运行配置

本示例工程的运行环境要求为JDK 8
根据接口请求中的描述，替换对应参数
运行 com.aliyun.sca.sample.SoundRecordSample

实时质检接口请求

请求链接

调用ApplyWsToken接口。参考文档：ApplyWsToken - 实时语音质检申领token
根据影响结果拼接链接，拼接规格 ${wsEndpoint}/${token}/${sessionId}
示例：wss://test.com/42e59bcd-7206-44c5-ad34-525d364687c4/35e59bcd-7206-44c5-ad34-525d364687c4

协议

参数、响应都是以json字符串形式

开启识别

请求参数解释

字段	类型	必填	描述	示例值
apiType	String	是	接口类型	START_TRANS
channelRole	String	是	角色类型	user agent
sampleRate	Integer	是	采样率	8000 16000

请求响应解释

名称	类型	描述	示例值
apiType	String	接口类型	START_TRANS
role	String	角色类型	user agent
code	String	code码 200：成功	200
success	boolean	调用是否成功	success
message	String	错误信息

示例说明

请求体

{
  "apiType": "START_TRANS",
  "channelRole": "user",
  "sampleRate":8000 
}

响应体

{
    "code": "200",
    "apiType": "START_TRANS",
    "role": "user",
    "success": true
}

发送语音流

请求参数解释

字段	类型	必填	描述	示例值
apiType	String	是	接口类型	LIVE_VOICE_TRANS
channelRole	String	是	角色类型	user agent
channelRoleId	Integer	是	客户/客服ID	121
channelRoleName	String	是	客户/客服名称	测试坐席
data	byte[]	是	语音字节包大小限制：1000～6000

请求响应解释

仅发送异常响应

名称	类型	描述	示例值
apiType	String	接口类型	LIVE_VOICE_TRANS
role	String	角色类型	user agent
code	String	code码 200：成功	200
success	boolean	调用是否成功	success
message	String	错误信息

示例说明

请求体

{
  "apiType": "START_TRANS",
  "channelRole": "user",
  "channelRoleId":121,
  "channelRoleName":"测试坐席" 
}

响应体

{
    "code": "InternalError",
    "apiType": "LIVE_VOICE_TRANS",
    "role": "user",
    "success": false,
    "message":"服务器内部错误，请联系管理人员"
}

关闭识别

请求参数解释

字段

类型

必填

描述

示例值

apiType

String

是

接口类型

CLOSE_TRANS

channelRole

String

是

角色类型

user

agent

请求响应解释

仅发送异常响应

名称	类型	描述	示例值
apiType	String	接口类型	CLOSE_TRANS
role	String	角色类型	user agent
code	String	code码 200：成功	200
success	boolean	调用是否成功	success
message	String	错误信息

示例说明

请求体

{
  "apiType": "CLOSE_TRANS",
  "channelRole": "user"
}

响应体

{
    "code": "200",
    "apiType": "CLOSE_TRANS",
    "role": "user",
    "success": true
}

更新质检状态

请求参数解释

字段

类型

必填

描述

示例值

apiType

String

是

接口类型

UPDATE_QUALITY_STATE

voiceFileUrl

String

是

录音文件地址，用于复核时录音回放，URL 必须是基于 HTTP 可访问的 URL 地址，不支持提交本地文件；URL 只能使用域名，不能使用 IP 地址，URL 中不可包含空格，请尽量避免使用中文；录音文件访问权限需要为公开，并且保证长期有效，否则在查看文件详情/文件复核时无法播放录音。

user

agent

请求响应解释

仅发送异常响应

名称	类型	描述	示例值
apiType	String	接口类型	UPDATE_QUALITY_STATE
role	String	角色类型	user agent
code	String	code码 200：成功	200
success	boolean	调用是否成功	success
message	String	错误信息

示例说明

请求体

{
    "apiType": "UPDATE_QUALITY_STATE",
    "voiceFileUrl":""
}

响应体

{
    "code": "200",
    "apiType": "UPDATE_QUALITY_STATE",
    "success": true
}

质检结果

响应结果示例

字段					类型	描述	示例值
apiType					String	接口类型	QUALITY_CHECK
role					String	角色	user agent
code					String	code码 200：成功	200
success					boolean	调用是否成功	success
message					String	错误信息
data					Object
	taskId				String	任务ID	20250124-7ee474b9-a1ea-4f01-ae19-d2aa9730302a
	tid				String	当前对话唯一标识。	2025012461299a20-6ece-4f71-a95f-93e350150d35
	rules				array<object>	命中的规则列表，每一条为一个规则，只返回命中的规则信息和命中规则位置信息。
		rname			String	命中规则的名称	通话时长超长/超短_副本6
		rid			String	命中规则的ID	131
		ruleInfoBase
			level		Integer	规则重要程度	2
			comments		String	规则备注	邀约客户，客户不同意参加试听
			scoreNum		Integer	计分值	1
			scoreType		Integer	加减分 1：加分（默认） 3：减分	1
			scoreNumType		Integer	计分类型 0：加减分 1：一次性得分	1
			type		Integer	规则类型ID	1
			ruleCategoryName		String	规则类型名	服务规范
		hit			array<object>	条件命中的关键字
			keyWords		object	条件命中的关键字
				to	Integer	关键字的结束位置。	4
				from	Integer	关键字的起始位置。	1
				val	String	关键字。	你好
				cid	Integer	规则的条件 ID。	2312
				pid	Integer	命中句子在全部对话中的下标值。	4
			phrase		object	条件命中的对话内容
				words	String	对话内容	你好请问有什么可以帮您的
				begin	Long	本句相对于整个对话的开始时间，单位：毫秒。	121
				emotionValue	Integer	本句的情绪值，0-10，值越大情绪越高。	3
				end	Long	本句相对于整个对话的结束时间，单位：毫秒。	322
				speechRate	Integer	本句语速单位：字/分钟。	122
				role	String	本句的角色，取值：客服、客户。	客服

示例说明

响应体

{
    "highlight": [
        {
            "28125": [
                {
                    "val": "14520",
                    "pid": -1,
                    "from": 0,
                    "oid": "28125",
                    "to": 1,
                    "tid": "2025012461299a20-6ece-4f71-a95f-93e350150d35",
                    "cid": "27385"
                }
            ],
            "oid": [
                "28125"
            ],
            "cid": "27385"
        }
    ],
    "ruleInfoBase": {
        "checkType": 2,
        "hitNumScore": false,
        "hitRuleNum": 0,
        "isHitNumScore": 0,
        "ruleScoreType": 3,
        "scoreType": 3,
        "schemeId": 538,
        "schemeVersion": 1737447073838,
        "autoReview": 1,
        "scoreNumType": 0,
        "name": "通话时长超长/超短_副本6",
        "hitNumScoreInfo": [

        ],
        "scoreNum": 5
    },
    "hit": [
        {
            "keyWords": [
                {
                    "val": "14520",
                    "from": 0,
                    "pid": -1,
                    "oid": "28125",
                    "to": 1,
                    "tid": "2025012461299a20-6ece-4f71-a95f-93e350150d35",
                    "cid": "27385"
                }
            ],
            "cid": [
                "27385"
            ]
        }
    ],
    "hitRuleDialogueList": [

    ],
    "rname": "通话时长超长/超短_副本6",
    "rid": "14759"
}