ESP32 環境監測 07:溫度過高時傳 LINE 通知
這是「ESP32 環境監測」系列的第 7 篇。到目前為止,我們都得主動打開試算表才看得到數據。這一篇要讓系統在溫度過高時,主動把警報推播到你的 LINE。
・建立 LINE 官方帳號並啟用 Messaging API
・取得 Channel access token 與你的 User ID
・在 Apps Script 加入警報判斷與冷卻機制,ESP32 程式完全不用改
難度:中等 預估時間:60 分鐘
一、架構:把警報放在 Apps Script
ESP32 可以直接呼叫 LINE 的 API,但那樣你必須把 Channel access token 寫進開發板的程式裡,一旦韌體或程式碼外流,別人就能用你的帳號發訊息。而且每次想改門檻,都得重新燒錄程式。
所以我們把警報判斷放在第 4 篇建立的 Apps Script 裡:
- ESP32 的程式完全不用修改,仍然只負責傳送溫濕度。
- LINE 的密鑰存在 Apps Script 的「指令碼屬性」,不會出現在程式碼或開發板上。
- 門檻與通知間隔,直接在 Apps Script 修改即可。
網路上很多舊教學使用 LINE Notify,但這項服務已在 2025 年 3 月底終止,不能再使用。本篇改用官方持續維護的 Messaging API。
二、需要準備的東西
- 已完成第 4、5 篇(ESP32 會定時把資料送進試算表)
- 一個 LINE 帳號,以及裝有 LINE 的手機
- 能收簡訊的手機號碼(第一次建立官方帳號時,可能需要簡訊認證)
三、設定 LINE 官方帳號與 Messaging API
LINE 的流程在 2024 年 9 月調整過:不能再直接在開發者後台建立 Messaging API 頻道,必須先有官方帳號,再從官方帳號後台啟用 Messaging API。請依下面順序操作。
1. 建立 Provider
- 前往 LINE Developers Console(https://developers.line.biz/console/),用你的 LINE 帳號登入。
- 點「Create new provider」,輸入名稱,例如「ESP32 Lab」,建立。這個名稱只用於後台管理。
2. 建立官方帳號並啟用 Messaging API
- 前往 LINE Official Account Manager(https://manager.line.biz/),建立一個官方帳號。名稱可以取「ESP32 環境監測」,類別隨意選擇,使用免費的「輕用量」方案即可。
- 進入該帳號的後台,點右上角的「設定」,在左側選單找到「Messaging API」,按「啟用 Messaging API」。
- 啟用時會要求選擇 Provider,選剛剛建立的那個。
- 完成後,回到 Developers Console,在該 Provider 底下就會出現這個 Messaging API 頻道。
3. 把官方帳號加為好友
推播只能傳給已經加入官方帳號的好友。在 Developers Console 該頻道的「Messaging API」分頁中有 QR code,用手機的 LINE 掃描,加入好友。
4. 關閉自動回覆(建議)
在官方帳號後台的「設定 → 回應設定」,把「加入好友的歡迎訊息」和「自動回應訊息」關掉,避免你在這個帳號聊天時收到罐頭回覆。這不影響我們的推播。
5. 取得 Channel access token
- 在 Developers Console 開啟頻道,進入「Messaging API」分頁。
- 捲到最下方的「Channel access token (long-lived)」,按「Issue」發行,並複製那一長串文字。
6. 取得你的 User ID
- 同一個頻道,切換到「Basic settings」分頁。
- 捲到最下方找到「Your user ID」,複製。它是 U 開頭、後面接 32 個字元的英數字。
注意這不是你在 LINE 裡設定的「LINE ID」,兩者不一樣。
拿到它的人可以用你的官方帳號發送訊息。請不要把它貼進文章、截圖、公開的 GitHub,也不要寫進 ESP32 的程式。萬一外洩,回到 Messaging API 分頁重新發行,舊的就會失效。
文章中的截圖,Token、User ID 和 Channel secret 都要塗掉。
四、把密鑰存進 Apps Script
- 開啟「ESP32 環境監測」試算表,點「擴充功能 → Apps Script」。
- 左側點「專案設定」(齒輪圖示),往下找到「指令碼屬性」,按「新增指令碼屬性」。
- 新增兩筆:
・屬性:LINE_CHANNEL_TOKEN,值:剛剛複製的 Channel access token
・屬性:LINE_USER_ID,值:你的 User ID - 儲存指令碼屬性。
五、修改 Apps Script 程式碼
把原本 Code.gs 的內容整份換成下面的版本。它包含第 5 篇的功能(驗證、時間戳記、寫入試算表),並新增警報判斷與推播。
// ===== 需要修改的設定 =====
const TOKEN = '請換成你自己的密碼'; // 與 ESP32 相同的密碼
const SHEET_NAME = 'data';
const TEMP_HIGH = 30; // 溫度警報門檻(°C)
const COOLDOWN_MIN = 180; // 兩次通知之間至少間隔幾分鐘
// ==========================
function doGet(e) {
const p = e.parameter;
if (p.token !== TOKEN) {
return ContentService.createTextOutput('unauthorized');
}
const temp = Number(p.temp);
const hum = Number(p.hum);
if (isNaN(temp) || isNaN(hum)) {
return ContentService.createTextOutput('bad data');
}
const ts = Number(p.ts);
const time = (ts > 1600000000) ? new Date(ts * 1000) : new Date();
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME);
if (!sheet) {
return ContentService.createTextOutput('sheet not found');
}
sheet.appendRow([time, temp, hum]);
// 警報失敗不應影響資料寫入,所以用 try/catch 包起來
try {
checkAlert(temp, hum, time);
} catch (err) {
console.error('警報處理發生錯誤:' + err);
}
return ContentService.createTextOutput('ok');
}
// 判斷是否需要發出警報
function checkAlert(temp, hum, time) {
if (temp < TEMP_HIGH) return;
const props = PropertiesService.getScriptProperties();
const last = Number(props.getProperty('LAST_ALERT') || 0);
const now = Date.now();
if (now - last < COOLDOWN_MIN * 60 * 1000) return; // 還在冷卻時間內
const timeText = Utilities.formatDate(time, 'Asia/Taipei', 'yyyy-MM-dd HH:mm:ss');
const text = '⚠️ 溫度警報\n' +
'目前溫度:' + temp + ' °C(門檻 ' + TEMP_HIGH + ' °C)\n' +
'濕度:' + hum + ' %\n' +
'時間:' + timeText;
if (pushLine(text)) {
props.setProperty('LAST_ALERT', String(now)); // 成功才記錄,失敗下次還會再試
}
}
// 透過 LINE Messaging API 推播文字訊息給自己
function pushLine(text) {
const props = PropertiesService.getScriptProperties();
const res = UrlFetchApp.fetch('https://api.line.me/v2/bot/message/push', {
method: 'post',
contentType: 'application/json',
headers: { Authorization: 'Bearer ' + props.getProperty('LINE_CHANNEL_TOKEN') },
payload: JSON.stringify({
to: props.getProperty('LINE_USER_ID'),
messages: [{ type: 'text', text: text }]
}),
muteHttpExceptions: true
});
const code = res.getResponseCode();
if (code !== 200) {
console.error('LINE 推播失敗:' + code + ' ' + res.getContentText());
}
return code === 200;
}
// 手動測試用:在編輯器選這個函式後按「執行」
function testLine() {
const ok = pushLine('測試訊息:ESP32 環境監測已連上 LINE');
Logger.log(ok ? '發送成功' : '發送失敗,請查看執行記錄');
}
程式說明
- checkAlert():溫度沒超過門檻就直接結束;超過了,還要檢查距離上次通知是否已超過冷卻時間,沒有的話就不再發送。
- 為什麼要冷卻機制:溫度一旦超標,ESP32 每分鐘都會送一筆資料,沒有冷卻的話你的手機會被洗版,也會很快用光訊息額度(見下面的提醒)。
- PropertiesService:讀取剛才設定的指令碼屬性,也用來記住「上次通知的時間」。
- UrlFetchApp.fetch():Apps Script 發出 HTTP 請求的方式,這裡呼叫 LINE 的 Push API。
- muteHttpExceptions:讓請求失敗時不會直接丟出例外,而是讓我們讀取回應碼並記錄原因。
- try/catch:即使 LINE 推播失敗,溫濕度資料仍然會正常寫入。
LINE 官方帳號的免費「輕用量」方案,每月可主動發送的訊息數量有限(我撰文時查到是每月 200 則,實際請以 LINE 官方帳號的方案說明為準),每則推播給一位用戶就算 1 則。
最壞的情況是溫度持續超標一整個月,則數大約是「30 × 24 × 60 ÷ 冷卻分鐘數」。冷卻 180 分鐘約為 240 則,超過後推播會失敗。請依實際需求調高冷卻時間,或在下面的延伸挑戰加上每日上限。
六、授權並重新部署
- 編輯器上方的函式選單選 testLine,按「執行」。
- 第一次執行時會要求授權(因為新增了「對外連線」的權限),選擇你的帳號,並依畫面允許。
- 執行完成後,手機的 LINE 應該收到「測試訊息:ESP32 環境監測已連上 LINE」。
- 到「部署 → 管理部署作業」,編輯現有部署,選擇「新版本」,按「部署」。程式碼才會讓 ESP32 呼叫的網址生效。
只儲存程式碼,ESP32 呼叫的仍是舊版本,不會有警報功能。授權新權限之後,也請重新部署新版本。
七、測試警報
不需要真的把感測器加熱,用瀏覽器送一筆假的高溫資料就可以測試。把網址貼進瀏覽器,並換成自己的部署網址與密碼:
https://script.google.com/macros/s/你的部署ID/exec?token=你的密碼&temp=35&hum=60
- 畫面顯示 ok,同時手機會收到溫度警報。
- 馬上再送一次同樣的網址,這次不會再收到通知,因為還在冷卻時間內。這代表冷卻機制正常。
- 測試完,請到試算表把剛才那筆溫度 35 的假資料刪掉,避免影響圖表。
想重複測試,需要重設冷卻
測試期間可以把 COOLDOWN_MIN 暫時改成 1,並重新部署;或到「專案設定 → 指令碼屬性」刪除 LAST_ALERT 這一筆,下次就會立即再通知。正式使用前記得改回合理的冷卻時間。
用真實感測器測試
把 TEMP_HIGH 暫時設成比目前室溫略高的值(例如室溫 27°C 就設 28),用手握住感測器幾十秒讓溫度上升,等待下一筆資料送出,就能測試完整流程。請不要用高溫熱源,避免損壞感測器。
八、常見問題
- testLine 執行成功但手機沒收到:確認你已經把官方帳號加為好友,並確認 User ID 是「Your user ID」,不是 LINE ID。
- 執行記錄顯示 401:Channel access token 貼錯或已失效,請重新發行並更新指令碼屬性。
- 執行記錄顯示 400:通常是 User ID 格式錯誤,或訊息格式有問題。檢查指令碼屬性有沒有多餘的空白。
- 執行記錄顯示 429:可能超過訊息額度,或請求過於頻繁。請檢查官方帳號後台的用量。
- 瀏覽器顯示 ok,但沒有通知:可能還在冷卻時間內,或沒有重新部署新版本。
- 授權視窗跳出「尚未驗證」:這是你自己寫的 Script,點「進階」後選擇繼續即可。
查看錯誤原因的方法:Apps Script 左側點「執行項目」,可以看到每次執行的記錄與 console.error 輸出的內容。
九、延伸挑戰
- 恢復通知:溫度回到門檻以下時,通知「已恢復正常」。注意每則都會消耗額度。
- 每日上限:用指令碼屬性記錄當天已發送的次數,超過上限就不再通知。
- 斷線警報:用 Apps Script 的「觸發條件」每 30 分鐘檢查試算表最後一筆資料的時間,太久沒有新資料就通知你 ESP32 可能離線,這是目前架構的盲點(資料不來就不會觸發警報)。
- 低溫與高濕度警報:加入不同的門檻,並在訊息中說明是哪一種異常。
下一篇預告
感測、傳輸、儲存、圖表、通知,整個 IoT 流程都完成了。系列最後一篇,我們要把累積的資料匯出成 CSV,交給 PySpark 做清洗、彙整與分析,算出每日的平均、最高與最低溫度。
系列:ESP32 環境監測
目錄:系列總整理 | 上一篇:把資料畫成圖表 | 下一篇:用 PySpark 分析環境資料
留言
張貼留言