API de masquage et d’annulation du masquage

Cette API est disponible pour les utilisateurs d'Engagement Hub disposant de la fonctionnalité d'enregistrement de la voix ou de l'écran. Si vous utilisez NiCE CXone ACD, consultez l'Agent API dans le portail Developer Community.

Pour les clients qui n'utilisent pas l'API Public masquer ou qui ont besoin d'une solution de basculement, Data Policies au sein de Interactions Hub sont recommandés. Data Policies permettent de gérer la conformité et les risques en automatisant le traitement des données sensibles. Cela inclut la suppression des interactions contenant des informations sensibles, telles que des violations PCI ou de confidentialité. La configuration de Data Policies constitue une solution provisoire ou permanente pour préserver la confidentialité et la sécurité des données.

Les API Mask and Unmask permettent de masquer les Recording voix et les vidéocaptures d’écran lorsqu’un Agent collecte des informations sensibles, puis de démasquer le Recording. La possibilité de masquer et d’afficher les enregistrements permet aux organisations d’assurer la conformité avec les lois de protection de la confidentialité et les réglementations PCI. Ces API permettent le masquage et le démasquage automatiques ou manuels des enregistrements. Vous soumettez une demande du masquage ou du démasquage pour un utilisateur spécifique. Les segments Masqués dans les enregistrements de l’appel 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 de l'enregistrement. Le lecteur fournit une indication visuelle lorsque le masquage est actif.

Un appel à l'API de masquage arrête l'enregistrement de la voix et de l'écran pour chaque Participant à l'appel avec l'Agent qui a l'ID de l'utilisateur spécifié.

  • L'Appel API peut être demandé que l'appel soit enregistré ou non. Aucune action ne se produit si l’appel n’est pas en cours d’enregistrement. Les agents peuvent être formés pour toujours masquer un appel lors de la collecte de données sensibles, même s'ils pensent que l'appel n'est pas enregistré. Ceci est dû au fait qu'un appel peut être enregistré à la suite d'une demande initiée par un administrateur ou par l'une des applications de l'agent, sans que l'agent en ait connaissance.

  • 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 d’affichage reprend l’enregistrement vocal et d’écran de l’appel. Aucune action ne se produit si :

  • L’appel n’était pas en cours d’enregistrement lorsque le masquage a été demandé.

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

La documentation sur le Masquage et affichage des API est disponible dans le portail Developer Community .

Avant de Démarrer

Vous pouvez tester les API NiCE CXone sur le portail développeur . Connectez-vous avec un compte NiCE CXone, puis vous pourrez effectuer 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 commencer à utiliser les API, vous devez vous enregistrer auprès de NiCE pour recevoir des identifiants valides utilisés pour l'authentification. Consultez la page Prise en main sur le portail des développeurs pour obtenir des instructions.

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

Entité : Pour masquer ou démasquer un Recording, vous devez disposer de l'autorisation Recherche et Lecture > API > Multi-ACD Masquage API.

Masquer les enregistrements

Masque l’enregistrement d’écran et vocal avec du bruit blanc pour l’ID utilisateur de l’agent. Vous devez associer une requête masquer avec une requête afficher.

Méthode : POST

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

Paramètres :

userId* :

chaîne de caractères

Id DE l’utilisateur de l’Agent à masquer.

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

Réponse :

  • Statut 200 — Succès de l'opération. L'appel est en cours de masquage.

  • Statut 202—Opération en cours. La requête de masquage a été acceptée et est en cours de traitement.

  • État 401 : l’utilisateur à l’origine de la requête ne s’est pas authentifié.

  • Statut 403 : l'utilisateur à l'origine de la requête n'est pas autorisé à exécuter l'opération.

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

  • État : 422—Opération non prise en charge pour les appels internes.

  • État 425 — L'interaction est verrouillée pendant le traitement d'une demande de masquage/démasquage précédente. La requête de masquage ne peut pas être traitée tant que le service est occupé par la requête précédente.

  • Statut 500 : erreur de serveur Interne.

  • Statut 504—La demande a dépassé le délai imparti.

Démasquer les enregistrements

Affiche l’enregistrement d’écran et vocal correspondant à l’ID utilisateur d’agent donné.

Méthode : POST

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

Paramètres :

userId* :

chaîne de caractères

ID utilisateur de l'agent à afficher.

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

Réponse :

  • État 200 — Succès de l'opération. L'appel est en cours de démasquage.

  • Statut 202 : Opération en cours. La requête d’affichage a été acceptée et est en cours de traitement.

  • État 401 : l’utilisateur à l’origine de la requête n’a pas réussi à s’authentifier.

  • Statut 403 : l'utilisateur à l'origine de la requête 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 — Opération non prise en charge pour les appels internes.

  • État 425 — L'interaction est verrouillée pendant le traitement d'une demande de masquage/démasquage précédente. La requête d’affichage ne peut pas être traitée tant que le service est occupé par la requête précédente.

  • Statut 500 — erreur interne de serveur.

  • Statut 504 : la demande a dépassé le délai imparti.