# 資料串接辦法

## 方法一(透過 Server Side Partner API 進行整合)

sequenceDiagram
participant USER as 使用者
participant LINE_APP as LINE APP
participant BROWSER as 瀏覽器(品牌端前端網頁)
participant SERVER as 品牌端伺服器
participant PARTNER_API as GOSU Partner API

par 定時同步使用者資料
  SERVER ->> PARTNER_API: 同步資料
end

USER ->> LINE_APP: 點擊訊息中的連結
USER ->> BROWSER: 進入網頁
BROWSER ->> SERVER: 透過 LINE LOGIN 取得使用者 LINE UserID
BROWSER ->> SERVER: 透過 SESSION 確認使用者身份 

- LINE LOGIN 實作細節 https://developers.line.biz/en/reference/line-login/
- 品牌端將自行保存數據
- Partner API 文件 https://partner.gosu.bar/doc/
- 需申請 Partner ID

## 方法二 (透過 LIFF SDK + 流程編輯器 進行整合)

sequenceDiagram
participant USER as 使用者
participant LINE_APP as LINE APP
participant BROWSER as 瀏覽器(品牌端前端網頁)
participant SERVER as 品牌端伺服器
participant GOSU_CUSTOMIZE_API as GOSU 流程編輯器中的自定義事件

par 建立流程
  GOSU_CUSTOMIZE_API ->> GOSU_CUSTOMIZE_API: 工程師需在後台建立流程
end

USER ->> LINE_APP: 點擊訊息中的連結
USER ->> BROWSER: 進入網頁
BROWSER ->> BROWSER: 透過 LIFF 取得使用者 AccessToken
SERVER ->> SERVER: 
BROWSER ->> GOSU_CUSTOMIZE_API: 透過 API 執行流程 <br/> 將透過 Bearer Authentication 驗證身份
GOSU_CUSTOMIZE_API ->> GOSU_CUSTOMIZE_API: 檢測使用者是否有標籤

- 自定義事件中需勾選檢查身份狀態
- 需要在機器人設定中設定白名單網址
- 品牌端伺服器無法知道使用者的相關資訊