LINE LIFF：如何串接

LINE LIFF 串接步驟：在 LINE Developers 建立 LIFF app、把對話平台公開網址設為 Endpoint URL，讓 Web Chat 在 LINE 聊天視窗內開啟。

使用前提：

• 已經在 MaiAgent 平台上建立好一個 「Website」 的對話平台，

• 已經在 LINE Developers 的 console 平台建立好一個 「Provider」 以及 「LINE Login」 的 channel

設定步驟：

1. 在在 LINE Developers 的 LINE Developers console 平台， LIFF detail 的頁面 「LIFF app name」 欄位為您的 LIFF app 命名。

2. Size 欄位選擇 Full

3. Endpoint URL 欄位

將對話平台的 「公開訪問URL」 複製到 「Endpoint URL」 欄位，加上「/line-liff/」

4. Scopes 欄位同時勾選 openid 與 profile

openid 必須勾選。MaiAgent 會用 LINE 簽發的 ID token 向 LINE 驗證使用者身分，驗證通過才把對話記到該 LINE 使用者名下；沒勾 openid 時，LIFF 頁面仍可對話，但對話會以匿名聯絡人記錄，後台看不到 LINE 使用者的名稱與頭像。已經上線的 LIFF app 請回到 LIFF detail 頁面補勾 openid 並按「Update」。

5. Add friend option 欄位選擇 ****On (normal)

6. 按下 頁面下方的「 Save」按鈕，再回到剛剛的 LIFF detail 頁面，此時您會看到 系統已產生一個 LIFF ID，將該 ID 填入到 「Endpoint URL」 欄位中網址「.../line-liff/」的後面，並按下「 Update」

7. 最後到最上方，將此 LIFF Published，即完成設定與上線。

開始使用！

1. 「LIFF URL」 就是這個 LIFF 的連結網址。

2. LINE 的聊天室中點開 「LIFF URL」 連結的使用者（圖文選單）便會被導向到 Web Chat 頁面使用 Agent 對話，MaiAgent 的後台就可以收到用戶、對話資訊。

聯絡人同步行為與限制

1. 聯絡人如何建立：使用者透過 LIFF 開啟 Web Chat 並送出訊息時，MaiAgent 會以該使用者的 LINE User ID 在這個對話平台建立聯絡人；之後同一位使用者再次對話，會更新該聯絡人的名稱與頭像。

2. 只取得 openid 與 profile 範圍的資料：LIFF 只取得驗證身分用的 ID token 與 LINE 的 profile（LINE User ID、顯示名稱、頭像），拿不到電話、Email 等其他個人資料。

3. 聯絡人在各自的對話平台中比對：聯絡人只會在同一個對話平台內以 LINE User ID 比對，不會跨對話平台合併。同一位使用者從 LINE 官方帳號（LINE 對話平台）和 LIFF 網頁（Website 對話平台）進來，在後台會是兩筆聯絡人。

4. LINE Login channel 與 Messaging API channel 要放在同一個 Provider：LINE User ID 依 Provider 區分，同一位使用者在不同 Provider 底下會拿到不同的 LINE User ID。請將 LIFF 所在的 LINE Login channel 與 LINE 官方帳號的 Messaging API channel 建在同一個 Provider 底下，兩邊的聯絡人才會是同一個 LINE User ID，方便您比對同一位使用者。

需要同步會員資料（例如會員編號、等級）到聯絡人，請參考 聯絡人 (Contact) 介紹及串接 與 聯絡人身分同步與 Token 更新。

適用場景

建立在官方帳號的圖文選單連結、線上商店整合、會員系統串接、活動報名系統、客戶服務系統