Monitoring Gateway 訂閱
您可以直接存取聯絡中心的健康狀況及監控資料。Monitoring Gateway 訂閱讓您可以將此資料從 NiCE CXone 提取至您自己的監控平台。 在您自己的平台中,您可以按自己認為合適的方式將此資料視覺化,從而對聯絡中心的健康狀況有更多的控制及深入了解。 這些訂閱使您可以存取兩種類型的資料:
-
所有於Voice Quality Metrics中提供的資訊,例如資料套件遺失、jitter率、MOS分數等。
-
有關 API 調用和 Studio 指令碼回應的資訊。
NiCE CXone 透過 webhook 產生此資料。 您可以訂閱特定類型的資料,例如指令碼 API 回應或語音品質資料。 當您設定與監控平台的訂閱及連線後,NiCE CXone 會持續將資料推送至您的平台。 這可以實現即時提醒和分析,讓您在出現問題時做出明智的決策。 它還可以幫助您了解趨勢和模式,以便您在影響聯絡人體驗之前預測並主動預防任何品質問題。 這是與 Monitoring Gateway 的本地整合,因此您可以立即開始使用這些見解,而無需額外的費用或延遲。
場景1:觸發語音質素門檻違規的即時警報
情況
您想盡量減少電話質素下降所造成的干擾。您已經使用企業監控平台進行系統健康和警示管理,現在您需要即時瞭解語音品質指標。
動作:
IT團隊設置Monitoring Gateway個訂閱,以將語音品質資料從NiCE CXone串流至您的監控平台中。他們為關鍵閥值配置警報,例如:
-
資料套件遺失:> 2%
-
Jitter: > 30 ms
-
MOS 分數:< 3.5
當電話超出任何這些閥值時,監控平台會即時觸發警示並通知網絡操作團隊。
結果:
在峰值小時期間,有警示因多個電話出現高 Jitter 而觸發。團隊迅速識別出發生故障的網絡區段,並在電話品質大幅下降之前重新導向流量。此主動方式可防止影響客戶,並減少重複事件發生。
情境 2:識別 Studio 程式碼 API 呼叫中的延遲和失敗模式
情況:
您發現自動化工作流程(例如電話路由及IVR
互動式語音回應。聯絡人可透過語音或按鍵輸入,使用自動電話選單以取得資訊、轉接來電語音通話,或同時進行兩者。回應)出現間歇性延遲。這些延遲會影響客戶體驗,並增加處理電話的時間。
動作:
您的技術性團隊設定 Monitoring Gateway 項訂閱,以將 Studio 程式碼 API 調用及回應資料串流至您的企業監控平台。他們會設定儀表板和警示,以追蹤:
-
API 回應時間
-
錯誤率
-
跨指令碼的失敗模式
在數小時內,監控平台便亮點顯示出在峰值流量期間某一特定程式碼中反覆出現的延遲高峰。
結果:
團隊調查後發現程式碼中存在效率低下的API 調用序列。他們優化工作流程,減少冗餘調用並改善錯誤處理。因此,回應時間大幅縮短,自動化流程運行順暢。這種主動監控可防止未來發生中斷,並提升整體系統效能。
設定Monitoring Gateway訂閱
訂閱 webhook 需要在 NiCE CXone 及您的監控平台中進行設定。 此功能使您可以在兩個伺服器之間建立 Webhook。
先決條件
您必須設定自己的伺服器來接收此監控資料。 以下是該伺服器的要求:
-
實施簽名或 MTLS 驗證方法。 在 NiCE CXone 介面中登記您的訂閱時,您會加入驗證方法的詳細資料,例如輸入必要的金鑰或憑證。
-
公開 NiCE CXone 可以向其傳送事件負載的端點。 該端點應該是可公開存取的 URL,並且能夠接收 POST 請求。 對於要接收的每種資料類型,您必須有一個唯一的端點。
檢視範例Voice Quality Metrics 工作負載
以下是指令碼 API 回應的範例 JSON 工作負載。 有了此有效載荷,您可以:
{ \"ContactId\":8675309, \"DataSource\": "SBC EXMS", \"MasterContactId\":86753099, \"BusinessUnit\":1337, \"SkillId\":4, \"SkillName\":\"Mysteries Report\", \"TeamId\":1010, \"TeamName\":\"Mysteries\", \"AgentId\":1174, \"Agent\":\"Sherlock Holmes\", \"DbKey\":null, \"StartDateTime\":\"2024-03-26T13:57:41.727Z\", \"EndDateTime\":\"2024-03-26T13:57:47.009Z\", \"From\":\"+18018675309\", \"To\":\"1174\", \"Direction\":null, \"AvgJitter\":null, \"AvgPktLoss\":null, \"AvgMos\":null, \"AvgRFactor\":null, \"CallScore\":null, \"Poc\":\"MysteriesReportLine\", \"LineType\":\"webRTC\", \"DisconnectReason\":\"1\", \"Disposition\":\"Very Mysterious\", \"Callduration\":561, \"Ringtime\":null, \"Disconnecttime\":null, \"Cluster\":\"L69\", \"SipResponseCode\":null, \"SipFailureCode\":null, \"SipIsDroppedCode\":null, \"SipAbandonedByOriginator\":null, \"AvgBitrate\":0.0, \"AvgRtt\":0, \"IspProvider\":\"London Speed\", \"CallSetupTime\":898.0, \"OperatingSystem\":\"Windows\", \"OsVersion\":\"10\", \"LocationCountry\":\"England\", \"LocationCity\":\"London\", \"SdkVersion\":\"1.30.9\", \"Browser\":\"Firefox\", \"ConnectionType\":\"TURN\", \"MediaTransport\":\"udp\", \"AgentConsoleType\":\"MAX\", \"AgentConsoleVersion\":\"24.2\", \"spearlineAnalysis\":null }
檢視範例程式碼 API 有效載荷
以下是指令碼 API 回應的範例 JSON 工作負載。 透過此有效載荷,您可以:
-
追蹤成功和錯誤的 API 回應。
-
存取 API 訊息以了解何時發生錯誤。
-
顯示同時進行的調用、指令碼和動作數量。
-
顯示 API 延遲資料。
-
顯示分佈:
-
最常使用的指令碼。
-
最常用的操作。
-
API 錯誤。
-
{ "source":"NICE", "event":"SCRIPT_API_MONITORING ", "timestamp":"4/20/2024 06:13:37 AM", "metadata":"[{ \"busNo\":\"4600000\", \"messageId\":\"123ed4d5-06bc-78a9-bf0-0f12345eb678\", \"contactId\":\"460000000000\", \"masterContactId\":\"460000000000\", \"scriptId/version\":\"130000000\", \"scriptName\":\"sub_webservice\", \"actionId\":\"40\", \"actionName\":\"Snippet\", \"actionLabel\":\"Do RESTful web service API call\", \"dateTime\":\"4/21/2023 11:20:20 AM\", \"apiEndpoint\":\"https://callbackurl.com", \"apiResponseCode\":\"200\", \"apiResponseMessage\":\"SUCESS\", \"responseTime\":\"1.000000\" }]” } -
建立訂閱註冊
所需權限:閘道訂閱 > 建立
-
在 NiCE CXone中,導覽至閘道訂閱:
- 按一下應用程式選擇器
並選取Monitoring Gateway。 - 點擊閘道訂閱。
- 按一下應用程式選擇器
- 點擊建立。
- Select either MTLS or SIGNATURE AUTH for your authentication method. This is the authentication between NiCE CXone and your monitoring platform.
Learn more about fields in this stepAuth Type Details MTLS Mutual TLS (MTLS) authentication ensures secure communication by authenticating both the server and client using mutually approved keys.
The NiCE CXone webhook service authenticates itself using the key when prompted by the receiving server.
Signature
Signature authentication validates the payload of the webhook. It requires a secret key known by both the webhook producer and consumer. The consumer (your server) calculates the signature using a secret key and matches it with the one sent by the producer (NiCE CXone).
- 輸入您在伺服器上實施的端點的 回調 URL。
- From the SELECT DATA TO RECEIVE drop-down, choose which data you want to receive.
Learn more about fields in this stepData Type Details Script API Monitoring This is any request or response for API calls made in Studio scripts. Voice Quality Metrics This is WebRTC data tracked in your agent client. This type of data is also available in the Voice Quality Metrics interface. - 點擊新增。
- 您可以選擇在同一個訂閱中新增多個資料類型。 如果新增更多資料類型,每種資料類型都必須有自己唯一的回調 URL。 重複前面的步驟以新增其他資料類型。
- Configure your authentication details. The fields that display depend on the authentication method you selected earlier in this task.
If you selected MTLSFIeld Details UPLOAD CERTIFICATE DATA This is a TLS certificate that contains a public key, issuer information, and an expiration date. ENTER KEY
The private key from your server. NiCE CXone presents this key and certificate to your server with each communication.
If you selected SIGNATURE AUTHField Details CONSUMER ID A unique identifier used to reference the client or consumer making the request. This ID is an essential part of the authentication process, helping to establish the identity of the requester and linking that identity to a specific cryptographic key.
PRIVATE KEY
The private key used to create a digital signature. The process of creating a digital signature typically involves generating a hash of the message or data. That hash is then encrypted with the sender's private key. The resulting digital signature is unique to both the message and the private key used to generate it. KEY VERSION A specific version or iteration of a cryptographic key used for signing digital data. Key versioning is particularly important in environments where cryptographic keys need to be rotated or updated regularly for security purposes. SIGNATURE URL The URL used to generate a digital signature. This is typically a full URL, including the protocol, hostname, path, and any query string parameters of a request. This URL is used as part of the data input when generating a digital signature.
To ensure the integrity and authenticity of a request, the URL and any headers or a body are used to create a string. The string is then signed using a cryptographic algorithm. This signature is then appended to the request, either in the query string or as a header.
REFRESH RATE How frequently the key is refreshed, like every 5 minutes. - 您可以選擇性新增您想要讓 NiCE CXone 就此整合聯絡的人員的電郵地址。如果 webhook 無法傳遞其有效載荷,NiCE CXone 會透過電郵傳送此處的地址。
- 點擊提交。