Monitoring Gateway Assinaturas
Você pode ter acesso direto aos dados de funcionamento e monitoramento da sua central de atendimento. As Assinaturas de Monitoring Gateway permitem que você extraia esses dados de NiCE CXone e os leve para sua própria plataforma de monitoramento. Em sua própria plataforma, você pode visualizar esses dados da forma que considerar adequada e ter mais controle e visibilidade sobre o funcionamento da sua central de atendimento. Essas assinaturas dão acesso a dois tipos de dados:
-
Todas as Voice Quality Metrics informações fornecidas, como perda de pacote, taxas de Jitter, pontuações de Mos, entre outras.
-
Informações sobre Chamadas de API e respostas dos scripts do Studio.
O NiCE CXone produz estes dados através de webhooks. Você pode se inscrever em tipos específicos de dados, como respostas da API de script ou dados de qualidade de voz. Quando você configura a assinatura e a conexão com sua plataforma de monitoramento, NiCE CXone envia dados continuamente para sua plataforma. Isso habilita alertas e análises em tempo real, que também permitem que você tome decisões informadas quando surgirem problemas. A assinatura também permite identificar tendências e padrões, de modo que você possa se antecipar e evitar proativamente quaisquer problemas envolvendo a qualidade antes que estes afetem a experiência dos contatos. Esta é uma integração nativa com Monitoring Gateway, portanto, você pode começar a usar esses insights imediatamente, sem sobrecarga ou retardo extra.
Cenário 1: Acionando alertas instantâneos para violações de limite de qualidade de Voz
Situação
Você deseja minimizar as interrupções causadas pela degradação de chamadas. Você já usa uma plataforma de monitoramento empresarial para a integridade do sistema e alertas, e precisa de visibilidade em tempo real das métricas de qualidade de voz.
Ação:
A equipe de TI configura Monitoring Gateway Assinaturas para transmitir dados de qualidade de voz de NiCE CXone para a plataforma de monitoramento. Eles configuram alertas para limites importantes, como:
-
Perda de pacote: > 2%
-
Jitter: > 30 ms
-
Pontuação mos: < 3.5
Quando uma chamada excede qualquer um desses limites, a plataforma de monitoramento aciona imediatamente um alerta para a equipe de operações de rede.
Resultado:
Durante os horas de pico, um alerta é disparado para Jitter elevado em chamadas Múltiplas. A equipe identifica rapidamente um segmento de rede com falha e redireciona o tráfego antes que ocorra uma degradação generalizada das chamadas. Essa abordagem proativa evita impacto ao cliente e reduz incidentes repetidos.
Cenário 2: identificando Padrões de latência e Falha em Chamadas de API de script do Studio
Situação
Você percebe atrasos intermitentes em fluxos de trabalho automatizados, como roteamento de chamadas e respostas de Rvi
Resposta de Voz Interativa. Menu de telefone automatizado que os contatos usam por meio de entradas de voz ou de teclas para obter informações, rotear uma chamada de voz de entrada, ou ambos.. Esses atrasos afetam a experiência do cliente e aumentam o tempo de atendimento de chamadas.
Ação:
Sua equipe técnica configura Monitoring Gateway Assinaturas para transmitir os dados de Chamada de API e resposta do script Studio para a sua plataforma de monitoramento corporativo. Eles configuram painéis e alertas para rastrear:
-
Tempos de Resposta da API
-
Taxas de erro
-
Padrões de falha em Scripts
Em poucas horas, a plataforma de monitoramento destaca um pico de latência recorrente em um script específico durante o horário de pico de tráfego.
Resultado:
A equipe investiga e descobre uma sequência ineficiente de Chamadas de API no script. Eles otimizam o fluxo de trabalho reduzindo chamadas redundantes e melhorando o tratamento de erros. Como resultado, os tempos de resposta caem significativamente, e os processos automatizados são executados sem problemas. Esse monitoramento proativo evita interrupções futuras e melhora o desempenho geral do sistema.
Configurar Assinaturas dos Monitoring Gateway
A assinatura dos webhooks requer configuração tanto no NiCE CXone quanto na sua plataforma de monitoramento. Isso permite estabelecer um webhook entre os dois servidores.
Pré-requisitos
É necessário dispor do seu próprio servidor configurado, capaz de receber estes dados de monitoramento. São os seguintes os requisitos deste servidor:
-
Implemente um método de assinatura ou autenticação MTLS. Ao registrar sua assinatura na interface do NiCE CXone, você adiciona detalhes do seu método de autenticação, como inserir as chaves ou o certificado necessários.
-
Exponha endpoints para os quais o NiCE CXone pode enviar payloads de evento. O terminal deve ser um URL acessível publicamente e capaz de receber solicitações POST. Você deve ter um terminal exclusivo para cada tipo de dados que deseja receber.
Exibir exemplo de carga útil do Voice Quality Metrics
O exemplo a seguir indica uma carga útil JSON correspondente a uma resposta da API de scripts. Com essa carga útil, você pode:
{ \"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 }
Exibir exemplo de carga útil de API do script
O exemplo a seguir indica uma carga útil JSON correspondente a uma resposta da API de scripts. Com essa carga útil, você pode:
-
acompanhar respostas bem sucedidas e de erro de APIs.
-
acessar mensagens de API para compreender quando tiver ocorrido um erro.
-
Exibir volumes simultâneos de chamada, script e ação.
-
Exibir dados de latência da API.
-
Exibir a distribuição de:
-
Scripts usados com maior frequência.
-
Ações utilizadas com maior frequência.
-
Erros de 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\" }]” } -
Criar um registro de Assinatura
Permissões necessárias: Assinaturas de gateway > Criar
-
Em NiCE CXone, navegue até Assinaturas de gateway:
- Clique no seletor de aplicativos
e selecioneMonitoring Gateway. - Clique em Assinaturas de gateway.
- Clique no seletor de aplicativos
- Clique em Criar.
- 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).
- Digite o URL DE Retorno de chamada do terminal que você tiver implementado no seu servidor.
- 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. - Clique em ADICIONAR.
- Opcionalmente, você pode adicionar múltiplos tipos de dados à mesma assinatura. Se você adicionar mais tipos de dados, cada um deve ter sua própria URL de retorno de chamada exclusiva. Repita as etapas anteriores para adicionar outros tipos de dados.
- 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. - Você pode, opcionalmente, adicionar endereços DE e-mail para pessoas que deseja que NiCE CXone contate sobre esta integração. NiCE CXone enviará aqui os endereços por e-mail se o webhook não transportar a carga útil.
- Clique Enviar.