# 功能說明
透過 SHOPLINE 整合模組，品牌可以：
- 用電話號碼或 Email 將 SHOPLINE 會員與 LINE 聯絡人綁定
- 將 SHOPLINE 會員資料（Customer ID、電話、Email、生日、性別、標籤）同步至 MAAC
- 讓會員透過 LINE 查看訂單、優惠券與會員卡資訊
- 設定通知型訊息，在會員完成指定行為後自動推播
🚨 注意
- 若您已在 SHOPLINE 串接 LINE Provider 的 「Login Channel」（例如：Social Login），請確認與漸強實驗室 MAAC 串接的 「Messaging API」必須在同一個 Provider，才能讓兩端的 LINE UID 相同
- 資料同步為單向：SHOPLINE → MAAC，MAAC 資料不會回傳至 SHOPLINE
- 啟用功能需完成以下兩個階段設定
# 第一階段｜前置作業
步驟 1｜確認 SHOPLINE 模組開通狀態
請確認已向 SHOPLINE 開通「漸強實驗室 - 全方位電商 AI 助理 (行銷|銷售|客服)」。
📝 若您過去已採用漸強 EC 小幫手服務並開通「OpenAPI 模組」，欲升級為新版電商會員卡，請聯繫 SHOPLINE 服務窗口，了解合約與收費轉換事宜。
步驟 2｜確認 SHOPLINE 會員驗證功能已開啟
請確認已開啟以下其中一項功能，並確保驗證功能已啟用，以利收集正確聯繫資料：
步驟 3｜向漸強實驗室申請安裝
完成前置確認並回信後，漸強夥伴將在 5 個工作天內提供 module_token。
📝 可透過 MAAC 右下角小幫手聯繫漸強夥伴，或洽詢 CSM 提出申請。
# 第二階段｜設定作業
步驟 4｜在 SHOPLINE 擴充功能商店完成設定
前往 SHOPLINE 擴充功能商店 → 漸強實驗室 - 全方位電商 AI 助理 (行銷|銷售|客服) → 打開擴充功能
點擊「重新授權」
授權完成後，填入漸強提供的 Module Token 開通功能。
步驟 5｜設定會員卡外觀
開通後進入會員卡設定頁面，可自行設定以下內容：
| 設定項目 | 說明 |
|---|---|
| 會員卡頁面標題 | 自訂顯示名稱 |
| LOGO | PNG 格式，600 × 320 px，檔案大小不超過 1 MB |
| 背景色 | 自訂品牌配色 |
| 前景色 | 會員卡姓名區塊的背景顏色 |
| 條碼格式 | Code 128 / Code 39 / EAN 13 / QR Code（可不啟用） |
| 會員權益連結 | 可不啟用 |
| 常見問題連結 | 可不啟用 |
步驟 6｜將會員卡連結放入圖文選單或自動回應
- 設定圖文選單：
- 設定自動回應：功能說明｜Omnichannel 自動回應（含 FB/IG / LINE / WhatsApp / Web Chat）
🎉 完成以上所有設定後，用戶即可透過 LINE 進行 SHOPLINE 會員綁定，並查看會員卡資訊！
# 用戶綁定流程
情況 A：已是 SHOPLINE 會員
- 點擊綁定連結，輸入電話或 Email
- 收到驗證簡訊 / 驗證信，輸入驗證碼
- 驗證成功 → 完成綁定 → 進入會員卡頁面
情況 B：尚未是 SHOPLINE 會員
- 點擊綁定連結，輸入電話或 Email
- 無註冊資料，點擊「建立帳號」
- 跳轉商家 LIFF 首頁，完成會員註冊
- 註冊完成關閉畫面後，需再次點擊綁定連結，進行綁定
# 常見問題
[會員卡啟用]
Q：若品牌正在使用舊版 SHOPLINE 小幫手模組，可以轉換為新模組嗎？
A：可以，請聯繫漸強實驗室夥伴，我們會協助您進行相關轉換流程。
Q：品牌已有 SHOPLINE 官網會員且有 LINE UID 欄位，可以直接協助 LINE 好友做會員綁定嗎？
A：若品牌在 SHOPLINE 串接的 LINE Provider 與漸強實驗室串接的 Provider 相同，可匯出包含 customer_id 與 LINE uid 的 SHOPLINE 會員資料，透過聯絡人匯入功能完成匯入，匯入後聯絡人即為已綁定狀態，可直接查看會員卡。請參考：設定教學｜匯入與更新聯絡人資料
⚠️ 透過匯入方式建立的聯絡人，系統不會主動將 SHOPLINE 的會員資料同步到 MAAC，除非聯絡人進行會員資料更新或發生訂單行為。
[SHOPLINE 會員卡]
Q：SHOPLINE 會員卡上線後，標籤資料會同步到漸強 MAAC 嗎？
A：會。標籤將在此階段同步回漸強 MAAC，並帶有前綴格式 shopline_bind_{標籤名稱}。例如：會員完成綁定時，會出現 shopline_bind_success。
Q：SHOPLINE 會員的個人資料（手機、Email、Birthday）也會同步回漸強 CDH 嗎？
A：會。個人資料將同步至漸強 CDH 並顯示於 MAAC，包含：Customer ID、電話號碼、性別、生日、標籤、Email。
⚠️ 由 SHOPLINE 回傳的電話號碼會以 E.164 格式記錄於 MAAC。SHOPLINE 中 09 開頭的電話號碼，在 MAAC 中會自動存為 +886 形式。
Q：MAAC 聯絡人資訊如有變更，是否會同步更新 SHOPLINE 會員資料？
A：不會。資料同步為單向：SHOPLINE → MAAC，MAAC 的資料不會回傳至 SHOPLINE。
Q：SHOPLINE 綁定可以選擇 Email 當 key 值嗎？
A：可以，Email 或電話號碼均可用於驗證綁定。
Q：若用戶在綁定時非 SHOPLINE 官網會員，會引導先做會員註冊嗎？
A：會。點擊綁定連結後，會先引導至會員註冊；註冊完成後，仍需再次點擊 LINE OA 的綁定連結完成綁定流程。
Q：SHOPLINE 會員卡條碼可支援海外用戶使用嗎？
A：可以，但僅限綁定 key 值為 Email 的情況。
Q：為什麼使用 Email 綁定會員卡時，會員卡條碼沒有顯示電話？
A：若聯絡人以 Email 作為綁定 key 值，且在 SHOPLINE 會員資料中未填寫電話號碼，則會員卡條碼無法顯示電話，因為漸強與 SHOPLINE 均無該聯絡人的電話資料。
Q：會員卡條碼中 Phone 和 Local Phone 有什麼差別？
A：
- Phone：含國碼（E.164 格式，如 +886）
- Local Phone：不含國碼（如 09xxxxxxxx）
- 請務必選擇與 SHOPLINE 後台實際儲存的電話資料格式一致
[通知型訊息 / 簡訊]
Q：SHOPLINE 通知型訊息的發送情境有哪些？
A：支援以下情境：完成會員註冊、完成付款通知（非貨到付款訂單）、訂單完成通知（貨到付款訂單）、出貨通知、到貨通知。可發送方式：LINE Push、通知型訊息、簡訊（品牌可決定要開啟哪個情境及發送方式）。
⚠️ 通知型訊息僅適用於來自「shop 線上官網」的訂單。透過 API、POS、SmartOMO 導購官網連結等方式產生的訂單，目前不在觸發範圍內。
Q：SHOPLINE 通知型訊息的接收者是誰？
A：
- 訂單完成通知 → 以訂購人電話為主
- 完成會員註冊、完成付款通知、出貨通知、到貨通知 → 以會員電話為主
Q：如為線下訂單，會發送簡訊訊息嗎？
A：不會，線下訂單不會發送簡訊＋訊息。
Q：發送 SMS+ 訊息有什麼注意事項？
A：
- 請務必開啟「手機註冊」功能
- 發送通知型訊息或簡訊前，請確認已完成儲值
[MAAC 其他功能應用]
Q：LINE PNP 訊息無法引導會員綁定，有其他方式嗎？
A：可改用以下方式引導用戶完成綁定：
- 新好友歡迎訊息：附上綁定連結與誘因說明（例如：綁定後可獲得 LINE Points 100 點）
- 圖文選單：放置會員卡連結，未綁定用戶點擊後會自動導至綁定頁面；連結可在開通後的會員卡設定頁面自行取得
Q：如何針對不同等級會員推播訊息？
A：請先透過標籤功能區分會員等級，再進行分眾推播。
Q：操作中遇到錯誤訊息，可以怎麼處理？
A：請依照錯誤訊息類型參考以下說明：
設定 Module Token 時：
-
module token is not for <platform>（module token 與商家平台不符）
請截圖錯誤訊息，透過 MAAC 右下方的對話窗與漸強夥伴回報，我們會進行排查並盡快回覆。 -
module token expired（module token 過期）
請截圖錯誤訊息，透過 MAAC 右下方的對話窗與漸強夥伴回報，我們會進行排查並盡快回覆。 -
invalid token（表單驗證用之 token 錯誤）
請先重新整理輸入 module token 的頁面，並確認該設定頁面網域為漸強實驗室網域（cresclab.com）。若仍無法使用，請截圖並透過 MAAC 右下方的對話窗與漸強夥伴回報。 -
invalid module token format（module token 格式錯誤）
請截圖錯誤訊息，透過 MAAC 右下方的對話窗與漸強夥伴回報，我們會進行排查並盡快回覆。 -
invalid module token length: <length>（module token 長度格式錯誤）
請截圖錯誤訊息，透過 MAAC 右下方的對話窗與漸強夥伴回報，我們會進行排查並盡快回覆。
聯絡人透過 LINE OA 進行綁定時：
| 情境 1 | 情境 2 | |
|---|---|---|
| 顯示內容（中） | 驗證失敗 無法取得綁定會員卡資訊 |
連線發生錯誤 請稍後再試 |
| 顯示內容（英） | Verification Failed Unable to retrieve the bound membership card information |
Connection error occurred Please try again later or contact the brand |
| 異常可能原因 | 1. EC 端 APP 已卸載 2. EC 端消費者帳號因不明原因消失 |
1. module token 到期 2. 消費者的 CID 異常（e.g. 在漸強紀錄的 CID 與 EC 有效 CID 不符） 3. 網路連線問題 4. EC 端連線異常 |
Q：「綁定門市 - 服務專員」欄位需要什麼 SHOPLINE 方案？
A：需使用 SHOPLINE OMO 大師或全通路領航員方案。