系列四 01|LINE Bot 架構規劃:從單向通知到雙向對話

本篇重點

  • 了解系列四「共同主線+三條分支」的閱讀方式
  • 看懂 LINE、橋接器、HiveMQ、ESP32 四者之間的資料流向
  • 分清楚「回覆」與「推播」:哪一種免費、哪一種吃額度
  • 建立 LINE 官方帳號、啟用 Messaging API,取得兩把金鑰與自己的 userId
  • 準備 Python 開發環境,傳出第一則由程式發送的 LINE 訊息

為什麼要做 LINE Bot?

系列四是本站第二階段「應用整合」的第一個系列。第一階段(系列一~三)我們專注在裝置本身,從這一篇開始,要把做好的系統接上真實的服務與使用者。

到系列三為止,我們已經有兩台 ESP32 在 HiveMQ Cloud 上即時回報資料,也有一個網頁儀表板可以看數據、下指令。但實際用起來會發現:想知道家裡現在幾度,還得打開瀏覽器、找到儀表板網址。

LINE 是台灣人每天都會打開的 App。如果能直接在 LINE 裡輸入「狀態」就收到兩台裝置的最新數據、按一下按鈕就能開燈、溫度異常時自動收到警報,整套系統的實用度會再上一個層次。這就是系列四要做的事。

與系列一的 LINE 通知有什麼不同?

系列一第 07 篇做過「溫度過高時發 LINE 通知」,那是單向的:裝置說話、你只能聽。而且當時常用的 LINE Notify 服務已在 2025 年 3 月 31 日結束,現在要從程式發 LINE 訊息,正規做法就是本系列使用的 LINE Messaging API。

比較項目 系列一:LINE 通知 系列四:LINE Bot
方向 單向(裝置 → 人) 雙向(人 ⇄ 裝置)
能查詢數據嗎 不行 可以,輸入指令即時回覆
能控制裝置嗎 不行 可以,經 MQTT 轉發指令
訊息樣式 純文字 文字、卡片、按鈕、圖文選單
需要伺服器嗎 不需要 需要一個「橋接器」程式

系列四怎麼讀:共同主線+三條分支

LINE Bot 的程式寫好之後,還有一個現實問題:這個程式要放在哪裡全天候執行?放雲端、放自己的電腦、還是讓 ESP32 自己發警報,各有優缺點,也適合不同的讀者。所以系列四分成兩段:前五篇是每個人都要讀的主線,讀完後再依自己的情況挑一條分支。

系列四閱讀路線 01 架構規劃 帳號與環境 02 Webhook 本機開發測試 03 橋接 MQTT 查詢裝置狀態 04 Flex 卡片 圖文選單 05 控制裝置 開燈、送字到 OLED ▲ 共同主線(每位讀者都讀) 分支 A:搬上雲端 Render 部署 不用開電腦,但會休眠 分支 B:本機常駐 電腦/樹莓派+通道 免費穩定,機器要開著 分支 C:ESP32 直接推播 警報不經過橋接器 可與 A 或 B 疊加 ▲ 依需求選讀;選 A 的讀者建議再搭配 C

簡單的選擇原則:

  • 家裡有一台常開的電腦或樹莓派:選分支 B,免費又穩定。
  • 不想讓任何機器一直開著:選分支 A,再搭配分支 C 補強警報。
  • 最在意「警報一定要收到」:無論選 A 或 B,都可以加讀分支 C。

整體架構:中間需要一台「橋接器」

LINE 和 MQTT 是兩個不同的世界:LINE 平台只會用 HTTPS 呼叫你的網址(稱為 Webhook),而 ESP32 的資料都在 HiveMQ 的 MQTT 主題裡。兩邊要對話,中間需要一個同時懂兩種語言的程式,本系列稱它為橋接器(Bridge),用 Python 撰寫。

系列四系統架構 手機 LINE 你和家人 LINE 平台 官方帳號 橋接器 Python+Flask +paho-mqtt HiveMQ MQTT Broker esp32-01 esp32-02 Webhook API MQTT ① 使用者傳「狀態」 ② 查最新數據、組回覆 ③ 平時持續訂閱 iot/#

橋接器有三個工作:

  1. 持續訂閱 HiveMQ 的 iot/#,把每台裝置的最新數據與上線狀態記在記憶體裡。
  2. 接收 Webhook:使用者在 LINE 輸入文字或按按鈕時,LINE 平台會把事件送到橋接器,橋接器查好資料後回覆。
  3. 轉發指令與警報:把「開燈」之類的指令發布到 MQTT 給 ESP32;偵測到數據異常時主動推播給管理員。

好消息是:ESP32 端在主線前四篇完全不用改。系列三的主題結構與 JSON 格式已經很完整,橋接器只要以另一個 MQTT 帳號登入、訂閱同樣的主題就能取得所有資料。只有第 05 篇做控制時,ESP32 才需要加幾行程式。

關鍵觀念:回覆與推播,一個免費一個吃額度

這是設計 LINE Bot 時最重要、也最容易忽略的地方。Messaging API 發訊息主要有兩種方式:

項目 回覆(Reply) 推播(Push)
什麼時候用 使用者先傳訊息或按按鈕,Bot 回應 Bot 在任何時間主動發送
需要什麼 事件附帶的 replyToken(只能用一次,需盡快使用) 對方的 userId
是否計入每月額度 不計入 計入
本系列用途 查詢狀態、控制裝置後的確認訊息 異常警報、裝置離線通知

LINE 官方帳號在台灣的免費方案(輕用量)每月有 200 則主動訊息額度,而且不能加購。200 則聽起來不少,但算一下就知道:

額度試算

200 則 ÷ 30 天 ≈ 每天約 6 則。
如果溫度超標時「每 5 分鐘推播一次」,只要超標 30 分鐘就用掉 6 則,一個下午就能把整個月的額度燒光。
另外要注意:推給 3 位家人,通常是以「發送對象人數」計算,等於一次就用掉 3 則。

所以系列四的設計原則是:

  • 能用回覆就用回覆:查詢、控制都由使用者發起,全部走免費的回覆。
  • 推播只留給真正的警報,而且要加「冷卻時間」,同一種警報在一段時間內只發一次。
  • 警報只推給管理員,不要預設推給所有好友。
  • 程式可以隨時查詢本月已用額度(本篇最後的測試程式就會示範)。

本系列規劃的指令

先把「使用者能做什麼」定下來,後面幾篇就照這張表逐步實作:

使用者輸入 Bot 的動作 發送方式 實作篇
任意文字 原樣回傳(測試用) 回覆 02
狀態 列出所有裝置的最新數據與上線狀態 回覆 03、04
esp32-01 只顯示指定裝置的詳細資料 回覆 03
開燈/關燈 發布指令給 ESP32,並回覆執行結果 回覆 05
顯示 文字內容 把文字送到 esp32-02 的 OLED 回覆 05
(無,自動觸發) 溫度超標、裝置離線時通知管理員 推播 分支 B/C

實作一:建立 LINE 官方帳號並啟用 Messaging API

現在 LINE 已經不能直接在開發者後台建立 Messaging API Channel,流程是先建立 LINE 官方帳號,再到官方帳號的後台啟用 Messaging API,啟用時系統會自動產生對應的 Channel。

※ LINE 後台介面偶爾改版,按鈕名稱可能與下文略有不同,找意思相近的選項即可。

步驟 1:建立 LINE 官方帳號

  1. 到 LINE Developers(developers.line.biz)用自己的 LINE 帳號登入,第一次登入會要求填寫開發者名稱與 Email。
  2. 建立一個 Provider(提供者),名稱可以用網站名稱,例如「IoT 實作筆記」。Provider 選定後無法更改,請想好再按。
  3. 在 Provider 底下選擇建立 Messaging API Channel,畫面會引導你「建立 LINE 官方帳號」,依表單填寫帳號名稱(例如「我家的 IoT 小管家」)、業種等資料後送出。

步驟 2:啟用 Messaging API

  1. 進入 LINE Official Account Manager(官方帳號管理後台),選擇剛建立的帳號。
  2. 點右上角「設定」,左側選「Messaging API」,按「啟用 Messaging API」。
  3. 選擇步驟 1 建立的 Provider,同意條款後完成。此時系統會自動建立 Messaging API Channel。

步驟 3:調整回應設定

官方帳號預設會用「自動回應訊息」回覆每一則訊息,這會跟我們的 Bot 打架。在官方帳號管理後台的「設定 → 回應設定」中:

  • 自動回應訊息:關閉
  • Webhook:開啟(下一篇才會填網址,先打開即可)
  • 加入好友的歡迎訊息:可保留,之後可改成指令說明

步驟 4:取得兩把金鑰與自己的 userId

回到 LINE Developers Console,點進剛產生的 Channel,記下三個值:

名稱 位置 用途
Channel secret Basic settings 分頁 驗證 Webhook 請求真的來自 LINE(下一篇使用)
Channel access token Messaging API 分頁最下方,按 Issue 產生(long-lived) 呼叫 API 發訊息時的通行證
Your user ID Basic settings 分頁下方 你自己的 userId(U 開頭),當作管理員與推播對象

最後,在 Messaging API 分頁掃描 QR code,用手機把這個官方帳號加為好友,否則等一下的測試訊息會發不到你身上。

安全提醒

Channel access token 等同於帳號密碼,拿到它的人就能用你的官方帳號發訊息。絕對不要寫進程式碼、截圖或上傳到 GitHub。萬一外洩,回到同一個位置重新發行(Reissue)即可讓舊的失效。

實作二:為橋接器準備 MQTT 帳號

系列三已經把 HiveMQ 的權限規劃成 iot/#。建議到 HiveMQ Cloud 的 Access Management 為橋接器另外建立一組帳號(例如 linebot-bridge),不要跟 ESP32 或網頁儀表板共用。好處是:

  • MQTT Client ID 與帳號各自獨立,不會互相把對方踢下線。
  • 將來不用橋接器了,只要刪掉這組帳號,不影響其他裝置。
  • 從 HiveMQ 的連線紀錄能一眼看出是誰在連線。

實作三:準備 Python 開發環境

橋接器使用 Python 3.10 以上版本。先建立專案資料夾與虛擬環境,再安裝四個套件:

mkdir linebot-bridge
cd linebot-bridge
python -m venv venv

# Windows
venv\Scripts\activate
# macOS / Linux
source venv/bin/activate

pip install flask line-bot-sdk paho-mqtt python-dotenv
套件 用途
flask輕量網頁框架,負責接收 LINE 的 Webhook
line-bot-sdkLINE 官方 Python SDK(本系列使用 v3 寫法)
paho-mqtt連線 HiveMQ、訂閱與發布 MQTT 訊息
python-dotenv從 .env 檔讀取金鑰,避免寫死在程式裡

建立 .env 設定檔

延續系列三 config.h「設定與程式分離」的精神,所有金鑰放在專案根目錄的 .env 檔:

# LINE
LINE_CHANNEL_SECRET=你的Channel_secret
LINE_CHANNEL_ACCESS_TOKEN=你的Channel_access_token
LINE_ADMIN_USER_ID=U開頭的你的userId

# MQTT(HiveMQ Cloud)
MQTT_HOST=xxxxxxxx.s1.eu.hivemq.cloud
MQTT_PORT=8883
MQTT_USER=linebot-bridge
MQTT_PASS=你的MQTT密碼

同一個資料夾再建立 .gitignore,確保金鑰與虛擬環境不會被上傳:

.env
venv/
__pycache__/

實作四:傳出第一則程式發送的訊息

環境準備好之後,用一支小程式驗證 Channel access token 是否正確:它會讀取官方帳號資訊、查詢本月額度,最後推播一則訊息給你自己。

# check_line.py:驗證 LINE 金鑰並發送第一則測試訊息
import os
from dotenv import load_dotenv
from linebot.v3.messaging import (
    Configuration, ApiClient, MessagingApi,
    PushMessageRequest, TextMessage
)

load_dotenv()
token = os.getenv("LINE_CHANNEL_ACCESS_TOKEN")
admin_id = os.getenv("LINE_ADMIN_USER_ID")

config = Configuration(access_token=token)

with ApiClient(config) as api_client:
    api = MessagingApi(api_client)

    # 1. 讀取官方帳號資訊,確認 token 有效
    info = api.get_bot_info()
    print("官方帳號名稱:", info.display_name)
    print("官方帳號 ID:", info.basic_id)

    # 2. 查詢本月額度與已使用量
    quota = api.get_message_quota()
    used = api.get_message_quota_consumption()
    print("本月額度:", quota.value, "/已使用:", used.total_usage)

    # 3. 推播一則訊息給自己(會用掉 1 則額度)
    api.push_message(PushMessageRequest(
        to=admin_id,
        messages=[TextMessage(text="IoT 小管家上線了!這是程式送出的第一則訊息。")]
    ))
    print("測試訊息已送出,請查看手機 LINE。")

執行方式:

python check_line.py

如果終端機印出官方帳號名稱與額度,而且手機收到訊息,就代表這篇的準備工作全部完成。注意這次測試是推播,所以已用量會多 1 則,正好印證前面講的計費差異。

常見問題

Q1:執行時出現 401 錯誤(Authentication failed)?
Channel access token 貼錯或不完整。token 很長,複製時容易少一截;也確認 .env 裡等號兩邊沒有空白或引號。

Q2:程式顯示成功,但手機沒收到訊息?
最常見的原因是還沒把官方帳號加為好友,或曾經封鎖它。另外確認 LINE_ADMIN_USER_ID 填的是 Developers Console 上的「Your user ID」,不是 LINE 的搜尋 ID。

Q3:用手機傳訊息給官方帳號,它回了一段制式文字?
那是官方帳號的「自動回應訊息」,請回到步驟 3 把它關閉。下一篇接上 Webhook 後,回覆就會改由我們的程式負責。

Q4:一定要用 Python 嗎?
不一定,LINE 也有 Node.js、Java、Go 等官方 SDK。本系列選 Python 是因為語法好讀,也和系列一的 PySpark 分析銜接。觀念都相同,熟悉其他語言的讀者可以自行改寫。

Q5:免費額度用完會怎樣?
推播會失敗,但回覆仍然可以正常使用。這也是為什麼查詢與控制功能都設計成回覆:就算本月額度用光,Bot 還是能查、能控制,只是暫時收不到主動警報。

延伸挑戰

  1. 到官方帳號管理後台修改「加入好友的歡迎訊息」,寫上本系列預計支援的指令清單。
  2. 修改 check_line.py,在推播前先判斷「剩餘額度小於 10 則」就不發送,改印出警告。
  3. 試著用 HiveMQ Cloud 的 Web Client,以 linebot-bridge 帳號訂閱 iot/#,確認新帳號看得到兩台 ESP32 的資料。

下一篇預告

下一篇要讓官方帳號「活起來」:用 Flask 寫出第一個 Webhook 伺服器,驗證 LINE 的簽章、把收到的文字原樣回覆,並透過通道工具讓 LINE 平台連到你電腦上的程式,在本機就能完整開發與測試。

留言

熱門文章