管理 Kafka Data Streams
所需權限: Data Streams
本頁協助您設定及訂閱Kafka資料串流。NiCE CXone會以串流形式提供IVR
互動式語音回應。聯絡人可透過語音或按鍵輸入,使用自動電話選單以取得資訊、轉接來電語音通話,或同時進行兩者。記錄,因此您必須在您所控制的目標設定一種使用該資料的方法。完整設定包括在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。
- 按一下應用程式選擇器
並選取Admin。 - 前往 帳戶設定 > 事件資料串流。
-
點選新建資料串流。
-
輸入資料串流的名稱,並可選擇輸入描述。
-
請選取 IVR Log 作為 事件類型。
-
為DATA FORMAT選擇您想要資料採用的架構格式。
-
對於目標串流類型,請選擇Kafka外部。
-
生成一組憑證。這是您可以用來訂閱 Kafka 串流的使用者名稱及密碼。
-
按一下 New Data Stream 頁面的「安全性」部分中的Manage,即會開啟安全性管理員視窗。
-
對於 Alias,請 Enter 一個唯一名稱以代表該組憑證。您必須 Enter 至少六個英數字元。僅允許使用破折號(-)或底線(_)作為特殊字元。
您每次只可為一個資料串流設定一組憑證。如有需要,請先刪除現有的憑證,然後再建立新的一組。
-
按一下Create and Download。此操作會將使用者名稱及密碼下載為 CSV 檔案。
-
-
在同一個安全性管理員視窗中,向下捲動並 enter 您要用於資料串流的 IP CIDR:
-
捲動至「Allowed IP CIDRs」部分。
-
在IP CIDR中,輸入您要透過其訂閱的 IP 位址的完整 CIDR。請確保同時包含 IP 位址及子網路遮罩,以組成完整的 CIDR 位址。您可以一次輸入多個 CIDR,並以逗號分隔。
- 每個資料串流一次僅可設有兩組 IP CIDR。 如有需要,您可以刪除 IP CIDR。
- Data Streams 目前支援 IPv4。
- 最大允許範圍為 /24 至 /32。
-
點擊確定。
-
- 點擊建立。
建立資料串流後,串流詳細資訊會顯示在底部,當中包括 broker 詳細資料、consumer 群組 ID 及主題名稱。您可以使用這些資訊來設定將使用該資料的服務或系統。
另外,資料串流通常會在建立後立即啟用。最大可能需要15至30分鐘。
設定目標以訂閱 Kafka 串流
在您自己的Kafka 目標
中,您必須插入在上一部分產生的串流代理程式詳細資料。您的技術性團隊必須運用其專業知識完成此項工作。
刪除 Kafka 憑證
基於安全性考量,您可能想要或需要更換一組憑證。在NiCE CXone中,您可以選擇軟刪除或硬刪除一組憑證。軟刪除即表示該憑證會在兩天內變為非活躍狀態,兩天後便會完全刪除。這讓您有時間產生一組新的憑證,並將其套用於您的Kafka訂閱。硬刪除則是即時刪除。
- 按一下應用程式選擇器
並選取Admin。 - 前往帳戶設定 > 事件資料串流。
- 選取所需的資料串流。
- 在列出您的認證別名的「安全性」部分中,按一下管理。
- 按一下您要刪除的憑證在「動作」欄中的刪除圖示。隨即會出現確認通知。
- Choose whether you want to soft delete or hard delete the credentials:
- 要軟刪除,請確認刪除。狀態圖示會變為黃色。兩天後,憑證將會永遠刪除。
- 如要硬刪除,請啟用核取方塊以立即刪除憑證,然後確認刪除。
疑難排解 Kafka Data Streams 問題
若您的資料串流訂閱無法正常運作,請檢查以下事項:
-
您已在訂閱該串流的系統中輸入正確的仲介者詳細資料。這些資料可在資料串流的詳細資料中的串流詳細資訊部分的NiCE CXone找到。
-
資料串流的詳細資料,以確保您輸入了正確的 IPv4 CIDR。請確保這些 IP 在 NiCE CXone 介面中亦顯示為 Active。
-
憑證於使用資料串流的系統中正確無誤。