Déployer Genesys Cloud Background Assistant (GCBA)

Genesys Cloud Background Assistant (GCBA) installe un service d'arrière-plan qui démarre automatiquement lors de l'installation et du redémarrage du système.

  1. Accédez au site Genesys Cloud Background Assistant (GCBA) installation.
    Remarque : Des pages de téléchargement spécifiques à chaque région sont également disponibles avec les modèles d'URL suivants : https://apps.{domainName}/background-assistant-windows/. Par exemple, https://apps.mypurecloud.ie/background-assistant-windows/.
  2. Cliquez sur Télécharger.
  3. Ouvrez le fichier téléchargé et exécutez le programme d'installation de GCBA.
  4. Cliquez sur Installer.
  5. Si vous intégrez un serveur proxy, sélectionnez Use Proxy Server et entrez les informations relatives au serveur proxy au format ProxyIP-or-Domain:PortNumber.
  6. Cliquez sur installer.

Une fois l'installation terminée, le service Genesys Cloud Background Assistant s'exécute en arrière-plan. Pour vérifier, suivez les étapes suivantes :

  1. Ouvrez Outils d'administration.
  2. Sélectionnez Services et vérifiez que le service Genesys Background Assistance apparaît.
    Remarques:

    Genesys Cloud Background Assistant s'installe dans le répertoire Program Files du dossier Genesys/GenesysCloudBackgroundAssistant. Par exemple, C:\NProgram Files (x86)\NGenesys\NGenesysCloudBackgroundAssistant.

    Une installation silencieuse ne nécessite pas d'invites de l'utilisateur ni d'interface.  

    1. Ouvrez l'invite de commande .
    2. Naviguez jusqu'au répertoire dans lequel vous avez enregistré le fichier d'installation GCBA.
    3. Tapez la commande suivante : <GenesysCloudBackgroundAssistantSetup.exe name> -install /quiet.
      Note: Si vous intégrez un serveur proxy, tapez la commande suivante :  <GenesysCloudBackgroundAssistantSetup.exe name> -install USEPROXY=1 PROXYSERVER="IP address or Domain Name:Port" /quiet.

    Remarques:
    • Si vous souhaitez mettre à jour les paramètres du serveur proxy pour une version existante de GCBA en utilisant la méthode d'installation silencieuse, désinstallez et réinstallez GCBA avec les paramètres du serveur proxy mis à jour.

    • Si vous utilisez le paramètre USEPROXY=1 sans spécifier de valeur pour le paramètre PROXYSERVER,,, l'installation du GCBA se termine avec succès sans configuration des paramètres du serveur proxy.

    L'option de réparation du programme d'installation remplace les fichiers corrompus en les restaurant dans leur version originale, par défaut, à partir de la source d'installation. 

    1. Accédez au site Genesys Cloud Background Assistant (GCBA) installation.
      Remarque : Des pages de téléchargement spécifiques à chaque région sont également disponibles avec les modèles d'URL suivants : https://apps.{domainName}/background-assistant-windows/. Par exemple, https://apps.mypurecloud.ie/background-assistant-windows/.
    2. Cliquez sur Télécharger.
    3. Cliquez sur Repair. 

    Note: L'option Réparer remplace les fichiers corrompus par les fichiers par défaut qui ne contiennent pas de paramètres spécifiques au client tels que les détails du serveur proxy. Pour vous assurer de conserver vos paramètres GCBA, Genesys vous recommande de désinstaller et de réinstaller l'application, puis de spécifier les paramètres requis.

    Dans Firefox, vous devez activer l'option Allow Firefox to automatically trust third-party root certificates you install. Pour plus d'informations, voir Genesys Cloud Background Assistant (GCBA) ne fonctionne pas lorsque j'utilise Firefox, comment puis-je résoudre ce problème ?

    1. Ouvrez le panneau de contrôle.
    2. Sélectionnez Programmes > Désinstaller un programme ou Ajout ou suppression de programmes.
    3. Sélectionnez GCBA dans la liste des programmes et cliquez sur Désinstaller.

    1. Ouvrez l'invite de commande .
    2. Naviguez jusqu'au répertoire dans lequel vous avez enregistré le fichier d'installation GCBA.
    3. Tapez la commande suivante : <GenesysCloudBackgroundAssistantSetup exe name> -uninstall /quiet.

    Localisez la version GCBA dans l'un des emplacements suivants :

    • Panneau de commande
    • Fenêtre des services du GCBA > description du service

    Le GCBA ne peut pas être mis à jour automatiquement. Utilisez un outil tiers pour vérifier que le fichier XML de l'application notifie la mise à jour de la version GCBA.

    Vous pouvez trouver la dernière version sur https://apps.mypurecloud.com/background-assistant-windows/appcast.xml.

    Après avoir téléchargé la version mise à jour de GCBA, exécutez le programme d'installation pour installer la nouvelle version de GCBA. Ce processus désinstalle l'ancienne version et installe la nouvelle.

    Pour effectuer une mise à niveau manuelle, procédez comme suit :

    1. Accédez au site Genesys Cloud Background Assistant (GCBA) installation.
    2. Cliquez sur Télécharger.
    3. Ouvrez le fichier téléchargé et exécutez le programme d'installation de GCBA.
    4. Cliquez sur Installer.
    5. Si vous intégrez un serveur proxy, sélectionnez Use Proxy Server et entrez les informations relatives au serveur proxy au format ProxyIP-or-Domain:PortNumber.

    Pour effectuer une mise à niveau silencieuse, procédez comme suit :

    1. Ouvrez l'invite de commande .
    2. Naviguez jusqu'au répertoire dans lequel vous avez enregistré le fichier d'installation GCBA.
    3. Tapez l'une des commandes suivantes :
      • Si vous n'avez pas de serveur proxy : <GenesysCloudBackgroundAssistantSetup.exe name> -install /quiet.
      • Si vous souhaitez conserver la configuration existante du serveur proxy :  <GenesysCloudBackgroundAssistantSetup.exe name> -install USEPROXY=1 PROXYSERVER="IP address or Domain Name:Port" /quiet.
      • Si vous souhaitez supprimer l'intégration du serveur proxy existant : <GenesysCloudBackgroundAssistantSetup exe name> -install USEPROXY=0 /quiet 

    Remarques:
    • Si vous installez GCBA alors que Firefox est en cours d'exécution, redémarrez Firefox. Pour plus d'informations, voir Genesys Cloud Background Assistant (GCBA) ne fonctionne pas lorsque j'utilise Firefox, comment puis-je résoudre ce problème ?
    • Si la version précédente de GCBA n'a pas de serveur proxy configuré et que, lors d'une mise à niveau silencieuse, le paramètre USEPROXY=1 a été défini sans spécifier de valeur pour le paramètre PROXYSERVER, l'installation de GCBA se termine avec succès sans que les paramètres du serveur proxy soient configurés. Si la version précédente de GCBA comportait des paramètres de serveur proxy, ils seront conservés.

    Pour effectuer les actions suivantes, un agent doit disposer d'un compte Windows® avec des droits d'administrateur.

    • Installer ou désinstaller GCBA
    • Démarrer, arrêter ou redémarrer le service GCBA
    • Terminer n'importe quel processus de GcbaBrowser

    Vérifiez que les agents ne disposent pas d'un compte Windows avec des droits d'administrateur.

    Par défaut, GCBA s'exécute automatiquement au démarrage de l'ordinateur. Avec des droits administratifs, vous pouvez arrêter ou redémarrer le service GCBA.

    1. Ouvrez Outils d'administration.
    2. Sélectionnez Services.
    3. Dans Genesys Cloud Background Assistant, sélectionnez Stop Service ou Start Service.

    Le fichier journal GCBA se trouve dans C:\NProgram Files (x86)\NGenesys\NGenesysCloudBackgroundAssistant\Nlogs\Nbackground-assistant.log.