> 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-shopify.md).

# Integrate with Shopify

Shopify customer contacts can be synced to the Omnichat.

{% hint style="info" %}

* When a customer who has logged in to your website starts a conversation through the Chat Plugin, their membership information will be displayed in the conversation page. (Customer data is not synced automatically. A manual sync is required.)
  {% endhint %}

{% hint style="info" %}
Supported Features:

* Customer Data Sync:
  * One-time sync of all customer data
  * Real-time sync via Webhooks when customer data changes
* Automatically Add WhatsApp Contacts
  {% endhint %}

### Step 1

{% hint style="info" %}
If you have not created a Shopify app before, continue with the steps below.

If you have already created a Shopify app, skip to [**Step 13**](https://app.gitbook.com/o/-L_qBouk_wijumBR7PT3/sites/site_0oD9U/s/3u2I1osIy6mEi07X1z46/~/edit/~/changes/606/features/she-ding/integrations/app-integrations/integrate-with-shopify#step-13).
{% endhint %}

You can also refer to Shopify's [App Creation Guide](https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard).

Go to the **Shopify Dev Dashboard** and click **Create app** in the top-right corner.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F1E9IazjHwmYFuMxMX5m7%2Fimage.png?alt=media&amp;token=cde0d7ca-8349-4155-b288-dc724177627d" alt=""><figcaption></figcaption></figure>

### Step 2

Enter an **App name**, then click **Create**.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F9AqiRmX7miMcdCBF3vAy%2Fimage.png?alt=media&amp;token=260c0f85-323e-4efc-9025-353de4727829" alt=""><figcaption></figcaption></figure>

### Step 3

After entering **Create a version**, scroll down to **Access**.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FBhEwMWKs0M0ga5ZuUGfG%2Fimage.png?alt=media&amp;token=038268e3-4a2c-4ecc-b2cb-a99e10f68a6c" alt=""><figcaption></figcaption></figure>

### Step 4

Under **Access > Scopes**, enter: read\_all\_orders, read\_customers, read\_orders, then click **Release**.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fb8m0D3x40lYqvkaTkJ9Q%2Fimage.png?alt=media&amp;token=1d7b48fa-8cf7-4cbe-868e-f068affdc4f0" alt=""><figcaption></figcaption></figure>

### Step 5

If needed, enter the version information, then click **Release**.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FhzGNHI2Kub2MHRf9wngm%2Fimage.png?alt=media&amp;token=98633443-f553-487e-b67b-4e8f7dd3b0a5" alt=""><figcaption></figcaption></figure>

### Step 6

The Shopify app has been created successfully.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FSAczq536MqOrygMrIqAI%2Fimage.png?alt=media&amp;token=6c2ee683-b4b2-424d-935e-deda5af61efa" alt=""><figcaption></figcaption></figure>

### Step 7

Click **Home** on the right, then click **Install app** to install the app.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FUlqbowiNYzCgy87N55Ow%2Fimage.png?alt=media&amp;token=c1e77ac1-2370-4989-b857-e1fbf6116c97" alt=""><figcaption></figcaption></figure>

### Step 8

Select the store where you want to install the app.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F7aRAnNTcOB2OpXk2GPmy%2Fimage.png?alt=media&amp;token=a6ae21d4-9183-47f6-a7d9-9dd370788e85" alt=""><figcaption></figcaption></figure>

### Step 9

Click **Install** to complete the installation.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FDnuXZdBfM9k4YZ913UGy%2Fimage.png?alt=media&amp;token=297ef9b4-b777-4203-823a-65970bf677aa" alt=""><figcaption></figcaption></figure>

### Step 10

After installation, the app will appear in the **Side Menu** of your Shopify Admin Panel.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FmrsScTXvOkXviq71muxR%2Fimage.png?alt=media&amp;token=a7aa5f94-e5eb-49e6-bd24-943ddd06c513" alt=""><figcaption></figcaption></figure>

### Step 11

#### **Get the Store URL**

In the Shopify Admin Panel, go to **Settings** in the bottom-left corner.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FKBjKXSCgLN0KuPjmR26o%2Fimage.png?alt=media&amp;token=d947765c-dfea-4eab-b8f8-c2eca0d68c95" alt=""><figcaption></figcaption></figure>

Copy the **Store URL** shown at the top of the left panel.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FIS7krLY3rHd1IusjkKxV%2Fimage.png?alt=media&amp;token=c9384095-c61f-43e2-8cbc-de0d54ff6eeb" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
**Important:** If you use a custom domain, go to **Domains** and use the default Shopify store URL in the following format:

`https://{store_name}.myshopify.com`

Using a custom store URL will cause the integration to fail.

Path: **Shopify Admin Panel > Settings > Domains**
{% endhint %}

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FlssBzF79hrDlj0IQBiZ6%2Fimage.png?alt=media&amp;token=55b94ecb-07fa-4ef7-a700-1bbb89de855b" alt=""><figcaption></figcaption></figure>

### Step 12

#### **Get the Client ID and Secret**

In the Shopify Admin Panel, switch to the **Dev Dashboard** in the top-right corner.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FoixViwHdPkr391IaK5yE%2Fimage.png?alt=media&amp;token=401a3a07-e976-41ff-a582-7fcddcf8c36b" alt=""><figcaption></figcaption></figure>

Select the app you created.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F3qt5r3ESNRmBv9qdrKJe%2Fimage.png?alt=media&amp;token=37561fb1-0eb8-4c4e-94f2-321503a4de88" alt=""><figcaption></figcaption></figure>

Go to **Apps > Settings** on the left.

Under **Credentials**, copy the **Client ID** and **Secret**.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FFY3CoqJ4zkST0btTRdEp%2Fimage.png?alt=media&amp;token=99830481-d597-49ee-bcf7-69e381728bdd" alt=""><figcaption></figcaption></figure>

### Step 13

In the Omnichat Admin Panel, go to **Settings > Integrations > App Integrations > Shopify** and click **Integrate** button for Shopify.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fn97Xujky6QEBNdkbRjz7%2F%E6%88%AA%E5%9C%96%202026-09-29%20%E4%B8%8B%E5%8D%883.19.55.png?alt=media&amp;token=f967148d-ee6e-4b43-91c0-1df774a956f5" alt=""><figcaption></figcaption></figure>

### Step 14

In the Omnichat Admin Panel, enter the **Store URL, Client ID, and Secret** obtained in Steps 12 and 13.

{% hint style="info" %}

* Unless you have specific requirements, you can use the same app for both **Customer Data** and **Order Data.**
* You can also enable **Ako Data Sync** according to your needs.
* If you want to add Shopify customer phone numbers as **WhatsApp events** in Omnichat, enable **Automatically Add WhatsApp Contacts** and select the WhatsApp account you want to sync.

  After the integration is completed, a feature menu will be displayed on the right side of the app.
  {% endhint %}

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FD3eLTWtNwPgimQPkiz2z%2F%E6%88%AA%E5%9C%96%202026-09-29%20%E4%B8%8B%E5%8D%883.21.22.png?alt=media&amp;token=29e9b78f-b925-44d4-9598-dbfec4b5d246" alt=""><figcaption></figcaption></figure>

### Step 15

After the integration is completed, a sync prompt will appear.

Click **Sync Now** to start syncing immediately. If you click **Sync Later**, you can return to the app's feature menu and start the sync at any time.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Ft1lQZ2ipBP3X0j0spahG%2Fimage.png?alt=media&amp;token=65355d11-e009-4b06-ad8f-91d723d5d05f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F4l9yKkIeS8w7OETeVyqF%2F%E6%88%AA%E5%9C%96%202026-09-29%20%E4%B8%8B%E5%8D%883.25.46.png?alt=media&amp;token=62ec4d9b-e2f0-4012-8d64-e5cf8b7fabe3" alt=""><figcaption></figcaption></figure>

The feature menu includes:

1. **Edit integration data**: Update the store integration information.
2. **Sync data**: Sync customer data again and view the status of the previous sync. You can close the pop-up window while the sync continues running in the background.
3. **Remove integration** : Disconnect the current store if you want to connect a different store.

<div><figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F29oW02SjZbTtF2nTSCi4%2F%E6%88%AA%E5%9C%96%202026-09-29%20%E4%B8%8B%E5%8D%883.24.34.png?alt=media&amp;token=3fd3c31c-8451-4a0d-8192-c5c77fc0fecc" alt=""><figcaption></figcaption></figure> <figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FqBArkRdwV66VGkL3PmKW%2F%E6%88%AA%E5%9C%96%202026-09-29%20%E4%B8%8B%E5%8D%883.24.50.png?alt=media&amp;token=81867d8e-5a69-4b5b-8714-53ad9dc7fdab" alt=""><figcaption></figcaption></figure></div>

## Customer Data Sync Results

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FzdLt79sJoKorwv6dYg3f%2F%E6%88%AA%E5%9C%96%202026-09-29%20%E4%B8%8B%E5%8D%883.25.37.png?alt=media&amp;token=eb1af8ee-8578-4143-9650-789c377b5aa7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If **New Contacts Synced** shows **0**, it means no new contacts were added during the sync.
{% endhint %}

The following customer data will be synced:

* Name
* Customer ID
* Email
* Phone Number
* Tags
* **Custom Attributes**:
  * Shopify - Total Orders
  * Shopify - Total Spent
  * Shopify - Notes
  * Shopify - Email Marketing Consent
  * Shopify - SMS Marketing Consent

## Notes

1. If you recently updated customer contacts but the contact count has not been updated after the integration, try **disconnecting and reconnecting** the integration.
