> 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/features/tong-xun-qu-dao/di-san-fang-ying-yong/chuan-jie-shopify.md).

# 串接 Shopify

{% hint style="info" %}
串接支援情境

* 會員資料同步\
  \- 單次所有會員資料同步\
  \- Webhook 異動即時同步
* 自動新增 WhatsApp 聯絡人
  {% endhint %}

### 步驟一

在 Omnichat 選單中找到串接頁面：「通訊渠道 > 第三方應用」，並點擊 Shopify 的串接按鈕

<figure><img src="/files/LF9DCR41OsGxU9B7M1ty" alt=""><figcaption></figcaption></figure>

### 步驟二

{% hint style="info" %}
若沒有建立過 shopify app，請繼續往下參考

若已經建立過 shopify app，可以直接前往 [步驟十四](#bu-zhou-ba)
{% endhint %}

{% hint style="info" %}
可同時參照 [Shopify 建立 App 說明文件](https://shopify.dev/docs/apps/build/dev-dashboard/create-apps-using-dev-dashboard)
{% endhint %}

前往 Dev Dashboard，點選右上角 “Create app“

<figure><img src="/files/LwszMJcH2gymR47QJr1P" alt=""><figcaption></figcaption></figure>

### 步驟三

輸入要建立的 App name，並點選 Create

<figure><img src="/files/LouYAsHgKw7J7tH8s7jA" alt=""><figcaption></figcaption></figure>

### 步驟四

進到 Create a version 後，往下拉到 Access

<figure><img src="/files/AyxIY5NA7O6aIhNMeEs2" alt=""><figcaption></figcaption></figure>

### 步驟五

Access 的 Scopes 填入：read\_all\_orders, read\_customers, read\_orders，並且按 Release

<figure><img src="/files/T9GegOMFl1TCSpsn5QT7" alt=""><figcaption></figcaption></figure>

### 步驟六

若有需要，可填入版本資訊，並按 Release

<figure><img src="/files/YHOjDpY6qGgiV1yAbClQ" alt=""><figcaption></figcaption></figure>

### 步驟七

建立 app 完成

<figure><img src="/files/wXPBTXtx2Pu6hevl4LGR" alt=""><figcaption></figcaption></figure>

### 步驟八

點選右邊回到 Home 點擊 Install App 來安裝

<figure><img src="/files/Uzw7O6O5dtqx8EuFuKBT" alt=""><figcaption></figcaption></figure>

### 步驟九

選擇要安裝的商店

<figure><img src="/files/jPH61spsexGYZ2p0bxK5" alt=""><figcaption></figcaption></figure>

### 步驟十

點選 Install 進行安裝

<figure><img src="/files/AJMPyvPQRZM535chjpJr" alt=""><figcaption></figcaption></figure>

### 步驟十一

安裝成功後會顯示在商店後台左手邊的 Side Menu

<figure><img src="/files/knzMzx4rDhLtsSRxosJM" alt=""><figcaption></figcaption></figure>

### 步驟十二

#### 取得 ”**商店 URL“**

點選 Shopify 後台 > 左下角 Settings

<figure><img src="/files/A6qla5tRYCsBWmxOdbfJ" alt=""><figcaption></figcaption></figure>

複製左側上方商店 URL

<figure><img src="/files/mrzbQ2DmJt5ONzKTtWjp" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
注意：若您有使用自訂網域，需到 「網域」 頁面，使用預設的商店URL， "必須符合 https\://{store\_name}.myshopify.com" 格式，若使用自訂的商店URL，會導致串接失敗。\
\
確認路徑：Shopify設定後台 >> 網域
{% endhint %}

<figure><img src="/files/zKQtdmxM4wYzKrz6aAmW" alt=""><figcaption><p>確認網域</p></figcaption></figure>

### 步驟十三

#### 取得 Client ID、Secret

Shopify 後台 > 右上角切換至 Dev Dashboard

<figure><img src="/files/IbHqJmQoCCXrGbXzXvBP" alt=""><figcaption></figcaption></figure>

點選設定好的 App

<figure><img src="/files/PCH1weXqMJ3ANs1iJ8fW" alt=""><figcaption></figcaption></figure>

點選左側 Apps > Settings，取得右側 Credentials 裡的 Client ID、Secret

<figure><img src="/files/OptdHJEphMgHUKD0bNRI" alt=""><figcaption></figcaption></figure>

### 步驟十四

在 Omnichat 後台貼上前面「步驟十二、十三」取得的 “商店 URL”、“Client ID”、“Secret”

{% hint style="info" %}
會員資料 和 訂單資料 如無特殊需求，可使用相同 App 即可
{% endhint %}

{% hint style="info" %}
可自行依需求開啟 Ako 資料同步

若需要將 Shopify 的會員手機資料新增為 Omnichat 的 WhatsApp 事件，請將 「自動新增 WhatsApp 聯絡人」 打勾，並選擇要同步的帳號串接成功後，在應用程式的右側會顯示功能選單
{% endhint %}

<figure><img src="/files/zi6yO7LlA3jdy89K1PWM" alt=""><figcaption></figcaption></figure>

### 步驟十五

串接成功後，會顯示同步按鈕，點擊 「立即同步」 會立刻執行同步功能

點擊「稍後同步」的話，也可以隨時回來串接應用程式的功能選單再度同步

<figure><img src="/files/WFzRL4hiDRVL1tH60AzW" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/1vpZSbQqdBRxMZpal1XK" alt=""><figcaption><p>取得串接資料後的選單畫面</p></figcaption></figure>

1. 編輯：可以更改商店的串接資訊
2. 資料同步：除了能再次同步聯絡人資料到最新的狀態外，也可以看到上次同步狀態的資訊
3. 解除串接：若要取得不同商店的聯絡人，可以解除串接後再次串接

立即同步

<figure><img src="/files/mhJJz054GKifoxAkeSTP" alt=""><figcaption></figcaption></figure>

同步時可先關閉彈出視窗，同步作業仍會在背景進行處理

<figure><img src="/files/pkQm3ihgh9GrVwQZqU6e" alt=""><figcaption></figcaption></figure>

### 會員資料同步完成後畫面

{% hint style="info" %}
同步資訊中，若「新聯絡人同步數量」為 0，代表這次同步的過程中沒有新增加的聯絡人。
{% endhint %}

<figure><img src="/files/fCjZrJrdnYDSBJgkIqNM" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
會員資料同步包含以下資料

* 姓名、會員編號、Email、電話、標籤
* 自訂屬性：Shopify - 累積訂單數、Shopify - 累積消費金額、Shopify - 備註、Shopify - Email 行銷同意、Shopify - SMS 行銷同意
  {% endhint %}

### 注意事項

1. 若在近期有更新連絡人，但串接後沒有看到聯絡人數量更新，請嘗試解除串接後重新串接。