Bright Pattern Documentation

Generated: 8/14/2022 9:28 pm
Content is available under license unless otherwise noted.

Configuration Overview

Co-browsing is the feature in the Agent Desktop application that allows an agent and a customer to navigate the same web resource at the same time during a chat session; the option is available for chat services with a specifically configured messaging/chat scenario entry. Co-browsing is an ideal solution for helping customers negotiate confusing web pages, fill out complex forms, and so forth.

For example, you have a chat service enabled for your website but you find customers getting stuck in certain areas and requiring assistance. If you add the co-browsing feature to the chat service, your agents will be able to see and interpret how your customers view your website, which can help you improve any difficult areas.

This tutorial describes the steps involved with configuring an end-to-end co-browsing chat service with the third-party service Surfly, including the following:

An agent co-browsing with a customer

Configure the Surfly Account Settings

Your Surfly account settings allow you to define what your agents can see and do while co-browsing with customers. This includes restricting the areas of a customer’s screen that an agent can see, masking text, allowing drawing tools, and so forth. For more information, please refer to Surfly’s Tutorials.

Surfly settings


For integration with Bright Pattern Contact Center software, it is necessary to configure the following settings:

Configure a Co-browsing Integration Account

In the Bright Pattern Contact Center Administrator application, you will create a co-browsing integration account. As a reminder, your service provider must enable this feature for your contact center. To configure this integration account, take the following steps.


  1. In section Contact Center Configuration > Integration Accounts, click the Add account button.
  2. From the Create integration account menu, select Co-browsing, and then click OK.

    Select the Co-browsing option

  3. In the Properties tab, configure the following:
    • The account name (any)
    • The account provider (i.e., Surfly is the default option)
    • The Surfly widget key (e.g., 218he91ndionvri4f9iquwndiuqwnd); the Surfly widget key is located in your Surfly account, section Settings > Integration.
  4. If you wish, you may test your widget key; if the key works, a validation message will pop. When you are finished, click Apply.

    Integration account settings

Configure a Messaging/Chat Scenario Entry

After you are finished creating a Co-browsing integration account, you will add it to an existing messaging/chat scenario entry. If you have not yet created a chat entry, please see Administration Tutorials, section How to Configure Web Chat.

1. Edit scenario entry's Properties

If you have an existing chat scenario entry, you will need to take the following steps to complete co-browsing configuration.

  1. In the Properties tab, enable the setting Enable co-browsing.

  2. For the Co-browsing account setting, select the name of your Surfly integration account.

    Enable co-browsing settings

  3. When you are finished, click Apply.

Note: If you previously configured co-browsing, note that you will need to enable new settings.

2. (Optional) Edit co-browsing dialog text

When the agent requests a co-browsing session, the customer will be prompted to accept and start the session. The message shown in this prompt is called the co-browsing dialog text, and you have the option to edit this text in chat widget configuration.

Co-browsing dialog text displayed to customer

  1. In the Contact Center Administrator application, go to Scenario Entries > Messaging/Chat > Chat Widget tab > Chat Styling and click edit.

  2. In the Chat Widget Configuration window that opens, make sure that Enable co-browsing is selected. Then find Co-browsing dialog text and enter the desired message in the text entry field.

    Note that the following default co-browsing dialog text will be shown to customers if no changes are made to this property: "By clicking Accept, an agent will join you on the page you are currently viewing. The agent can view and help you as you browse the web in this tab. The agent will not see login details, passwords, other browser tabs or programs you have opened. You can stop co-browsing at any time, by clicking X in the menu or by closing this tab in your browser."

    Co-browsing dialog text in Chat Widget Configuration editor

  3. Click Save.

Instructing Agents About Co-browsing Procedures

Once co-browsing is configured in your contact center, you will need to instruct your agents on how to initiate and operate co-browsing sessions. Your procedures will likely incorporate your contact center’s best practices and other important points.

An example process that uses the Bright Pattern recommended settings might look like the following:

For more information, agents may be directed to the Bright Pattern Contact Center Agent Guide, section How to Co-browse with Surfly Integration.

An agent co-browsing with a customer in the Agent Desktop application