API's maskeren en de maskering opheffen

Deze API is alleen beschikbaar voor gebruikers van Multi-ACD (Open) . Als u CXone Mpower ACD gebruikt, raadpleeg dan de Agent API in de Developer Community-portal.

Voor klanten die de Public Mask API niet gebruiken of een failover-oplossing nodig hebben, worden Data Policies binnen Interactions Hub aanbevolen. Data Policies Beheer naleving en risico's door de verwerking van gevoelige gegevens te automatiseren. Dit omvat het verwijderen van interacties die gevoelige informatie bevatten, zoals PCI- of privacyschendingen. Het configureren van Data Policies dient als een tijdelijke of permanente oplossing voor het handhaven van de privacy en beveiliging van gegevens.

De API's Maskeren en Maskering opheffen maken het maskeren van spraak-en schermopnamen mogelijk wanneer een agent gevoelige informatie verzamelt en daarna de maskering van de opname opheft. De mogelijkheid om opnamen te maskeren of de maskering op te heffen, helpt organisaties om de naleving van privacy- en PCI-regelgevingen te behouden. Deze API's staan het automatisch of handmatig maskeren van opnamen of het opheffen van de maskering ervan. U dient een verzoek in voor het maskeren of opheffen van de maskering voor een specifieke gebruiker.

Een oproep naar de API Maskeren stopt de spraak- en schermopname voor elke deelnemer op de oproep met de agent die de opgegeven gebruikers-ID heeft.

  • De API-oproep kan worden gevraagd of de oproep al dan niet wordt geregistreerd. Er vindt geen actie plaats als de oproep niet worden opgenomen. Agents kunnen worden getraind om een oproep altijd te maskeren wanneer gevoelige gegevens worden verzameld, zelfs als ze denken dat de oproep niet wordt geregistreerd. Dit is omdat een oproep kan worden opgenomen vanaf een door de beheerder gestarte aanvraag of een van de applicaties van de agent zonder dat de agent dit kent.

  • Als de agent deelneemt aan meer dan één actief gesprek met een klant, maskeert de API-oproep de laatste oproep waaraan deze heeft deelgenomen.

Een oproep naar de API Maskering opheffen hervat de spraak- en schermopname van de oproep. Er treedt geen actie op wanneer:

  • De oproep niet werd opgenomen wanneer maskeren werd gevraagd.

  • Een gebeurtenis voor opname stoppen is ontvangen tijdens het maskeren.

De API's Mask en Unmask zijn beschikbaar in de Developer Community-portal.

Voor meer informatie over domeinen en URL's, zie Aan de slag in de Developer Community-portal.

Voordat u begint

Voordat u de API's Maskeren en Maskering opheffen kunt gebruiken, dient u eerst een gebruikersmachtiging in te stellen, een toegangssleutel te genereren en het registratie- en authenticatieproces uitgelegd op de Developers Portal te doorlopen. Vereiste machtiging:

  • Entiteit: om een opname te maskeren of de maskering ervan op te heffen, dient u over de machtiging Zoeken & afspelen > API's > API Multi-ACD maskeren te beschikken.

POST maskeren

Maskeer de spraak- en schermopname met witte ruis voor de gebruikers-ID van de opgegeven agent. U moet een verzoek voor Maskeren koppelen met een verzoek Maskering opheffen.

userId*:

string

Agentgebruikers-ID van de te maskeren agent.

POST /interaction-recording-management-service/v1/interactions/mask?userId=12345

Respons

  • Status 200-Bewerking geslaagd. De oproep wordt gemaskeerd.

  • Status 202-Bewerking in uitvoering. Het verzoek tot maskeren is geaccepteerd en wordt verwerkt.

  • Status 401 - De aanvragende gebruiker kon zich niet verifiëren.

  • Status 403 - De aanvragende gebruiker is niet geautoriseerd om de bewerking uit te voeren.

  • Status 404-Niet gevonden. Er zijn geen actieve interacties gevonden voor de gevraagde agent.

  • Status: 422-Bewerking wordt niet ondersteund voor interne oproepen.

  • Status 425 - De interactie is vergrendeld tijdens het verwerken van een eerder verzoek tot maskeren/ontmaskeren. Het verzoek voor maskeren kan niet worden behandeld terwijl de service bezig is met het vorige verzoek.

  • Status 500-Interne serverfout.

  • Status 504 - De aanvraag is verlopen.

POST maskering opheffen

Hef de maskering op van de spraak- en schermopname voor de opgegeven agentgebruikers-ID.

userId*:

string

Agentgebruikers-ID van de agent waarvoor de maskering moet worden opgeheven.

POST /interaction-recording-management-service/v1/interactions/unmask?userId=12345

Respons

  • Status 200-Bewerking geslaagd. De maskering van de oproep wordt opgeheven.

  • Status 202-Bewerking in uitvoering. Het verzoek tot maskering opheffen is geaccepteerd en wordt verwerkt.

  • Status 401 - De aanvragende gebruiker kon zich niet verifiëren.

  • Status 403 - De aanvragende gebruiker is niet geautoriseerd om de bewerking uit te voeren.

  • Status 404-Niet gevonden. Er zijn geen actieve interacties gevonden voor de gevraagde agent.

  • Status: 422-Bewerking wordt niet ondersteund voor interne oproepen.

  • Status 425 - De interactie is vergrendeld tijdens het verwerken van een eerder verzoek tot maskeren/ontmaskeren. De interactie kan niet worden behandeld terwijl de service bezig is met het vorige verzoek.

  • Status 500-Interne serverfout.

  • Status 504 - De aanvraag is verlopen.