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 Suivant.
  5. Under Select the mode for local GCBA communication, choose whether you want to use a loopback address or use Microsoft Edge extension for internal communication. For more information, see What internal communication setup option can I use for GCBA?
  6. If you integrate with a proxy server, select Use Proxy Server under Proxy settings and enter the proxy server information in the ProxyIP-or-Domain:PortNumber format.
  7. 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:

    3. Genesys Cloud Background Assistant installs in the Program Files directory in the Genesys\GenesysCloudBackgroundAssistant folder. For example, C:\Program Files (x86)\Genesys\GenesysCloudBackgroundAssistant.

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. Type one of the following commands:
    • Silent installation (uses loopback address by default):  <GenesysCloudBackgroundAssistantSetup.exe name> -install /quiet
    • Silent installation with loopback address: <GenesysCloudBackgroundAssistantSetup.exe name> -install COMMUNICATION_MODE="Loopback" /quiet
    • Silent installation with Edge extension: <GenesysCloudBackgroundAssistantSetup.exe name> -install COMMUNICATION_MODE="EdgeExtension" /quiet

Remarques: 
  • If you want to update the proxy server settings for an existing GCBA version using the silent installation method, uninstall and reinstall GCBA with the updated proxy server settings.
  • If you integrate with a proxy server, add these command-line arguments:  USEPROXY=1 PROXYSERVER="IP address or Domain Name:Port".

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.

Firefox

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 ?

Serveur Edge de Microsoft

If you are using the Microsoft Edge extension for GCBA’s internal communication, you can follow these steps to check whether the Edge extension for GCBA Connector is installed or not:

  1. Open Edge.
  2. Type edge://extensions in the address bar and press Enter.
  3. Verify that Genesys Cloud GCBA Connector appears in the installed extensions list.

Remarques:
  • Restart Edge after installing GCBA and then check the installed extension.
  • Refer to the GCBA release notes to find the latest version of the GCBA Connector extension.

  1. Open the Control Panel.
  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.

Note: If you are using the Microsoft Edge extension for GCBA’s internal communication, any previously installed GCBA Connector extension in the Edge browser is also uninstalled.

  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.

Note: If you are using the Microsoft Edge extension for GCBA’s internal communication, any previously installed GCBA Connector extension in the Edge browser is also uninstalled.

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 Suivant.
  5. If you integrate with a proxy server, select Use Proxy Server under Proxy settings and enter the proxy server information in the ProxyIP-or-Domain:PortNumber format. 

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. Type one of the following commands:
    • If you want to retain the existing configuration, use the same command that you used for installation. If the existing communication is through the GCBA Connector extension for Edge and a new version of extension is available, the extension is automatically upgraded.
    • If you want to update the existing proxy server configuration, add these command-line arguments to or remove them from the silent installation command: USEPROXY=1 PROXYSERVER="IP address or Domain Name:Port".
    • If you want to remove the existing proxy server integration: <GenesysCloudBackgroundAssistantSetup exe name> -install USEPROXY=0 /quiet. 

Remarques:

    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.

    If you want to change the internal communication method, it is recommended that you uninstall GCBA and reinstall it. Any setup change without uninstalling and reinstalling GCBA is not recommended or supported by Genesys. For more information, see What internal communication setup option can I use for GCBA?

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