AI智能化接口
语音实时智能质检
使用场景
在需要对话务员进行敏感词监控的系统中,通过调用该接口,可实时将话务员的语音全程分句转写成文本,并经由 HTTP 接口上报给质检系统进行处理。
实现流程
略
Get请求参数说明
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| caller | 主叫号码 | |
| callee | 被叫号码 | |
| callid | 通话唯一标识,被叫callid | |
| caller-callid | 主叫callid | 用于关联外呼弹屏消息 |
| side | 哪一方的说话内容 | caller: 主叫 callee: 被叫 |
| txt | 说话内容 | URLEncoder UTF-8的编码后的字符串 |
配置方法
开启分机号码的语音质检功能
配置通知接口:
注:配置的地址,应该是您自己的系统处理语音转文本通知的URL完整地址。
设置质检模式:

语音实时转文字RokectMQ接口
使用场景
为了赋能网页智能填单、知识库推荐等智能化功能,系统可以利用Alibaba开源的RocketMQ作为消息中间件。借助其高可靠的异步消息传递能力,坐席与客户的实时通话文本得以稳定、高效地送达对接系统进行处理。
实现流程
- 前置条件:已经开通和配置好了语音识别。
- 对接资料:
- apache官方 RocketMQ 资料:https://rocketmq.apache.org/docs/simple-example/
- rocketmq-java 代码参考:https://github.com/JasonLiGit/rocketMQDemo
配置方法

交互接口描述
坐席通话中,调用该接口,启动语音识别
http://x.x.x.x:12121/bridge/callctrl?extnum=801&opt=STT_ON_TALKING_START&seat_id=jxt_001
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| extnum | 通话相关的分机号码 | |
| seat_id | 扩展字段,字段名和值可以任意字符串,只要符合URL字符规范即可 | 扩展字段可原封不动的通过MQ Json消息透传。方便业务和消息进行关联 |
| opt | STT_ON_TALKING_START | 固定值,不要变动 |
| x.x.x.x | 呼叫中心服务器IP地址 |
返回结果:
- 200:成功
- 404:分机号(extnum)没有在通话中
- 480: 系统语音识别总开关没有开启
- 483: 重复提交
- 500:系统错误
关闭语音识别
http://x.x.x.x:12121/bridge/callctrl?extnum=801&opt=STT_ON_TALKING_STOP
请参考启动语音识别接口描述
语音识别通知内容JSON格式定义
{
"uuid": "bc6ffeb9-a45c-4e50-abda-9fba37f0e23d",
"call_hash": "18585436821",
"seat_id": "jxt_001",
"leg": "bleg",
"offer": "KXT-CTI",
"content": "你好有什么可以帮您",
"date": "2019-12-19 14:38:07",
"timestamp": "1576737487877933"
}
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| uuid | 通话的唯一标识 | |
| call_hash | 来电人的电话号码 | |
| leg | 说话方 | aleg:通话中,来电人说话,语音转写的文本 bleg:通话中,坐席人员说话,语音转写的文本 |
| offer | 业务标志 | 根据需要配置 |
| content | 说话的内容 | 语音转文本的内容 |
| date | 消息产生的时间, | 格式:"2019-12-19 14:38:07" |
| timestamp | 消息产生的时间,时间戳格式 |
通话中话务员语音输入文字接口
使用场景
在话务员与客户沟通时,需要记录客户的信息时。可以按住一个按键重复客户的话,系统会自动将话务员说的话识别成文字通过接口返回。
实现流程

交互接口描述
启动语音识别接口
http://x.x.x.x:12121/bridge/callctrl?extnum=801&side=callee&opt=START_VOICE_INPUT
返回值
- 200:启动成功
- 400:参数错误
- 404:分机号(extnum)没有在通话中
- 480:STT语音识别没有配置
- 486:正在识别,还没有超时或者关闭,默认60秒超时
- 500:系统错误
结束语音识别并返回识别文字接口:
http://x.x.x.x:12121/bridge/callctrl?extnum=801&side=callee&opt=STOP_VOICE_INPUT
| 字段名 | 字段含义 | 描述 |
|---|---|---|
| extnum | 通话中的分机号码 | |
| side | 可选,识别那一侧通话 | 默认识别被叫侧, caller:主叫侧,callee:被叫侧 |
| opt | 操作类型 | START_VOICE_INPUT:开始识别 STOP_VOICE_INPUT: 停止识别 |
| x.x.x.x | 呼叫中心服务器IP |
返回值
- 400:参数错误
- 404:分机号(extnum)没有在通话中
- 404:分机号(extnum)没有在通话中
- 480: 当前分机没启动语音输入
- 500:系统错误
- 其他:返回的识别文字
