LINE官方帳號整合

1.1 版本

1.2 功能介紹

LINE官方帳號整合功能可以讓排程的推送透過LINE官方帳號傳送給員工，員工可以像在APP中一樣，直接在LINE中查看報表。

在line notify的基礎上，官方賬號整合可以實現使用者直接查看報表，無需進行二次登入。

.
插件獲取方式：

• 填寫 試用報名表 ，會有工作人員聯絡您。 

• 直接掃描下方QR Code，加工作人員line獲取安裝包。

加入我們，試用期間體驗插件，無需支付任何費用。提供高價值反饋和使用場景的小夥伴，正式發佈版本將享受特別優惠！

注：插件在試用過程中有任何問題，可加工作人員line獲取協助。

2.1 註冊和認證官方帳號

註冊官方帳號：https://tw.linebiz.com/account/

認證官方帳號：https://tw.linebiz.com/column/line-lac-id-0418/

不同帳號差異：

注：一般帳號（非認證帳號）、認證官方帳號、企業官方帳號均支援進行Line官方帳號整合。

2.2 準備網路環境

要求1

報表伺服器需要能存取Line伺服器。若報表伺服器在內網，無法存取到Line伺服器的話，支援正向代理配置，地址為https://api.line.me。配置完成後在「Line官方帳號管理>應用管理」中填入代理伺服器地址，如下圖所示：

要求2

1）一般官方帳號

• 報表伺服器一定是可以被外網存取的，並且一定是https的地址。地址舉例:https://xxx.xxx.com:xxx/webroot/decision

2）認證官方帳號&企業官方帳號

• 支援http和https協議的報表伺服器，並且報表伺服器可以不被外網存取，但不能被外網存取時，不可以實現單點效果。

2.3 安裝插件

插件安裝方式，可參考A11-18伺服器-插件管理。

3.1 在Line後台設定訊息傳送應用

3.1.1 登錄Line Developers後台create a new provider

登錄Line Developers：https://developers.line.biz/console/。

具體步驟參考：https://developers.line.biz/en/docs/messaging-api/getting-started/。

3.1.2 建立Message API Channel

登入 LINE Developers，點選【Create a Messaging API channel】，按要求填寫完整後點選【Create】，按提示步驟操作即可。

3.1.3 建立一個LINE Login Channel並發佈

注：訪問報表免登錄需設定此項。

1）登錄Line Developers：https://developers.line.biz/console/，點擊「Create a LINE Login channel」。

2）APP types勾選Web app， 其他必填項按實際情況填寫即可，完成後點擊「Create」。

3）發佈此Channel

3.1.4 LINE Login Channel關聯Messaging API

Login Channel的Basic Setting 中找到 Linked LINE Official Account 屬性，编辑选中新建的Messageing API。

3.1.5 配置Callback URL

在Line後台切換到【LINE Login】選項卡，新增一個Callback URL。注意Callback URL是在決策平台中填入的【報表伺服器地址】的基礎上，新增/v10/line/login/callback字尾組成的。

注：決策平台中填入的報表伺服器地址 與 Callback URL中包含的報表伺服器地址，均需使用可以被外網存取的地址。

3.1.6 設定webhook

注：如使用一般帳號，需設定webhook。

1）登錄官方帳號管理後台：https://manager.line.biz/account/${Bot basic ID}/setting/messaging-api。

2）在Line官方帳號後台的Messaging API中設定Webhook URL並儲存，格式為 報表伺服器地址+“/plugin/public/com.fr.plugin.line.official/webhook?channelId=xxxxxx”。如下圖所示：

注：若配置了Login Channel，此處的channelId須填寫Login API中的channelId。

例如：https://endemo.finereport.com/webroot/decision/plugin/public/com.fr.plugin.line.official/webhook?channelId=123456789。

3）登錄Line Developers：https://developers.line.biz/console/。

4）進入建立好的Messaging API channel，選到Messaging API頁籤。

5）上述配置完成后，「Webhook settings」會自動填充「Webhook URL」，點擊開啟「Use webhook」即可。

3.2 在平台綁定官方帳號

3.2.1 進入【應用管理】介面

以管理員身分登入決策平台，點選【管理系統】→【Line官方帳號管理】，進入【應用管理】介面。

3.2.2 伺服器設定

1）【伺服器地址】就是填寫決策平台可被外網存取的URL。如果伺服器不可以訪問外網，需要先配置正向代理，然後在【代理伺服器地址】填入代理的地址。

2）新增應用

完成后点击保存。

3.3 匹配平台使用者和LINE使用者

3.3.1 进入【成员列表】管理頁面

點選【成員管理】Tab，进入【成员列表】管理頁面。

3.3.2 讀取使用者管道設定

一般帳號只能選擇Line Webhook讀取，認證官方帳號和企業官方帳號可以選擇Line API讀取。「Channel選擇」中選定 3.3.1節 中添加的Channel。

注：「Line Api 讀取」僅適用已驗證或進階帳戶

      「Line Webhook 讀取」適用所有賬戶，存量使用者需要重新關注公眾號（封鎖→解除封鎖）才能讀取。若應用配置修改後，重新同步使用者時無法獲取到部分使用者，請獲取不到的使用者重新關注公眾號後再次進行成員同步。如下圖所示：

平台會根據【應用管理】中錄入的資訊，拉取LINE官方帳號的使用者，此時需要等待數分鐘。

3.3.3 手動匹配平台和LINE使用者

拉取完成後，平台會顯示【Line使用者ID】【Line使用者名稱】【Line使用者狀態】，管理員可以透過這些資訊，將LINE使用者和平台使用者匹配起來。

匹配時，點選【平台使用者】一欄的下拉框，找到對應的平台使用者。下拉框預設顯示10個平台使用者，可以點選【點選載入更多資料】以載入更多使用者，或者直接輸入使用者名稱進行快速查詢。

在下拉框中選擇某一使用者，即可完成匹配，平台會即時錄入匹配結果。

3.3.4 搜尋使用者

如果想要快速查詢某個官方帳號關注者，可以在右側搜尋框中輸入LINE使用者的名稱。

如果想查詢某個匹配到LINE使用者的平台使用者，也可以透過右側搜尋框進行查詢。

3.3.5 取消匹配關係

如果想取消匹配關係，可以下拉後選擇【不選】。

3.3.6 刪除使用者關係

使用者列表每一列最後加一個刪除按鈕，支援刪除使用者關係。

注：透過webhook同步的使用者，可能會發生取消關注的時候無法正確移除使用者的情況，此時需要手動刪除對應的使用者。

3.4 更新使用者

部分企業會產生人員流動，LINE官方帳號的好友也會有增有減，因此需要更新平台使用者和Line好友的綁定列表。如果不進行更新，則平台僅儲存上一次拉取的LINE好友資訊。

注：僅認證官方帳號和企業認證帳號有該設定，一般官方帳號每次進入決策平台即展現最新好友列表。

3.4.1 手動更新

進入【Line官方帳號管理】→【成員管理】介面，點選【更新使用者】按鈕，可以立即更新使用者。

3.4.2 自動更新

1）點選【設定自動更新使用者】按鈕，進入設定視窗。

2）需要先勾選【啟用自動更新】，如果未勾選，即使在下方設定了更新週期，平台也不會執行自動更新。

【更新週期】預設是每天0點，可以修改小時和分鐘。

可以將週期調整為【每週】，然後選擇周幾。

3.5 應用快捷配置

• 生成連結的時候一定要選擇對應企業應用名稱。
  

• 可以生成三種連結：決策平台、單個範本、自訂連結（三種連結均具有Line單點登入效果）

• 應用場景：

  排程管理最後一步「檔案處理>用戶端通知」派送「自訂連結」。可參考文檔：排程管理任務詳細設定步驟；具體應用效果見 本文第4.1節。

  範本訊息事件插件派送。 範本訊息事件插件 可以將該連結派送給行動端使用者，使用者點開後即可存取連結對應的內容。具體應用效果見 本文第4.2節。

           生成連結支援直接在瀏覽器存取（預設走line單點登入邏輯）或做到Line的「選單」功能中。具體應用效果見 本文第5節。

4.1 設定排程任務推送到Line

4.1.1 基礎設定

1）進入【排程管理】，選擇【新增任務】。

2）在【基本設定】步驟中，編輯【預設使用者組】，選擇收取推送的平台使用者。需要事先將平台使用者和LINE使用者進行綁定，後續才能在LINE中收取到推送。

3）繼續下一步，在【排程物件】步驟中，選擇需要推送的範本。

4）繼續下一步，在【調度週期】步驟中，設定任務執行的週期。

5）在【檔案處理】步驟中，勾選【使用者端通知】並勾選【Line官方帳號推送】。

如果同時勾選【APP通知】和【Line官方帳號推送】，則可以再兩個客戶端中都接收推送。

4.1.2 訊息類型

訊息類型	平台設定	效果查看
連結訊息	輸入【主題】和【內容】，這裡和普通排程一樣，支援公式。 預設連結型別可選【定時結果連結】【自訂連結】。 注：使用【定時結果連結】，則使用者在LINE收到推送後，可以免去登入直接查看報表。如果連結是【自訂連結】，並且輸入了某個報表的訪問URL，使用者在LINE收到推送後，需要手動登入後才能查看報表。 點選【儲存】儲存任務，任務執行後，使用者可以透過LINE接收推送。
圖文訊息	【訊息類型】可更改為【圖文訊息】，更改後，可上傳一張封面圖。 【儲存】並執行任務，使用者可以透過LINE接收圖文推送。點選推送訊息的任意位置後，可以直接在LINE中查看報表。 注1：如果不上傳封面圖，則LINE推送的圖片部分會是空白的。 注2：如果更改封面，則以前傳送過的圖文訊息中，圖片部分會消失。 注4：建議管理員在完成使用者匹配後，參考本節的步驟設定一份測試排程。如果推送失敗，或是使用者在LINE中無法直接開啟報表，需要先檢查【應用管理】中錄入的資訊是否準確。
圖片訊息	【儲存】並執行任務，使用者可以透過LINE接收推送。 報表內容將以圖片形式傳送。
檔案訊息	注：由於LINE API的限制，暫不支援向LINE推送檔案訊息。	/

4.2 設定範本訊息事件推送到Line公眾號

4.2.1 範本設定

1）輸入接收訊息的使用者名稱、角色、部門

2）勾選Line Official派送

3）選擇對應的line Official應用，將【應用快捷配置】處生成的連結拷貝到【連結】處，填寫標題和內容。

4.2.2 效果查看

4.3 設定數據預警任務推送到Line公眾號

4.3.1 任務設定

數據預警詳細操作步驟請參考：數據預警插件使用說明 。

4.3.2 效果查看

5.1 直接在瀏覽器存取

複製連結後可直接在瀏覽器開啟，預設以同Line使用者綁定的平台使用者登入，如下圖所示：

5.2 Line「選單」存取

5.2.1 設定 LINE 圖文選單

注：具體操作步驟可參考：Line官方賬號操作手冊 。

1）利用「LINE Business ID」進行登入。

2）登入管理頁面後，於帳號一覽中選擇要進行圖文選單設定的 LINE 官方帳號。

3）在左側欄位點選展開「聊天室相關」選單，並點選「圖文選單>建立圖文選單」。

4）依次填入對應內容，動作類型選擇「連結」，填入「快捷應用配置」中生成的連結，全部填寫完成後點擊「儲存」。

5.2.2 效果範例