系列四 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 自己發警報,各有優缺點,也適合不同的讀者。所以系列四分成兩段:前五篇是每個人都要讀的主線,讀完後再依自己的情況挑一條分支。
簡單的選擇原則:
- 家裡有一台常開的電腦或樹莓派:選分支 B,免費又穩定。
- 不想讓任何機器一直開著:選分支 A,再搭配分支 C 補強警報。
- 最在意「警報一定要收到」:無論選 A 或 B,都可以加讀分支 C。
整體架構:中間需要一台「橋接器」
LINE 和 MQTT 是兩個不同的世界:LINE 平台只會用 HTTPS 呼叫你的網址(稱為 Webhook),而 ESP32 的資料都在 HiveMQ 的 MQTT 主題裡。兩邊要對話,中間需要一個同時懂兩種語言的程式,本系列稱它為橋接器(Bridge),用 Python 撰寫。
橋接器有三個工作:
- 持續訂閱 HiveMQ 的
iot/#,把每台裝置的最新數據與上線狀態記在記憶體裡。 - 接收 Webhook:使用者在 LINE 輸入文字或按按鈕時,LINE 平台會把事件送到橋接器,橋接器查好資料後回覆。
- 轉發指令與警報:把「開燈」之類的指令發布到 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 官方帳號
- 到 LINE Developers(developers.line.biz)用自己的 LINE 帳號登入,第一次登入會要求填寫開發者名稱與 Email。
- 建立一個 Provider(提供者),名稱可以用網站名稱,例如「IoT 實作筆記」。Provider 選定後無法更改,請想好再按。
- 在 Provider 底下選擇建立 Messaging API Channel,畫面會引導你「建立 LINE 官方帳號」,依表單填寫帳號名稱(例如「我家的 IoT 小管家」)、業種等資料後送出。
步驟 2:啟用 Messaging API
- 進入 LINE Official Account Manager(官方帳號管理後台),選擇剛建立的帳號。
- 點右上角「設定」,左側選「Messaging API」,按「啟用 Messaging API」。
- 選擇步驟 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-sdk | LINE 官方 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 還是能查、能控制,只是暫時收不到主動警報。
延伸挑戰
- 到官方帳號管理後台修改「加入好友的歡迎訊息」,寫上本系列預計支援的指令清單。
- 修改
check_line.py,在推播前先判斷「剩餘額度小於 10 則」就不發送,改印出警告。 - 試著用 HiveMQ Cloud 的 Web Client,以
linebot-bridge帳號訂閱iot/#,確認新帳號看得到兩台 ESP32 的資料。
下一篇預告
下一篇要讓官方帳號「活起來」:用 Flask 寫出第一個 Webhook 伺服器,驗證 LINE 的簽章、把收到的文字原樣回覆,並透過通道工具讓 LINE 平台連到你電腦上的程式,在本機就能完整開發與測試。
系列四:LINE Bot 與裝置互動
📚 系列總整理 |
🗺️ 系列四學習地圖
← 上一篇:系列三 06|裝置管理 |
下一篇:02|第一個 Webhook:本機開發與測試 →
留言
張貼留言