筆者這幾天因需要, 剛好在研究如何快速建立 Line beacon, 很不巧的是筆者很少寫web app, 加上網路上有各種不清不礎的教學就因此卡關很久.

以下將介紹如何快速實作Line bot with Beacon

[正文開始]

1. 申請heroku 帳號 (heroku sign up
2. 申請 Line bot Message APi 帳號
   
   [秘訣]
   (1) 使用chatbot 就需要選擇Message API, 請不要選錯
   (2) 使用FB 帳戶申請Line account (不需要綁定電話號碼的做法)
   方法有兩種:
   • 使用bluestack 模組器
     參考網頁: Sign up line account without phone number
   • 使用未登入帳號的Line, 就可以註冊一個新帳號
3. 登入LINE@ Manager 後選擇Beacon裝置與Bot的連動
   
   [秘訣] 如果沒有購買Line官方出的Line beacon 裝置的話, 可使用Raspberry Pi 做Line simple beacon 來玩
   可參考: Line Simple Beacon Github
4. 選擇要連動的帳號
5. 輸入Hardware ID/ code
   
   [秘訣] 這兩組資料會在實體的Line Beacon裝置上看到
6. 回到Line Development 後台, 產生兩組token 並記錄下來
   • Channel secret
   • Channel access token (long-lived)
7. 啟用webhook 及設定webhook 網址, 設定完成後按下Update
   
   [秘訣]
   (1) 請在大括號內輸入創建的herokuapp 名稱
   (2) 按下Verify前請先確認heroku APP 是否已經建立完成 (暫時先不按)
8. 使用現成的Golang Line bot Template 佈署到heroku
   
   [秘訣] 這個Github 上面寫的修改原始碼的方式是不能用的, 筆者嘗試過發現無法使用. 需要使用老方法, 直接將Github 的資料clone 下來後才能修改原始碼
9. 輸入Heroku App 名稱, 按下Deploy app 就自動會佈署成功
   
10. 完成後點入Manage APP, 進入頁面, 選擇Settings, 移到Config Vars, 新增以下兩個項目後存檔, 回到步驟7之秘訣2, 按下Verify 就會出現成功
    
11. ChatBot golang 版本這樣就可以使用, 但我們需要修改內容以回應beacon內容
12. Clone Line-bot-template for golang
13. 使用vscode editor 打開main.go
14. 加入關於beacon event 回應的部份, 筆者是在自動回文的上面多加入回應beacon hardware ID
    
    完整程式碼請參考: main.go
15. 設定完後更新heroku app 後就會在line 看到回應
    
16. Golang 版本實作完成

[Python 版本實作如下]
完整程式碼請參考 abeacon

18. 創建heroku app , 名稱設定為abeacon

heroku create abeacon

19. 下載空的abeacon repostiory
    [秘訣] 這邊有很多種作法, 可以不要下載, 直接init 一個也可以, 不過筆者嫌太麻煩. 選擇簡單的做法搞定
20. 打開app.py, 在linebot model 中要載入BeaconEvent
    
21. app.py 中需要新增一個回應beacon的function

@handler.add(BeaconEvent)
def handle_beacon_event(event):
    if event.beacon.hwid == "{your HWId}":
        msg = '{your message 1}'
    else:
        msg = '{your message 2}'

    line_bot_api.reply_message(
        event.reply_token,
        TextSendMessage(text=msg)
* 接收到特定的beacon hwid 後會回應特殊的字串內容, 否則統一回一樣的字串內容

22. 新增app.py/ Procfile/ Requirements.txt
23. 設定好後重新更新heroku app 就可以開始使用Line bot with beacon
    [秘訣] 關於Beacon Event 相關的API 可以在[BeaconEvent] (https://developers.line.me/en/reference/messaging-api/#beacon-event) 查詢
    
24. 當手機打開藍芽及Line 後就會收到Line Beacon
    
    [秘訣] 若收不到Line Beacon , 請先確認Line app 的Location 權限是否有被允許. 由於Beacon 這個技術還是存在部分issue 待解, 如果真的得不到的話, 在正式場合上請記得還是要準備QR Code 以備不時之需

後記:
筆者在做Line beacon 時所搜尋到的Line Bot 都是應用跟變化版的居多或是使用nginx 在本機端自架server的版本. 真的是讓筆者超級傻眼. 心想: 沒有基本款嗎? 無奈之下只好直接實作, 這篇教學文就是這樣出現的, 雖然跟主題系列無關. 但就一起分享囉!!