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. Sous Sélectionner le mode de communication locale GCBA, choisissez d'utiliser une adresse de bouclage ou d'utiliser l'extension Microsoft Edge pour la communication interne. Pour plus d'informations, voir Quelle option de configuration de la communication interne puis-je utiliser pour GCBA ?
  6. Si vous intégrez un serveur proxy, sélectionnez Use Proxy Server sous Proxy settings et saisissez les informations relatives au serveur proxy au format ProxyIP-or-Domain:PortNumber.
  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 s'installe dans le répertoire Program Files dans le dossier Genesys\GenesysCloudBackgroundAssistant. Par exemple, 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. Tapez l'une des commandes suivantes :
    • Installation silencieuse (utilise l'adresse loopback par défaut) :  <GenesysCloudBackgroundAssistantSetup.exe name> -install /quiet
    • Installation silencieuse avec adresse de bouclage : <GenesysCloudBackgroundAssistantSetup.exe name> -install COMMUNICATION_MODE="Loopback" /quiet
    • Installation silencieuse avec extension Edge : <GenesysCloudBackgroundAssistantSetup.exe name> -install COMMUNICATION_MODE="EdgeExtension" /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 intégrez un serveur proxy, ajoutez les arguments de ligne de commande suivants :  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

Si vous utilisez l'extension Microsoft Edge pour la communication interne de GCBA, vous pouvez suivre les étapes suivantes pour vérifier si l'extension Edge pour le connecteur GCBA est installée ou non :

  1. Bord ouvert.
  2. Tapez edge://extensions dans la barre d'adresse et appuyez sur Enter.
  3. Vérifiez que Genesys Cloud GCBA Connector apparaît dans la liste des extensions installées.

Remarques:
  • Redémarrez Edge après avoir installé GCBA, puis vérifiez l'extension installée.
  • Consultez les notes de mise à jour de GCBA pour trouver la dernière version de l'extension GCBA Connector.

  1. Ouvrez le panneau de configuration.
  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: Si vous utilisez l'extension Microsoft Edge pour la communication interne du GCBA, toute extension du connecteur GCBA précédemment installée dans le navigateur Edge est également désinstallée.

  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: Si vous utilisez l'extension Microsoft Edge pour la communication interne du GCBA, toute extension du connecteur GCBA précédemment installée dans le navigateur Edge est également désinstallée.

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. Si vous intégrez un serveur proxy, sélectionnez Use Proxy Server sous Proxy settings et saisissez 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 souhaitez conserver la configuration existante, utilisez la même commande que celle utilisée pour l'installation. Si la communication existante passe par l'extension GCBA Connector for Edge et qu'une nouvelle version de l'extension est disponible, l'extension est automatiquement mise à jour.
    • Si vous souhaitez mettre à jour la configuration existante du serveur proxy, ajoutez ces arguments de ligne de commande à la commande d'installation silencieuse ou supprimez-les : USEPROXY=1 PROXYSERVER="IP address or Domain Name:Port".
    • Si vous souhaitez supprimer l'intégration du serveur proxy existant : <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.

    Si vous souhaitez modifier la méthode de communication interne, il est recommandé de désinstaller GCBA et de le réinstaller. Toute modification de la configuration sans désinstallation et réinstallation de GCBA n'est pas recommandée ni prise en charge par Genesys. Pour plus d'informations, voir Quelle option de configuration de la communication interne puis-je utiliser pour GCBA ?

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