API de masquage et d’annulation du masquage
Cette API est disponible pour les utilisateurs d'Engagement Hub disposant de la fonctionnalité voix ou d'enregistrement d'écran. Si vous utilisez NiCE CXone ACD, consultez 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 gèrent 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 liées à la norme 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 Mask et Unmask permettent de masquer les enregistrements vocaux et les vidéocaptures d’écran lorsqu'un Agent collecte des informations sensibles, puis de démasquer l'enregistrement. 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 de masquage ou de 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. L'enregistreur 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 tous les 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 s'explique par le fait qu'un appel peut être enregistré à partir d'une demande initiée par un administrateur ou d'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 relative au Masquage et affichage des API est disponible sur le portail Developer Community
.
Avant de Démarrer
Vous pouvez test les API NiCE CXone sur le portail développeur
. Connectez-vous avec un compte NiCE CXone, vous pourrez alors effectuer des demandes avec le locataire
High-level organizational grouping used to manage technical support, billing, and global settings for your NiCE CXone system. de votre compte.
Pour commencer à utiliser les API, vous devez vous enregistrer auprès de NiCE pour recevoir des informations d'identification valides utilisées pour l'authentification. Consultez la page Prise en main
sur le portail développeur pour obtenir des instructions.
Utilisation de ces API requiert l'autorisation suivante :
Entité : Pour masquer ou démasquer un enregistrement, vous devez disposer de l'autorisation Recherche et Lecture > API > API de masquage multi-ACD.
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 Agent devant être masqué. |
|---|
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é.
-
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 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 interne de serveur.
-
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 :
-
Statut 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 ne s'est pas authentifié.
-
État 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.
-
Statut 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 de serveur Interne.
-
Statut 504 : la demande a dépassé le délai imparti.