# 功能說明
透過漸強實驗室 LINE mini app x 輔翼 OMO 會員卡整合，品牌可以：
- 透過手機號碼或 E-mail OTP 驗證，將輔翼 FLAPS 會員與 LINE 聯絡人綁定
- 取得品牌在輔翼系統中既有會員資料（Customer ID、電話號碼、性別、生日、E-mail）同步至 MAAC
- 讓會員透過 LINE 查看會員資訊與訂單資訊
🚨 注意
- 資料同步為單向：FLAPS → MAAC，MAAC 資料不會回傳至輔翼 FLAPS
- 目前不提供通知型訊息功能（無法取得訂單狀態 Webhook 即時資訊）
- 目前不提供優惠券資料（無法取得輔翼 FLAPS 優惠券資料）
- 啟用功能需完成以下兩個階段設定
# 第一階段｜前置作業
步驟 1｜向輔翼 FLAPS AM 提出採購申請
請向輔翼 FLAPS AM 申請採購「漸強實驗室 LINE mini app x 輔翼 OMO 會員卡」功能。
🔔 開通時，請務必向輔翼 FLAPS 確認貴司 API 在輔翼伺服器的維護時間。
步驟 2｜提供設定值給漸強夥伴
採購開通後，輔翼 FLAPS 將提供以下 4 項設定值，請轉交給漸強夥伴：
- Address URL
- Token
- IS
- MemberClassSerNo
步驟 3｜等待漸強實驗室完成串接
完成前置確認並回信後，漸強夥伴將在 5 個工作天內完成 OMO 會員卡開通，並安排一個 30 分鐘的上線會議說明後續流程。
📝 可透過 MAAC 右下角小幫手聯繫漸強夥伴，或洽詢 CSM 提出申請。
# 第二階段｜設定作業
步驟 4｜在 MAAC 擴充市集設定會員卡
收到開通通知後，請進入 MAAC 擴充市集 → FLAPS → 前往編輯，進行會員卡設定。
開通後進入會員卡設定頁面，可自行設定以下內容：
| 設定項目 | 說明 |
|---|---|
| 會員卡頁面標題 | 自訂顯示名稱 |
| LOGO | PNG 格式，600 × 320 px，檔案大小不超過 1 MB |
| 背景色 | 自訂品牌配色 |
| 前景色 | 會員卡姓名區塊的背景顏色 |
| 條碼格式 | Code 128 / Code 39 / EAN 13 / QR Code（可不啟用） |
| 會員權益連結 | 可不啟用 |
| 常見問題連結 | 可不啟用 |
步驟 5｜將會員卡連結放入圖文選單或自動回應
- 設定圖文選單：
- 設定自動回應：
🎉 完成以上所有設定後，用戶即可透過 LINE 進行輔翼 FLAPS 會員綁定，並查看會員卡資訊！
# 用戶綁定流程
- 點擊綁定連結，輸入手機號碼或 E-mail
- 收到驗證簡訊 / 驗證信，輸入驗證碼
- 驗證成功 → 完成綁定 → 查看會員卡
- 用戶綁定成功後，在 MAAC 可查看到「flap_bind_success」標籤
完成串接設定後的流程圖示：
# 常見問題
[會員卡資料]
Q：聯絡人在會員卡上，會看到哪些資料？
A：姓名、Barcode、會員卡號、會員等級、會員等級期間、會員等級期間消費累積金額、可用點數、消費紀錄。
Q：輔翼 FLAPS 會員卡有「通知型訊息」功能嗎？
A：目前不提供。因無法取得輔翼 FLAPS 訂單狀態、資料變更時的 Webhook 即時資訊，故尚不支援通知型訊息功能。
Q：輔翼 FLAPS 會員卡會顯示「優惠券」嗎？
A：目前不提供。因無法取得輔翼 FLAPS 優惠券資料，故尚不支援優惠券資料顯示。
[資料同步與標籤]
Q：MAAC 聯絡人資訊如有變更，是否會同步更新輔翼 FLAPS 會員資料？
A：不會。資料同步為單向：FLAPS → MAAC，MAAC 的資料不會回傳至輔翼 FLAPS。
Q：客戶若想針對不同等級會員推播訊息，是否只能使用標籤來分眾推播？
A：是的。請先透過標籤功能整理會員等級後，再進行分眾推播設定。
[帳號與綁定流程]
Q：若聯絡人在綁定時尚未成為輔翼 FLAPS 會員怎麼辦？
A：需請用戶先完成線下門市或輔翼線上會員註冊，完成後再回到 LINE OA 點擊綁定連結進行綁定流程。
Q：如果遇到輔翼 FLAPS API 伺服器維護時間，會影響哪些功能？
A：維護期間，聯絡人將無法進行會員綁定，也無法查看會員卡資訊。
Q：若品牌線下使用輔翼系統、線上使用其他電商平台，在會員卡上可以看到整合資料嗎？
A：目前會員卡僅支援「單一接口」，呈現的資料來自單一系統來源（如 CYBERBIZ、SHOPLINE、91APP、Shopify、FLAPS）。若品牌有不同線上平台、線下系統或 CRM，需先自行整合至 1 個中心系統。若有線上、線下會員與訂單資料整合需求，請先聯繫您的電商平台或輔翼 FLAPS。
[錯誤訊息]
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 端連線異常 |