API de masquage et de démasquage

Cette API est disponible pour les utilisateurs d’Engagement Hub disposant de la fonctionnalité d’enregistrement vocal ou d’écran. Si vous utilisez NiCE CXone ACD, consultez l’API Agent dans le portail de la communauté des développeurs.

Pour les clients qui n’utilisent pas l’API Public Mask ou qui ont besoin d’une solution de secours, il est recommandé d’utiliser Data Policies au sein de Interactions Hub. Data Policies permettent de gérer la conformité et les risques en automatisant le traitement des données sensibles. Cela comprend la suppression des interactions contenant des informations sensibles, telles que des violations liées au PCI ou à la confidentialité. La configuration de Data Policies constitue une solution provisoire ou permanente pour maintenir la confidentialité et la sécurité des données.

Les API de masquage et de démasquage permettent de masquer les enregistrements vocaux et d’écran lorsqu’un agent recueille des informations sensibles, puis de démasquer l’enregistrement. La possibilité de masquer et de démasquer les enregistrements aide les organisations à se conformer aux réglementations en matière de protection de la vie privée et de PCI. Ces API permettent le masquage et le démasquage automatiques ou manuels des enregistrements. Vous soumettez une demande de masquage ou de démasquage pour un utilisateur spécifique. Les Segments Masqués dans les enregistrements d’appels sont intentionnellement silencieux. Il s’agit d’un comportement attendu lorsque le masquage est appliqué et cela n’indique pas une erreur système, une mise en attente d’appel ou un échec d’enregistrement. Le Lecteur fournit une indication visuelle lorsque le masquage est actif.

Un appel à l’API de msquage arrête l’enregistrement de la voix et de l’écran pour chaque participant à l’appel avec l’agent qui a l’ID utilisateur spécifié.

  • L’appel API peut être demandé que l’appel soit enregistré ou non. Aucune action n’est entreprise si l’appel n’est pas enregistré. Les agents peuvent être formés à toujours masquer un appel lorsqu’ils recueillent des données sensibles, même s’ils pensent que l’appel n’est pas enregistré. En effet, un appel peut être enregistré à partir d’une demande initiée par l’administrateur ou d’une des applications de l’agent sans que ce dernier en soit informé.

  • Si l’agent participe à plusieurs appels actifs avec un client, l’appel API masque le dernier appel auquel il a participé.

Un appel à l’API de démasquage reprend l’enregistrement de la voix et de l’écran de l’appel. Aucune action ne survient lorsque :

  • L’appel n’était pas enregistré lorsque le masquage a été demandé.

  • Un événement d’arrêt d’enregistrement a été reçu pendant l’opération de masquage.

La documentation relative aux API de masquage et de démasquage est disponible dans le portail de la communauté des développeurs .

Avant de commencer

Vous pouvez tester les API NiCE CXone sur le portail des développeurs . Connectez-vous avec un compte NiCE CXone, puis vous pourrez faire des demandes avec le locataireClosed Regroupement organisationnel de haut niveau utilisé pour gérer le soutien technique, la facturation et les paramètres globaux de votre système NiCE CXone. de votre compte.

Pour démarrer l'utilisation des API, vous devez vous enregistrer auprès de NiCE afin de recevoir des identifiants valides utilisés pour l'authentification. Revoyez la Page Démarrage sur le portail des développeurs pour connaître les instructions.

L’utilisation de ces API nécessite l’autorisation suivante :

Entité : Pour masquer ou démasquer un enregistrement, vous avez besoin de l’autorisation Recherche & Lecture > API > API de Masquage Multi-ACD.

Masquer les enregistrements

Masque l’enregistrement de la voix et de l’écran avec un bruit blanc pour l’ID utilisateur de l’agent donné. Vous devez associer une demande de masquage à une demande de démasquage.

Méthode : POST

Terminal : /interaction-recording-management-service/v1/interactions/mask

Paramètres :

userId*:

string

ID d’utilisateur de l’agent à masquer.

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

Réponse

  • Statut 200 - opération réussie. L’appel est masqué.

  • Statut 202 - Opération en cours. La demande de masquage a été acceptée et est en cours de traitement.

  • Statut 401 - Le demandeur n’a pas réussi à s’authentifier.

  • Statut 403 - Le demandeur n’est pas autorisé à effectuer l’opération.

  • Statut 404 - Introuvable. Aucune interaction active n’a été trouvée pour l’agent demandé.

  • Statut 422 - L’Opération n’est pas prise en charge pour les appels internes.

  • Statut 425 - L’interaction est verrouillée pendant le traitement d’une demande de masquage/démasquage précédente. La demande de masquage ne peut pas être traitée tant que le service est occupé par la demande précédente.

  • Statut 500 - Erreur Interne du serveur.

  • Statut 504 - La demande a expiré.

Démasquer Recordings

Démasque l’enregistrement de la voix et de l’écran pour l’ID d’utilisateur de l’agent donné.

Méthode : POST

Terminal : /interaction-recording-management-service/v1/interactions/unmask

Paramètres :

userId*:

string

ID d’utilisateur de l’agent à démasquer.

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

Réponse

  • Statut 200 - opération réussie. L’appel est en train d’être démasqué.

  • Statut 202 - Opération en cours. La demande de démasquage a été acceptée et est en cours de traitement.

  • Statut 401 - Le demandeur n’a pas réussi à s’authentifier.

  • Statut 403 - Le demandeur n’est pas autorisé à effectuer l’opération.

  • Statut 404 - Introuvable. Aucune interaction active n’a été trouvée pour l’agent demandé.

  • Statut 422 - L’Opération n’est pas prise en charge pour les appels internes.

  • Statut 425 - L’interaction est verrouillée pendant le traitement d’une demande de masquage/démasquage précédente. La demande de démasquage ne peut pas être traitée tant que le service est occupé par une demande précédente.

  • Statut 500 - Erreur Interne du serveur.

  • Statut 504 - La demande a expiré.