This article outlines the procedure to complete your account setup after your InsideView Refresh account is authorized by an InsideView Customer Success Manager (CSM).
Only Administrators can configure the InsideView Refresh for Salesforce CRM account.
InsideView managed package will add Account, Contact and Lead Outbound workflow rules when you log in to your Salesforce instance after installing the latest package. These workflow rule components are required to push account and contact matches and updates from InsideView Refresh into your CRM and for future capabilities.
Note: If your organization restricts network access to third party applications, please ask your IT administrator to add the following IP address ranges to allow updates from InsideView:
- 188.8.131.52 to 184.108.40.206
Caution: The InsideView Refresh managed package will add an active workflow rule when installed. By default, Salesforce has a limit of 50 active workflow rules in a production environment and 10 in a Sandbox instance, we recommend you to check the number of active workflow rules in your Salesforce instance. If that number is already 50 in Production or 10 in Sandbox, one of the rules must be set to ‘inactive’ (or deleted), or the following error message is displayed:
Exceeded maximum number (50)/(10) of active workflow rules or approval processes for Account records.
However, you can increase the number of active workflow rules in your Salesforce CRM. For more information, refer to the Salesforce documentation.
Supported Web Browsers
The Web browsers which support Transport Layer Security (TLS) 1.1 and 1.2 protocols to install InsideView Refresh are:
|Google Chrome||v70 and above|
|Internet Explorer||v11 and above|
|Mozilla Firefox||v60 and above|
|Apple Safari||v12 and above|
Supported Salesforce CRM Versions
InsideView Refresh supports Salesforce CRM Enterprise and Unlimited Editions.
Configuring InsideView Refresh for Salesforce CRM consists of the following tasks:
Make sure you have required roles, created a backup of your data and enabled field auditing before your proceed with InsideView Refresh Installation.
Roles Required to Authenticate Access
To install InsideView Refresh, you must have the Salesforce administrator role with CRUD permissions on the Account, Contact and Lead objects in the CRM.
The Salesforce account administrator must grant the View Setup and Configuration access to the standard users to allow them to view InsideView Refresh setup pages(i.e. view the object details, page layouts, and other components) that required for InsideView configuration. The account administrator must go to the Profile/Permission Set page under the System Permissions and enable the View Setup and Configuration checkbox.
To learn more, read the Salesforce Help documentation.
Create a Backup of Your Salesforce Account and Contact Data
Before installing InsideView Refresh, backup your Salesforce CRM account and contact records.
- Log in to your Salesforce CRM.
- In the Classic edition, go to Setup > Data Management > Data Export and click Export Now.
In the Lightning edition, go to Setup > Data Export and click Export Now.
Note: The Export Now option is only available if you not exported files manually in the past six weeks.
- In the Exported Data section, select the Account check box and then click Start Export.
- Once the account data export is completed, click the link in the email notification or click Data Export to download .zip file(s).
- To backup your contact records, in the Exported Data section, select the Contact check box and then click Start Export.
- Once the contact data export is completed, click the link in the email notification or click Data Export to download .zip file(s).
Salesforce creates a .zip archive of .csv files and then emails you when files are ready. If you export a large account file it is split into multiples files.
Note: The steps to create a backup of account records might be different for the Salesforce Enterprise and Unlimited Editions. InsideView recommends you to refer the Salesforce documentation for more recent instructions on their website.
Enable Field History Tracking for Accounts in Salesforce CRM
Before installing InsideView Refresh, you must enable field history tracking for users in the Salesforce CRM account and contact fields to restore previous information when automated cleaning processed is used to update Salesforce records. Field tracking is optional for some fields.
- Log in to your Salesforce account.
- In the Classic edition, go to Setup > Customize > Account and select Fields.
In the Lightning edition, go to Setup > Object Manager > Account and select Fields and Relationships.
- Click Set History Tracking and enable history tracking for Accounts object.
select Enable Account History
- To set history tracking for these Account fields, as a minimum. You can also track custom fields that you have mapped:
- Account Name
- Account Owner
- Annual Revenue
- Billing Address
- Ticker Symbol
- To set field history tracking for contact fields, in the Classic edition, go to Setup > Customize > Contact and select Fields.
In the Lightning edition, go to Setup > Object Manager > Contact and select Fields and Relationships.
- Click Set History Tracking and enable history tracking for Contacts object.
select Enable Contact History
- To set history tracking for these Contact fields, as a minimum. You can also track custom fields that you have mapped:
- Mailing City
- Mailing Country
- Mailing State/Province
- First Name
- Last Name
- Mobile Phone
- Click Save.
For the latest information on how to enable history tracking for Salesforce accounts, refer to their online documentation.
Install the InsideView Refresh package in your Salesforce CRM
You can install InsideView Refresh in your Salesforce CRM either in the sandbox or production instance.
It is a best practice to install InsideView Refresh in your Salesforce CRM in the Sandbox first and then move to a production environment.
- Sign up for the Salesforce Sandbox instance from here: https://test.salesforce.com/packaging/installPackage.apexp?p0=04t1W000000U7Xy
- Sign up for the Salesforce Production instance from here: https://login.salesforce.com/packaging/installPackage.apexp?p0=04t1W000000U7Xy
To install InsideView's package, follow the instructions in the Installing InsideView in Salesforce CRM in our Knowledge Base.
Note: When a Salesforce CRM instance is refreshed, the field mappings and filters associated with the existing ORG ID˟˟ are lost. To access InsideView Refresh again, the new CRM instance has to be provisioned before the InsideView Refresh package is re-installed. To do this, contact your CSM.
The reason the field mappings and filters of the Sandbox are lost is because the ORG ID and URL of the Sandbox instance in question, changes after a Sandbox Refresh. For example, ORG URL changes from cs45 to cs25 or cs30. Since both, the ORG ID and the URL change, it is not possible to treat this as the older Org ID. This will be, from InsideView Refresh's standpoint treated as a New Org ID, which explains why you do not see the filters.
|1||Go to the InsideView Refresh page||Click here to go to InsideView Refresh home page and select the login option.
|2||Log in and allow OAuth access||Log in to InsideView Refresh with your Salesforce account credentials.
|3||Review the installation components||
InsideView Refresh will add and populate the following custom fields and workflow rule in your Salesforce CRM:
Important Note: After installing InsideView package, when you log in to your Salesforce CRM the following custom fields and workflow components are added to your CRM. You must not delete these custom fields and workflow rules under any circumstances. These custom fields and workflow rule components are required to push the matches and updates from InsideView Refresh into your CRM.
Build an InsideView Refresh List
InsideView Refresh allows you receive updates and review matches for your Salesforce CRM account data based on filters you define. To control which accounts are managed by InsideView Refresh, create a filter by following the steps below:
|1||Go to the InsideView Refresh page||To build a new filter, click Start.
This screen appears when are build a list for the first time in InsideView Refresh:
If you have already defined few lists, you need to choose any of the following option:
For example, select the New List from Criteria option to build a new list using search criteria filters.
|2||Define rule details||In the Define your rule for selecting accounts page, enter the following filter details shown:
Note: You can add five filters only. Exclude filter takes the highest priority.
|3||Map fields||On the Field Mapping tab, by default some InsideView Refresh fields are mapped to your Salesforce CRM fields. You can edit the custom field mapping as illustrated below:
You can select the following options:
Note: You can set any option (Overwrite, Update, if blank or Flag Only) for all fields by selecting the option at the top. The option selected will be common for all fields.
You can configure the frequency at which you want to receive updates from InsideView Refresh.
On the Set Frequency page, select the type as shown below:
Note: The Start Date and Start Time indicates that the updates will be sent to your CRM from that specified date and time onwards.
You can select the following frequency types:
|5||Complete the list||Review the filter details and click Finish to complete the list and close the page.|
|6||Run and View the filter||To run the list that you have just created, scroll down on the InsideView Refresh home page as shown below:
Select a filter and do any of the following actions:
Upload Salesforce Account Data
InsideView Refresh allows you to upload your Salesforce CRM account data file and update it with the latest information.
Note: In this release, you can add five filters and upload one file. If you add both a filter and upload a file, the file takes the highest priority. The file that you upload will always work according to an “include only” rule. The include only rule will add all accounts from the file into InsideView Refresh and sync account updates into Salesforce CRM.
Any additional file which you upload will replace the existing set of records with the new accounts in the file.
|1||Go to the New List page||In the InsideView Refresh dashboard, click New and to upload account data, click Start in the Upload a File region.
|2||Select the data file||On the Open pop-up window, select the file you want to upload, as shown below:
Note: The .csv file that you have exported from your Salesforce CRM must include only the Account IDs. The header of the column containing the data you wish to import into InsideView Refresh should be ‘CRM Account ID’.
|3||Review upload status||
Once you select a .csv file, the upload status tracker is appears.
|4.||Complete the setup||
Once the file is uploaded, follow steps 2 to 6 in the Add an InsideView Refresh Filter section above to add a filter for the accounts data from the file.
Once you build a list or upload an account or contact file, complete the steps described above and then click Finish and Run to execute the filter.
The Managed Records results is displayed with the Total Records and Total Updates that available to sync from InsideView Refresh into your Salesforce CRM as illustrated below:
To review matches and updates from InsideView Refresh:
- Click the Account Matches donut chart region to open the Review Matches page. For more information, read the article Reviewing Account Matches in Salesforce CRM.
- Click the Account Updates region to open the Review Account Updates page. For more information, read the article Reviewing Account Updates in Salesforce CRM.
- Click the Contact Matches donut chart to review the contacts matches based on matched accounts. For more information, read the article Reviewing Contact Matches in Salesforce CRM.
- Click the Contact Updates region to review the contacts updates that available in InsideView Refresh for matched contacts. For more information, read the article Reviewing Contact Matches in Salesforce CRM.