> 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 %}

回到 Shopify 設定後台，並點擊左下角的 Settings >> Apps and slaes channel

<div><figure><img src="/files/CEgHzisFVv3SuKlGpNhx" alt=""><figcaption></figcaption></figure> <figure><img src="/files/gdG2r5W5kX9kpJ35ruS1" alt=""><figcaption></figcaption></figure></div>

### 步驟三

點選 Develop apps >> Create an app

<div><figure><img src="/files/KX1fwwp0mIKgnnxDUEan" alt=""><figcaption></figcaption></figure> <figure><img src="/files/i9L4QXRTKViFMnF7wlXL" alt=""><figcaption></figcaption></figure></div>

### 步驟四

替 App 名稱命名，並選擇有權限的帳號後，進入介面點擊 「Configure Admin API scopes」

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

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

### 步驟五

授權 API 權限，需要至少授權 「`read_customers」`

Webhook subscriptions 選擇 2024-04 版本

並點擊頁面最下方的 Save 儲存

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

### 步驟六

點擊 Install app 並同意

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

### 步驟七

點擊 「Reveal token once」 取得 API access token

{% hint style="danger" %}
此 token 僅可顯示一次，請妥善保存
{% endhint %}

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

### 步驟八

複製所有串接資訊至 Omnichat 後台

若需要將 Shopify 的會員手機資料新增為 Omnichat 的 WhatsApp 事件，請將 「自動新增 WhatsApp 聯絡人」 打勾，並選擇要同步的帳號

<figure><img src="/files/6YsInhGVGBqs3oqERdpF" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/iZXx2cUrA2jZILezCPRP" 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>

### 步驟九

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

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

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

串接成功後，在應用程式的右側會顯示功能選單

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

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

### 步驟十

完成同步後，會顯示底下畫面。

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

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

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

若完成同步後，可以到「聯絡人及推播訊息 > 網站」的列表中，找到 Shopify 的客人資料。

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

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

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

### 注意事項

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