Hermes Agent 串接 Line Messaging API

 如何用Line聊天室窗，呼叫 Hermes Agent 做事

 

流程大致如下

Line chat(官方帳號) > ngrok tunnel >  Hermes Agent(本地端)

創建一個LIne官方帳號，讓該帳號的後台透過ngrok閘道連線到本地端的Hermes Agent 

1. 先到line developers創立一個Line官方帳號，用個人帳號登入即可

     https://developers.line.biz/

2. 在line developers首頁，直接點選Providers Create，輸入專案名稱

    這邊輸入Hermes Agent ，再點 Create 

3. 左側即可看到剛剛建立的專案，點選Hermes Agent ，右邊切換到Channels分頁

    點選 Create a Messaging API channel 圖示 > 並依步驟建立 LINE Official Account 

    把資料一路填寫完成後，會幫你自動建立一個官方帳號，再來要啟用Messaging API

    

    先點畫面右上的 [設定] > Messaging API > 回應設定

    開啟Webhook，並關閉自動回應訊息，後續Hermes Agent的回應才不會被干擾

    

    接著點畫面右上的 [設定] > Messaging API > 啟用Messaging API 

 

    選擇 Line developers 的專案，即可完成綁定

    這時點回 Line developers 即可發現已經綁定Messaging API 

4. 點進Messaging API頁面取得相關資訊

        

        Channel secret

        Channel access token

5. 開啟ngrok通道

ngrok http 8646

    如果沒有安裝，可以到下方Microsoft Store下載安裝

    ms-windows-store://pdp/?ProductId=9mvs1j51gmk6

    安裝後登入取得Token

    https://dashboard.ngrok.com/get-started/setup/windows

再設定Token

ngrok config add-authtoken "<YOUR_AUTHTOKEN>"

上述設定完成後再輸入以下指令

ngrok http 8646

即可完成，並將出現的外部網址Forwarding紀錄下來

6. 回到Line developers > Messaging API 設置Webhook URL

    將Forwarding資訊設定上去，並於URL尾部加/line/webhook    

7. 開啟 C:\Users\<YourName>\AppData\Local\hermes\.env，於檔案內輸入

LINE_CHANNEL_ACCESS_TOKEN=<Channel access token>
LINE_CHANNEL_SECRET=<Channel secret>
LINE_PUBLIC_URL=<Forwarding>
LINE_ALLOW_ALL_USERS=true
LINE_ALLOWED_USERS=<LineId>

LINE_ALLOW_ALL_USERS = true : 所有人都能使用該聊天

LINE_ALLOWED_USERS=<LineId> : 只有指定的Line ID可以使用該聊天

8. 開啟 C:\Users\<YourName>\AppData\Local\hermes\config.yaml，於檔案內輸入

gateway:
  platforms:
    line:
      enabled: true

9. 完成後執行

hermes gateway run

即可在Line加入好友，嘗試輸入訊息，如此設定就完成了