Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Integrate with Salesforce

The following plan requirements must be met to sync contact data between Omnichat and Salesforce.

Omnichat Plan Requirements

  • Salesforce Membership Data Integration add-on is required.

Salesforce Plan Requirements

  • Professional: Web Services API add-on is required.

  • Enterprise: Web Services API is included.

Step 1: Start Integration and Authorization

In Omnichat, go to Settings > Integrations > App Integrations and click Integrate for Salesforce.

After clicking Integrate, an information page will appear. Click Authorize at the bottom to start the Salesforce integration.

You will be redirected to the Salesforce authentication page. Enter your Salesforce account and password to authenticate.

Please use an account with Salesforce Admin permissions for the integration.

After authorization is completed, return to the Omnichat Admin Panel to continue the setup.

Step 2: Set Up Sync Settings

Click Start Setup on the previous page. The first step is to configure the identity matching fields.

Select Identification Fields

  • Select a Salesforce field and map it to Membership ID, Phone Number, or Email in Omnichat.

  • When the values in the selected Salesforce and Omnichat fields match, the records are considered to belong to the same customer and can be synchronized.

What to Do When No Matching Contact Is Found

When syncing from Salesforce to Omnichat, if no matching contact is found in Omnichat, select one of the following options:

  • Create New Contact: Automatically create a new contact in Omnichat when no matching contact is found.

  • Update Existing Contacts: Update only contacts that already exist in Omnichat without creating new contacts.

When syncing from Omnichat to Salesforce, if no matching contact is found in Salesforce, select one of the following options:

  • Create New Contact: Automatically create a new contact in Salesforce when no matching contact is found.

  • Update Existing Contacts: Update only contacts that already exist in Salesforce without creating new contacts.

Step 3: Configure Social Identity Sync Settings

Next, configure social identity synchronization. If customer social IDs, such as Facebook PSID or LINE UID, are already stored in Salesforce, Social Identity Sync allows you to quickly create social contacts in Omnichat. Social contact data managed through Omnichat can also be synced to Salesforce for storage.

The Social CDP plan supports multiple social identity sync configurations. Upgrade to the Social CDP plan if you need to sync multiple social identities.

For WhatsApp, both Phone Number and BSUID are currently supported. However, BSUID only supports one-way synchronization to Salesforce.

Step 4: Configure Field Mapping

In this step, configure synchronization for other fields, such as Membership ID and Birthday.

Fields configured in previous steps do not need to be configured again.

When syncing phone numbers, Salesforce data must include the country/region code. For example, Taiwan phone numbers must include 886 at the beginning, such as 886912345678. Incorrect formatting will prevent the data from being synchronized.

Step 5: Sync conditions from Salesforce to Omnichat

In this step, you can define the conditions for syncing Salesforce contacts to Omnichat. Only contacts that meet the specified conditions will be synchronized.

  • If no conditions are set, all Salesforce contacts with an identity matching field will be synchronized.

  • If conditions are set, a contact must meet all conditions to be synchronized.

  • After completing the setup, click Save in the upper-right corner to save the synchronization settings.

Step 6: Complete Setup and Start Syncing

After the synchronization settings are completed, if Salesforce → Omnichat synchronization is configured, the Start Sync button will appear. Click the button to perform the initial full data synchronization. After that, changed data will be automatically synchronized every 15 minutes.

If only Omnichat → Salesforce synchronization is configured, real-time synchronization of changed data will begin immediately after setup is completed.

You can close the window during synchronization, and the synchronization will continue in the background.

Other Actions

  • After completing the synchronization setup, you can click the integration button to Edit Sync Settings, View Sync Information, or Remove integration.

  • On the Sync Information page:

    • Salesforce → Omnichat: Manually sync data.

    • View synchronization records, including Salesforce → Omnichat, Omnichat → Salesforce, and two-way synchronization.

Last updated