進行熱線實時質檢。
接口說明
熱線實時質檢是在通話過程中，實時的將對話語音轉寫為對話文本，把文本傳入到智能對話分析系統中進行實時質檢，從而實時監測可能出現的潛在問題或風險，您可以實時的將對話文本及質檢結果展示在客服人員工作臺中（第三方系統）。區別于離線質檢（調用 UploadAudioData 進行的質檢或數據集質檢，詳見開發指南），離線質檢均是在通話結束并且錄音文件生成后進行的質檢分析。
使用流程
需自行實現通話過程中將語音流實時轉寫為文本，或直接使用阿里云-云呼叫中心，云呼叫中心與智能對話分析進行了深度集成，可在通話過程中直接進行實時質檢，無需進行 API 對接。
若自行實現語音流轉文本，在通話過程中，當一個角色說完一句話產生對話文本后，就需要調用該 API：SyncQualityCheck 進行實時質檢，會同步返回該句話的質檢結果。
上傳數據時可以攜帶技能組信息，然后通過呼叫中心質檢-配置管理功能來配置不同技能組的通話使用不同的質檢規則。
通話結束后，您可以將錄音文件存儲在公網可訪問的存儲服務器中，調用錄音信息維護 API：UpdateSyncQualityCheckData，將錄音名稱、錄音文件 URL 等信息提交到智能對話分析服務，這樣質檢員在復核時就可以播放錄音了。
通話結束后在呼叫中心質檢-結果展示-實時質檢結果中看到質檢的結果，您也可以調用實時質檢結果查詢 API:GetSyncResult 獲取質檢結果。通過評分大盤-實時大盤，可查看客服、技能組、評分項的數據圖表。
全文質檢
質檢規則中有十幾種算子，有些算子分析時需要對話上下文（客服與客戶的多輪對話），但實時質檢是在通話過程中的質檢，通常只有一個角色說的一句話的文本，部分算子不適用于實時質檢，所以質檢規則分為實時質檢規則和全文質檢規則：
實時質檢規則：進行實時質檢時使用的規則，支持的算子類型有限，不支持指定算子的檢測范圍。
全文質檢規則：進行離線質檢時使用的規則，支持全量算子類型，支持自定義指定算子的檢測范圍。
進行了實時質檢的通話，在通話結束后，此時已經有了完整的對話文本，此時可以對完整對話文本使用全文質檢規則再次進行質檢分析。如何啟用實時質檢后的全文質檢功能？請查看呼叫中心質檢-配置管理中關于全文質檢的說明。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| sca:SyncQualityCheck | create | *全部資源 * |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| JsonStr | string | 是 | 完整 JSON 字符串信息，具體內容參見以下詳細信息。 | {"tid":"20200823-234234","dialogue":"{}"} |
| BaseMeAgentId | long | 否 | 業務空間 Id |
jsonStr 屬性說明:
| 屬性 | 值類型 | 是否必須 | 說明 |
|---|---|---|---|
| isSchemeData | Integer | 否 | 是否將數據上傳至新版智能對話分析，取值：0（否）；1（是），默認值為 0。 |
| uuid | String | 否 | 當前句子唯一標識，冪等用，重復請求會排重，排重有效期 24 小時 |
| tid | String | 是 | 當前對話唯一標識（務必確保唯一性），可以理解為自有業務系統中的通話 ID，后臺會根據此標識，合并為一個完整的對話，長度至少 8 位，并且前 8 位是通話的發生時間（年月日），例如錄音發生時間是 2020 年 7 月 5 日，那么前綴即為 20200705，建議在前綴后再拼接上自有業務系統中的通話 ID，例如：20200705-234890134。前綴時間必須在 API 調用時間的前一個月、后一小時范圍內。 |
| dialogue | Dialogue | 是 | 業務方的待檢文本對話部分內容，一般是一句話，也可以是多句，具體內容參見下方的jsonStr.dialogue 屬性說明。 |
| dialogueStatus | Integer | 否 | 會話開始結束標識，1：開始，2：對話中。 |
| beginTime | Long | 否 | 錄音&對話的開始時間，格林威治時間 1970 年 01 月 01 日 00 時 00 分 00 秒到現在的毫秒數（即毫秒時間戳，例如：1584535485856），如果每次調用都傳入，以第一次調用為準，若不指定，則會取當前時間。 |
| customerServiceId | Long | 否 | 客服 ID。可從控制臺-基礎設置-人員管理頁面獲取，正確填入客服 ID，客服登錄控制臺頁面時可以查看與自己關聯的錄音文件。 |
| customerServiceName | String | 否 | 客服姓名。 |
| skillGroupId | Long | 否 | 技能組 ID。 |
| skillGroupName | String | 否 | 技能組名稱。 |
| callType | Integer | 否 | 呼叫類型，可取值：1（呼出）（默認）；3（呼入）；4（其他） |
| callee | String | 否 | 被叫號碼，呼出時指的是客戶號碼，呼入時指的是客服號碼。 |
| caller | String | 否 | 主叫號碼，呼出時指的是客服號碼，呼入時指的是客戶號碼。 |
| callId | String | 否 | 通話 ID，可以是呼叫中心系統中的通話 ID，或者其他可以標識通話的 ID，存在轉接時，坐席 1~n，callid 是相同的，tid 不同。 |
| business | String | 否 | 業務線名稱，屬于自定義數據，用于分類統計。 |
| remark1 | String | 否 | 自定義數據 1，可以存放與您業務相關的自定義字段，最大長度為 32 字符。 |
| remark2 | String | 否 | 自定義數據 2，可以存放與您業務相關的自定義字段，最大長度為 32 字符。 |
| remark3 | String | 否 | 自定義數據 3，可以存放與您業務相關的自定義字段，最大長度為 32 字符。 |
| requiredFields | String | 否 | 出參額外字段，取值：ruleInfoBase（規則信息）；ruleInfoBase.ruleCategoryName（規則類型名） |
jsonStr.dialogue 屬性說明:
| 屬性 | 值類型 | 是否必須 | 說明 |
|---|---|---|---|
| role | String | 是 | 對話內容角色，取值：客服、客戶、系統 |
| identity | String | 否 | 對話角色的具體身份標識，比如客服 ID，客戶 ID 等 |
| words | String | 是 | 這個角色說的一句話。僅支持 UTF-8 編碼，例如 Emoji 表情并不是 UTF-8 編碼，文本內容中請勿包含 Emoji 表情。 |
| begin | Integer | 是 | 相對起始點的開始時間偏移，單位 ms |
| end | Integer | 是 | 相對起始點的結束時間偏移，單位 ms |
| emotionValue | Integer | 否 | 情緒能量值 1-10，值越高情緒越強烈 |
| speechRate | Integer | 否 | 本句的平均語速，單位為每分鐘字數 |
| silenceDuration | Integer | 否 | 本句與上一句之間的靜音時長，單位為秒 |
返回參數
對話上下文句子說明：一些復雜場景下，某個角色的一句話無法分析出是否存在違規，往往還需要之前的一些句子做上下文信息來做質檢分析。目前上下文句子數量最大值默認為 30 句。打個比方，比如一通通話，當前已經說到了第 40 句，在第 40 句上傳后，我們會向前再取 29 句，加上當前最新的第 40 句，一共 30 句來做質檢分析。所以極端情況下，某些句子會進行 30 次質檢分析，我們在返回質檢結果時，會自動去重，也就是一個句子若多次命中同一個規則中的同一個條件，則只有在第一次命中時會返回該句的命中結果。
示例
正常返回示例
JSON格式
{
"Code": "200",
"Message": "successful",
"RequestId": "66E1ACB8-17B2-4BE8-8581-954A8*****",
"Success": true,
"Data": {
"Score": 100,
"TaskId": "66E1ACB866E1ACB8",
"Tid": "20200876-66E1ACB8",
"BeginTime": 1584535485856,
"Rules": [
{
"RuleName": "禁用語",
"Rid": "232232",
"RuleInfoBase": {
"Level": 0,
"Comments": "",
"ScoreNum": 0,
"ScoreType": 0,
"ScoreNumType": 0,
"Type": 0,
"RuleCategoryName": ""
},
"Hit": [
{
"HitKeyWords": [
{
"To": 4,
"From": 1,
"Val": "你好",
"Cid": 2312,
"Pid": 4
}
],
"Phrase": {
"Words": "你好請問有什么可以幫您的",
"Identity": "xxx",
"Begin": 1230,
"EmotionValue": 6,
"End": 3440,
"SpeechRate": 233,
"Role": "客服",
"SilenceDuration": 123
}
}
]
}
]
}
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-12-17 | OpenAPI 返回結構發生變更 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |