Contact your company's Salesforce Administrator
You will need to work with your Salesforce Administrator to install the RollWorks ABM Salesforce App. The Salesforce administrator completing this installation must have:
-
- Permissions to download and install AppExchange Packages
- Access to login to your company's RollWorks account - add your CRM Admin to your RollWorks account following these steps
Video walkthrough
What is the Salesforce Integration
The Salesforce Integration for RollWorks connects your Salesforce org to the RollWorks platform to power your ABM strategy and enable these features and benefits. The Salesforce integration is bi-directional and allows you to push data from RollWorks to Salesforce and vice-versa.
To find other articles related to our Salesforce Integration, including: features, troubleshooting, data attributes, sync details, reporting and more:
- Visit the Salesforce Integration section of the Help Center.
- Visit the Sales Insights section of the Help Center.
RollWorks will sync data over to Salesforce dynamically daily at 12 pm UTC. Visit this help center article to learn what RollWorks data is ingested by Salesforce and how it is synced.
Who can access
To use the Salesforce Integration with RollWorks you must have:
-
An API-enabled Salesforce edition such as Enterprise Edition, Unlimited Edition, Developer Edition, or Performance Edition.
-
- To view the latest list of API-enabled Salesforce editions click here
- To confirm your Salesforce Edition click here
-
- Any paid RollWorks package.
To find your current subscription, log in to RollWorks and navigate to Settings > Billing > Plans & Usage.
Step 1 - Install the RollWorks ABM App package
In this first step, you will find the link needed to install the RollWorks ABM package directly in Salesforce using a unique URL that you will find in your RollWorks account.
- Your Onboarding Success Manager will provide an installation link
- Log in to Salesforce in a new browser tab
- Paste the installation link in the browser's address bar and hit enter
- Select Install for Admins Only and click Install
The package installation will take approximately 5 minutes to complete and you will receive an email when the installation is complete.
To verify that your app has been installed log in to Salesforce and navigate to Setup > Apps > Packaging > Installed Packages, and find the RollWorks ABM App package.
Step 2 - Choose who will be your Authenticated user
In this step your CRM Admin will decide which Salesforce user will be used to manage the integration between RollWorks and Salesforce.
Depending on how many Salesforce licenses you have available you may want to simply use an existing user, however we strongly recommend using a dedicated user with a full license to manage your integrations to avoid a potential data sync interruption in the future.
These are the 3 reasons why every company needs a dedicated Salesforce integration user.
Below are the three options to choose your Authenticated User who will manage the integration:
Use a dedicated full Salesforce license (not used by a human) with a custom profile, and permission set to manage all your integrations. A dedicated full license integration user is a more secure, auditable way to move data into and out of your instance without relying on an existing user’s license. This is the only option that will prevent data sync interruption between Salesforce and RollWorks. To create a dedicated full license Salesforce integration user you should use a dedicated email such as integrationuser@yourdomain.com
A full license is required
A full license is required, the limited Salesforce Integration User license does not provide sufficient permissions to RollWorks to configure the Visualforce components needed to power our Sales Insights product.
Step 3 - Assign permissions to the Authenticated User
Watch this 4-minute video to assign the required permissions to your Authenticated user. If these permissions are not granted to the Authenticated User your end users may experience issues to access the RollWorks features powered by the Salesforce Integration.
Required RollWorks Permissions for the Authenticated User
- RollWorks Admin permission set - this set is created after installing the RollWorks ABM App
-
Under System permissions > Users:
- View all users
- Manage Profiles and Permission Sets
-
Under System permissions > System
- View Setup and Configuration
- View Roles and Role Hierarchy
-
Under Object Settings:
- Object Permissions: Enable Read, Create, Edit, Delete, View All, Modify All
- Field Permissions: Enable Read Access and Edit Access to all fields in the object
- Permissions in Step 4 should be applied to Account, Opportunity, Contact, Lead, Campaign, and Task/Activity Objects.
Step 4 - Assign permissions sets to End Users
In this step, you will assign permissions sets to the end users (Sales and Marketing employees) that need to see RollWorks data through reports, dashboards or page layouts.
The RollWorks ABM App package for Salesforce includes three permission sets you can assign to your End users in Salesforce to control access to RollWorks data:
- RollWorks Admin permission set
- RollWorks Marketer permission set
- RollWorks Sales Insights permission set
You can find resources to learn how to assign permissions sets to Salesforce users in this Salesforce Help Center article.
The RollWorks Marketer permission set is recommended for end users that only need read/view access to RollWorks Custom Object data.
This permission set includes:
- View/Read RollWorks Custom Objects in Salesforce
-
Please note you may need to ensure that the end users have access to:
-
- View Reports pulling data from RollWorks Custom Objects
- View Page Layouts that expose RollWorks Custom Objects data
-
The RollWorks Admin permission set must be assigned to:
- The Authenticated user that completes the installation and authentication of the App package in Salesforce.
- The main Point of Contact(s) at your organization that will use the RollWorks platform.
This permission set includes:
- Read/Edit/Create/Delete RollWorks Custom Objects in Salesforce
- Re-authorize your Salesforce account to connect with RollWorks
- Run and stop the data sync between Salesforce and RollWorks
- Exclude your existing customers using the Salesforce List Builder
- Sync your 1st party contact data for Personalized Ads
This permission set is automatically assigned to Salesforce users, when they are granted a Sales Insights seat in the RollWorks user interface.
This permission set includes:
- View the Sales Insights Widget in Salesforce
- View/Read RollWorks Custom Objects in Salesforce
Please note that assigning this permission set to an end user will only grant view access to the Sales Insights Widget if they also have a Sales Insights Seat assigned in RollWorks.
Sales Insights Seat Management
Sales Insights Widget in Salesforce
Step 5 - Authorize the App and initiate Sync
- Log in to Salesforce using a user with the RollWorks Admin permission set
- Go to the Salesforce App Launcher and select RollWorks ABM App
- Scroll down to Salesforce Data Sync Settings
- Select Yes, opt-in to data sharing - this allows RollWorks to ingest Account, Opportunity, Contact, Lead, and Activity data
- Click Save
- Click Authorize RollWorks ABM
- Enter your RollWorks login credentials on the next screen and click Sign In.
- Click Allow on the next screen
- After successfully authorizing your RollWorks account you will see a prompt that says "Success! We've connected your Audience to RollWorks".
- Go back to Salesforce, click the Salesforce App Launcher, and select RollWorks ABM App.
- Click the RollWorks Settings tab to confirm RollWorks is now connected to Salesforce. You will see the next sync time listed under Next Scheduled Run. RollWorks will sync data over to Salesforce dynamically daily at 12 pm UTC. After this sync, this Salesforce data will be available in RollWorks.
Step 6 - Configure Page Layouts (Optional)
After the initial package installation and user permissions are complete you should configure page layouts using the Object Manager to make the information easy to read and accessible to your Salesforce users:
- Customize the 'RollWorks Account Aggregated Data' object page layout
- Customize the 'RollWorks Contact/Lead Aggregated Metrics' object page layout
- Add the new objects as related lists to your Standard objects for Account, Contact, and Leads.
Without these steps, RollWorks data will not be visible to your end users when they look at your Standard Account, Contact or Lead records.
Follow the step-by-step instructions in this article to configure your Page Layouts.
Step 7 - Configure your reports
Your CRM admin can create reports using RollWorks custom objects and custom fields in combination with your Account, Contact and Lead standard objects.
Salesforce Custom Object Name | Definition |
---|---|
‘RollWorks Aggregated Account Data’ |
At a high level this object aggregates RollWorks data tracked for the corresponding Account record.
|
'RollWorks Aggregated Contact/Lead Data’ |
At a high level this object aggregates RollWorks data linked to the corresponding Contact and Lead records.
|
Step 8 - Assign Sales Insights seats to your users
After you have connected your RollWorks account to your Salesforce instance you should log in to RollWorks to assign Sales Insights seats to your Sales Team following the instructions in this help center guide.
Assigning a Sales Insights seat in RollWorks to your SDRs, Sales Reps, and Sales Managers will enable them to access the RollWorks Sales Insights widget directly in Salesforce.
Re-authorize the integration
If the Salesforce user that originally authorized your RollWorks Integration in Salesforce leaves your company and their Salesforce user profile is no longer valid, you may need to re-authenticate the integration. To prevent this from happening in the future, we recommend that you create a dedicated Salesforce user to manage your integrations instead of a real employee user profile.
To re-authorize the integration follow the steps in this help center article.
After reauthenticating, Salesforce will attempt to sync data over to RollWorks dynamically the next day at 12 pm UTC.
Grant LMA access to RollWorks Solutions Engineers
If you are experiencing issues with the Salesforce integration you may need to grant RollWorks temporary access to Salesforce for our engineering team to troubleshoot following the instructions in this help center article.
Find more Salesforce troubleshooting articles in this Help Center section.
Salesforce Integration FAQs
How do I verify if the Salesforce App is installed?
To verify if the Salesforce App has been installed login to Salesforce and navigate to 'Apps' > 'Installed Packages'. You should see a package named 'RollWorks ABM App' on the list of packages installed.
Does the Salesforce Integration with RollWorks affect my Salesforce Organization’s API request limits?
What is the minimum amount of emails required to run a CRM-based contact targeting campaign?
Your contact list must contain a minimum of 100 emails for you to run a campaign in RollWorks.
What is the maximum amount of accounts allowed for each Company List?
A single Company list should not contain more than 50,000 accounts.
How do I create Account Lists and Account Groups using Salesforce fields?
Creating account lists and groups using Salesforce fields is done in the Account List Builder in the RollWorks Platform. For more information about how to use the RollWorks Account List Builder to create Account Lists and Account Groups please refer to this Help Center article.
Is my Salesforce data shared with other RollWorks or NextRoll Customers?
No, your Salesforce CRM data is your data. NextRoll, Inc. will not use this data outside of improving the platform capabilities of your RollWorks account.
Is my Salesforce data shared with third-party systems or data partners outside of NextRoll?
No, your Salesforce data is only stored and processed by NextRoll internal systems to power your RollWorks platform experience.
Where is my Salesforce data stored?
Your Salesforce data is stored in S3 and AWS-hosted databases alongside your other platform data.
How is my Salesforce data protected?
This data is encrypted server-side using Amazon S3 default encryption for S3 buckets. You can read more about Amazon S3 Default Encryption for S3 buckets here.
How long will this data be retained?
We will retain this data indefinitely while your RollWorks account is active. If you deactivate your RollWorks account, we will retain this data for a maximum of 180 days. This data can be permanently deleted at any time per your request.
Is the RollWorks ABM app compatible with Salesforce Classic?
RollWorks ABM app is not optimized for Salesforce Classic and while using it you may encounter issues. It is recommended to switch to Lightning.