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 修改即可。
溫度警報的資料流程 ESP32 送出溫濕度 Apps Script 寫入試算表 判斷是否超標 LINE 平台 Messaging API 你的手機 收到警報 HTTPS Push 通知 超過門檻,且距離上次通知已過冷卻時間,才會推播
關於 LINE Notify
網路上很多舊教學使用 LINE Notify,但這項服務已在 2025 年 3 月底終止,不能再使用。本篇改用官方持續維護的 Messaging API。

二、需要準備的東西

  • 已完成第 4、5 篇(ESP32 會定時把資料送進試算表)
  • 一個 LINE 帳號,以及裝有 LINE 的手機
  • 能收簡訊的手機號碼(第一次建立官方帳號時,可能需要簡訊認證)

三、設定 LINE 官方帳號與 Messaging API

LINE 的流程在 2024 年 9 月調整過:不能再直接在開發者後台建立 Messaging API 頻道,必須先有官方帳號,再從官方帳號後台啟用 Messaging API。請依下面順序操作。

1. 建立 Provider

  1. 前往 LINE Developers Console(https://developers.line.biz/console/),用你的 LINE 帳號登入。
  2. 點「Create new provider」,輸入名稱,例如「ESP32 Lab」,建立。這個名稱只用於後台管理。

2. 建立官方帳號並啟用 Messaging API

  1. 前往 LINE Official Account Manager(https://manager.line.biz/),建立一個官方帳號。名稱可以取「ESP32 環境監測」,類別隨意選擇,使用免費的「輕用量」方案即可。
  2. 進入該帳號的後台,點右上角的「設定」,在左側選單找到「Messaging API」,按「啟用 Messaging API」。
  3. 啟用時會要求選擇 Provider,選剛剛建立的那個。
  4. 完成後,回到 Developers Console,在該 Provider 底下就會出現這個 Messaging API 頻道。

3. 把官方帳號加為好友

推播只能傳給已經加入官方帳號的好友。在 Developers Console 該頻道的「Messaging API」分頁中有 QR code,用手機的 LINE 掃描,加入好友。

4. 關閉自動回覆(建議)

在官方帳號後台的「設定 → 回應設定」,把「加入好友的歡迎訊息」和「自動回應訊息」關掉,避免你在這個帳號聊天時收到罐頭回覆。這不影響我們的推播。

5. 取得 Channel access token

  1. 在 Developers Console 開啟頻道,進入「Messaging API」分頁。
  2. 捲到最下方的「Channel access token (long-lived)」,按「Issue」發行,並複製那一長串文字。

6. 取得你的 User ID

  1. 同一個頻道,切換到「Basic settings」分頁。
  2. 捲到最下方找到「Your user ID」,複製。它是 U 開頭、後面接 32 個字元的英數字。

注意這不是你在 LINE 裡設定的「LINE ID」,兩者不一樣。

Channel access token 要當成密碼保管
拿到它的人可以用你的官方帳號發送訊息。請不要把它貼進文章、截圖、公開的 GitHub,也不要寫進 ESP32 的程式。萬一外洩,回到 Messaging API 分頁重新發行,舊的就會失效。
文章中的截圖,Token、User ID 和 Channel secret 都要塗掉。

四、把密鑰存進 Apps Script

  1. 開啟「ESP32 環境監測」試算表,點「擴充功能 → Apps Script」。
  2. 左側點「專案設定」(齒輪圖示),往下找到「指令碼屬性」,按「新增指令碼屬性」。
  3. 新增兩筆:
     ・屬性:LINE_CHANNEL_TOKEN,值:剛剛複製的 Channel access token
     ・屬性:LINE_USER_ID,值:你的 User ID
  4. 儲存指令碼屬性。

五、修改 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 則,超過後推播會失敗。請依實際需求調高冷卻時間,或在下面的延伸挑戰加上每日上限。

六、授權並重新部署

  1. 編輯器上方的函式選單選 testLine,按「執行」。
  2. 第一次執行時會要求授權(因為新增了「對外連線」的權限),選擇你的帳號,並依畫面允許。
  3. 執行完成後,手機的 LINE 應該收到「測試訊息:ESP32 環境監測已連上 LINE」。
  4. 到「部署 → 管理部署作業」,編輯現有部署,選擇「新版本」,按「部署」。程式碼才會讓 ESP32 呼叫的網址生效。
別漏掉重新部署
只儲存程式碼,ESP32 呼叫的仍是舊版本,不會有警報功能。授權新權限之後,也請重新部署新版本。

七、測試警報

不需要真的把感測器加熱,用瀏覽器送一筆假的高溫資料就可以測試。把網址貼進瀏覽器,並換成自己的部署網址與密碼:

https://script.google.com/macros/s/你的部署ID/exec?token=你的密碼&temp=35&hum=60
  1. 畫面顯示 ok,同時手機會收到溫度警報。
  2. 馬上再送一次同樣的網址,這次不會再收到通知,因為還在冷卻時間內。這代表冷卻機制正常。
  3. 測試完,請到試算表把剛才那筆溫度 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 分析環境資料

留言

熱門文章