CoBrowse for messaging

Offer an enhanced, visual consumer experience for messaging
  • Messaging

With CoBrowse, agents and visitors browse a brand's website together. Each can see a virtual mouse cursor of the other, along with illustrations of where they are typing and clicking. This allows brands to address customers’ queries quickly and efficiently by helping them navigate web pages collaboratively.

To focus the visitor, the agent can also animate elements on the visitor screen by:

  • Clicking on an element will display a yellow circle around the cursor.
  • Ctrl + left mouse - will animate the element with a wiggle effect.

Why use CoBrowse?

  • Personalized: Valuable customers receive personal attention as they are guided through an online task or process.
  • Browser-contained: CoBrowse does not require any installations, plugins, or configuration by agents or by visitors.
  • Easy to use: CoBrowse can be used on all major browsers with zero setup time or preparation required.
  • Secure: A multi-stage and customizable security architecture systematically protects sensitive information and meets individual security requirements.
  • Two-way interactivity: User actions are captured and replicated without the need to manually hand over input control.

Use cases

CoBrowse enables agents to assist visitors with complicated online tasks and processes, for example:

  • Purchasing complex products such as customized travel packages
  • Completing application forms for banking services or insurance
  • Following guided online support for troubleshooting items
  • Learning how to set up an account or use online self-service options
  • Following a guided shopping experience which provides store-like assistance online

Only the web variant of messaging can use CoBrowse - other messaging channels are not web based and therefore do not contain any content which can be shared in this way.

Security and Privacy

CoBrowse was designed with strict security controls to protect the privacy of both visitors and agents. The following controls can be implemented as part of the solution:

  • CoBrowse solely builds on standard applications protocols such as HTTP, HTTPS and JavaScript.
  • The agent cannot access the visitor’s local system, or web applications opened in other browser tabs or windows.
  • The visitor cannot access the agent’s local system or web applications opened in other browser tabs or windows.
  • Agents have the option to choose between “shared” mode and “view only” mode. “Shared” mode enables the full collaborative experience, whereas “view only” mode offers a higher level of customer privacy.
  • Form fields and widgets can be masked, in which case the data is not transmitted to the server or the agent browser.
  • Sessions are not recorded or stored.

How CoBrowse works

CoBrowse technology has an enhanced level of security in comparison to traditional screen sharing and desktop sharing. This is because in desktop sharing, at least one of the participants downloads a software or plug-in for sharing a video screen of the entire screen or desktop applications. In contrast, CoBrowse is restricted to sharing only the website that the consumer is currently chatting on.

The basic CoBrowse process is described in the image below:


The agent sends an invite to the consumer in the Embedded Engagement Window. If the consumer accepts, the CoBrowse session starts on the same webpage as the consumer was on when they initiated the conversation.

The CoBrowse service not only shares the webpage view with the agent, but it also monitors the consumer’s actions, for example: mouse movements, mouse clicks, form field input, etc. The consumer’s actions are displayed in the agent’s browser. If the agent selects “Interactive Mode”, the agent’s actions such as mouse clicks are replicated in the consumer’s browser. If the agent selects “View-only mode”, the agent can highlight elements on the page, but not fill in forms or navigate to actively assist the consumer.

The CoBrowse process for agents & consumers

The consumer starts a conversation with the agent.The agent invites the consumer to share a live view of the web page (CoBrowse).
The consumer receives an invite and accepts. The CoBrowse session is started on the visitor side.A new CoBrowse widget opens in the Agent Workspace.
The webpage is transmitted to the agent’s browser.The webpage from the visitor’s browser is displayed in the Agent Workspace.
All actions, e.g. mouse movements, mouse clicks, and form input, are monitored and transmitted to the connected browser.The actions are displayed in the agent’s browser.
In interactive mode, all agent actions are displayed in the consumer’s browser.If the agent performs actions in Interactive Mode, these are transmitted to the consumer’s browser.
In view-only mode, agent mouse movements and highlights are displayed in the consumer’s browser.In view-only mode, only mouse movements and highlighting actions are transmitted to the consumer’s browser.


CoBrowse for Web Messaging is enabled by default. 

Initiating CoBrowse

1 - From the conversation window, click the CoBrowse icon.

2 - Choose the session type:

  • CoBrowse - View Only enables you to view the visitor’s screen only.
  • CoBrowse - Shared gives you full control over the current browser tab.

3 - The visitor receives a notification asking them to accept the CoBrowse session.


4 - Once the visitor accepts, the CoBrowse session opens on the agent side and both cursors are displayed and labeled as shown in the image below.

5 - Using the fullscreen button on the widget header, agents are able to switch to full screen mode and view wider websites easily.


6 - On the visitor or consumer side, when the CoBrowse session begins, a frame is displayed around the browser tab, indicating an active session. While using CoBrowse, password fields are automatically masked. Other fields such as credit card numbers can also be configured as masked.

7 - The visitor can close the session at any time by clicking the X at the top of the frame.


  • An agent can run one session of CoBrowse at a time and can send only one invitation at a time.
  • CoBrowse differs from desktop sharing in that the agent’s virtual mouse pointer is shown over the same element, but may not be shown at the same exact position due to different screen resolutions.

Impact on existing functionality

  • Agent: Agents can conduct only one CoBrowse session at a time
  • Agent manager: Transcripts don't contain the invitation text.
  • Consumer: Consumers receive an invitation to CoBrowse in the Embedded Engagement Window


1. How is CoBrowse different to desktop sharing?

CoBrowse differs from desktop sharing in that it is more secure, requires no installation, and is non-intrusive. The agent does not take control of the visitor’s desktop, nor do they have access to the visitor’s local files and applications. This minimizes the risk of agents unknowingly sharing sensitive information. In contrast to desktop sharing, CoBrowse offers a next-generation co-browsing experience with zero setup time.

2. What is the difference between “shared” mode and “view only” mode?

Agents have the option to choose between "shared” mode and "view only" mode. "Shared" mode provides a full, two-way interactive experience, whereas "view only" mode offers a higher level of privacy for consumers. The table below illustrates the CoBrowse features, along with which CoBrowse features are available in each mode.

Table 1: CoBrowse features and permissions

FeatureDescriptionAvailable in “shared” mode?Available in “view only” mode?
Co-ScrollingThe visitor and the agent see the same parts of a web page.YesYes
Co-Highlighting on PageThe visitor and the agent see each other’s virtual mouse pointer and can highlight elements of a web page.YesYes
Co-Highlighting on Text ElementsThe visitor and the agent can highlight text elements.YesYes
Co-NavigationThe agent can navigate to other web pages.YesNo
Co-Form fillingThe visitor and the agent fill out forms together.YesNo

3. Is CoBrowse compatible with corporate firewalls etc.?

Yes, CoBrowse is generally compatible with corporate firewalls. It only uses standard web protocols that are deployed and used in typical web applications.

4. Which options are available to secure form input (e.g. password)?

Password form fields are automatically blocked from transmitting data into the CoBrowse session of other participants. Other fields have to be identified by using a proprietary HTML attribute or by manually managing a blacklist on a server (e.g., using CSS selectors).

5. Is it possible to have a CoBrowse session on untagged web pages and external domains?

CoBrowse works on tagged pages only. This is to ensure a secure co-browsing session, and also to enable the transfer of the session state (e.g. shopping cart), along with the last visited page and form data.

Prerequisites & technical requirements

For the Conversational Cloud

The following table lists the prerequisites and technical requirements necessary for deploying CoBrowse on Conversational Cloud 2.0.

  • The Embedded Engagement Window must be deployed in the popped in state. Alternatively, the Messaging Window API can be used
  • Web Tag must be deployed. For more information, see Web Tag
  • The Web Tag must be placed on every webpage that is visited during the CoBrowse session
  • The agent must use an operating system and browser that is listed in the LivePerson System Requirements

For brand website

  • All website pages must be tagged. This includes the page from where the session is started, and all pages which are visited during navigation
  • The tag must be deployed in the topmost frame of the page
  • Your website must adhere to HTML, CSS and JavaScript standards
  • HTML framesets must not be used
  • iFrames must originate from the same domain. This relates to Same Origin Policy (SOP)
    • iFrames from different domains cannot be synchronized from the consumer to the agent
    • Not all third-party iFrames, for example Facebook and Google tracking are relevant to the agent, and are therefore not displayed
    • In the situation that the iFrames originate from different subdomains, you can adopt SOP relaxation techniques. This requires you to modify both pages and set the document.domain to the same domain
  • Embedded HTML objects and their content, for example an external image in a Canvas element, must originate from the same domain
  • Embedded HTML objects, for example Scalable Vector Graphics (SVG), which have been encoded by the web application, may not be visible to the agent
  • All resources, for example CSS, images and fonts, can be reloaded multiple times without restrictions:
    • Loading resources is not bound to cookie or other session identifiers
    • Loading resources is not bound to “Http Basic Authentication”
  • Agents and consumers must use a web browser that is listed in the LivePerson System Requirements
  • CoBrowse is only supported on regular (not private / incognito) windows
  • For the consumer, the session is active only in the browser tab where it was started. If the consumer switches to another browser tab with the same (or another) website opened, they will no longer be active in the CoBrowse session
  • If the CoBrowse session is not ended by either the consumer or the agent pressing the ‘session end’ button, the agent will not be able send a new CoBrowse invite
  • The consumer must not navigate at the same time as accepting an invite
  • The consumer must not close the browser tab or navigate to an untagged page during a CoBrowse session
  • The agent must not close the browser tab (or navigate to an untagged page in interactive mode)
  • third-party cookies must be enabled
  • The website must not use the CSS Object Model (CSSOM). Note that libraries such as Styled Components can be configured to use the DOM instead.


  • Your website should not contain any browser-specific code or overwriting of core JavaScript functions, for example window.addEventListener
  • Encoded web content poses a security risk and is therefore filtered.
  • There are no embedded non-HTML objects, for example Flash, Active-X or PDF
  • Non-HTML content is not monitored and is not visible to the agent.

For network

  • Your website must be accessible via port 80 (http) or 443 (https)
  • The agent and consumer’s network must allow long-running Http connections, also called ‘long polling’ (This applies to all modern networks, there are rare cases of misconfigured proxy servers or application layer firewalls in company networks)
  • A company proxy server or application layer firewall must not modify essential, for example, security, http headers of the CoBrowse application.
  • If there is an extremely high network latency or unstable network connection, the CoBrowse session may be dropped.
  • The agent and the consumer have an available bandwidth of 10,000 kbit/s in downstream.
  • If your website is using HTTPS, the certificate must be signed by an official certificate authority (self-signed certificates will not be accepted).
  • The minimum upstream bandwidth requirement is 750 kbit/s. The actual requirement depends on a number of factors, such as the size of the rendered website.

Non-public web sites (intranet, localhost) are not supported.

Performance best practices

  • The recommended upstream bandwidth requirements is 1500 kbit/s
  • Large rendered websites > 2 MB (DOM tree) can lead to a significant delay until the website is fully visible to the agent (waiting time 15 sec. or more to view the page)
  • If your website is continuously changing elements of the DOM tree, this can lead to delays when synchronizing the state between visitor and agent
  • Your website should make sparse use of background animations (animations without user interaction)
  • The real-time experience is affected by several applications competing for upstream bandwidth on the consumer’s system

Missing Something?

Check out our Developer Center for more in-depth documentation. Please share your documentation feedback with us using the feedback button. We'd be happy to hear from you.