遮罩和取消遮罩 API

此 API 僅適用於 CXone Multi-ACD (CXone Open) 使用者。 如果您使用的是 CXone ACD，請參考 DEVone 開發者社群入口網站中的客服專員 API。

遮罩和取消遮罩 API 可在客服專員收集敏感資訊時遮罩語音錄音和螢幕錄製，然後解除遮罩錄製。 對錄製遮罩和取消遮罩的功能可幫助組織保持符合隱私和 PCI 法規。 這些 API 允許自動或手動對錄製遮罩和取消遮罩。 您為特定使用者提交遮罩或取消遮罩請求。

調用遮罩 API 會停止具有指定使用者 ID 的客服專員與每個通話參與者的語音錄音和螢幕錄製。

  • 無論通話是否正在記錄，都可以請求 API 調用。 如果通話未被錄製，則不會發生任何動作。 可以訓練客服專員在收集敏感資料時始終遮罩通話，即使他們認為通話未被錄製。 這是因為通話錄製可能來自管理員發起的請求或客服專員的某個應用程式，而客服專員並不知情。

  • 如果客服專員與客戶進行了多個活動通話，API 調用會遮罩他們加入的最新通話。

調用取消遮罩 API 可恢復通話的語音和螢幕錄製。 在下列情況下不會執行任何動作：

  • 請求遮罩時通話未被記錄。

  • 遮罩操作期間收到停止錄音事件。

遮罩和取消遮罩 API 可於 DEVone 開發者社群入口網站供應。

關於網域和 URL 的詳細資訊，請查閱 DEVone 開發者入口網站中的開始使用。

開始之前

在開始使用遮罩和取消遮罩 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—請求逾時。