遮罩和取消遮罩 API
此 API 僅適用於 Multi-ACD (Open) 使用者。 如果您使用的是 CXone Mpower ACD,請參閱開發者社區入口網站中的客服專員 API。
對於不使用 public 遮罩 API 或需要容錯移轉解決方案的客戶,建議使用Data Policies中的Interactions Hub。 Data Policies 透過自動處理敏感資料來管理合規性和風險。 這包括刪除包含敏感資訊的互動,例如 PCI 或侵犯隱私權。 配置Data Policies作為維護資料隱私和安全的臨時或永久解決方案。
遮罩和取消遮罩 API 可在客服專員收集敏感資訊時遮罩語音錄音和螢幕錄影,然後解除遮罩錄製。 對錄製遮罩和取消遮罩的功能可幫助組織保持符合隱私和 PCI 法規。 這些 API 允許自動或手動對錄製遮罩和取消遮罩。 您為特定使用者提交遮罩或取消遮罩請求。
調用遮罩 API 會停止具有指定使用者 ID 的客服專員與每個通話參與者的語音錄音和螢幕錄影。
-
無論通話是否正在記錄,都可以請求 API 調用。 如果通話未被錄製,則不會發生任何動作。 可以訓練客服專員在收集敏感資料時始終遮罩通話,即使他們認為通話未被錄製。 這是因為通話錄製可能來自管理員發起的請求或客服專員的某個應用程式,而客服專員並不知情。
-
如果客服專員與客戶進行了多個活動通話,API 調用會遮罩他們加入的最新通話。
調用取消遮罩 API 可恢復通話的語音和螢幕錄製。 在下列情況下不會執行任何動作:
-
請求遮罩時通話未被記錄。
-
遮罩操作期間收到停止錄音事件。
開發者社區入口網站中提供了遮罩和取消遮罩 API。
有關網域和 URL 的更多資訊,請參閱開發者社區入口網站中的使用入門。
開始之前
在開始使用遮罩和取消遮罩 API 之前,您必須設定使用者權限、產生存取金鑰,並按照開發人員入口網站上說明的註冊和身份驗證過程進行操作。 所需權限:
-
實體:要對錄製遮罩或取消遮罩,您需要 搜尋及播放 > API >多個 ACD 遮罩 API 權限。
貼文遮罩
使用白色雜訊遮罩給定客服專員使用者 ID 的語音錄音和螢幕錄影。 遮罩請求應與解除遮罩請求配對。
userId*: |
字串 要遮罩的客服專員的客服專員使用者 ID。 |

POST /interaction-recording-management-service/v1/interactions/mask?userId=12345
回應
-
狀態 200 - 操作成功。 通話被遮罩。
-
狀態 202 - 操作處理序中。 已接受遮罩請求,正在處理。
-
狀態 401 - 請求使用者驗證失敗。
-
狀態 403 - 請求使用者未獲授權執行操作。
-
狀態 404 - 未找到。 未找到請求客服專員的活躍互動。
-
狀態:422-內部呼叫不支援操作。
-
狀態 425 - 處理先前的遮罩/取消遮罩請求時互動被鎖定。 當服務忙於處理前一個請求時,無法處理遮罩請求。
-
狀態 500 - 內部伺服器錯誤。
-
狀態 504 - 請求逾時。
貼文取消遮罩
取消給定客服專員使用者 ID 的語音和螢幕記錄遮罩。
userId*: |
字串 要取消遮罩的客服專員的客服專員使用者 ID。 |

POST /interaction-recording-management-service/v1/interactions/unmask?userId=12345
回應
-
狀態 200 - 操作成功。 通話正在解除遮罩。
-
狀態 202 - 操作處理序中。 已接受解除遮罩請求,正在處理中。
-
狀態 401 - 請求使用者驗證失敗。
-
狀態 403 - 請求使用者未獲授權執行操作。
-
狀態 404 - 未找到。 未找到請求客服專員的活躍互動。
-
狀態:422-內部呼叫不支援操作。
-
狀態 425 - 處理先前的遮罩/取消遮罩請求時互動被鎖定。 當服務忙於處理前一個請求時,無法處理取消遮罩請求。
-
狀態 500 - 內部伺服器錯誤。
-
狀態 504 - 請求逾時。