> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/en/features/she-ding/integrations/app-integrations/integrate-with-salesforce.md).

# 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.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Ff9xivSpPX22bROQGJzi9%2F%E6%88%AA%E5%9C%96%202026-09-24%20%E4%B8%8B%E5%8D%883.34.12%E6%8B%B7%E8%B2%9D.png?alt=media&amp;token=165aa081-581b-4b28-b138-6a168df57da3" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FCAqzKWlE4ix5DlDLfSyu%2F%E6%88%AA%E5%9C%96%202026-09-24%20%E4%B8%8B%E5%8D%883.34.26.png?alt=media&amp;token=d209402c-13a5-42c7-9a2a-6118f1e55fd1" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
Please use an account with **Salesforce Admin** permissions for the integration.
{% endhint %}

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FX8c4MbNW3boZT0kEr6iR%2Fimage.png?alt=media&amp;token=f2e9e705-674a-4b7f-9371-82cea54b0bca" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FWhZ5tOUJlL5TW4wJtXpZ%2Fimage.png?alt=media&amp;token=7f04e355-da04-4abf-820d-1caf6c976711" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FnlSLrQZmUdsWfwBLYaq9%2F%E6%88%AA%E5%9C%96%202026-09-29%20%E4%B8%8B%E5%8D%883.45.58.png?alt=media&amp;token=7637560f-789c-4579-8293-48f681bb25dc" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FHCL6xiZAnsj86SsEYXTA%2F%E6%88%AA%E5%9C%96%202026-09-29%20%E4%B8%8B%E5%8D%883.47.15.png?alt=media&amp;token=8fed8d37-30e3-48e4-9169-71fcc407f3e6" alt=""><figcaption></figcaption></figure>

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**.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FlJqpgeSO5QIcgGRNibyi%2Fimage.png?alt=media&amp;token=8507c417-e0ba-4dee-86a1-65366d6d5e24" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FDttkXxwmjpATnn29S8eH%2F%E6%88%AA%E5%9C%96%202026-09-29%20%E4%B8%8B%E5%8D%883.52.12.png?alt=media&amp;token=491878af-1fa2-4bc0-98ec-185828b065a7" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FmNXbpjuUgygDeW4uIjgi%2F%E6%88%AA%E5%9C%96%202026-09-29%20%E4%B8%8B%E5%8D%883.54.10.png?alt=media&amp;token=90b622a5-95ac-40f6-bc8e-79a0db32b365" alt=""><figcaption></figcaption></figure>

### 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.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FYsEVYhgHik1WwkbulK47%2Fimage.png?alt=media&amp;token=5bb33e07-b36b-43cd-af20-d1e8c0438fea" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FKRHggMA4j9Bc9BaZnJ2E%2Fimage.png?alt=media&amp;token=8245c5ae-6950-4a41-8124-1ebbfaaeacf3" alt=""><figcaption></figcaption></figure>

### Other Actions

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FupCU0Ev9dWNKy4DuwIvg%2F%E6%88%AA%E5%9C%96%202026-09-29%20%E4%B8%8B%E5%8D%883.45.31.png?alt=media&amp;token=08118bb8-a74b-42b3-8d66-f073b83ec04b" alt=""><figcaption></figcaption></figure>

* 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**.
