LINE 設定教學（LINE Developers）

1. 整體流程與需要的值

1. 建立 ProviderLINE Developers 中用來放 channel 的「資料夾」，通常用店名或公司名。
2. 建立 LINE 官方帳號並啟用 Messaging API顧客加好友、在群組 +1 下單、收到通知的帳號。
3. 建立 LINE Login channel 與 LIFF顧客與管理者在 LINE 內開啟加一購畫面時使用的登入。
4. 把值填入加一購設定 > LINE 設定。最後按「Verify」確認 Webhook 連線成功。

值的對照表（哪裡的值要填到哪裡）

反過來，以下的值是由加一購提供，要填到 LINE Developers：

2. 建立 Provider（服務提供者）

用平常使用的 LINE 帳號登入 LINE Developers Console。第一次登入時，會要求輸入開發者名稱與 Email，並同意開發者條款。

1. 1在「Providers（服務提供者）」旁按「Create（建立）」。

1. 1「Provider name（服務提供者名稱）」輸入店名或公司名（顧客在 LINE 登入時會看到）。
2. 2按「Create（建立）」。

1. 1按「Create a Messaging API channel（建立 Messaging API channel）」。

目前 Messaging API channel 無法直接在 LINE Developers 建立，要先建立 LINE 官方帳號，再從官方帳號啟用 Messaging API。

1. 1按「Create a LINE Official Account（建立 LINE 官方帳號）」，會開啟官方帳號的申請頁面。

3. 建立 LINE 官方帳號

申請頁面會依您 LINE 帳號的地區顯示中文或日文。以下為日本地區的畫面（日文），台灣地區的欄位內容相同。

1. 1「アカウント名（帳號名稱）」：顧客在好友清單與聊天室看到的名稱，建議用店名。
2. 2「会社・事業者の所在国・地域（公司・事業所在國家／地區）」：選擇店家所在地（台灣請選「台湾」）。
3. 3「業種（業種）」：例如「ショッピング・小売店（購物・零售）」。

1. 1業種與「運用目的（使用目的）」：依實際情況選擇。
2. 2「主な使い方（主要用途）」：選「チャット・LINEコール用（聊天・LINE 通話）」或依需求選擇。之後可以變更。
3. 3第一次申請請選「ビジネスマネージャーの組織を作成（建立商業管理組織）」。

填寫完成後按頁面下方的「確認」→「完了（完成）」。按鈕上的條款同意請由店家本人確認後操作。

4. 官方帳號的設定（群組・Messaging API・回應設定）

官方帳號建立後，會開啟「LINE Official Account Manager（官方帳號管理畫面）」。可在右上的語言選單切換成繁體中文。

1. 1按右上的「設定」。

允許加入群組（在 LINE 群組 +1 下單必需）

1. 1「加入群組或多人聊天室」選「接受邀請加入群組或多人聊天室」。

1. 1按「變更」。

啟用 Messaging API

1. 1左側選單按「Messaging API」。
2. 2按「啟用 Messaging API」。

1. 1選擇第 2 章建立的 Provider。一旦選擇就無法變更，請確認名稱。
2. 2確認「LINE 官方帳號 API 服務條款」後按「同意」。接著隱私權政策等欄位可空白，按「確定」。

1. 1「Webhook 網址」貼上加一購的 Webhook URL（https://ja1go.net/t/{店家代碼}/webhook），按「儲存」。也可以稍後在 LINE Developers 設定（第 5 章）。

回應設定

1. 1「Webhook」：開啟（沒有開啟，加一購收不到 +1 與訊息）。
2. 2「自動回應訊息」：關閉（避免與加一購的回覆重複）。

5. Messaging API：取得 Channel secret 與 Access token

回到 LINE Developers Console，打開第 2 章建立的 Provider，會看到剛才啟用的官方帳號的 channel。

1. 1點選標示「Messaging API」的 channel（名稱為官方帳號名稱）。

1. 1「Basic settings（基本設定）」分頁：往下捲動。
2. 2「Messaging API」分頁：之後設定 Webhook 與 Access token 時使用。

1. 1「Channel secret（channel 密鑰）」：按右側的複製圖示，貼到加一購的「LINE Bot 設定 > Channel Secret」。
2. 2「Your user ID（您的使用者 ID，U 開頭）」：貼到加一購的「管理者 LINE User ID」。這是登入 LINE Developers 的 LINE 帳號的 ID，新訂單等通知會傳到這個帳號。

Webhook 設定

1. 1「Webhook URL」：按「Edit（編輯）」，貼上 https://ja1go.net/t/{店家代碼}/webhook 後按「Update（更新）」。
2. 2「Use webhook（使用 Webhook）」：開啟。
3. 3「Allow bot to join group chats（允許加入群組）」顯示「Enabled（已啟用）」即可（第 4 章設定的項目）。

「Verify（驗證）」按鈕要等加一購的設定填好後再按（第 9 章）。

發行 Channel access token

1. 1捲到最下方，「Channel access token (long-lived)（長期權杖）」按「Issue（發行）」。

1. 1按右側的複製圖示，貼到加一購的「LINE Bot 設定 > Channel Access Token」。很長的一串文字，請完整複製。

6. 建立 LINE Login channel

顧客與管理者在 LINE 內開啟加一購的畫面（LIFF）時，會用 LINE Login 自動登入。請在同一個 Provider 中建立。

1. 1在 Provider 的 Channels 分頁按「Create a new channel（建立新的 channel）」，選「LINE Login」。

1. 1「Region to provide the service（提供服務的地區）」：顧客在台灣請選「Taiwan（台灣）」。
2. 2「Company or owner's country or region（公司或負責人所在國家／地區）」：選擇店家所在地。

1. 1「Channel name（channel 名稱）」：顧客登入時會看到，例如「〇〇商店 Login」。
2. 2「Channel description（說明）」：例如「〇〇商店的 LINE 登入」。
3. 3「App types（應用程式類型）」：勾選「Web app（網頁應用程式）」。

1. 1確認「LINE Developers Agreement（LINE 開發者協議）」後勾選同意。
2. 2按「Create（建立）」。

1. 1「Channel ID」：貼到加一購的「LINE Login 設定 > Login Channel ID」。
2. 2「LINE Login」分頁：設定 Callback URL（下方）。
3. 3「LIFF」分頁：建立 LIFF（第 7 章）。

1. 1「Channel secret」：貼到加一購的「LINE Login 設定 > Login Channel Secret」。（與 Messaging API 的 Channel secret 是不同的值，請勿混用）

1. 1「Use LINE Login in your web app（在網頁應用程式使用 LINE Login）」：開啟。
2. 2「Callback URL」：按「Edit」，輸入 https://ja1go.net/t/{店家代碼}/line/callback 後按「Update」。

7. 建立 LIFF（管理者用・顧客用）

LIFF 是在 LINE 內開啟的網頁。加一購需要管理者用與顧客用兩個 LIFF，都建在第 6 章的 LINE Login channel 的「LIFF」分頁。

管理者用 LIFF

1. 1「LIFF app name（名稱）」：例如「〇〇 管理者」。
2. 2「Size（大小）」：選「Full（全螢幕）」。
3. 3「Endpoint URL（端點網址）」：https://ja1go.net/t/{店家代碼}/liff/admin

1. 1「Scopes（權限範圍）」：勾選 openid、profile、chat_message.write。
2. 2「Add friend option（加入好友選項）」：管理者用選「Off（關閉）」。

其他項目保持預設，按最下方的「Add（新增）」。

1. 1按「Add（新增）」可再建立一個（顧客用，下方）。
2. 2「LIFF ID」：管理者用的 LIFF ID 貼到加一購的「LIFF Admin ID」。

顧客用 LIFF

「LIFF app name」例如「〇〇 顧客」，「Size」選「Full」，其餘如下：

1. 1「Endpoint URL」：https://ja1go.net/t/{店家代碼}/liff（結尾沒有 /admin）
2. 2「Scopes」：勾選 openid、profile、chat_message.write。openid 一定要勾選（LINE OC 連線間的登入會用到）。
3. 3「Add friend option」：選「On (Aggressive)（開啟・積極）」，顧客第一次登入時會一併請他加入官方帳號好友。

1. 1顧客用的 LIFF ID → 加一購的「LIFF Customer ID」
2. 2管理者用的 LIFF ID → 加一購的「LIFF Admin ID」

8. 連結官方帳號並公開 LINE Login

連結官方帳號（Add friend option）

1. 1「Linked LINE Official Account（連結的 LINE 官方帳號）」按「Edit」，選擇第 3 章建立的官方帳號。
2. 2按「Update（更新）」。

1. 1顯示官方帳號的 ID 與名稱即完成。

公開 LINE Login channel

剛建立的 LINE Login channel 是「Developing（開發中）」狀態，只有開發者本人能登入。請公開後再讓顧客使用。

1. 1按 channel 名稱下方的「Developing（開發中）」。
2. 2確認說明後按「Publish（公開）」。公開後無法改回開發中。

1. 1顯示「Published（已公開）」即完成。
2. 2Channel ID 可在這裡再次確認。

9. 填入加一購並驗證 Webhook

把第 5〜7 章取得的值填入加一購的「設定 > LINE 設定」，各區塊按「儲存」。畫面說明請看店家使用說明「LINE 設定」。

填好後回到 LINE Developers 的 Messaging API channel > Messaging API 分頁，在 Webhook settings 按「Verify」。

1. 1按「Verify（驗證）」。
2. 2顯示「Success（成功）」即完成。按「OK」關閉。

最後用手機 LINE 加官方帳號為好友，開啟顧客用 LIFF（https://liff.line.me/{顧客用 LIFF ID}），確認能看到商店首頁。

10. 常見問題