ScreenAgent pour Windows

ScreenAgentFermé NICE ScreenAgent est un service qui s'exécute sur les bureaux d'agents nécessitant un enregistrement d'écran. est disponible si vous avezCXone RecordingAvancée et une licence d'enregistrement d'écran.

Installez ScreenAgent sur les ordinateurs pour enregistrer ou surveiller l’activité sur l’écran d’un agent lors d’une interaction. ScreenAgent s’exécute en arrière-plan et enregistre automatiquement selon les politiques d’enregistrement (voir CXone Recording). Les superviseurs et les évaluateurs peuvent également superviser l'activité d'un agent lors d'une interaction.

Pour garantir que CXone Recording Engagement de la main-d'œuvre (WEM) offre une expérience client transparente qui exploite la technologie la plus récente, assurez-vous que vous utilisez les versions ScreenAgent prises en charge :

  • ScreenAgent pour les versions Windows 3.0.22 ou ultérieures.

  • ScreenAgent pour les versions MAC 3.0.1 ou ultérieures.

Si vous utilisez des versions plus anciennes de ScreenAgent, vous devez mettre à jour vos utilisateurs vers les versions ScreenAgent 3.0.x. Les versions antérieures ne sont pas prises en charge et risquent de ne pas enregistrer les écrans de vos agents.

Vous trouverez la dernière version de ScreenAgent sur la page de téléchargement.

Pour utiliser les versions ScreenAgent 3.0.x, assurez-vous que les noms réseaux qualifiés (FQDN) suivants sont autorisés :

  • Pour FedRamp : cxone-gov.niceincontact.com

  • Pour toutes les autres régions : cxone.niceincontact.com

Vous pouvez installer ScreenAgent sur les ordinateurs des agents ou dans un environnement d’infrastructure de bureau virtuel (VDI). Voici une liste de VDI pris en charge :

  • VMware Horizon

  • Citrix Virtual Desktops (anciennement XenDesktop)

  • Citrix Virtual Apps (anciennement XenApp)

  • Environnements VDI non persistants

  • Environnements multisession

  • Environnements VDI de type terminal-serveur

VMware Horizon ne nécessite aucune configuration particulière. Pour les autres environnements VDI, voir Conditions préalables.

Vous pouvez Vérification de la connectivité de ScreenAgent avant ou après l’installation.

Pour les locataires configurés avec un enregistrement d'écran à 100 %, l’enregistrement d'écran commence dans les 25 secondes suivant la connexion de l’agent. L’enregistrement d’écran peut ne pas fonctionner correctement pendant ces 25 secondes.

 

Vous pouvez regarder une vidéo qui donne un aperçu de l’installation de ScreenAgentsur l’ordinateur d’un agent. La vidéo comprend les prérequis et les étapes d'installation.

Pour plus d’informations, voir Questions fréquentes sur ScreenAgent.

Pour consulter la liste des fonctionnalités ajoutées aux versions ScreenAgent précédentes, voir ScreenAgent : Notes de version cumulatives.

Conditions préalables

Avant d’installer ScreenAgent, veillez à :

  1. Vérifier le Exigences de connectivité. Gardez à l’esprit que ScreenAgent n’enregistre pas si votre pare-feu génère des certificats autosignés ou supprime les en-têtes de demande des paquets HTTPS.

  2. Si votre site utilise des VDI, assurez-vous que:

    • Vous utilisez ScreenAgent en version 3.x.x et supérieure.

    • Pour le mode des applications virtuelles Citrix:

      • Activez une stratégie de bouclage IP virtuel. Ajoutez ScreenAgent.exe etChrome.exe à la liste des programmes de bouclage virtuel IP virtuel. Gardez à l'esprit que chaque programme doit être répertorié sur une ligne distincte.

      • Installez ScreenAgent sur le serveur Citrix Virtual Apps.

    • Dans un environnement VDI non persistent :

      • Utilisez ScreenAgent version 3.0.22 ou supérieure.

      • Installez ScreenAgent sur l’image de base du VDI.

      • Effectuez un instantané de l’image de base.

      • Distribuez-le sur toutes les instances VDI.

    • Pour les environnements multi-sessions et VDI de type terminal-serveur :

      • Utilisez ScreenAgent version 3.0.22 ou supérieure.

      • Configurez ScreenAgent de manière qu’il fonctionne en mode Connexion au système d’exploitation.

      • Les utilisateurs doivent se connecter à ScreenAgent en utilisant les informations d’authentification propres au système d’exploitation.

      La valeur Connexion au système d’exploitation pour chaque profil d'employé doit être unique. La valeur Connexion au système d’exploitation ne peut pas être utilisée pour plusieurs profils d'employés, même si certains des profils d'employés dupliqués sont inactifs. Si plusieurs profils d'employés ont la même valeur Connexion au système d’exploitation, ScreenAgent ne s'exécutera pas pour tout agent utilisant cette valeur Connexion au système d’exploitation .

    Si vous travaillez dans un environnement VDI multisession ou non persistant et que vous rencontrez des problèmes, contactez l’assistance NICE pour vérifier que votre environnement précis est pris en charge.

    Le mode bureau virtuel VMware Horizon et Citrix ne nécessite aucune configuration particulière.

  3. Vérifiez la configuration informatique de l'agent.

  4. Assurez-vous que l’utilisateur qui installe ScreenAgent (par exemple, l’administrateur) dispose de privilèges d’administrateur sur l’ordinateur de l’agent.

  5. Assurez-vous que l’utilisateur qui installe ScreenAgent (par exemple, l’administrateur) dispose de ces autorisations CXone :

    • Peut accéder aux téléchargements d'assistance: Activé, cela vous permet d'accéder à la page Supports - Téléchargements.

    • Clef d'accès:Créer, il s'agit de gérer les clés d'accès de votre organisation.

  6. Générez une clé d’accès pour ScreenAgent.

    Vous pouvez utiliser la même clé d’accès pour installer ScreenAgent sur tous les ordinateurs des agents de votre locataire.

    La clé d'accès reçoit toutes les autorisations du CXone utilisateur qui le génère. Si cet utilisateur est un administrateur, toute personne disposant de la clé d'accès aurait des privilèges d'administrateur. Donc, pour des raisons de sécurité, créez d’abord un utilisateur et un rôle CXone pour ScreenAgent, puis générez la clé avec l’utilisateur ScreenAgent.

    1. Créez un rôle pour le service ScreenAgent :

      1. Cliquez sur le sélecteur d'applications et sélectionnezAdmin.
      2. Allez à Sécurité > Rôles et autorisations.

      3. Cliquez sur Nouveau rôle.

      4. Donnez un nom au rôle, par exemple Clé d'accès ScreenAgent.

      5. Supprimez toutes les autorisations pour le rôle, à l’exception de Clé d’accès et Ma clé d’accès.

      6. Enregistrer et activer le profil.

    2. Créez un employé pour le service ScreenAgent :

      1. Cliquez sur le sélecteur d'applications et sélectionnezAdmin.
      2. Cliquez sur Employés.

      3. Cliquez sur Nouvel employé.

      4. Donnez un nom à l'employé, par exemple ScreenAgent.

      5. Dans la liste déroulante Rôle principal, sélectionnez le rôle Clé d'accès ScreenAgent que vous venez de créer.

      6. Dans l'onglet Général, effacez tous les attributs.

      7. Créez l’employé ScreenAgent. Vous pouvez générer des clés d’accès uniquement après avoir créé le compte.

    3. Ouvrez de nouveau l’employé ScreenAgent et accédez à l’onglet Sécurité. Cliquez sur Ajouter une clé d’accès pour générer une clé d’accès.

    4. Copiez à la fois l'ID de la clé d'accès et Clé d'accès secrète et enregistrez-les dans un endroit sûr. Si vous ne copiez pas le Clé d'accès secrète ou si vous le perdez, vous devrez en créer un nouveau. Utilisez cet ID de clé d’accès et cette clé d’accès secrète lors de l’installation de ScreenAgent sur les ordinateurs de tous les agents.

    5. Activez le compte ScreenAgent d'employé en cliquant sur le bouton Activer le compte dans l'e-mail d'activation.

  7. Téléchargez le MSI ScreenAgent :

    1. Allez à CXone et connectez-vous en tant qu'utilisateur avec l'autorisation Peut accéder aux téléchargements d'assistance.

    2. Cliquez sur votre Nom d’utilisateur et sélectionnez Support et téléchargements.

    3. Téléchargez le MSI requis. Notez où vous téléchargez le MSI, vous aurez besoin de l'emplacement du fichier plus tard.

  8. ScreenAgent prend en charge cinq méthodes d’authentification proxy pour l’enregistrement d’écran : Basic, Digest, Kerberos, NTLM et Negotiate. Lors de l'utilisation de la méthode d'authentification proxy :

    • Assurez-vous de définir le proxy au niveau du système d'exploitation dans les paramètres du proxy.

    • Pour les méthodes d'authentification de base et Digest, vous devez définir les informations d'identification dans Windows Credential Manager.

    • Il n'y a aucun changement dans l'installation. Toutefois, si vous souhaitez utiliser un proxy pour ScreenAgent sans changer de proxy au niveau du système d’exploitation, vous pouvez utiliser le proxy direct dans l’installation de ScreenAgent.

    • Gardez à l'esprit que ces méthodes d'authentification sont uniquement destinées à l'enregistrement d'écran et non à la surveillance d'écran.

Installation de ScreenAgent pour Windows

Vous pouvez installer ScreenAgent à l’aide d’un outil de déploiement ou manuellement sur l’ordinateur de chaque agent.

Si vous utilisez un outil de déploiement, configurez l’installation à l’une des fins suivantes :

  • Exécuter avec les droits de l'utilisateur (mode utilisateur/contexte utilisateur) : vous n'avez pas besoin de redémarrer l'ordinateur de l'agent.

  • Exécuter avec des droits d'administration—Vous devez redémarrer les ordinateurs de tous les agents.

Vous pouvez spécifier l’emplacement d’installation :

  • Par défaut, ScreenAgent est installé sur le lecteur C, dans le dossier \NICE-InContact\ScreenAgent. Vous pouvez spécifier un autre chemin d’installation dans la commande d’installation.

  • En cas de mise à niveau vers une version ultérieure, vous pouvez définir un chemin d’installation différent. La version précédente est supprimée et la nouvelle version est installée à l’emplacement spécifié.

  • Si vous réinstallez la même version de ScreenAgent, l’installation existante est remplacée au même emplacement. Pour modifier le chemin d’installation, désinstallez l’instance existante, puis spécifiez l’emplacement voulu lors de la réinstallation.

Certains paramètres ScreenAgent peuvent être modifiés après l’installation. Voir Modification de la configuration de ScreenAgent. Pour mettre à jour d’autres paramètres d’installation, réinstallez le client ScreenAgent.

Pour mettre à niveau ScreenAgent vers une version ultérieure, installez le client ScreenAgent. Il est inutile de désinstaller la version précédente.

Lorsque vous mettez à niveau ou réinstallez ScreenAgent, l’installation utilise automatiquement la configuration existante sauf si vous spécifiez des paramètres différents. Voir Réinstallation ou mise à niveau avec la configuration actuelle. Lorsque vous désinstallez ScreenAgent, la configuration n’est pas enregistrée et vous devez spécifier les paramètres d’installation lorsque vous mettez à niveau ou réinstallez l’application.

Effectuez la mise à niveau ou la réinstallation de ScreenAgent lorsque les agents ne sont pas en cours d’enregistrement. Si un agent est en cours d’appel pendant l’installation, l’enregistrement d’écran arrête l’appel. À l’issue de l’installation, les appels seront enregistrés conformément aux politiques d’enregistrement et aux scripts Studio.

Pour installer ScreenAgent:

  1. Assurez-vous que toutes les conditions préalables sont en place.

  2. Ouvrez l'invite de commande en tant qu'administrateur. Dans la ligne de commande, accédez à l'endroit où vous avez téléchargé le MSI et entrez la commande d'installation avec les paramètres appropriés:

  3. Vérifiez le succès de l'installation à partir du fichier journal. Le fichier install.log se trouve dans le dossier à partir duquel vous avez installé le MSI, en général le dossier % %ProfilUtilisateur%\téléchargements.

    • Vérifiez que le programme d'installation dispose des privilèges d'administrateur.

    • Si l'ordinateur de l'agent ne dispose pas de Microsoft .NET Framework 4.0 ou version ultérieure, installez-le.

    Le fichier de configuration, configFile.ini, est masqué automatiquement après l’installation. Pour afficher et ouvrir le fichier, activez Éléments masqués dans l’Explorateur de fichiers de Windows.

  4. Assurez-vous que l'agent a l'attribut Peut être enregistré (écran) (dans CXone, allez dans la section Administrateur > Des Employés, puis cliquez sur l'agent). Cet attribut est nécessaire pour activer l’enregistrement d’écran, la supervision d’écran ou les deux.

  5. Enregistrez un appel et vérifiez le fichier journal ScreenAgent. Le fichier ScreenAgent.log est situé dans : %appdata%\ScreenAgent\logs\ScreenAgent.log.

    En outre, vos fichiers journaux ScreenAgent sont automatiquement chargés dans le cloud, où l’équipe d’assistance NICE CXone peut y accéder, si nécessaire.

    En cas d’erreur, voir Dépanner les enregistrements.

Vous pouvez regarder une vidéo qui donne un aperçu de la façon d’améliorer les interactions des agents avec la surveillance d’écran en temps réel à l’aide de ScreenAgent.

Configuration de la clé de registre Google Chrome pour la liste de refus

Lors de l'utilisation des navigateurs Google Chrome sur la machine de l'agent, si la valeur UiAutomationProviderEnabled n'est pas présente dans la clé de registre GoogleChrome , il se peut que les URL spécifiées dans la liste de refus ne soient pas exclues de l'enregistrement. Voir Gestion d’une liste de refus d’enregistrement d’écran.

Pour ajouter la valeur à la clé de registre :

  1. Assurez-vous que la machine de l'agent utilise le navigateur Chrome 126 ou une version ultérieure.

  2. Assurez-vous que vous disposez de droits d'administrateur de Windows.

  3. Assurez-vous que le chemin d'accès au registre HKLM:\NSOFTWARE\NPolicies\NGoogle\NChrome existe.

  4. Exécutez la ligne de script Powershell suivante pour ajouter la valeur au registre Google Chrome  :

    Set-ItemProperty -Path "HKLM:\SOFTWARE\Policies\Google\Chrome" -Name "UiAutomationProviderEnabled" -Value 1 -Type DWord

Modification de la configuration de ScreenAgent

Après installation, vous pouvez modifier certaines configurations de ScreenAgent.

Le fichier de configuration, configFile.ini, est masqué automatiquement après l’installation. Pour afficher et ouvrir le fichier, activez Éléments masqués dans l’Explorateur de fichiers de Windows.

  1. Ouvrez le fichier configFile.ini qui se trouve dans le dossier d’installation de ScreenAgent, en général sous C:\Programmes\NICE-InContact\ScreenAgent.

  2. Modifiez les valeurs des paramètres :

    • Modifiez la valeur framePerSecond à la section [recordingParameters]. Par défaut, cette valeur est de 5.

      Les valeurs autorisées sont 1, 2, 3, 4 ou5.

      La réduction du nombre d’images par seconde réduit la taille du fichier, la cadence du processeur et la quantité de RAM.

      Images par seconde Réduction des images Impact sur la taille du fichier/la bande passante, le processeur et la RAM (estimation)

      5.

      Par défaut (maximum)

      Aucun

      4.

      20 % de moins

      ~15 % de réduction

      3.

      40% de moins

      ~30% de réduction

      2.

      60% de moins

      ~45% de réduction

      1.

      80% de moins

      ~60% de réduction

    • Modifiez la valeur resolutionLevel à la section [recordingParameters]. Par défaut cette valeur est null, ce qui équivaut à la résolution d'écran actuelle.

      Les valeurs autorisées sont null, low, medium ou high (tout en minuscules).

      La réduction de la résolution réduit la taille du fichier, la cadence du processeur et la RAM disponible.

      Niveau de résolution Réduction de la RÉSOLUTION Impact sur la taille du fichier/la bande passante, le processeur et la RAM (estimation)

      Null

      Par défaut (résolution d'écran actuelle)

      Aucun

      Haut

      Résolution d'écran / 1,5

      ~20% de réduction

      Moyen

      Résolution d'écran / 2

      ~40% de réduction

      Faible

      Résolution d'écran / 4

      ~60 % de réduction (ce paramètre est uniquement recommandé pour les écrans 4K.)

      Pour réinitialiser la résolution d’écran, remettez la valeur de resolutionLevel à null.

    • Modifiez la valeur loadCertificates à la section [others]. Par défaut, cette valeur est true.

      Les valeurs acceptables sont true ou false.

  3. Enregistrez le fichier configFile.ini.

  4. Pour appliquer les modifications, relancez l’application ScreenAgent :

    1. Dans le gestionnaire des tâches Windows, mettez fin à la tâche ScreenAgentWatchDog.exe , puis aux processus ScreenAgent.exe.

    2. Dans le dossier d’installation de ScreenAgent, exécutez le fichier ScreenAgentWatchdog.exe.

Vérification de la connectivité de ScreenAgent

Utilisez l’outil de vérification de la connectivité de ScreenAgent pour exécuter une séquence de tests afin de vérifier l’accès réseau et de s’assurer que ScreenAgent va fonctionner correctement.

  • Cet outil peut être utilisé avant ou après l'installation de ScreenAgent.

  • Vous pouvez télécharger la dernière version de l’outil de vérification de la connectivité sur la page de téléchargement.

  • Il est recommandé d’utiliser cet outil lorsque la configuration réseau d’un agent a changé ou qu’elle diffère de la configuration normale. Vous n’avez pas besoin d’exécuter l’outil pour chaque agent.

  • Vous pouvez exécuter l’outil de vérification de la connectivité plusieurs fois en utilisant la même commande.

  • Après exécution de chaque test, une notification indique si les tests ont réussi ou échoué. À la fin de l’exécution, un récapitulatif affiche le statut de chaque test.

  • Une fois les tests réalisés, l’outil de vérification de la connectivité crée un fichier journal.

  • L’outil de vérification de la connectivité ne permet pas actuellement de réaliser une surveillance d’écrans en temps réel sur le réseau.

  1. Téléchargez le fichier EXE de l’outil de vérification de la connectivité :

    1. Allez à CXone et connectez-vous en tant qu'utilisateur avec l'autorisation Peut accéder aux téléchargements d'assistance.

    2. Cliquez sur votre Nom d’utilisateur et sélectionnez Support et téléchargements.

    3. Téléchargez le fichier EXE requis. Notez l’emplacement auquel vous téléchargez le fichier EXE, car vous en aurez besoin par la suite.

  2. Exécutez l’outil de vérification de la connectivité.

    1. Exécutez l’invite de commande en tant qu’Administrateur.

    2. Copiez et collez la commande dans l'invite de commandes et modifiez les paramètres répertoriés dans le tableau.

      <chemin d’accès au fichier EXE> ACCESS_KEY_ID=<ID de clé d’accès> ACCESS_KEY_SECRET=<clé d’accès secrète> REGION_TYPE=<sous domaine (3 premiers caractères) de l’URL CXone> WEB_PROXY=<facultatif : URL du serveur proxy>

    Exemple de commande :

    C:%UserProfile%\downloads ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 WEB_PROXY=https://proxyserver:8088
  3. L’outil de vérification de la connectivité exécute les tests. Après exécution de chaque test, une notification indique si les tests ont réussi ou échoué. Si un test échoue, la raison de l’échec est indiquée. À la fin de l’exécution, un récapitulatif affiche si le test a réussi ou échoué, ou s’il n’était pas nécessaire de l’exécuter (N/A). Par exemple, si ScreenAgent ne s’exécutait pas en arrière-plan lorsque l’outil de vérification de la connectivité a démarré, il est inutile d’exécuter les tests pour fermer et relancer ScreenAgent.

    Lorsque les tests sont terminés, l’outil de vérification de la connectivité crée un fichier journal (SA_Connectivity_tool_log_<runUniqueUUID>) dans le même dossier que le fichier d’installation de l’outil de vérification de la connectivité. Le fichier journal inclut toutes les informations qui étaient affichées à l’invite de commande.

Tests de connectivité