Engage Workspace Desktop Edition (WDE)
Plugin version v1.x
Last updated
Was this helpful?
Plugin version v1.x
Last updated
Was this helpful?
Supported WDE versions: 8.5.147.05+.
installed on your WDE instances.
Add the plugin and dependencies to your Workspace Desktop Edition installation:
Genesyslab.Desktop.Modules.CobrowseIO.dll
Genesyslab.Desktop.Modules.CobrowseIO.module-config
These files should be added adjacent to your other Module .dll files, in the same directory as InteractionWorkspace.exe. This executable is most commonly found atC:\Program Files (x86)\GCTI\Workspace Desktop Edition.
The configuration values can be added via Genesys GAX, Genesys Administrator, or directly in a InteractionWorkspace.exe.config file adjacent to your InteractionWorkspace.exe
When using Genesys GAX, please navigate to Environment/Applications -> WorkspaceDesktop -> Application Options -> interaction-workspace and add the following fields there.
Field
Type
Value
cobrowse.api required
string
eg. https://cobrowse.yourcompany.com
default is https://cobrowse.io
cobrowse.license required
string
your license key
cobrowse.debug optional
string
true / false
default is false
cobrowse.initialUrl optional
string
Override initial Url the plugin tab will load
cobrowse.proxyServer optional
(Supported in v1.4+)
string
URL to proxy WebView traffic through
cobrowse.proxyBypassList optional
(Supported in v1.4+)
string
Semi-colon-separated list of hosts.
You should now see the COBROWSE tab within your Workspace Desktop Edition when interacting with an end-user, such as on a phone call, or via a live chat.
Take note of your <PROVIDER_ID>. It should a string of 6 characters after the /login/saml/ path seen in the login page URL.
Update cobrowse.initialUrl to the URL below, replacing <DOMAIN> with the domain of the Cobrowse instance, often cobrowse.io, <PROVIDER_ID> with the 6 characters that you took note of in the previous step and <YOUR_LICENSE_KEY> with the license key for your account.
https://<DOMAIN>/api/1/saml/auth?provider=<PROVIDER_ID>&redirectTo=%2Fapps%2Fgenesys%2Findex.html%3Fenv%3Dwde%26interactionId%3D%24Interaction.Id%24%26license%3D<YOUR_LICENSE_KEY>
Now when opening the COBROWSE tab from within WDE you should be taken to your SSO provider allowing you to sign in and be authenticated within WDE.
Please enable the optional setting cobrowse.debug = true as described above.
This will provide additional logging from the COBROWSE tab to the Genesys Workspace Desktop Edition logs.
The plugin will also activate remote debugging of the web app on port 9222. Open MS Edge, go to edge://inspect/#devices and the plugin will appear there:
See for more detail.
If you wish to sign into Cobrowse from within WDE using SSO you must first follow our documentation to .
With SAML configured, visit the page of your Cobrowse dashboard and look to the login page URL seen within the SAML Config section. It should look something like https://<DOMAIN>/login/saml/<PROVIDER_ID>.
Please verify if your version of Genesys Workspace Desktop Edition is 8.5.147.05+. If you are running an earlier version, or if you are running a supported version which still faces this issue, please contact us at .
