管理 Kafka Data Streams

所需權限: Data Streams

本頁協助您設定及訂閱Kafka資料串流。NiCE CXone會以串流形式提供IVRClosed 互動式語音回應。聯絡人可透過語音或按鍵輸入,使用自動電話選單以取得資訊、轉接來電語音通話,或同時進行兩者。記錄,因此您必須在您所控制的目標設定一種使用該資料的方法。完整設定包括在NiCE CXone中的設定步驟,以及設定將訂閱並使用該串流的服務或系統。

在NiCE CXone中設定串流時,您可以選擇以下列架構格式使用資料:

  • PROTO
  • JSON
  • AVRO
  • JSON 與換行字元
  • JSON AVRO 配合換行

設定 Kafka 資料串流

首先,計劃您將如何使用Kafka串流。您必須具備技術性資源,以建立可訂閱該串流的目標。這需要您配合安全性要求:

  • 提供您希望用以存取 Kafka 主題的 IPv4 CIDR。此操作可向 NiCE CXone 確保您的 IP 屬合法且被允許使用。您可以一次新增兩個 IP CIDR。

  • 使用 NiCE CXone 之使用者名稱及密碼憑證的認證方法。

在 NiCE CXone 中建立 Kafka 資料串流

以下指引可協助您建立資料串流、產生一組憑證,以及新增將用於訂閱該資料串流的IP CIDR。

  1. 按一下應用程式選擇器 icon of app selector 並選取Admin。
  2. 前往 帳戶設定 > 事件資料串流。
  3. 點選新建資料串流。

  4. 輸入資料串流的名稱,並可選擇輸入描述。

  5. 請選取 IVR Log 作為 事件類型。

  6. 為DATA FORMAT選擇您想要資料採用的架構格式。

  7. 對於目標串流類型,請選擇Kafka外部。

  8. 生成一組憑證。這是您可以用來訂閱 Kafka 串流的使用者名稱及密碼。

    1. 按一下 New Data Stream 頁面的「安全性」部分中的Manage,即會開啟安全性管理員視窗。

    2. 對於 Alias,請 Enter 一個唯一名稱以代表該組憑證。您必須 Enter 至少六個英數字元。僅允許使用破折號(-)或底線(_)作為特殊字元。

      您每次只可為一個資料串流設定一組憑證。如有需要,請先刪除現有的憑證,然後再建立新的一組。

    3. 按一下Create and Download。此操作會將使用者名稱及密碼下載為 CSV 檔案。

  9. 在同一個安全性管理員視窗中,向下捲動並 enter 您要用於資料串流的 IP CIDR:

    1. 捲動至「Allowed IP CIDRs」部分。

    2. 在IP CIDR中,輸入您要透過其訂閱的 IP 位址的完整 CIDR。請確保同時包含 IP 位址及子網路遮罩,以組成完整的 CIDR 位址。您可以一次輸入多個 CIDR,並以逗號分隔。

      • 每個資料串流一次僅可設有兩組 IP CIDR。 如有需要,您可以刪除 IP CIDR。
      • Data Streams 目前支援 IPv4。
      • 最大允許範圍為 /24 至 /32。
    3. 點擊確定。

  10. 點擊建立。

建立資料串流後,串流詳細資訊會顯示在底部,當中包括 broker 詳細資料、consumer 群組 ID 及主題名稱。您可以使用這些資訊來設定將使用該資料的服務或系統。

另外,資料串流通常會在建立後立即啟用。最大可能需要15至30分鐘。

設定目標以訂閱 Kafka 串流

在您自己的Kafka 目標 Icon of dark gray square with an arrow pointing out of its upper right corner 中,您必須插入在上一部分產生的串流代理程式詳細資料。您的技術性團隊必須運用其專業知識完成此項工作。

刪除 Kafka 憑證

基於安全性考量,您可能想要或需要更換一組憑證。在NiCE CXone中,您可以選擇軟刪除或硬刪除一組憑證。軟刪除即表示該憑證會在兩天內變為非活躍狀態,兩天後便會完全刪除。這讓您有時間產生一組新的憑證,並將其套用於您的Kafka訂閱。硬刪除則是即時刪除。

  1. 按一下應用程式選擇器 icon of app selector 並選取Admin。
  2. 前往帳戶設定 > 事件資料串流。
  3. 選取所需的資料串流。
  4. 在列出您的認證別名的「安全性」部分中,按一下管理。
  5. 按一下您要刪除的憑證在「動作」欄中的刪除圖示。隨即會出現確認通知。
  6. Choose whether you want to soft delete or hard delete the credentials:
    • 要軟刪除,請確認刪除。狀態圖示會變為黃色。兩天後,憑證將會永遠刪除。
    • 如要硬刪除,請啟用核取方塊以立即刪除憑證,然後確認刪除。

疑難排解 Kafka Data Streams 問題

若您的資料串流訂閱無法正常運作,請檢查以下事項:

  • 您已在訂閱該串流的系統中輸入正確的仲介者詳細資料。這些資料可在資料串流的詳細資料中的串流詳細資訊部分的NiCE CXone找到。

  • 資料串流的詳細資料,以確保您輸入了正確的 IPv4 CIDR。請確保這些 IP 在 NiCE CXone 介面中亦顯示為 Active。

  • 憑證於使用資料串流的系統中正確無誤。