Salesforce Integration: Configuration

NOTE: An authorized user account is required to run this integration. To support better security and audit visibility, we recommend creating a dedicated "service account" user. When configuring this integration, sign in using the service account rather than your personal user account to ensure that audit logs reflect the service account running the integration instead of the user who originally installed it.

Complete the steps below to configure the Salesforce integration.

NOTE: Before starting the configuration steps below, be sure you have completed the required prerequisite steps, including creating the three custom fields in Salesforce. See the Salesforce Integration: Prerequisites article for more information.
  1. Click Admin on the sidebar menu and select Integrations Library.
  2. Click the Marketplace tab.
  3. Locate and select the Salesforce integration in the CRM area.
  4. Click the Configure button.
  5. The Initial Configuration section is automatically populated. Click the Next button.
  6. On the Connections page, enter your Salesforce connection details as described in the first table below, and then click the Next button.
  7. On the Sync Settings page, configure the settings described in the second table below, and then click the Next button.
  8. On the Opportunity Sync page, configure the settings described in the third table below. Then, click the Finish button.
  9. If Enable Initial Sync is checked, the integration runs the one-time sync of your existing Salesforce data. Do not leave this page while the sync is running. If you need to work on something in the system while the integration syncs, open Rev.io in another tab.

Each setting on the Connections page is defined below.

LabelDefinition
Salesforce ConnectionYour Salesforce username, password, security token, and login URL. See the Salesforce Integration: Prerequisites article for more information.
Rev.io PSA ConnectionFilled in for you. No changes are needed.
Production ModeLeave this checked. It is only unchecked for testing.

Each setting on the Sync Settings page is defined below.

LabelDefinition
Account Type FilterSalesforce account types to sync. Leave this blank to sync all accounts regardless of type.
Opportunity Stage FilterOnly syncs accounts that have opportunities at the selected stages. Leave this blank to include all accounts.
Bill Profile IDRev.io bill profile assigned to new customers. Leave this as 0 to use your default bill profile.
Sync ScheduleHow often the scheduled sync runs. The default is daily at 3:00 AM. Running more often than every 12 hours is not recommended.
Batch SizeThe most records processed in each sync run. The default is 50. Increase it if you have a large amount of Salesforce data.
Enable Initial SyncCheck this option to run the one-time sync of your existing Salesforce data when setup finishes. Uncheck it only if you want to skip importing your existing records.
Debug ModeTurns on detailed logging for troubleshooting. Leave this unchecked for normal use.

Each setting on the Opportunity Sync page is defined below. The Status Map and Stage Map lists are filled in from your Salesforce and Rev.io accounts, so you select values instead of typing them.

LabelDefinition
Opportunity Trigger StagesSalesforce stages that sync opportunities to Rev.io. Leave this blank to turn off opportunity sync. Accounts and contacts still sync.
PSA Default StageRev.io stage used for new opportunities when a Salesforce stage is not in the Stage Map. The list shows the stages in your Rev.io account.
PSA Default TypeRev.io type used for new opportunities.
PSA Default StatusRev.io status used for new opportunities when a Salesforce stage is not in the Status Map.
PSA Default Owner User IDRev.io user ID used as the opportunity owner when no Rev.io user's email matches the Salesforce opportunity owner. Leave this as 0 if you don't want a fallback owner. 
Closed Lost ReasonText entered in the lost reason field when a Closed Lost opportunity syncs. The default is Closed Lost in Salesforce.
Status MapMatches each Salesforce stage to a Rev.io status, such as Closed Won to Won.
Stage MapMatches each Salesforce stage to a Rev.io stage, such as Prospecting to Discovery.

For more information about the Salesforce integration, see the following articles.

Salesforce Integration: Overview
Salesforce Integration: How the Sync Works