Mascarar e desmascarar API
Esta API está disponível para usuários do Engagement Hub com funcionalidade de gravação de voz ou de tela. Se você estiver usando NiCE CXone ACD, consulte Agent API
no portal da Developer Community.
Para clientes que não utilizam a API Pública de Máscara ou que necessitam de uma solução de failover, recomenda-se Data Policies dentro de Interactions Hub. Data Policies gerenciam a conformidade e o risco automatizando o tratamento de dados confidenciais. Isso inclui excluir interações que contenham informações confidenciais, como violações de PCI ou de privacidade. Configurar Data Policies serve como uma solução provisória ou permanente para manter a privacidade e a segurança dos dados.
As APIs de Mascaramento e Desmascaramento permitem mascarar Gravações de voz e de Tela quando um agente está coletando informações sensíveis e, em seguida, desmascarar a gravação. A capacidade de mascarar e desmascarar gravações ajuda as organizações a manter a conformidade com os regulamentos de privacidade e PCI. Essas APIs permitem mascarar e desmascarar gravações de maneira automática ou manual. Você envia uma solicitação de mascaramento ou desmascaramento para um usuário específico. Os segmentos mascarados nas gravações de chamadas são silenciados intencionalmente. Este é um comportamento esperado quando o mascaramento é aplicado e não indica erro no sistema, chamada em espera ou falha na Recording. O Player fornece uma indicação visual quando o mascaramento está ativo.
Uma chamada para a API de mascaramento interrompe a gravação de voz e tela de cada participante da chamada com o agente que possui o ID de usuário especificado.
-
A Chamada de API pode ser solicitada independentemente de a chamada estar sendo gravada ou não. Nenhuma ação ocorrerá se a chamada não estiver sendo gravada. Os Agentes podem ser treinados para sempre mascarar uma chamada ao coletar dados confidenciais, mesmo que pensem que a chamada não está sendo gravada. Isso ocorre porque uma chamada pode ser gravada a partir de uma solicitação iniciada pelo administrador ou por um dos aplicativos do agente sem o conhecimento do agente.
-
Se o agente estiver participando de mais de uma chamada ativa com um cliente, a Chamada de API mascarará a última chamada na qual ele ingressou.
Uma chamada para a API de desmascaramento retoma a gravação de voz e tela da chamada. Nenhuma ação ocorre quando:
-
A chamada não estava sendo gravada quando o mascaramento foi solicitado.
-
Um evento de parada de gravação foi recebido durante a operação de mascaramento.
A documentação da API de mascaramento e desmascaramento está disponível no portal Developer Community
.
Antes de Iniciar
Você pode testar as NiCE CXone APIs no portal do desenvolvedor
. Faça login com uma conta NiCE CXone e, em seguida, você pode fazer solicitações com o locatário
Agrupamento organizacional de alto nível usado para gerenciar o suporte técnico, o faturamento e as configurações globais do seu sistema NiCE CXone. da sua conta.
Para começar a usar a API, você deve registrar-se com NiCE para receber credenciais válidas usadas para autenticação. Revise a página de Introdução
no portal do desenvolvedor para obter instruções.
Uso dessas APIs requer a seguinte permissão:
Entidade: Para mascarar ou desmascarar uma gravação, você precisa da permissão Search & Reproduzir > API > API de Mascaramento Multi-ACD.
Máscara de Gravações
Mascare a gravação de voz e tela com ruído branco para o ID de usuário do agente fornecido. Você deve emparelhar uma solicitação de marcaramento com uma solicitação de desmascaramento.
Método: POST
Terminal: /interaction-recording-management-service/v1/interactions/mask
Parâmetros:
| userId*: |
Sequência Id DO usuário do agente a ser mascarada. |
|---|
POST /interaction-recording-management-service/v1/interactions/mask?userId=12345
Resposta
-
Status 200 — operação bem-sucedida. A chamada está sendo mascarada.
-
Status 202 — Operação em andamento. A solicitação de mascaramento foi aceita e está sendo processada.
-
Status 401 - O usuário solicitante não conseguiu se autenticar.
-
Status 403—O usuário solicitante não está autorizado a realizar a operação.
-
Status 404 – Não encontrado. Nenhuma interação ativa foi encontrada para o agente solicitado.
-
Status: 422—A Operação não é compatível com chamadas internas.
-
Status 425 - Interação bloqueada durante o processamento de uma solicitação anterior de mascaramento/desmascaramento. A solicitação de mascaramento não pode ser atendida enquanto o serviço está ocupado com a solicitação anterior.
-
Status 500 — erro interno de servidor.
-
Status 504 — A solicitação atingiu o tempo limite.
Desmascarar Gravações
Desmascare a gravação de voz e tela do ID de usuário do agente fornecido.
Método: POST
Terminal: /interaction-recording-management-service/v1/interactions/unmask
Parâmetros:
| userId*: |
Sequência ID de usuário do agente a ser desmascarado. |
|---|
POST /interaction-recording-management-service/v1/interactions/unmask?userId=12345
Resposta
-
Status 200 — operação bem-sucedida. A chamada está sendo desmascarada.
-
Status 202—Operação em andamento. A solicitação de desmascaramento foi aceita e está sendo processada.
-
Status 401 - O usuário solicitante não conseguiu se autenticar.
-
Status 403—O usuário solicitante não está autorizado a realizar a operação.
-
Status 404 – Não encontrado. Nenhuma interação ativa encontrada para o agente solicitado.
-
Status: 422—A Operação não é compatível com chamadas internas.
-
Status 425 - Interação bloqueada durante o processamento de uma solicitação anterior de mascaramento/desmascaramento. A solicitação de desmascaramento não pode ser atendida enquanto o serviço está ocupado com a solicitação anterior.
-
Status 500—Interna erro de servidor.
-
Status 504—A solicitação atingiu o tempo limite.