APIs de mascaramento e desmascaramento

Essa API apenas está disponível para CXone Multi-ACD (CXone Open) usuários do . Se você estiver usando o CXone ACD, consulte API de Agente no portal DEVone Developer Community.

As APIs de mascaramento e desmascaramento permitem mascarar gravações de voz e tela quando um agente está coletando informações confidenciais e, em seguida, desmascarar a gravação. A capacidade de mascarar e desmascarar gravações ajuda as organizações a manter a conformidade com as regulamentações 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.

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 da 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 se acharem 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 de 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.

As APIs Máscara e Desmascarar estão disponíveis no Portal DEVone Developer Community.

Para obter mais informações sobre domínios e URLs, consulte Começando no portal DEVone Developer Community.

Antes que você comece

Antes de começar a usar as APIs de mascaramento e desmascaramento, você deve configurar uma permissão de usuário, gerar uma chave de acesso e seguir o processo de registro e autenticação explicado no portal do desenvolvedor. Permissão necessária:

  • Entidade: para mascarar ou desmascarar uma gravação, você precisa da permissão Pesquisa e Reprodução > APIs > API de Mascaramento multi-ACD.

Mascaramento POST

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.

userId*:

string

ID de usuário do agente a ser mascarado.

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 do servidor.

  • Status 504 - A solicitação atingiu o tempo limite.

Desmascaramento POST

Desmascare a gravação de voz e tela do ID de usuário do agente fornecido.

userId*:

string

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 - Erro interno do servidor.

  • Status 504 - A solicitação atingiu o tempo limite.