一. 离线转写提交接口

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