From Bright Pattern Documentation
Jump to: navigation, search
(Marked this version for translation)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
<translate>
 
<translate>
= Installing and Updating the Agent Desktop Helper Application=
+
= Installing and Updating the Agent Desktop Helper Application= <!--T:1-->
 
The Agent Desktop Helper Application is a software component that provides many functions for the Agent Desktop application, such as a softphone, screen-pop, logging, indication of audio device changes, alerts on all audio devices, screen recording and monitoring, and voice quality monitoring.
 
The Agent Desktop Helper Application is a software component that provides many functions for the Agent Desktop application, such as a softphone, screen-pop, logging, indication of audio device changes, alerts on all audio devices, screen recording and monitoring, and voice quality monitoring.
  
 +
<!--T:2-->
 
From time to time, you may be prompted by Agent Desktop to install the Agent Desktop Helper Application on your computer or enable it in your web browser. This article will guide you through the process of downloading, installing, and enabling the application on any browser.
 
From time to time, you may be prompted by Agent Desktop to install the Agent Desktop Helper Application on your computer or enable it in your web browser. This article will guide you through the process of downloading, installing, and enabling the application on any browser.
  
== When Do You Need the Agent Desktop Helper App? ==
+
<!--T:30-->
 +
You don't need local system administrative privileges on your PC to set up and use Agent Desktop and Agent Desktop Helper Application
 +
 
 +
== When Do You Need the Agent Desktop Helper App? == <!--T:3-->
 
You may be prompted by a warning message to download and install the Agent Desktop Helper application when...
 
You may be prompted by a warning message to download and install the Agent Desktop Helper application when...
 
* You log in to Agent Desktop for the first time.
 
* You log in to Agent Desktop for the first time.
Line 15: Line 19:
 
* An error message indicates that you logged in with a softphone, but the Agent Desktop Helper app is not installed or is blocked by your computer.
 
* An error message indicates that you logged in with a softphone, but the Agent Desktop Helper app is not installed or is blocked by your computer.
  
 +
<!--T:4-->
 
A warning message such as the one shown contains instructions for installing and enabling the Agent Desktop Helper Application component on your computer. The exact text of the message and your actions will depend on the browser you are using.
 
A warning message such as the one shown contains instructions for installing and enabling the Agent Desktop Helper Application component on your computer. The exact text of the message and your actions will depend on the browser you are using.
  
  
 +
<!--T:5-->
 
[[File:Image.png|thumb|450px|center|Agent Desktop update message]]
 
[[File:Image.png|thumb|450px|center|Agent Desktop update message]]
  
  
== How to Enable the Application for Various Browsers ==
+
== How to Enable the Application for Various Browsers == <!--T:6-->
The Agent Desktop Helper Application is supported on Google Chrome, Mozilla Firefox, Safari, and Microsoft Internet Explorer. Some browser extensions or other settings may need to be enabled, depending on your browser.
+
The Agent Desktop Helper Application is supported on Google Chrome, Microsoft Edge, Microsoft Internet Explorer, Mozilla Firefox, and Safari. Some browser extensions or other settings may need to be enabled, depending on your browser.
  
=== Chrome ===
+
=== Chrome === <!--T:7-->
 
The Agent Desktop Helper Application is enabled for Chrome using an extension called '''Agent Desktop Chrome Extension'''.
 
The Agent Desktop Helper Application is enabled for Chrome using an extension called '''Agent Desktop Chrome Extension'''.
  
==== How to Enable the Extension for Chrome ====
+
==== How to Enable the Extension for Chrome ==== <!--T:8-->
 
# When prompted by the warning message, follow the instructions to download and install the Agent Desktop Helper Application (Mac: ''bpclient_mac.pkg'', Windows: ''BPClientSetup.exe'').<br /><br />[[File:AD-Chrome-5317.png|thumb|650px|center|Agent Desktop update message]]<br /><br />
 
# When prompted by the warning message, follow the instructions to download and install the Agent Desktop Helper Application (Mac: ''bpclient_mac.pkg'', Windows: ''BPClientSetup.exe'').<br /><br />[[File:AD-Chrome-5317.png|thumb|650px|center|Agent Desktop update message]]<br /><br />
 
# After installation is complete, go to the [https://chrome.google.com/webstore/detail/agent-desktop-chrome-exte/mkaocfkkgijdkejknbfblgfbelppnfci <span class="underline">Chrome Web Store</span>] and click '''Add to Chrome''' to get the Agent Desktop Chrome Extension.<br /><br />[[File:AD-Chrome2.PNG|thumb|800px|center|Chrome Extensions &gt; Agent Desktop Chrome Extension]]<br /><br />
 
# After installation is complete, go to the [https://chrome.google.com/webstore/detail/agent-desktop-chrome-exte/mkaocfkkgijdkejknbfblgfbelppnfci <span class="underline">Chrome Web Store</span>] and click '''Add to Chrome''' to get the Agent Desktop Chrome Extension.<br /><br />[[File:AD-Chrome2.PNG|thumb|800px|center|Chrome Extensions &gt; Agent Desktop Chrome Extension]]<br /><br />
Line 36: Line 42:
  
  
=== Firefox ===
+
=== Edge === <!--T:31-->
 +
The Agent Desktop Helper Application is enabled for Microsoft Edge 85 and later using an extension called '''Agent Desktop Chrome Extension'''.
 +
 
 +
==== How to Enable the Extension for Edge ==== <!--T:32-->
 +
# When prompted by the warning message, follow the instructions to download and install the Agent Desktop Helper Application (Windows: ''BPClientSetup.exe'').<br /><br />[[File:Edge-ADHA-Message-555.PNG|thumb|450px|center|Agent Desktop update message]]<br /><br />
 +
# After installation is complete, go to the [https://chrome.google.com/webstore/detail/agent-desktop-chrome-exte/mkaocfkkgijdkejknbfblgfbelppnfci <span class="underline">Chrome Web Store</span>] and click '''Add to Chrome''' to get the Agent Desktop Chrome Extension.<br /><br />[[File:Edge-Add-Chrome-Extension5-555.PNG|center|thumb|800px|Adding the extension]]<br /><br />
 +
# Then click '''Add extension'''.<br /><br />[[File:Edge-Add-Chrome-Extension2-555.PNG|thumb|800px|center|Confirm that you want to add the extension]]<br /><br />
 +
# You will then see the extension's icon in the Edge toolbar. To check that the extension is enabled for Edge, click the icon and then click '''Manage extensions'''.<br /><br />[[File:Edge-Add-Chrome-Extension3-555.PNG|thumb|350px|center|Click Manage extensions to enable the extension for Edge]]<br /><br />
 +
# Set the slider to '''On''' to enable the extension for Edge. When the slider is black/white, the extension is not enabled. When the slider is blue, it is enabled.<br /><br />[[File:Edge-Add-Chrome-Extension4a-555.PNG|center|thumb|450px|Manage extensions > Agent Desktop Chrome Extension]]<br /><br />
 +
# Go back to the Agent Desktop application and refresh the page. You can now begin using it.
 +
 
 +
 
 +
=== Firefox === <!--T:9-->
 
The Agent Desktop Helper Application is enabled for Firefox version 53 and later through the use of an extension called '''Agent Desktop Extension'''.
 
The Agent Desktop Helper Application is enabled for Firefox version 53 and later through the use of an extension called '''Agent Desktop Extension'''.
  
==== How to Enable the Extension for Firefox ====
+
==== How to Enable the Extension for Firefox ==== <!--T:10-->
# When prompted by a warning message such as the one shown, follow the instructions to download the Agent Desktop Helper Application (Mac: ''bpclient_mac.pkg'', Windows: ''BPClientSetup.exe''). Note that you may be prompted to restart your computer after installation is complete.<br /><br />[[File:Firefox-Warning-ADHA-5317.PNG|thumb|450px|center|Example of an Agent Desktop warning message]]<br /><br />
+
# In Agent Desktop, you will be prompted by a warning message.<br /><br />[[File:ADHA-Warning-Firefox-5317.PNG|thumb|800px|center|Example of an Agent Desktop warning message]]<br /><br />
# If this is your first time installing the Agent Desktop Helper Application on your computer, you will need to add the Agent Desktop Extension to your browser and enable it. If you have previously installed it and are simply updating your application, you can skip this step and move ahead to Step 5 of this procedure.<br /><br />
+
# Follow the instructions in the message to download the Agent Desktop Helper Application (Mac: ''bpclient_mac.pkg'', Windows: ''BPClientSetup.exe'') and install and enable the Agent Desktop Extension:<br /><br />
# After installation is complete, open Firefox. Go to [https://addons.mozilla.org/en-US/firefox/addon/bpcc-agent-desktop-extension/ <span class="underline">Firefox Browser Add-Ons</span>] (click the link or type '''about:addons''' in the address bar of the browser, and search for “Agent Desktop Extension”). Click '''+''' '''Add to Firefox''' to get the Agent Desktop Extension.<br /><br />[[File:Firefox-ADHA-Addon-5317.PNG|center|thumb|450px|Agent Desktop Extension in Firefox Add-Ons]]
+
## Click the '''downloading''' link to download the application.<br /><br />
# Follow the prompts to add it.<br /><br />[[File:Firefox-ADHA-Extension-5317.PNG|center|thumb|450px|Confirm that you’re adding the extension]]<br /><br />
+
## Run the installer, and follow all the instructions given on your screen.<br /><br />
# Make sure that the extension is enabled. Go to ''Firefox Menu &gt; Add-ons'' (or type '''about:addons''' in the address bar of the browser to access the extension).<br /><br />[[File:Firefox-Settings-5317.PNG|center|thumb|450px|Firefox &gt; Menu &gt; Add-ons]]<br /><br />
+
## Click the '''Agent Desktop Extension''' link in the warning message to install the Agent Desktop Extension. Doing so will bring up a Firefox dialog such as the one shown, asking you to allow the Agent Desktop Extension to be installed as an add-on. Click '''Continue to Installation'''.<br /><br />[[File:ADHA-Firefox-Addons2-5317.PNG|thumb|800px|center|Example dialog for Firefox add-on installation]]<br /><br />
# The Agent Desktop Extension should be shown as '''Enabled''', and the slider should be switched to '''On'''.<br /><br />When the slider is gray, the extension is not enabled. When the slider is blue, it is enabled.<br /><br />[[File:Firefox-Addons-Extensions-5317.PNG|thumb|800px|center|Agent Desktop Extension in about:addons]]<br /><br />
+
# Make sure that the extension is enabled in Firefox Add-ons. Go to ''Firefox Menu > Add-ons'' (or type '''about:addons''' in the address bar of the browser to access the extension).<br /><br />[[File:Firefox-Settings-5317.PNG|center|thumb|450px|Firefox > Menu > Add-ons]]<br /><br />
# If you click on '''Agent Desktop Extension''', you can view and change the other settings for the extension. Those settings are optional.<br /><br />
+
# The Agent Desktop Extension should be shown as '''Enabled''', and the slider should be switched to '''On'''. When the slider is gray, the extension is not enabled. When the slider is blue, it is enabled.<br /><br />[[File:Firefox-Extensions2.PNG|thumb|800px|center|Agent Desktop Firefox Extension in about:addons]]<br /><br />
# Close Firefox, and then reopen Firefox. You can now return to the Agent Desktop application and begin using it.
+
# If you click on Agent Desktop Extension, you can view and change the other settings for the extension. Those settings are optional.<br /><br />
 +
# You can now return to the Agent Desktop application. Refresh the page to begin using it.
  
  
=== Internet Explorer ===
+
=== Internet Explorer === <!--T:11-->
 
Internet Explorer does not require an extension, but if you use Internet Explorer 11 or higher, the browser's Enhanced Protected Mode must be disabled in order for all Agent Desktop application logs to appear in the same folder (e.g., “''C:\Users\&lt;UserName&gt;\AppData\Local\Temp\logs”'').
 
Internet Explorer does not require an extension, but if you use Internet Explorer 11 or higher, the browser's Enhanced Protected Mode must be disabled in order for all Agent Desktop application logs to appear in the same folder (e.g., “''C:\Users\&lt;UserName&gt;\AppData\Local\Temp\logs”'').
  
 +
<!--T:12-->
 
The logs provide information about what has happened in the application while you were logged in. Having logs is important because you may need to provide them to your supervisor or administrator if ever you need troubleshooting assistance.
 
The logs provide information about what has happened in the application while you were logged in. Having logs is important because you may need to provide them to your supervisor or administrator if ever you need troubleshooting assistance.
  
==== How to Disable Enhanced Protected Mode ====
+
==== How to Disable Enhanced Protected Mode ==== <!--T:13-->
 
# In the browser application, click '''Tools''' (Alt+X) and select '''Internet options'''.<br /><br />
 
# In the browser application, click '''Tools''' (Alt+X) and select '''Internet options'''.<br /><br />
 
# Click the '''Security''' tab, and deselect the '''Enable Enhanced Protected Mode''' checkbox.<br /><br />
 
# Click the '''Security''' tab, and deselect the '''Enable Enhanced Protected Mode''' checkbox.<br /><br />
 
# Click '''OK'''.
 
# Click '''OK'''.
  
=== Safari ===
+
=== Safari === <!--T:14-->
 
The Agent Desktop Helper Application is enabled for Safari 10, 11, and 12 on Mac OS X 10.12 (Sierra) and higher through the use of an extension, which is packaged in the Agent Desktop Helper Application installer (''bpclient_mac.pkg''). The installer will detect the OS X version your system is running on and will install the extension only if needed.
 
The Agent Desktop Helper Application is enabled for Safari 10, 11, and 12 on Mac OS X 10.12 (Sierra) and higher through the use of an extension, which is packaged in the Agent Desktop Helper Application installer (''bpclient_mac.pkg''). The installer will detect the OS X version your system is running on and will install the extension only if needed.
  
==== How to Enable the Application for Safari ====
+
==== How to Enable the Application for Safari ==== <!--T:15-->
 
# When prompted by the warning message, follow the instructions to download the Agent Desktop Helper Application (''bpclient_mac.pkg'').<br /><br />[[File:Image.png|thumb|450px|center|Agent Desktop update message]]
 
# When prompted by the warning message, follow the instructions to download the Agent Desktop Helper Application (''bpclient_mac.pkg'').<br /><br />[[File:Image.png|thumb|450px|center|Agent Desktop update message]]
 
# Follow the prompts to install “CSIM Client Plugin.”<br /><br />[[File:AD-Safari-5317.png|thumb|800px|center|Install CSIM Client Plugin]]<br /><br />
 
# Follow the prompts to install “CSIM Client Plugin.”<br /><br />[[File:AD-Safari-5317.png|thumb|800px|center|Install CSIM Client Plugin]]<br /><br />
Line 69: Line 89:
  
  
== Other Updates ==
+
== Mac Security/Privacy Settings == <!--T:33-->
 +
If you are on a Mac, note that you may have to update your security/privacy settings, in addition to all the aforementioned steps for installing/updating the Agent Desktop Helper Application on various browsers.
 +
 
 +
<!--T:34-->
 +
In your privacy settings, allow both "Agent Desktop Helper" and "bpclient" apps to use the microphone. This step is required, no matter which web browser you are running.
 +
 
 +
 
 +
<!--T:35-->
 +
[[File:Mac-Security-Privacy-53AD.png|center|thumb|650px|Example of allowing apps to use the microphone in Security & Privacy > Privacy]]
 +
 
 +
 
 +
== Other Updates == <!--T:16-->
 
From time to time, the Agent Desktop Helper Application may have to be updated to support new system functionality. When a new version of this component becomes available, you may see a warning message similar to the one described above prompting you to upgrade. Follow the instructions of the message to update and enable the Agent Desktop Helper Application component on your computer.
 
From time to time, the Agent Desktop Helper Application may have to be updated to support new system functionality. When a new version of this component becomes available, you may see a warning message similar to the one described above prompting you to upgrade. Follow the instructions of the message to update and enable the Agent Desktop Helper Application component on your computer.
  
== Troubleshooting ==
+
== Troubleshooting == <!--T:17-->
 
This section describes some common issues you might experience and what you should do.
 
This section describes some common issues you might experience and what you should do.
  
=== I just installed the Agent Desktop Helper Application but I still get the warning message in Agent Desktop. ===
+
=== I just installed the Agent Desktop Helper Application but I still get the warning message in Agent Desktop. === <!--T:18-->
  
 +
<!--T:19-->
 
What this might mean:
 
What this might mean:
 
* The installation may be incomplete. Check that the application is installed on your computer.
 
* The installation may be incomplete. Check that the application is installed on your computer.
  
 +
<!--T:20-->
 
* You may need to refresh the page again. If the warning message still appears after that, then close your browser, reopen it, and go back to Agent Desktop.
 
* You may need to refresh the page again. If the warning message still appears after that, then close your browser, reopen it, and go back to Agent Desktop.
  
 +
<!--T:21-->
 
* If your browser requires an extension, it may be disabled. Go to the extension settings and make sure the extension is '''enabled''' or set to '''On'''.<br /><br />[[File:ADHA-Chrome-Details.PNG|center|thumb|450px|Agent Desktop Chrome Extension details]]
 
* If your browser requires an extension, it may be disabled. Go to the extension settings and make sure the extension is '''enabled''' or set to '''On'''.<br /><br />[[File:ADHA-Chrome-Details.PNG|center|thumb|450px|Agent Desktop Chrome Extension details]]
  
 +
<!--T:22-->
 
* Your browser may be blocking the application, the page, or pop-ups on the page. Try clicking the lock icon in the address bar, and make sure that all options are set to '''Allow'''.<br /><br />[[File:Chrome-Lock-5317.PNG|center|thumb|450px|Click the lock]]
 
* Your browser may be blocking the application, the page, or pop-ups on the page. Try clicking the lock icon in the address bar, and make sure that all options are set to '''Allow'''.<br /><br />[[File:Chrome-Lock-5317.PNG|center|thumb|450px|Click the lock]]
  
=== A message says a network issue is disrupting your phone device. ===
+
=== A message says a network issue is disrupting your phone device. === <!--T:23-->
 
What this might mean:
 
What this might mean:
 
* Restarting Agent Desktop may be required. Log out of Agent Desktop, and log in again.
 
* Restarting Agent Desktop may be required. Log out of Agent Desktop, and log in again.
  
 +
<!--T:24-->
 
* You may have lost Internet connectivity. Check your Internet connection and refresh the page.
 
* You may have lost Internet connectivity. Check your Internet connection and refresh the page.
  
 +
<!--T:25-->
 
* If you made changes to the [[Agent-guide/Setup/PhoneDevice | phone device]], you need to log out of Agent Desktop and log in again for those changes to take effect.
 
* If you made changes to the [[Agent-guide/Setup/PhoneDevice | phone device]], you need to log out of Agent Desktop and log in again for those changes to take effect.
  
=== A message says I logged in with a softphone, but the Agent Desktop Helper app is not installed or is blocked by your computer. ===
+
=== A message says I logged in with a softphone, but the Agent Desktop Helper app is not installed or is blocked by your computer. === <!--T:26-->
 
What this might mean:
 
What this might mean:
 
* If your browser requires an extension, it may be disabled. Go to the extension settings and make sure the extension is '''enabled''' or set to '''On'''.
 
* If your browser requires an extension, it may be disabled. Go to the extension settings and make sure the extension is '''enabled''' or set to '''On'''.
  
 +
<!--T:27-->
 
* Your browser may be blocking the application, the page, or pop-ups on the page. Try clicking the lock icon in the address bar, and make sure that all options are set to '''Allow'''.<br /><br />[[File:Chrome-Lock-5317.PNG|center|thumb|450px|Click the lock]]
 
* Your browser may be blocking the application, the page, or pop-ups on the page. Try clicking the lock icon in the address bar, and make sure that all options are set to '''Allow'''.<br /><br />[[File:Chrome-Lock-5317.PNG|center|thumb|450px|Click the lock]]
  
 +
<!--T:28-->
 
* Anti-virus software running on your computer might be blocking the application. Typically, in this case, you will see a warning message asking you either to cancel or confirm the download/install. Choose the confirm/allow/proceed option to proceed with the installation/upgrade.
 
* Anti-virus software running on your computer might be blocking the application. Typically, in this case, you will see a warning message asking you either to cancel or confirm the download/install. Choose the confirm/allow/proceed option to proceed with the installation/upgrade.
  
=== None of this helps me. ===
+
=== None of this helps me. === <!--T:29-->
 
Contact your supervisor and/or service provider to request assistance.
 
Contact your supervisor and/or service provider to request assistance.
  

Latest revision as of 22:45, 8 September 2021

Other languages:
English • ‎日本語
• 5.3 • 5.8

Installing and Updating the Agent Desktop Helper Application

The Agent Desktop Helper Application is a software component that provides many functions for the Agent Desktop application, such as a softphone, screen-pop, logging, indication of audio device changes, alerts on all audio devices, screen recording and monitoring, and voice quality monitoring.

From time to time, you may be prompted by Agent Desktop to install the Agent Desktop Helper Application on your computer or enable it in your web browser. This article will guide you through the process of downloading, installing, and enabling the application on any browser.

You don't need local system administrative privileges on your PC to set up and use Agent Desktop and Agent Desktop Helper Application

When Do You Need the Agent Desktop Helper App?

You may be prompted by a warning message to download and install the Agent Desktop Helper application when...

  • You log in to Agent Desktop for the first time.
  • The Agent Desktop Helper app is not yet installed on your computer.
  • Agent Desktop has been updated, requiring a higher version of the Agent Desktop Helper app.
  • The app is being blocked by your web browser.
  • The browser extension is not enabled.
  • An error message indicates that the SIP phone has lost connection to the system.
  • An error message indicates that you logged in with a softphone, but the Agent Desktop Helper app is not installed or is blocked by your computer.

A warning message such as the one shown contains instructions for installing and enabling the Agent Desktop Helper Application component on your computer. The exact text of the message and your actions will depend on the browser you are using.


Agent Desktop update message


How to Enable the Application for Various Browsers

The Agent Desktop Helper Application is supported on Google Chrome, Microsoft Edge, Microsoft Internet Explorer, Mozilla Firefox, and Safari. Some browser extensions or other settings may need to be enabled, depending on your browser.

Chrome

The Agent Desktop Helper Application is enabled for Chrome using an extension called Agent Desktop Chrome Extension.

How to Enable the Extension for Chrome

  1. When prompted by the warning message, follow the instructions to download and install the Agent Desktop Helper Application (Mac: bpclient_mac.pkg, Windows: BPClientSetup.exe).

    Agent Desktop update message


  2. After installation is complete, go to the Chrome Web Store and click Add to Chrome to get the Agent Desktop Chrome Extension.

    Chrome Extensions > Agent Desktop Chrome Extension


  3. Then click Add extension.

    Confirm that you want to add the extension


  4. Go to Settings > Extensions (or type “chrome://extensions/” in your browser’s address bar), find the Agent Desktop Chrome Extension, and set the slider to On. Doing so will enable the extension for Chrome. When the slider is gray, the extension is not enabled. When the slider is blue, it is enabled.

    Chrome Settings > Extensions > Agent Desktop Chrome Extension


  5. Alternatively, you may enable the extension by clicking Details and setting the slider to On. The other settings in Details are optional.

    Agent Desktop Chrome Extension details


  6. Go back to the Agent Desktop application and refresh the page. You can now begin using it.


Edge

The Agent Desktop Helper Application is enabled for Microsoft Edge 85 and later using an extension called Agent Desktop Chrome Extension.

How to Enable the Extension for Edge

  1. When prompted by the warning message, follow the instructions to download and install the Agent Desktop Helper Application (Windows: BPClientSetup.exe).

    Agent Desktop update message


  2. After installation is complete, go to the Chrome Web Store and click Add to Chrome to get the Agent Desktop Chrome Extension.

    Adding the extension


  3. Then click Add extension.

    Confirm that you want to add the extension


  4. You will then see the extension's icon in the Edge toolbar. To check that the extension is enabled for Edge, click the icon and then click Manage extensions.

    Click Manage extensions to enable the extension for Edge


  5. Set the slider to On to enable the extension for Edge. When the slider is black/white, the extension is not enabled. When the slider is blue, it is enabled.

    Manage extensions > Agent Desktop Chrome Extension


  6. Go back to the Agent Desktop application and refresh the page. You can now begin using it.


Firefox

The Agent Desktop Helper Application is enabled for Firefox version 53 and later through the use of an extension called Agent Desktop Extension.

How to Enable the Extension for Firefox

  1. In Agent Desktop, you will be prompted by a warning message.

    Example of an Agent Desktop warning message


  2. Follow the instructions in the message to download the Agent Desktop Helper Application (Mac: bpclient_mac.pkg, Windows: BPClientSetup.exe) and install and enable the Agent Desktop Extension:

    1. Click the downloading link to download the application.

    2. Run the installer, and follow all the instructions given on your screen.

    3. Click the Agent Desktop Extension link in the warning message to install the Agent Desktop Extension. Doing so will bring up a Firefox dialog such as the one shown, asking you to allow the Agent Desktop Extension to be installed as an add-on. Click Continue to Installation.

      Example dialog for Firefox add-on installation


  3. Make sure that the extension is enabled in Firefox Add-ons. Go to Firefox Menu > Add-ons (or type about:addons in the address bar of the browser to access the extension).

    Firefox > Menu > Add-ons


  4. The Agent Desktop Extension should be shown as Enabled, and the slider should be switched to On. When the slider is gray, the extension is not enabled. When the slider is blue, it is enabled.

    Agent Desktop Firefox Extension in about:addons


  5. If you click on Agent Desktop Extension, you can view and change the other settings for the extension. Those settings are optional.

  6. You can now return to the Agent Desktop application. Refresh the page to begin using it.


Internet Explorer

Internet Explorer does not require an extension, but if you use Internet Explorer 11 or higher, the browser's Enhanced Protected Mode must be disabled in order for all Agent Desktop application logs to appear in the same folder (e.g., “C:\Users\<UserName>\AppData\Local\Temp\logs”).

The logs provide information about what has happened in the application while you were logged in. Having logs is important because you may need to provide them to your supervisor or administrator if ever you need troubleshooting assistance.

How to Disable Enhanced Protected Mode

  1. In the browser application, click Tools (Alt+X) and select Internet options.

  2. Click the Security tab, and deselect the Enable Enhanced Protected Mode checkbox.

  3. Click OK.

Safari

The Agent Desktop Helper Application is enabled for Safari 10, 11, and 12 on Mac OS X 10.12 (Sierra) and higher through the use of an extension, which is packaged in the Agent Desktop Helper Application installer (bpclient_mac.pkg). The installer will detect the OS X version your system is running on and will install the extension only if needed.

How to Enable the Application for Safari

  1. When prompted by the warning message, follow the instructions to download the Agent Desktop Helper Application (bpclient_mac.pkg).

    Agent Desktop update message
  2. Follow the prompts to install “CSIM Client Plugin.”

    Install CSIM Client Plugin


  3. After installation is complete, refresh the Agent Desktop webpage. You can now begin using it.


Mac Security/Privacy Settings

If you are on a Mac, note that you may have to update your security/privacy settings, in addition to all the aforementioned steps for installing/updating the Agent Desktop Helper Application on various browsers.

In your privacy settings, allow both "Agent Desktop Helper" and "bpclient" apps to use the microphone. This step is required, no matter which web browser you are running.


Example of allowing apps to use the microphone in Security & Privacy > Privacy


Other Updates

From time to time, the Agent Desktop Helper Application may have to be updated to support new system functionality. When a new version of this component becomes available, you may see a warning message similar to the one described above prompting you to upgrade. Follow the instructions of the message to update and enable the Agent Desktop Helper Application component on your computer.

Troubleshooting

This section describes some common issues you might experience and what you should do.

I just installed the Agent Desktop Helper Application but I still get the warning message in Agent Desktop.

What this might mean:

  • The installation may be incomplete. Check that the application is installed on your computer.
  • You may need to refresh the page again. If the warning message still appears after that, then close your browser, reopen it, and go back to Agent Desktop.
  • If your browser requires an extension, it may be disabled. Go to the extension settings and make sure the extension is enabled or set to On.

    Agent Desktop Chrome Extension details
  • Your browser may be blocking the application, the page, or pop-ups on the page. Try clicking the lock icon in the address bar, and make sure that all options are set to Allow.

    Click the lock

A message says a network issue is disrupting your phone device.

What this might mean:

  • Restarting Agent Desktop may be required. Log out of Agent Desktop, and log in again.
  • You may have lost Internet connectivity. Check your Internet connection and refresh the page.
  • If you made changes to the phone device, you need to log out of Agent Desktop and log in again for those changes to take effect.

A message says I logged in with a softphone, but the Agent Desktop Helper app is not installed or is blocked by your computer.

What this might mean:

  • If your browser requires an extension, it may be disabled. Go to the extension settings and make sure the extension is enabled or set to On.
  • Your browser may be blocking the application, the page, or pop-ups on the page. Try clicking the lock icon in the address bar, and make sure that all options are set to Allow.

    Click the lock
  • Anti-virus software running on your computer might be blocking the application. Typically, in this case, you will see a warning message asking you either to cancel or confirm the download/install. Choose the confirm/allow/proceed option to proceed with the installation/upgrade.

None of this helps me.

Contact your supervisor and/or service provider to request assistance.



< Previous | Next >