Salesforce (Legacy)



Salesforce (Legacy) has been upgraded, please see Salesforce V2. provides an integration with Salesforce available in the Salesforce AppExchange Marketplace. Get started here

Install the app

Please install for Salesforce from the Salesforce App Exchange. You will also need to sign-up for an account via the website to use with your Salesforce.

Once for Salesforce is installed into your Salesforce instance, you will see Settings and Dashboard available via the App Launcher.

Insert the license key

The first step is to insert your license key into Settings, to associate your account with your Salesforce instance.

To generate a license key, please create an account via the website. Then you can enter it via the App Launcher by navigating to Settings. You can leave Filter Config as it is for now.

If you have not entered your valid license key into your Salesforce settings, you will receive the following error when trying to load Dashboard via the App Launcher in Salesforce.

Grant access to Users

Next, you need to define which Users will have access to within Salesforce. You will need to go to Setup -> App Manager and then click to Manage the CobrowseIO app as shown in the screenshot.

We want users to automatically be granted access, as long as they belong to the valid Profiles or have the valid Permission Set assignments, and are already logged into Salesforce. Click Edit Policies as shown in the screenshot.

Please change the option under OAuth Policies -> Permitted Users to "Admin approved users are pre-authorized". Then click Save.

Now, if you try to load Dashboard you will see the following error. This is because we have not yet defined the Profiles to have access to within Salesforce, or assigned any users the " Agent" or " Admin" Permission Sets.

From the App Manager, go back to "Manage Profiles" for the CobrowseIO app.

Now, select the System Administrator Profile you want to grant access. Once this is done, you can try to refresh the Dashboard via the App Launcher to see the page load.

This works for the System Administrator, but for Salesforce also comes with two Permission Sets, namely " Agent" or " Admin". You can add these Permission Sets to Profiles, or assign them to Users individually.

Here's what it looks like to assign these Permission Sets. Admins will be able to edit the account-level settings, whereas Agents will only be able to use the tool.

If you have any questions at all, we'd be happy to guide you through it. Please email us at!

Generate signing certificate

As long as your users are authenticated with Salesforce, they will automatically be authenticated with We achieve this by using JSON Web Tokens (JWTs) which are signed on the Salesforce backend by a private signing certificate, and verified on the backend by the certificate's corresponding public key.

In Salesforce, please naviate to Setup -> Certificate and Key Management and "Create Self-Signed Certificate" named "CobrowseIO".

Here's what it looks like when you create the new certificate.

Next, you will need to download the certificate so that you can extract the certifiate's corresponding public key. Make sure to delete it from your local computer afterwards, because it can be used to authenticate your Salesforce users to

Once the file is downloaded, use the command openssl x509 -pubkey -noout -in CobrowseIO.crt to extract the public key.

Finally, login to the website and paste it in under JWT SSO in your settings page.

Visualforce widget placement

Now, when you load Dashboard via the App Launcher in Salesforce, you should see a list of any active devices. If you don't see any, then make sure you've added the SDK to your apps.

You can also add the 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 that page and click the settings button in the top right to "Edit Page".

The widget is exposed as a Visualforce page which can be dragged and dropped into your page layout. Most clients will position the widget on the right sidebar with Height: 900.

Once you click save, you'll have the ability to "Assign as Org Default" for all users in your Salesforce organization.

One more confirmation dialog to finish.

Now you will see the Widget in the sidebar of this Record page. Here it is shown for a Contact Record. Notice how the user's devices are already pre-filtered for you by e-mail address from the context of the page.

If you'd like to modify which fields are used to pre-filter the relevant devices for a particular Record, this is what the Filter Config setting is for under App Launcher -> Settings. Please email us at if you have any questions!

Last updated