Salesforce
v2.x

Overview

The new version of our Salesforce integration is now available. System admins can follow the steps below in order to give your organization access to Cobrowse.io within Salesforce.
Migrating from version 1? Follow the instructions here first: Migrating from legacy to v2.

Install the app

Search for 'Cobrowse.io' in the AppExchange Marketplace and select our application.
The Cobrowse.io AppExchange Marketplace application.
Follow the install guidance and complete the information until you see the screen below. Select Install for All Users at the install page.
Select Install for All Users at the install page.
This will allow all users to access the application after permissions have been granted within Salesforce (as shown later). The install process will take a few minutes.
Verify that the app has been installed by searching for Cobrowse.io in the App Launcher search bar.
Click on either option and the below screen should appear.
The Cobrowse.io screen should show a message refusing to connect.
This is expected and verifies that the application has been installed correctly. The next step is to give appropriate access to the users in your organisation (including admins).

Grant access to Users

Go to Setup and search for App Manager. Select Manage for the CobrowseIOWebApp as shown below.
Manage the CobrowseIOWebApp to grant access to Users.
Select Edit Policies and change Permitted Users to "Admin Approved users are pre-authorized" and then Save.
Select Admin approved users are pre-authorized to enable access to users.

Managing access using Salesforce Profiles

If you manage access using Salesforce Profiles within your organisation to access Cobrowse.io then follow the steps below. If you instead require Permission Sets, skip to the next section.
Next select Manage Profiles from the Profiles section of the Manage page display.
Select Manage Profiles to allow user profiles access to Cobrowse.io.
Within the Manage Profiles options select System Administrator and other profiles (e.g. Standard User) and then Save.
Search Cobrowse.io in the App Launcher search bar again and go back to the dashboard by selecting either option.
The Cobrowse.io dashboard should now be visible to permitted profiles.

Managing access using Salesforce Permission Sets

If you manage access using Salesforce Permission Sets, then follow the instructions below. Otherwise, use the previous section to enable Cobrowse.io using Salesforce Profiles.
Due to an underlying Salesforce restriction, you need to clone the Permission Sets that are shipped with our App when it is installed in order to enabled them.
To do this, go to your organisation's Permission Sets tab and Clone the Cobrowse.io Agent and Cobrowse.io Admin Permission Sets.
Note: you may change the name of the cloned permission sets, but you should not make any other changes.
This will mean that two Permission Sets for both Cobrowse.io Agent and Cobrowse.io Admin appear, this is expected.
Click the Clone button on the Permission Sets and save them without changing anything else.
Go back to the App Manager and manage CobrowseIOWebApp again. Select Manage Permission Sets and add both of the cloned Cobrowse.io Agent and Cobrowse.io Admin Permission Sets to the App. The correct ones are the ones that are able to be added, the non-cloned ones will show an error message.
Add the cloned Permission Sets to the CobrowseIOWebApp, leave the original in place.
Next, simply add the relevant Permission Sets to the Profiles or Users who you wish to access Cobrowse.io.
Make sure to correctly add the appropriate Permission Set (either Admin or Agent).
If your users have custom user profiles, then you need to add both the original and cloned Permission Set to your users, e.g. Cobrowse.io Agent and Cobrowse.io Agent (cloned) Permission Sets for each agent who does not have admin rights.
Add the Permission Sets to the correct Users (or Profiles)
The Cobrowse.io application will now appear to your agents and admins who have been granted the correct permissions.

Sidebar widget placement

You can add the Cobrowse.io widget to your record pages for Cases, Contacts, Accounts, or any other record pages accessible via Sales Console, Service Console, or otherwise.
To do this, navigate to the page you would like to add the widget to and click the settings button in the top right to "Edit Page".
Select Edit Page underneath the cog to add the sidebar widget.
You can then drag and drop the Cobrowse.io Sidebar managed component (from Custom - Managed on the left) into the location of your choice and Save.
Drag and drop the Cobrowse.io Sidebar component.
The sidebar widget should then be displayed in all of the pages that it has been added to.

Configuring Cobrowse.io Account Settings

Account Settings can be configured by an admin user by going to the Cobrowse.io application and clicking on the Account Settings icon.
If you migrated from v1, then your Cobrowse.io account settings will have been preserved.
Configure your Cobrowse.io Account Settings

Add our SDKs to get started!

See Getting started to add our SDKs and begin end-to-end testing! Your license key can be found in your Account Settings, seen above.

Filtering devices using Salesforce Record metadata (optional)

This step is optional for clients who wish to override the default device filtering in the Cobrowse.io Sidebar widget. For example in Cases and Contacts, the sidebar widget will filter by devices that match the end user's email address by default.
In Salesforce legacy, this filtering was provided in the Cobrowse.io Settings tab. It is now located within the Cobrowse.io Dashboard. Go to Cobrowse.io Dashboard (e.g. via App Launcher search) then Account Settings (Admins only), then Integrations, then Salesforce record Mapping.
The first argument specifies the page for the filtering to be applied to, e.g. "Case". Then the key:value pair specifies the SalesforceMetadata:Cobrowse.ioCustomData that should be mapped together, linking the Salesforce metadata from a page to the corresponding Cobrowse.io custom data field to filter the devices.
In the example above (and by default), "ContactEmail" in Salesforce is mapped to "user_email" in Cobrowse.io custom data. This means that "ContactEmail" filters the devices shown on the "Case" pages.
This information must match the correct metadata to work, and it must be formatted in correct JSON (as the other examples are).
See https://docs.cobrowse.io/sdk-features/identify-your-devices for more information on using Cobrowse.io custom data to identify your devices.
If you have any questions about the above steps then please get in touch at [email protected]!

Troubleshooting

Granting multiple users Cobrowse.io Admin role permissions

As part of the install, you may need to grant multiple users the Admin role permissions within Cobrowse.io, e.g. so that they can see all agents' session history. This should happen automatically, but if it does not work then it can also be done manually.
Simply go the User's profile within Salesforce via Setup then Users and Users again. Select the User and inspect their Permission Set Assignments. Edit Assignments and add the Cobrowse.io Admin permission set to their profile. They will then have Cobrowse.io Admin rights which can be verified in the Cobrowse.io Dashboard.
Copy link
On this page
Overview
Install the app
Grant access to Users
Managing access using Salesforce Profiles
Managing access using Salesforce Permission Sets
Sidebar widget placement
Configuring Cobrowse.io Account Settings
Add our SDKs to get started!
Filtering devices using Salesforce Record metadata (optional)
Troubleshooting
Granting multiple users Cobrowse.io Admin role permissions