Use this guide to understand how to install and configure the Crossbeam managed package for Salesforce, which includes the Lightning Web Component (commonly referred to as the "Widget") and the "Crossbeam Overlaps" custom object (commonly referred to as "Salesforce push").
In this article:
Installing the managed package
Navigate to Crossbeam's Salesforce AppExchange listing and click the Get It Now button. If you are not already logged into the Salesforce instance you wish to install the package into, Salesforce will prompt you to log in. Once logged in:
Select Install for Admins Only: this option allows for controlling access and permissions after the package has been installed.
Then, click the Install button:
Install for All Users: this option does not allow for controlling access and permissions on an individual level after the package has been installed
Approve Third-Party Access by ticking the checkbox and clicking the Continue button:
Third-Party access must be approved to continue with the installation and use the Crossbeam Integration in Salesforce. The third-party access is used for:
api.crossbeam.com - getting Crossbeam data
auth.crossbeam.com - authenticating your Crossbeam users
sentry.io - reporting on errors
login.salesforce.com - authenticating your Salesforce access for data
test.salesforce.com - sandbox testing
Connecting to your Crossbeam account
Salesforce User Requirements
Users completing the Crossbeam Setup steps detailed below must have specific permissions and object access:
Users validating the Lightning Web Component ("widget") need:
Users authorizing the Custom Object ("Salesforce push") need:
Visualforce Page Access enabled
Read access to the Account and Lead objects
Ensure you have the permission Crossbeam Setup User assigned to yourself, which provides you permission to manage the connection.
Accessing the Crossbeam Setup App
Navigate to Salesforce App Launcher and search for "Crossbeam" to access the Crossbeam Setup App:
Completing the 3 Crossbeam Setup Steps
The steps detailed below establish a connection between your Crossbeam account and your Salesforce instance.
Step 1: Outbound Connection
This part of the Crossbeam Setup will validate access to your Crossbeam account and allow Crossbeam data to be viewed in the widget. Have your Crossbeam login credentials handy.
Click the Validate button:
A new window will pop up asking for Crossbeam login credentials:
Log in with your Crossbeam username and password (or click "Log in with Google" if you used Google as your auth method when registering your Crossbeam account).
If your Crossbeam account has SSO enforced, be sure to log in as your SSO exception user.
Click the Next button.
Step 2: Crossbeam Organization Selection
If you successfully authenticated your Crossbeam account in the previous step, this screen will display the name of your Crossbeam account. Users with access to more than one Crossbeam account will see all of their accounts displayed.
Select the Crossbeam account you are connecting to this Salesforce instance:
Click the Next button.
Step 3: Inbound Connection
This part of the Crossbeam Setup will authorize Crossbeam to push data to the "Crossbeam Overlaps" custom object.
Click the Authorize button:
A new Salesforce approval window may pop up. If so, click to approve/confirm.
Make sure the connection status changes from "Not Connected" to "Connected."
Click the Finish button.
You should see a successful System Connections screen:
You are now ready to view Crossbeam data in the Lightning Web Component ("widget") and can enable data to push from your Crossbeam account to the "Crossbeam Overlaps" custom object in your Salesforce instance.
Assigning permission sets
The Crossbeam managed package comes with a number of different permission sets so you can control exactly which users can see Crossbeam data and the actions they are able to take.
Crossbeam Setup User: full access for an administrator
must be assigned to the user installing or reauthorizing the Salesforce Widget
grants access to the Lightning Web Component ("Widget")
grants write access to the "Crossbeam Overlaps" custom object
Lightning Web Component ("Widget") Permissions:
Crossbeam Account User: enables access to the widget
Full Access: Users with a paid Crossbeam Core or Sales Edge seat will have full access to the widget, including ability to see data partners have shared.
Starter Access: Users without a paid Crossbeam Core or Sales Edge seat will see a high level overview.
Crossbeam Widget Viewer:
grants access to the widget but disables any clickable buttons
users will not be able to access data shared by partners or initiate messages
Custom Object Permissions:
Crossbeam Report User: enables access to the custom object
grants access to the "Crossbeam Overlaps" custom object
allows users to build Salesforce reports and dashboards with Crossbeam data
Placing the Lightning Web Component ("Widget")
The Crossbeam Overlaps component may be placed on lightning page layouts for Account, Opportunity, Contact, and Lead records.
This example will show you how to place the Crossbeam Overlaps component on an account record page:
Navigate to Setup, click the Object Manager tab (under Objects and Fields header)
Click on Account
Click on Lightning Record Pages
Click Default Accounts (or the account record layout relevant to you)
Click the Edit button
In the subsequent "Lightning App Builder" page, on the left hand navigation bar, scroll down to the "Custom - Managed" section
Click and drag the Crossbeam Overlaps component, placing it in the desired location on your page layout:
Click Activation -> Set as Org Default -> Save