This article gives step-by-step setup instructions of Channeltivity’s Partner Sync integration with Salesforce. An overview of Channeltivity’s Partner Sync Salesforce Integration can be found in this article.


Set Up Salesforce Fields

  1. Log into Salesforce.com CRM as an Admin.
  2. Go to Setup > Object Manager > Accounts > Fields & Relationships > New. 
  3. Add a custom checkbox field to the Account Layout and call it "Sync with Channeltivity" (or anything you want). 
  4. There will also need to be a picklist field on the Salesforce Account to denote the Partner's status in Channeltivity (Active, Prospective, or Inactive). You can use an existing picklist (e.g. the built-in Account Type) or create a new one (go to Setup > Object Manager > Accounts > Fields & Relationships), but you'll need to make sure you have three separate picklist values you can use for Active Partner, Prospective Partner, and Inactive Partner.

    Note: While many customers use the Account Type field and add the following values, others create a new picklist field called "Channeltivity Partner Status."
    1.  Active
    2.  Prospective
    3.  Inactive


Prep Salesforce Partner Data  

IMPORTANT:

To avoid duplicate records being created, it is of critical importance that all your Partner Accounts in Salesforce are properly categorized with the status (active, prospective, inactive) and have the sync flag set.

  1. Log into Salesforce CRM
  2. Go through any Partner Accounts that already exist in Salesforce and make sure each of them has the "Sync with Channeltivity" flag checked and is assigned to the correct picklist value is set for Active, Prospective, or Inactive Partners. You can change multiple records at once using the same technique outlined in this article. (There's no need to manually create any Partner Accounts in Salesforce because Channeltivity will create any missing Partners.)


Configure Channeltivity 

  1. Log into Channeltivity PRM as an Admin and go to Settings > Salesforce Integration
  2. If you haven't already done so, set your Salesforce Integration Credentials
  3. If your credentials are valid, the Partner Sync configuration section becomes available. Click on it:

  4. Set the Partner Sync to "Bi-Directional Sync":


5. Check the boxes if you want Prospective or Inactive Partners to be synchronized between Salesforce and Channeltivity. 


6. You will also need to select a checkbox field that indicates that a Partner Account in Salesforce should get synced with Channeltivity. If you use record types in Salesforce for Accounts and Contacts, you can specify which one to use below.



7. Scroll down to the field mappings configuration section to view the mappings. The mappings determine the two-way flow of data between Partner records in Channeltivity and Salesforce. The system will display all of the Partner and Contact fields in Channeltivity on the left and all of the Account and Contact fields in Salesforce on the right. The standard Partner and Contact fields are already mapped to the standard Salesforce Account and Contact fields, but you will need to map the Status field to a picklist field that includes the following values: Active, Prospective, and Inactive. 


        To map the Status field, click the plus sign and select the picklist field from the dropdown menu > Add.



You'll then map each picklist value to a corresponding value in the other system. You'll need to specify all three statuses even if you're not synchronizing Prospective or Inactive Partners. 

Note: All dropdown values are pulled directly from your Salesforce portal. If you change them in Salesforce, you'll need to refresh the page to have them appear.


8. When you are finished, you can add additional field mappings by clicking the “Add Mapping” button and select a field from the Channeltivity dropdown menu. You'll then select the corresponding field from the Salesforce dropdown menu. 



If the field does not exist in Salesforce, you can create it in Salesforce by clicking the “Create New Field” button.


Note: You can use the "Create New Field" functionality to add the below Channeltivity system fields to the Account and Contact layouts in Salesforce. 

  • Record Status (Read-Only) - indicates whether or not the record exists in Channeltivity 
  • Record URL (Read-Only) - the link/URL to the record in Channeltivity 


9. Once all your mappings are complete, press the "Save" button at the very bottom of the page to finish the setup process. Depending on the details of your Salesforce configuration, the saving process can take up to 30 minutes. 


10. When the saving process completes, you will be redirected to the Partner matching wizard, which allows you to link existing Partners from both systems to prevent the creation of duplicate records. The wizard suggests Partners based on Partner name and address and allows you to link each Partner in Channeltivity to an existing Partner Account in Salesforce, or to create a new Partner Account. Any Contacts/Users will be matched solely based on their email addresses; Salesforce Contacts without an email address will not be synced.


11. During the matching process, Channeltivity will merge data from matched records and then update both systems with the merged data. Merging data is done field-by-field so that if one side has data but the other side doesn't, the side with data is selected to create the final data. The Master System determines which side is used if field data exists in both Channeltivity and Salesforce. Check the box to indicate that you've completed the preparation process and select the "Master System". Tip: You can change the Master System as you go along.


12. Press the "Continue" button to display a list of your Partners from Channeltivity along with suggested matches from Salesforce. In the screenshot below, you see Channeltivity Partners on the left and the suggested Salesforce Account matches on the right. You can now do one of the following:
  1. Select the suggested Salesforce Account by pressing the "Link" button. 
  2. Manually select a different Account using the "Select Other Account" dropdown and corresponding "Link" button.
  3. Create a completely new Account in Salesforce by pressing the "Create New Account" button in the bottom right.
  4. Permanently exclude the record from synchronization by pressing the "Do Not Sync" button on the left.


Tip: If you need to make changes on either side, make the changes and then hit the "Refresh Data" button at the top, which reloads all Partner data from both systems. 


13. When you've matched all your Partners and the matching process is complete, a confirmation page is displayed, and Channeltivity will start syncing Partner records.