Cobrowse.io Docs
  • Getting started
  • SDK Installation
    • Web
    • iOS
    • Android
    • React Native
    • Flutter
    • .NET Mobile
    • macOS
    • Windows
  • SDK Features
    • Account config
    • Identify your devices
    • Use 6-digit codes
    • Redact sensitive data
    • Viewing PDFs
    • Universal Cobrowse
    • Customize the interface
      • Active session controls
      • 6-digit code screen
      • User consent dialog
      • Remote control consent dialog
      • Full device consent dialog
      • Localization / translation
    • Initiate sessions with push
    • Listening for events
    • Full device capabilities
      • Full device screen sharing
      • Full device remote control
      • Managing full device mode
    • Advanced configuration
      • Starting and stopping the SDK
      • Declaring capabilities
      • Intercepting mobile SDK network requests
      • Web
        • IFrames support
        • IE 11 polyfills
        • Cross-domain session support
        • Ignore Views
      • iOS
        • Alternate render method
        • Custom touch handling
      • Android
        • Backporting TLS to older Android versions
  • Agent-side integrations
    • Agent-side overview
    • Platform integrations
      • Zendesk
      • Salesforce
        • Migrating from legacy to v2
        • Salesforce (Legacy)
      • Genesys
        • Genesys Cloud
        • Engage Workspace Web Edition (WWE)
        • Engage Workspace Desktop Edition (WDE)
      • Intercom
      • Freshworks
      • Talkdesk
      • NICE
    • Custom integrations
    • Agent SDK
      • API Reference
      • Sample code snippets
    • Authentication (JWTs)
      • JWT Policies
    • Authentication (SAML 2.0)
    • IFrame embeds
  • Enterprise self-hosting
    • Self-hosting overview
    • Docker Compose
    • Helm chart
      • Image Pull Secret
      • Environment Variables
      • Optional recording components
      • Pod Annotations
    • AWS terraform
      • AWS metrics configuration
    • Azure terraform
      • Azure metrics configuration
    • GCP terraform
      • GCP metrics configuration
    • Sizing guidelines
    • Running your instance
      • Adding a superuser
      • Limiting account creation
      • Limiting magic link recipients
      • Configuring SMTP
      • Managing your deployment
    • Monitoring your instance
      • Available metrics
      • Self-Hosted Prometheus
    • Advanced configuration
      • Air gap configuration
      • Pin web SDK version
      • L7 firewall configuration
      • Docker proxy configuration
    • Troubleshooting
Powered by GitBook
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

Was this helpful?

  1. Agent-side integrations
  2. Platform integrations

Salesforce

Easily start a Cobrowse session from Salesforce.

PreviousZendeskNextMigrating from legacy to v2

Last updated 3 months ago

Was this helpful?

Overview

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 - .

Install the app

Search for 'Cobrowse.io' in the AppExchange Marketplace and select our application.

Follow the install guidance and complete the information until you see the screen below. 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.

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.

Select Edit Policies and change Permitted Users to "Admin Approved users are pre-authorized" and then Save.

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.

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.

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.

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.

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".

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.

The sidebar widget should then be displayed in all of the pages that it has been added to.

Configuring Cobrowse.io Account Settings

If you migrated from v1, then your Cobrowse.io account settings will have been preserved.

Add our SDKs to get started!

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).

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.

Migrating from version 1? Follow the instructions here first: .

can be configured by an admin user by going to the Cobrowse.io application and clicking on the Account Settings icon.

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

See 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 !

Migrating from legacy to v2
Account Settings
Getting started
https://docs.cobrowse.io/sdk-features/identify-your-devices
support@cobrowse.io
AppExchange Marketplace listing
Cobrowse for Salesforce
The Cobrowse.io AppExchange Marketplace application.
Select Install for All Users at the install page.
The Cobrowse.io screen should show a message refusing to connect.
Manage the CobrowseIOWebApp to grant access to Users.
Select Admin approved users are pre-authorized to enable access to users.
Select Manage Profiles to allow user profiles access to Cobrowse.io.
Click the Clone button on the Permission Sets and save them without changing anything else.
Add the cloned Permission Sets to the CobrowseIOWebApp, leave the original in place.
Add the Permission Sets to the correct Users (or Profiles)
Select Edit Page underneath the cog to add the sidebar widget.
Drag and drop the Cobrowse.io Sidebar component.
Cobrowse.io Dashboard
Salesforce record mapping