Use this guide to understand how to install and configure the Crossbeam managed package for Salesforce, which includes the Lightning Web Component (referred to as Crossbeam Copilot for Salesforce formally 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:
✍️ Note
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
For more details on managed packages, including required user permissions and installation types, review Salesforce's documentation "Install a Package."
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 (Crossbeam Copilot for Salesforce) need:
the Crossbeam Setup User permission assigned to their user profile
Users authorizing the Custom Object ("Salesforce push") need:
the Crossbeam Setup User permission assigned to their user profile
Visualforce Page Access enabled
Read access to the Account and Lead objects
✍️ Note
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 Crossbeam Copilot for Salesforce. Have your Crossbeam login credentials handy.
The Crossbeam user you are logging-in as must have the "Admin" role for Crossbeam Core and the "Manager" role for Crossbeam for Sales.
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
✍️ Note
Login to Salesforce directly as the user who is completing these steps. If you "login as" another user, an Insufficient Privileges error will be displayed.
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 (Crossbeam Copilot for Salesforce) and can enable data to push from your Crossbeam account to the "Crossbeam Overlaps" custom object in your Salesforce instance.
Be sure to assign the appropriate Permission Sets to individual users or user groups in order for them to be able to see and interact with Crossbeam data.
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.
We recommend assigning "Crossbeam Account User" and "Crossbeam Report User" to your entire team. This allows them to see Crossbeam data in the Crossbeam Copilot for Salesforce, and build Salesforce reports and dashboards featuring Crossbeam data.
Administrative Permissions:
Crossbeam Setup User: full access for an administrator
must be assigned to the user installing or reauthorizing the Salesforce Crossbeam Copilot for Salesforce
grants access to the Lightning Web Component (Crossbeam Copilot for Salesforce)
grants write access to the "Crossbeam Overlaps" custom object
Lightning Web Component (Crossbeam Copilot for Salesforce formally Widget) Permissions:
Crossbeam Account User: enables access to the Crossbeam Copilot for Salesforce
Full Access: Users with a paid Crossbeam Core or Sales seat will have full access to the Crossbeam Copilot for Salesforce, including the ability to see data partners have shared.
Starter Access: Users without a paid Crossbeam Core or Sales seat will see a high level overview.
Crossbeam Widget Viewer:
grants access to the Crossbeam for Sales(formally 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 (Crossbeam Copilot for Salesforce)
The Crossbeam Overlaps component may be placed on lightning page layouts for Account, Opportunity, Contact, and Lead records.
We recommend placing the Crossbeam Copilot for Salesforce on Account and Opportunity record pages, in a conspicuous location.
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
Consider adding visibility filters to the component if you don't want it to appear on the page for certain user roles, for example. More on component visibility here.
Configure Trusted URLs for Crossbeam Copilot for Salesforce
For detailed steps on how to configure Trusted URLs in Salesforce for the Crossbeam Copilot for Salesforce, read this article here or watch a video on setting up the Trusted URLs here.