What is the Salesforce Integration
The Salesforce Integration for RollWorks connects your Salesforce org to the RollWorks platform to power your ABM strategy. 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:
- Visit the Salesforce Integration section of the Help Center.
- Visit the Sales Insights section of the Help Center.
Video Walkthrough
In this 7-minute video, we will walk you through the Salesforce<>RollWorks installation which takes approximately 10 minutes to complete.
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. Click here to view the latest list of API-enabled Salesforce editions. To confirm your Salesforce Edition click here.
- A paid RollWorks package: Starter, Standard, Professional, or Ultimate.
To find your current subscription, log in to RollWorks and navigate to Settings > Billing > Plans & Usage.
Connect Salesforce to RollWorks
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:
- Salesforce permissions to download AppExchange Packages.
- Login credentials to access your company RollWorks account.
Step 1 - Install the RollWorks ABM package in Salesforce
- Find the Salesforce installation link by logging in to RollWorks and going to Integrations > Salesforce.
- Click the button Copy Salesforce App 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. This will ensure that only administrators have access to all objects, fields, pages, and page layouts. Later in Step 3, we will assign different permission sets for all users.
The package installation will take approximately 4 to 5 minutes to complete. You will receive an email like the one below 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 - Decide which Salesforce user will manage the integration
Create a Dedicated Salesforce Integration User
Use a dedicated full Salesforce license (not used by a human) with a custom profile, and permission set to manage all your 3rd party integrations. A dedicated 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. Learn more about the value of using a dedicated Salesforce Integration user in this blog post.
To create a dedicated Salesforce integration user you should use a dedicated email such as integrationuser@yourdomain.com and assign the following user permissions:
- RollWorks Admin permission set.
- View All / Read / Write access to Account, Opportunity, Contact, Lead, Campaign, and Activities/Tasks objects.
- Read / Edit access to User objects with the ability to manage permission sets.
- View Roles and Role Hierarchy.
- View Setup and Configuration.
Use an Existing Salesforce Admin
Using an existing Salesforce System Admin is not recommended and it will result in the interruption of the data sync between RollWorks and Salesforce in the event that the user leaves your company or their user profile is deactivated. If you decide to use an existing Salesforce Admin, they will automatically have the required user permissions:- RollWorks Admin permission set.
- View All / Read / Write access to Account, Opportunity, Contact, Lead, Campaign, and Activities/Tasks objects.
- Read / Edit access to User objects with the ability to manage permission sets.
- View Roles and Role Hierarchy.
- View Setup and Configuration.
Use an Existing Salesforce User with Extended Permissions
Using this option is not recommended and it will result in the interruption of the data sync between RollWorks and Salesforce in the event that the user leaves your company or their user profile is deactivated. Select an existing Salesforce user and extend their Salesforce user permissions:
- RollWorks Admin permission set.
- View All / Read / Write access to Account, Opportunity, Contact, Lead, Campaign, and Activities/Tasks objects.
- Read / Edit access to User objects with the ability to manage permission sets.
- View Roles and Role Hierarchy.
- View Setup and Configuration.
Step 3 - Assign user permissions sets to end users
In this step, you will assign permissions sets to the end users that will use the RollWorks ABM App in Salesforce (Sales and Marketing employees) that need to see RollWorks data and reports directly in Salesforce. There are two different permissions sets that you will assign to your Salesforce users:
The RollWorks Admin permission set is granted to all the users responsible for managing the RollWorks platform (usually these are members of your Marketing team). They will be able to:
- Complete the initial integration setup between Salesforce and RollWorks.
- Authenticate your Salesforce account to connect with RollWorks.
- Schedule, run and stop the data sync between Salesforce and RollWorks.
- Read and write access to all pages, objects, and fields used by the RollWorks ABM App.
- Use the List Builder in Salesforce to sync over your Excluded Customers, Excluded Competitors, and Contact Lists.
- Sync your 1st party contact data for Personalized Ads.
- The user has a Sales Insights seat assigned on the RollWorks platform.
- The user has the Sales Insights permission set assigned in Salesforce.
Step 4 - Authorize the App and start 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, and select Yes, opt-in to data sharing to enable 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 5 - Assign Sales Insights seats to your Salesforce 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.
Step 6 - Configure your Salesforce Page Layouts and Reports
After the initial package installation and user permissions are complete you should configure your Account and Contact Page Layouts to display RollWorks custom objects and custom fields to your end users. Without this step, RollWorks data will not be visible to your end users when they look at an Account record.
Follow the steps in this article to configure your Page Layouts and share the default RollWorks Custom Report templates with your end users.
Troubleshooting
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. If you do not have permission to Grant Account Login Access to RollWorks, please contact your Salesforce Administrator.
To learn more about how to grant account login access to RollWorks visit this Salesforce article or follow the instructions below.
Grant RollWorks Account Login Access in Salesforce Lightning:
- Log in to Salesforce and click the avatar on the top right corner and click Settings.
- Click Grant Account Login Access on the left side navigation panel.
- Find NextRoll Support and click the Access Duration dropdown.
- Select 1 Month and click Save.
Grant RollWorks Account Login Access in Salesforce Classic:
- Log in to Salesforce and click the avatar.
-
Depending on your Organization settings, the Setup button is next to the logged-in user's name at the top right corner of the page or listed as a drop-down option when the logged-in user's name is clicked.
- Click Setup > My Personal Information > Grant Login Access.
- Click Your Name > My Settings > Personal > Grant Account Login Access.
- Find NextRoll Support and click the Access Duration dropdown.
- Select 1 Month and click Save.
Re-authorize the Salesforce 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 the reauthentication, Salesforce will attempt to sync data over to RollWorks dynamically the next day at 12 pm UTC.
RollWorks data available in Salesforce
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 is synched.
Use Cases
Read through the four use cases below to leverage the Salesforce Integration with RollWorks and find step-by-step instructions:
| Use Case | Example | How |
|---|---|---|
| Create and sync Account Lists and Account Groups based on Salesforce fields | Define the Account Lists and Groups you want to target in RollWorks using your own Salesforce fields | Go to the Account List Builder in the RollWorks platform and select Salesforce as your data source. Learn how-to here. |
| Define Journey Stages based on Salesforce fields | Customize Journey Stages to understand how accounts progress through the sales cycle using your own Salesforce fields | Go to Journey Stages in the RollWorks platform to edit, or add new stages. Learn how-to here. |
| Bring over your Salesforce contacts into RollWorks as Contact Lists | Target known contacts from Salesforce with advertising. Exclude known contacts/leads from your campaigns | Use the Contact List Builder in RollWorks and use Salesforce contacts filtered with RollWorks data to create a dynamic list. Learn how-to here. |
| Create and sync Account Lists to use in our General Exclusions | Exclude specific Accounts from your advertising campaigns, for example, some of your existing customers | Use the RollWorks List Manager in Salesforce to create a company list, and use it in RollWorks General Exclusions. Learn how-to here. |
| Create new Account records in Salesforce from your RollWorks Account Lists | Add new accounts to Salesforce that do not exist yet in your CRM based on their fit, engagement, or intent signals. | Go to RollWorks, select an Account List, and manually push the accounts to Salesforce. Learn how-to here. |
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.
