# Engage Workspace Desktop Edition (WDE)

## Installation

Supported WDE versions: 8.5.147.05+.

[WebView2](https://docs.genesys.com/Documentation/IW/8.5.1/Developer/Chromium) installed on your WDE instances.

### 1. Install plugin

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 at`C:\Program Files (x86)\GCTI\Workspace Desktop Edition`.

{% hint style="info" %}
Cobrowse can provide these files to you upon request, free of charge, in order to conduct a proof-of-concept (PoC) or other technical evaluation.
{% endhint %}

### 2. Add required config

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.

<table data-header-hidden><thead><tr><th width="270.3333333333333">Field</th><th width="94">Type</th><th>Value</th></tr></thead><tbody><tr><td>Field</td><td>Type</td><td>Value</td></tr><tr><td><strong>cobrowse.api</strong><br>required</td><td>string</td><td>eg. <code>https://cobrowse.yourcompany.com</code><br><br>default is <code>https://cobrowse.io</code></td></tr><tr><td><strong>cobrowse.license</strong><br>required</td><td>string</td><td>your license key</td></tr><tr><td><strong>cobrowse.debug</strong><br>optional</td><td>string</td><td><code>true</code> / <code>false</code><br><br>default is <code>false</code></td></tr><tr><td><strong>cobrowse.initialUrl</strong><br>optional</td><td>string</td><td>Override initial Url the plugin tab will load</td></tr><tr><td><p><strong>cobrowse.proxyServer</strong><br>optional</p><p>(Supported in v1.4+)</p></td><td>string</td><td>URL to proxy WebView traffic through</td></tr><tr><td><p><strong>cobrowse.proxyBypassList</strong><br>optional</p><p>(Supported in v1.4+)</p></td><td>string</td><td><p>Semi-colon-separated list of hosts.</p><p>See <a href="https://www.chromium.org/developers/design-documents/network-settings/#command-line-options-for-proxy-settings">--proxy-bypass-list</a> for more detail.</p></td></tr></tbody></table>

<figure><img src="/files/gTOem6zsv13ZYReH3SFc" alt=""><figcaption><p>Screenshot of GAX configuration for interaction-workspace</p></figcaption></figure>

### 3. Start Workspace Desktop Edition

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.

## Configuring SSO

If you wish to sign into Cobrowse from within WDE using SSO you must first follow our documentation to [setup SAML](https://docs.cobrowse.io/agent-side-integrations/authentication-saml-2.0).

With SAML configured, visit the [integration settings](https://cobrowse.io/dashboard/settings/integrations) 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>`.

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.

## Troubleshooting

### Why is the COBROWSE tab always blank?

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 <hello@cobrowse.io>.

### How do I debug the COBROWSE tab?

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:

<figure><img src="/files/x34dTTKqyNMxCsuicEvs" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cobrowse.io/agent-side-integrations/crm-helpdesk-integrations/genesys/engage-workspace-desktop-edition-wde.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.