# Line Bot Lesson 1 - EchoBot
:house: [回筆記首頁](https://www.mirai.tw)
###### tags: `python` `Line` `Bot` `Flask`
[toc]

Line Bot最簡單的範例就是User傳送給 Line Bot 訊息
Line Bot 就會回覆使用相同的訊息.你可以用這個QR-Code試試!

### 1. 取得Line Bot API 程式所需資訊
Line Bot API 運行需要Chanel Secret & Channel Token，
請先登入 https://developers.line.biz/zh-hant/
這裡可用Line掃QR-Code登入。
新增Provider之後，再新增一個channel，把它的Secret和Token複製貼到筆記本內，之後會用到。

Chanel Secret: 在Basic settings選單下面
Chanel Token: 在Messaging API選單下面
若沒出現可以按issue

### 2. 在python中安裝LINE Bot SDK

先將pip昇到最新版
pip install --upgrade pip
再安裝LINE Bot SDK
pip install line-bot-sdk

### 3. 使用Flask建立網站
建立一個echobot.py檔(這個範例使用Flask框架)
並複製以下程式碼, 記得要改成你自己的Token&Secret

LINE_CHANNEL_ACCESS_TOKEN='Your channel token'
LINE_CHANNEL_SECRET='Your channel secret'

from flask import Flask, request
from linebot import LineBotApi, WebhookHandler
from linebot.exceptions import InvalidSignatureError
from linebot.models import MessageEvent, TextMessage, TextSendMessage

app = Flask(__name__)

line_bot_api = LineBotApi(LINE_CHANNEL_ACCESS_TOKEN)
handler = WebhookHandler(LINE_CHANNEL_SECRET)

@app.route("/", methods=["POST"])
def webhook_handler():
    # verify signature if needed
    # add logic to handle the request
    signature = request.headers['X-Line-Signature']
    body = request.get_data(as_text=True)
    try:
        handler.handle(body, signature)
    except InvalidSignatureError:
        raise HTTPException(status_code=400, detail="SignatureError")
    return 'OK'
 
@handler.add(MessageEvent, message=TextMessage)
def handling_message(event):
    line_bot_api.reply_message(event.reply_token,
        TextSendMessage(text=event.message.text))

執行echobot.py的方法(Flask官方的建議方法)  

$ (Linux的bash/csh)
$ export FLASK_APP=echobot.py
$ export FLASK_DEBUG=on

$ (Windows的power shell)
$ $env:FLASK_APP = "echobot"
$ $env:FLASK_DEBUG = "on"

$ (Windows的cmd)
$ set FLASK_APP=echobot
$ set FLASK_DEBUG=on
$ flask run --port 8000

在開發階段可加上debug可使得flask具備Hot reload功能，不需要一直關閉與重啟。  

# 接下來發佈在server上，我們提供3個方法

### A. 使用ngrok產生webhook並填入這個的Webhook URL
用 
[ngrok](https://hackmd.io/@CSL/Hk6aDDQdi)
產生外部鏈結，並在Line的開發網頁中填入這個的Webhook URL (http://URI) 
打開Line，加入這個LineBot，測試一下...
它會在server中出現相關 log(紀錄)

從line_api傳來的message body裡面有
>
"events":
[{
"type":"message",
"message":{"type":"text","id":"17294665296744","text":"ABCD\\nedfg\\ncccc\\nddd"},
"webhookEventId":"01GM8GEBNKYT83GP0QJZXYFJ45",
"deliveryContext":{"isRedelivery":false},
"timestamp":1671027961089,
"source":{"type":"user","userId":"Uc25b496581627ebc921e47b5f6bb5f62"},
"replyToken":"11550933970e4e86aff9f29921463a3b",
"mode":"active"
}]

### B. 使用deta.sh產生webhook並填入這個的Webhook URL
將程式推送到deta.sh中，方法可參閱 
[將LineBot發布到 Deta.sh 中](https://hackmd.io/@CSL/HJcsPvhOj)

我現在所有的linebot都放在這裡......這個bot也是!

### C. 安裝在 Unit/NGINX中
將下面的config.json 寫入unit設定中 ```curl -X PUT --data-binary @config.json --unix-socket /var/run/control.unit.sock http://localhost/config```

{
"listeners": {
"*:80": {
"pass": "routes"
}

},

"routes": [
{
"match": {
"uri": "/static/*"
},

"action": {
"share": "/home/kevin$uri"
}
},

{
"match": {
"uri": "/callback"
},
"action": {
"pass":"applications/callback"
}
},

{
"action": {
"pass": "applications/pythonapp"
}
}
],

"applications": {
"pythonapp": {
"type": "python",
"path": "/home/kevin/app/",
"home": "/home/kevin/env/",
"module": "app",
"user": "kevin",
},
"callback": {
"type": "python",
"path": "/home/kevin/app/",
"home": "/home/kevin/env/",
"module": "callback",
"user": "kevin",
"callable": "app"
}
}
}

參考資料: ![reference]: https://qiu-yan-ming.gitbook.io/python-chatbot/shi-yong-line-bot-sdk