Co-browse Restrictions and Known Limitations

Due to some browsers' strict cookie policies, Genesys highly recommends that you host the Load Balancer on the same domain as the website or on one of its sub-domains. Otherwise, chat and Co-browse stickiness cookies may be rejected as third-party and the solution will not work. Users will not be able to start chat nor begin co-browsing.

Synchronization of Interactions with Browser Plugins is Not Supported

By design, synchronization of interactions with browser plugins is not supported. HTML markup managed by browser plugins (Flash, Java, Silverlight, ActiveX, etc.) is synchronized as is and may be displayed if both browsers support the plugin.

Web Components are Not Supported

Custom Elements and Shadow DOM are not supported.

Some Obsolete Web Techniques are Not Supported

Quirks Mode, Almost Standards Mode — Co-browse always uses Full Standards Mode when rendering the customer's website on the agent side and requires the valid document type definition to be set on the customer's pages. Technically, it means that doctype is always set to <!DOCTYPE html> when rendering anything on the agent side. Pages in Quirks Mode or Almost Standards Mode are not supported.
Framesets — Obsolete technology is not supported.

Some HTML5 Features are Not Supported

The following HTML5 features are not supported:

Canvas
WebGL
HTML5 audio and video—HTML markup is synchronized. Synchronization of playing, pausing, etc. is not supported.

SVG

Genesys Co-browse 8.5.1 adds support for SVG in co-browse sessions.

Some Pseudo CSS Selectors are Not Supported

The following pseudo selectors are not supported:

:visited
:target
:active
:focus
:fullscreen
:scope
CSS3 form selectors such as :valid and :required

For other pseudo selectors (For example, :dir(), :read-only, and :nth-last-of-type()), synchronization depends on the browsers. The pseudo-selector will be synchronized only if it is supported by both browsers.

Important

The :hover selector is supported. For more information, see JavaScript Configuration API—css.

Customer Representative Can Handle Only One Co-browse Session at a Time

Starting with Co-browse 8.5.003, an agent is by default limited to handling one co-browse session at a time. You can allow an agent to handle more than one co-browse session at a time by configuring co-browse session limitations in Workspace Desktop Edition.

Conferencing, Consultation and Transfer are Not Supported for Co-browse Sessions

As Co-browse sessions are not interactions like chat or voice, these standard operations for interactions are not currently supported for Co-browse.

Mouse synchronization

Mouse positions may differ slightly on the Customer side and Agent side if websites render differently in different browsers.

Representation of Dynamically Shown List Items May be Partially Broken on Agent side Browsers Using IE11

Issues may arise when IE11 is used as a Agent side browser on a website with dynamically shown/hidden sub-menus.

Example:

Workaround

Create a CSS file with a rule that sets the fixed display property of submenu list items.
Example:
```
.my-submenu li {
  display: block !important;
}
```
Host this file somwhere that is accessible via HTTP
Specify the URL of the file in the slave.cssPatchUrl option in Config Server.

Co-browse Fails Silently on Internet Explorer 8, 9, 10

Co-browse will always fail silently when run on Internet Explorer 8, 9, or 10, meaning that the error message Your browser is not supported will not generate.

Static resource synchronization behind authentication

Static resource synchronization is supported starting in release 9.0.005.15. For information about known issues, see the Co-browser Server 9.0.x Release Note.

Static resources behind authentication prevents a DNS failover fallout

With DNS Failover, Co-browse is able to properly keep active sessions until they finish naturally. However, all new sessions cannot be established successfully because the Co-browse Server web-proxy that passes resources to the agent side requires DNS to download the resources from the customer site.

Web-proxy that is affected by DNS Failover can be replaced with Static Resources Behind Authentication, which provides a server-based caching service that does not require DNS because all resources are sent from the customer client browser directly to the Co-browse Server, and then downloaded by the agent side via hash-based direct links from the Co-browse Server.

For information about known issues with Static Resources Behind Authentication (such as the hover effects), see the Co-browser Server 9.0.x Release Note.

Configuring Co-browse for multibyte character encodings

In rare cases, when the co-browsed web page uses multibyte encoding like Shift JIS and some other factors combined, Co-browse may not work in Internet Explorer on certain versions of Windows. To mitigate this, configure your Load Balancer to serve the Co-browse JavaScript file (the gcb.min.js) in UTF-8. For Nginx, this can be done by adding the charset UTF-8; line to any http, server, or location directive. For example, your Nginx config (see Configuring a Load Balancer for Co-browse Cluster) may look like this:

   ...
   location /cobrowse {
     charset UTF-8;
     ...

Scaling effects are not supported

If an end-user or an agent are scaling their browser, the scaling effect will not be transferred to the other side, however, the size of shared page area remains the same for both sides.

Different co-browse sessions in the same browser instance are not supported for the user

Co-browse does not support two different sessions in the same browser instance at the same time for the user.

Stricter policy with HTTPS-based localization

Starting in release 9.0.005.33, Genesys Co-browse Plug-in for Workspace Desktop Edition (WDE) now has a stricter policy for working with origins against the agent's localization. To allow working with the localization resource via HTTPS, you must place the resource in the same origin that the Co-browse Plug-in for WDE uses to work with Co-browse.

If load balancing is used for the Co-browse Plug-in for WDE to access Co-browse, place the JSON localization file in the static folder of the Co-browse nodes, and add the following snippet in your NGINX configuration file.

location /static {
            proxy_pass https://<cobrowsecluster>$uri?$args;
}

Co-browse handles the agent side CSS resources only in UTF-8

Use of multi-byte encoding like shift_jis on the webpage may encounter parsing issues. As per the W3C recommendation, use UTF-8 encoding.