ScreenAgent pour Windows

ScreenAgentFermé NICE ScreenAgent est un service qui s’exécute sur les ordinateurs de bureau des agents qui nécessitent une vidéocapture d’écran. est disponible si vous avez CXone Recording Avancé et une licence de vidéocapture d’écran.

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

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

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

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

Si vous utilisez des versions antérieures de ScreenAgent, vous devrez mettre à jour tous vos utilisateurs vers 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 pouvez trouver la dernière version de ScreenAgent dans la page Téléchargements.

Pour utiliser les versions ScreenAgent 3.0.x, assurez-vous d’avoir autorisé les noms de domaines complets suivants :

  • 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). Les VDI pris en charge comprennent :

  • VMware Horizon

  • Citrix Virtual Desktops (anciennement XenDesktop).

  • Citrix Virtual Apps (anciennement XenApp)

  • Environnements VDI non persistants

  • Environnements multi-sessions

  • Environnements VDI de type terminal-serveur

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

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

Pour les locataires configurés avec 100 % de vidéocapture d’écran, la vidéocapture d’écran commence jusqu’à 25 secondes après que l’agent se soit connecté. L’enregistrement d’écran ne fonctionne pas correctement pendant ces 25 secondes.

 

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

Pour plus d’informations, voir FAQ pour ScreenAgent

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

Conditions préalables

Avant d’installer ScreenAgent, assurez-vous de :

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

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

    • Vous utilisez ScreenAgent V3.x.x ou une version supérieure.

    • Pour le mode des applications virtuelles Citrix :

      • Activez une stratégie de bouclage IP virtuel. Ajouter ScreenAgent.exe et Chrome.exe à la liste des programmes de bouclage virtuel Virtual IP. 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 persistant :

      • Utilisez ScreenAgent version 3.0.22 ou une version supérieure.

      • Installez ScreenAgent sur l’image de base VDI.

      • Prendre un instantané de l’image de base

      • Procédez à la distribution à toutes les instances VDI.

    • Pour les environnements multisessions et les environnements VDI de type serveur de terminal :

      • Utilisez ScreenAgent version 3.0.22 ou une version supérieure.

      • ConfigurezScreenAgent pour un fonctionnement en mode Connexion au système d’exploitation.

      • Les utilisateurs doivent se connecter à ScreenAgent avec leurs informations de connexion au système d’exploitation.

      La valeur de 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 sera pas exécuté pour les agents utilisant cette valeur Connexion au système d’exploitation.

    Si vous travaillez dans un environnement VDI multi-sessions ou non persistant et que vous rencontrez des problèmes, contactez le soutien de NICE pour vérifier si votre environnement spécifique est pris en charge.

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

  3. Vérifier la configuration informatique de l’agent.

  4. Assurez-vous que l’utilisateur qui installe ScreenAgent (par exemple, l’administrateur) dispose de droits 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 à la page Support et téléchargements : Activée, cela vous permet d’accéder à la page Support et 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 de l’utilisateur CXone qui la génère. Si cet utilisateur est un administrateur, toute personne disposant de la clé d’accès aurait des privilèges d’administrateur. Pour des raisons de sécurité, créez d’abord un utilisateur CXone et un rôle 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. Accédez à Sécurité > Rôles et autorisations.

      3. Cliquez sur Nouveau rôle.

      4. Donnez un nom au rôle, tel que 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. Enregistrez et activez 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é, tel que ScreenAgent.

      5. Dans la liste déroulante Rôle principal, sélectionnez le rôle de 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 ne pouvez générer des clés d’accès qu’après avoir créé le compte.

    3. Ouvrez à 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 la clé d’accès secrète et enregistrez-les dans un endroit sûr. Si vous ne copiez pas la clé d’accès secrète ou si vous la perdez, vous devrez en créer une nouvelle. 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 employé ScreenAgent en cliquant sur le bouton Activer le compte dans le courriel d’activation.

  7. Téléchargez le MSI ScreenAgent :

    1. Accédez à CXone. et ouvrez une session en tant qu’utilisateur avec une autorisation Peut accéder aux téléchargements du service d’assistance.

    2. Cliquez sur votre nom d’utilisateur et sélectionnez Assistance 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 mandataire pour la vidéocapture d’écran : Basic, Digest, Kerberos, NTLM et Negotiate. Lors de l’utilisation de la méthode d’authentification mandataire :

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

    • Pour les méthodes d’authentification Basic 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 le mandataire pour ScreenAgent sans changer de mandataire au niveau du système d’exploitation, vous pouvez utiliser le mandataire direct dans l’installation de ScreenAgent.

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

Installer ScreenAgent pour Windows

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

Si vous utilisez un outil de déploiement, configurez l’installation de l’une des manières 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 de l’installation :

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

  • Lors de la mise à jour 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 dernière version est installée à l’emplacement spécifié.

  • La réinstallation de la même version de ScreenAgent remplace l’installation existante au même emplacement. Pour modifier le chemin d’installation, désinstallez l’instance existante et spécifiez l’emplacement requis lors de la réinstallation.

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

Pour mettre à jour ScreenAgent vers une version plus récente, installez le client ScreenAgent. Vous n’avez pas besoin de désinstaller la version précédente.

Lorsque vous mettez à niveau ou réinstallez ScreenAgent, l’installation utilise automatiquement la configuration existante, à moins que vous ne spécifiiez 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 lors de la mise à niveau ou de la réinstallation.

Mettez à jour ou réinstallez ScreenAgent lorsque les agents ne sont pas enregistrés. Si un agent est en communication pendant l’installation, la vidéocapture d’écran s’arrête pour cette communication. Une fois l’installation terminée, 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. Sur la ligne de commande, accédez à l’emplacement où vous avez téléchargé le MSI et entrez la commande d’installation avec les paramètres appropriés:

  3. Vérifiez la réussite de l’installation à partir du fichier journal. Le fichier install.log se trouve dans le dossier à partir duquel vous avez installé le MSI, c’est-à-dire généralement le dossier %Profildutilisateur%\téléchargements.

    • Vérifiez que le programme d’installation dispose des privilèges d’administration.

    • 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 automatiquement masqué après l’installation. Pour visualiser 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, accédez à Admin > Employés, puis cliquez sur l’agent). Cet attribut est nécessaire pour activer la vidéocapture d’écran, l’observation d’écran ou les deux.

  5. Enregistrez un appel et consultez le fichier journal ScreenAgent. Le fichier ScreenAgent.log se trouve ici : %appdata%\ScreenAgent\logs\ScreenAgent.log.

    Vos journaux ScreenAgent sont également automatiquement téléversés dans le nuage où l’équipe de soutien NICE CXone peut y accéder, si nécessaire.

    S’il y a eu des erreurs, 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, les URL spécifiées dans la liste de refus peuvent ne pas être exclues de l’enregistrement. Voir Gérer une liste de refus de vidéocapture 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 des droits d’administrateur dans Windows.

  3. Vérifiez 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 de Google Chrome :

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

Modifier la configuration de ScreenAgent

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

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

  1. Ouvrez le fichier configFile.ini dans le dossier d’installation ScreenAgent, généralement sous C:\Program Files\NICE-InContact\ScreenAgent.

  2. Modifier les valeurs des paramètres :

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

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

      La diminution du nombre d’images par seconde réduit la taille du fichier et l’utilisation du processeur et de la mémoire vive.

      Images par seconde Réduction du nombre d’images Impact sur la taille des fichiers, la bande passante, le processeur et la mémoire vive (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 dans la section [recordingParameters]. Par défaut, cette valeur est nul, soit la résolution actuelle de l’écran.

      Les valeurs autorisées sont nul, faible, moyen ou élevé (insensible à la casse).

      La diminution de la résolution réduit la taille du fichier et l’utilisation du processeur et de la mémoire vive.

      Niveau de résolution Réduction de la RÉSOLUTION Impact sur la taille des fichiers, la bande passante, le processeur et la mémoire vive (estimation)

      Nul

      Par défaut (résolution actuelle de l’écran)

      Aucun

      Élevé

      Résolution de l’écran / 1,5

      ~20 % de réduction

      Moyen

      Résolution de l’écran / 2

      ~40 % de réduction

      Bas

      Résolution de l’écran / 4

      Réduction de ~60 % (recommandé uniquement pour les écrans 4K)

      Pour revenir à la résolution de l’écran, définissez la valeur resolutionLevel sur nul.

    • Modifiez la valeur de loadCertificates dans la section [others]. Par défaut, cette valeur est vraie.

      Les valeurs autorisées sont vrai ou faux.

  3. Enregistrez le fichier configFile.ini .

  4. Pour appliquer les modifications, redémarrez l’application ScreenAgent :

    1. Dans le Gestionnaire de tâches de Windows, mettez fin à la tâche ScreenAgentWatchDog.exe en cours, puis terminez les processus ScreenAgent.exe.

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

Vérifiez la connectivité de ScreenAgent

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

  • Vous pouvez utiliser l’outil 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é à partir de la page Téléchargements.

  • Il est recommandé d’utiliser cet outil lorsque la configuration du réseau d’un agent a changé ou est différente de la configuration habituelle. Il n’est pas nécessaire d’exécuter l’outil pour chaque agent.

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

  • Après l’exécution de chaque test, une notification de réussite ou d’échec s’affiche. À la fin de l’exécution, un résumé affiche l’état de chaque test.

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

  • L’outil de vérification de la connectivité ne comprend pas actuellement de tests permettant de vérifier la mise en réseau pour la surveillance de l’écran en temps réel.

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

    1. Accédez à CXone. et ouvrez une session en tant qu’utilisateur avec une autorisation Peut accéder à la page Support et téléchargements.

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

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

  2. Lancez 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 vers le 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 mandataire>

    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é commence à exécuter les tests. Après l’exécution de chaque test, une notification de réussite ou d’échec s’affiche. Si un test échoue, la raison de l’échec est affichée. À la fin de l’exécution, un résumé indique si chaque test a réussi, échoué ou n’a pas eu besoin d’être exécuté (N/A). Par exemple, si ScreenAgent n’était pas en cours d’exécution en arrière-plan lorsque l’outil de vérification de la connectivité a démarré, les tests visant à fermer ScreenAgent et à le redémarrer n’ont pas besoin d’être exécutés.

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

Tests de connectivité