一. 离线转写提交接口
1 接口概述
根据通话记录的唯一标识id,提交请求将该录音通过语音转换文本的能力(asr),转换成文本内容。
2 接口请求
- HTTP请求方式:POST
- 请求url:{HOST}/v20180426/asr/submit/{ACCOUNTID}?sig=SIG
- 请求时请将{HOST}换成对接数据查询获取到的请求域名,{ACCOUNTID}替换为账户编号,SIG是根据鉴权规则生成的,请看鉴权文档,查看具体的生成规则
- 鉴权方式:接口鉴权
3 接口参数
字段 | 类型 | 是否必须 | 值 | 备注 |
callId | string | 是 | 通话记录callSheetId | 示例:6bf31c1b-da45-4a89-babe-12bb8fac8567 |
callbackUrl | string | 否 | 回调地址 | http://www.baidu.com(有此参数,在转写完成后推送到到地址(推送方式为post,数据格式为application/json)) |
请求示例:
{
"callId": "6bf31c1b-da45-4a89-babe-12bb8fac8567",
"callbackUrl": "http://www.baidu.com"
}
4 系统返回
返回Json对象,样例: 第一次提交:
{
"code": 200,
"message": "SUCCESS"
}
重复提交:
{
"code": 200,
"message": "SUCCESS",
"data":{数据见query接口}
}
二.离线转写查询接口
1 接口概述
查询发起离线转写请求的通话记录并返回对应录音转写后的内容。
2 接口请求
- HTTP请求方式:POST
- 请求url:{HOST}/v20180426/asr/query/{ACCOUNTID}?sig=SIG
- 请求时请将{HOST}换成对接数据查询获取到的请求域名,{ACCOUNTID}替换为账户编号,SIG是根据鉴权规则生成的,请看鉴权文档,查看具体的生成规则
- 鉴权方式:接口鉴权
3 接口参数
字段 | 类型 | 是否必须 | 值 | 备注 |
callId | string | 是 | 通话记录callSheetId | 示例:6bf31c1b-da45-4a89-babe-12bb8fac8567 |
4 系统返回
返回Json对象,样例:
{
"code": 200,
"message": "SUCCESS",
"data": {
"account": N00000002411,
"connectType": "dialout",
"agentId": "d2be7ca0-bcd0-11ea-b1b6-6386234372df",
"fileUrl": "http://139.199.107.111/monitor/pbx.tx.test02.3/20200721/20200721-155350_N00000003167_20571659_919940817951_cc-ali-0-1595318030.1551855.mp3",
"sentences": [
{
"role": "AGENT",
"beginTime": 1280,
"endTime": 2030,
"silenceDuration": 0,
"channelId": 0,
"speechRate": 80,
"emotionValue": 3.6,
"text": "喂。",
"ruleHitRecords": [],
"highlightLists": [],
"_id": "c79f76fd-bd94-4fa4-bf6d-a15b060a44b5"
},
{
"role": "VISITOR",
"beginTime": 3820,
"endTime": 4770,
"silenceDuration": 1,
"channelId": 0,
"speechRate": 126,
"emotionValue": 4.8,
"text": "没有。",
"ruleHitRecords": [],
"highlightLists": [],
"_id": "ee001779-f081-41db-b05c-2e9d50f79660"
},
{
"role": "AGENT",
"beginTime": 4860,
"endTime": 5820,
"silenceDuration": 0,
"channelId": 0,
"speechRate": 62,
"emotionValue": 4.7,
"text": "嗯。",
"ruleHitRecords": [],
"highlightLists": [],
"_id": "7b390ef4-d63b-4a6a-9fc6-5d39b9079bb5"
},
{
"role": "VISITOR",
"beginTime": 7290,
"endTime": 9660,
"silenceDuration": 1,
"channelId": 0,
"speechRate": 25,
"emotionValue": 5.3,
"text": "e。",
"ruleHitRecords": [],
"highlightLists": [],
"_id": "1293afd8-bbbb-443f-be8b-665dd3e6295e"
},
{
"role": "AGENT",
"beginTime": 10100,
"endTime": 16470,
"silenceDuration": 0,
"channelId": 0,
"speechRate": 37,
"emotionValue": 5.4,
"text": "他就是他。",
"ruleHitRecords": [],
"highlightLists": [],
"_id": "242e4412-be98-428b-932d-2793d5c693f0"
}
],
"createTime": "2020-07-22 16:21:06",
"sessionId": null,
"aliTaskId": "49ff05b5cbf411eabaf917714426095a",
"taskError": null,
"_id": "1b58e096-782c-4f71-9cb5-cd34d39cf5a3"
}
}
返回值字段说明:
字段 | 类型 | 是否必须 | 值 |
_id | String | 是 | 通话编号 |
accountId | String | 是 | 账号id |
agentId | String | 是 | 接听座席ID (UUID) |
sessionId | String | 是 | 提交转写任务的座席ID (接口提交的情况下,值为null) |
aliTaskId | String | 是 | 阿里云语音转写的任务ID |
taskError | String | 是 | 转写错误,一般为null |
connectType | String | 是 | dialout-外呼 normal-普通来电 transfer-来电转接 dialTransfer-外呼转接 |
createTime | string | 是 | 转写提交的创建时间 |
fileUrl | String | 是 | 录音文件地址 |
setences | Object[] | 是 | 转写内容 |
setences[]._id | String | 是 | 本句对话的ID |
setences[].ChannelId | Int | 是 | 该句所属音轨ID |
setences[].role | Int | 是 | 该句所属角色,AGENT为坐席,VISITOR为用户侧 |
setences[].beginTime | Int | 是 | 该句的起始时间偏移,单位为毫秒 |
setences[].endTime | Int | 是 | 该句的结束时间偏移,单位为毫秒 |
setences[].text | string | 是 | 该句的识别文本结果 |
setences[].emotionValue | Int | 是 | 情绪能量值1-10,值越高情绪越强烈 |
setences[].silenceDuration | Int | 是 | 本句与上一句之间的静音时长,单位为秒 |
setences[].speechRate | Int | 是 | 本句的平均语速,单位为每分钟字数 |