一. 离线转写提交接口

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	是	本句的平均语速，单位为每分钟字数