Replicating contacts to Salesforce

✖
Copy to clipboard

Kentico EMS required

Features described on this page require the Kentico EMS license.

Feature retired in Kentico 9

Salesforce integration in Kentico 9 uses Salesforce SOAP API version 23.0, which is deprecated and will be retired in 2023. For more information, see the Salesforce Platform API Versions 21.0 through 30.0 Retirement article.

If you wish to use Salesforce integration, you need to upgrade to Kentico Xperience 13.

The system replicates contacts to Salesforce leads using the SalesForce replication scheduled task. This task runs separately for each site in Kentico, by default once per hour.

Prerequisite: Before the system can run the replication task, you need to configure the website for access to your Salesforce organization and the related replication settings. See: Configuring Salesforce integration

Scheduling the replication process

You can configure the Salesforce replication task according to your own requirements, for example to change when and how often the replication takes place.

  1. Open the Scheduled tasks application.

  2. Select your site.

  3. Click Edit () next to the SalesForce replication task.

    Editing the SalesForce replication scheduled task

  4. Set the properties of the task as required.

    • Use the Task interval section to schedule the time and frequency of the Salesforce replication process.
    • We recommend keeping the Run task in separate thread option enabled to maintain optimal replication performance.

  5. Click Save.

The system performs contact replication for the given website based on the settings of the task.

Tip: You can Execute () the Salesforce replication task manually at any time from the list of scheduled task.

Checking the replication status of your contacts

You can view which contacts in Kentico have or have not been replicated to Salesforce leads.

  1. Open the Contact management application.
  2. Click Advanced search.
  3. Select one of the options on the second Search row in the filter:
    • Replicated into Salesforce leads
    • Not replicated into Salesforce leads
  4. Click Search.

The list now only shows contacts that match the selected replication status.

Replication process specifics

When executed, the SalesForce replication scheduled task attempts to replicate all contacts that meet the scoring requirements set for the given website.

The application can only make a limited number of API calls to Salesforce within a 24 hour window, so the replication process handles contacts in batches. Each batch is processed using one API call. You can specify the maximum number of contacts that the system replicates in a single batch through the Batch size setting in Settings -> Integration -> Salesforce.com.

Note: The replication process runs separately for each site in the system. As a result, each site also has its own batch counter.

To view how many API requests your company has made and how close you are to the limit, refer to Setup -> System Overview -> API Usage in the Salesforce interface.

Replication error handling

Errors can occur during the replication of contacts. For example if a numeric value is too large for the target Salesforce field, or if a contact in Kentico doesn’t have a field that is required by Salesforce filled in. In these cases, the process skips the related contact and continues with the replication.

You can find records of all replication errors in the Event log application.

The system flags all contacts that caused an error and blocks them from subsequent replication attempts. The replication block is automatically removed for individual contacts when one of their fields is updated, or globally if the Mapping of contacts to Salesforce leads settings change (see the Configuration section for details).