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


  1. Log into Channeltivity as an Administrator and go to Settings > Salesforce Integration 
  2. If you haven't done so already, make sure to enter your Salesforce Integration Credentials.
  3. If your credentials are valid, the Deal Registration configuration section becomes available. Click on it:


  4. Set the Deal Registration to "Export Only":

  5. Select whether you want Channeltivity to automatically create a Lead in Salesforce whenever a Deal is registered or whether you want the manual control over which Deals get pushed into Salesforce. If you have different Lead record types defined in Salesforce, you can also specify which one to use:



  6. Map the fields from the Channeltivity Deal Registration box on the left to the Salesforce Lead box in the middle. These field mappings determine which Deal Registration fields get exported and where their data are stored in Salesforce. The configuration page will automatically display all fields in your Salesforce instance. Mappings are created by first clicking on the source field on the left and then clicking the destination on the right. Use the "1st Sync Only" checkbox for Salesforce fields that you don't want Partners to edit once the Salesforce Lead has been created, as it prevents changes in Channeltivity from overwriting existing data in Salesforce.
    You can also select fields from Salesforce to be synced back to the Deal in Channeltivity. This is helpful if you want your Partners to see the Opportunity stage from Salesforce within Channeltivity, for example. There are a few restrictions:

    1. Any Salesforce data that is synced back to the Deal in Channeltivity is read-only and resides in special read-only custom fields. This means that the sync is not truly bi-directional.

    2. The sync of Salesforce data to Deals in Channeltivity is not instantaneous. You will need to hit the “Sync Now” button or wait for the next hourly sync to complete.



  7. If you wish to map Deal Registration fields to Salesforce Opportunities as well, you can switch to the Opportunity tab in the center box and complete those mappings there. We don't recommend mapping to the Opportunity Amount, Close Date or Stage fields, as this a) will cause any changes made in Salesforce to be overwritten and b) will allow your Partners to directly affect the fields you use for forecasting and reporting in Salesforce.

  8. Check the "Hide unmapped field" box to only show your mappings. Here's a recommended starting point consisting of only basic Lead fields. No Opportunity fields are mapped. Especially if you use our managed Salesforce package, you most likely only need a handful of fields.


  9. Tip: You can create new destination fields in Salesforce from Channeltivity, by mapping Channeltivity fields (column on the left) to "New Field" at the bottom of the Salesforce box (column on the right.
    LeadSetup-8-Create-new-field.png

  10. 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. Besides saving your configuration, the saving process will also create a number of custom Salesforce fields used by Channeltivity and add them to your Salesforce layouts:

    • Salesforce Lead custom fields required by Channeltivity:

      • Channeltivity Last Update (Ctvt_Sys_LastUpdated__c, Date/Time)

      • Channeltivity Status (Ctvt_Sys_EntityType__c, Text(255))

      • Channeltivity URL (Ctvt_Sys_URL__c, URL(255))

    • Salesforce Opportunity custom fields required by Channeltivity:

      • Channeltivity Last Update (Ctvt_Sys_LastUpdated__c, Date/Time)

      • Channeltivity Status (Ctvt_Sys_EntityType__c, Text(255))

      • Channeltivity URL (Ctvt_Sys_URL__c, URL(255))

  11. When the setup process is complete, you will be redirected to the Salesforce Integration Settings page.

  12. You're all set! Go ahead and submit a Deal Registration to test out the integration between your Channeltivity PRM and Salesforce CRM.