接上真的 LINE

1. 在 LINE Official Account Manager 啟用這個帳號的 Messaging API，這時才會建立 Messaging API channel
2. 第一次使用時要填名字與電子郵件，建立開發者帳號
3. 選擇或建立 Provider

Provider 選定後不能更改，也不能取消。 同一個使用者在不同 Provider 底下的 userId 不同，所以同一個單位的服務要放在同一個 Provider。

完成後用同一個帳號登入 LINE Developers Console，點進 Provider，確認看得到這個 channel。

token 有好幾種。long-lived 不會過期，練習時最簡單；重新核發時，舊的就失效。官方的 Building a bot 建議使用可以自訂到期時間的 v2.1 token，正式服務可依官方比較表選擇。

這兩個值等於官方帳號的鑰匙，不可以貼到程式碼、聊天室、截圖或 GitHub。

在 Messaging API 分頁找到 Greeting messages 與 Auto-reply messages，點旁邊的 Edit 會開啟 LINE Official Account Manager，把兩者關閉。

這兩項預設是開啟的。不關的話，使用者會同時收到自動回應和機器人的回覆，你很難分辨是誰回的。如果你有寫 FollowEvent 的歡迎訊息，也要關閉 Greeting messages，否則加好友時會有兩則。

# app.py，和第 2 課相同
import os
from flask import Flask, request, abort
from linebot.v3 import WebhookHandler
from linebot.v3.exceptions import InvalidSignatureError
from linebot.v3.messaging import Configuration, ApiClient, MessagingApi, ReplyMessageRequest, TextMessage
from linebot.v3.webhooks import MessageEvent, TextMessageContent

app = Flask(__name__)
configuration = Configuration(access_token=os.environ['LINE_CHANNEL_ACCESS_TOKEN'])
handler = WebhookHandler(os.environ['LINE_CHANNEL_SECRET'])


@app.route('/callback', methods=['POST'])
def callback():
    signature = request.headers['X-Line-Signature']
    body = request.get_data(as_text=True)
    try:
        handler.handle(body, signature)
    except InvalidSignatureError:
        abort(400)
    return 'OK'


@handler.add(MessageEvent, message=TextMessageContent)
def on_text(event):
    with ApiClient(configuration) as api_client:
        MessagingApi(api_client).reply_message(ReplyMessageRequest(
            reply_token=event.reply_token,
            messages=[TextMessage(text=event.message.text)],
        ))

環境變數只存在於這個終端機視窗，關掉就要重設。macOS、Linux 寫成 export LINE_CHANNEL_SECRET="..."。忘記設定時，程式一啟動就會停下來，這比執行到一半才出錯好：

--debug 開啟除錯模式，只能在自己的電腦上用。畫面上的警告要照做：開發伺服器不可以拿來上線。

LINE 的 Verify 會送一個 events 是空陣列的 POST，伺服器要回 200。你可以自己送一次，分清楚問題在程式還是在網路。伺服器繼續開著，再開一個終端機，同樣設定 LINE_CHANNEL_SECRET：

# check_webhook.py：不經過 LINE，自己送一個和 Verify 相同內容的請求
import base64, hashlib, hmac, os, urllib.error, urllib.request

body = '{"destination":"Utest","events":[]}'.encode('utf-8')
secret = os.environ['LINE_CHANNEL_SECRET'].encode('utf-8')
good = base64.b64encode(hmac.new(secret, body, hashlib.sha256).digest()).decode()

for name, sig in [('正確的簽章', good), ('錯誤的簽章', 'AAAA')]:
    req = urllib.request.Request('http://127.0.0.1:5000/callback', data=body, method='POST',
                                 headers={'Content-Type': 'application/json', 'X-Line-Signature': sig})
    try:
        print(name, urllib.request.urlopen(req).status)
    except urllib.error.HTTPError as e:
        print(name, e.code)

Flask 繼續開著，再開一個終端機。Forwarding 那行的 https 網址就是對外的網址。

依官方文件，帳號會得到一個自動指定的開發網域，重新啟動 ngrok 不會改變。如果你的網址和上次不同，要回 Console 更新 Webhook URL。

這段時間任何人都能連到你的 /callback，這正是第 3 課要驗簽的原因。使用者的訊息會經過 ngrok 的服務，所以只拿來開發，測試完就按 Ctrl+C 關掉，也不要用真實使用者的資料測試。

依官方 Building a bot，在 Console 打開 channel 的 Messaging API 分頁：

1. Webhook URL 旁按 Edit，填入 https://你的名稱.ngrok-free.dev/callback（結尾要有 /callback），按 Update
2. 開啟 Use webhook
3. 按 Verify，成功時會顯示 Success

Webhook URL 必須是 HTTPS，憑證要由瀏覽器普遍信任的憑證機構簽發，自簽憑證不行。ngrok 已經處理好這一點；日後部署到自己的網域要自己準備。

失敗時看下方的常見錯誤表。瀏覽器打開 http://localhost:4040，可以看到 ngrok 收到的每個請求與回應。

用手機掃描 Messaging API 分頁上的 QR code，把官方帳號加為好友，傳一句話，應該會收到一樣的回覆。

同時看三個地方，就能追到每一段：

這是第一次看到真的版面，把前面課程裡的 Flex 卡片也拿來試。

把第 12 課的 app.py、db.py、flex.py 放進資料夾。有三個地方要改：

範例的 ADMIN_KEY 也要換成自己產生的值，放環境變數。

你的電腦關機，機器人就停了。要長期服務，就要部署到有固定網域的伺服器，流程與上線檢查見後端開發軌的部署上線：用 Gunicorn 或 Waitress 執行、前面放 Nginx、申請 HTTPS 憑證。

部署完到 Console 把 Webhook URL 換成正式網址，再按一次 Verify。金鑰在伺服器上一樣放環境變數。SQLite 檔案要放在不會被部署覆蓋的位置，並且要備份。