🚀 開始使用：加入第一個頻道

1. 打開「管理頻道」，輸入 ThingSpeak 的 Channel ID。也可以點 QR 碼按鈕掃描他人分享的頻道。
2. 公開頻道不需要任何金鑰；私有頻道請貼上該頻道的 Read API Key（在 ThingSpeak 頻道的「API Keys」分頁）。
3. 加入後即可在儀表板看到每個欄位的圖表。在「時間選項」切換 10 分鐘至 1 週的範圍，在「自動重新整理」設定每 10 秒、30 秒、1 分鐘或 5 分鐘更新一次。
4. 想分享頻道給別人？在頻道上選擇「顯示 QR Code」，對方用 SensorDeck 掃描即可加入。

不需要註冊任何帳號，SensorDeck 直接從 ThingSpeak 讀取資料。

🚀 Getting Started: Add Your First Channel

1. Open Manage Channels and enter your ThingSpeak Channel ID, or tap the QR button to scan a channel someone shared with you.
2. Public channels need no key. For a private channel, paste its Read API Key (found on the channel's "API Keys" tab in ThingSpeak).
3. Each field now appears as a chart on the dashboard. Use Time Options to switch between 10 minutes and 1 week, and Auto-refresh to update every 10 s, 30 s, 1 min or 5 min.
4. To share a channel, choose Show QR Code on it; the other person scans it with SensorDeck.

No account is needed — SensorDeck reads directly from ThingSpeak.

🚀 はじめに：最初のチャネルを追加

1. 「チャネル管理」を開き、ThingSpeak の チャネル ID を入力します。共有された QR コードをスキャンして追加することもできます。
2. 公開チャネルはキー不要です。プライベートチャネルの場合は、ThingSpeak の「API Keys」タブにある Read API Key を貼り付けてください。
3. 各フィールドがダッシュボードにグラフとして表示されます。「表示期間」で 10 分〜1 週間を切り替え、「自動更新」で 10 秒・30 秒・1 分・5 分ごとの更新を設定できます。
4. チャネルを共有するには「QR コードを表示」を選び、相手が SensorDeck でスキャンします。

アカウント登録は不要で、SensorDeck は ThingSpeak から直接データを読み込みます。

🔔 警示規則

在「警示設定」點「新增警示」，選擇頻道、欄位與條件：

• 大於／小於：數值越過門檻時通知（免費版可用）。
• 超出區間／落在區間 專業版：例如濕度不在 35–70% 之間。
• 變化過快 專業版：在指定時間內變化超過設定值，例如 10 分鐘內溫度上升 5°C。
• 無資料（離線） 專業版：感測器超過指定時間沒有回報，可能已斷線或沒電。

進階選項 專業版

• 最短重複間隔：持續異常時，兩次通知至少間隔多久（1 分鐘至 12 小時，預設 5 分鐘）。
• 勿擾時段：例如晚上 11 點到早上 7 點不通知，可跨午夜。
• 恢復通知：數值回到正常或感測器重新回報時通知您。
• 自訂訊息：可使用 {channel} {field} {value} {threshold} {time}，例如 {channel}：{field} 目前 {value}。

每條規則旁的紙飛機按鈕可以立即發送一則測試通知。

🔔 Alert Rules

In Alert Settings, tap Add Alert and pick a channel, a field and a condition:

• Greater than / Less than: notify when a value crosses a threshold (free).
• Outside range / Inside range Premium: e.g. humidity outside 35–70%.
• Rapid change Premium: the value changes by more than an amount within a time window, e.g. +5 °C in 10 minutes.
• No data (offline) Premium: the sensor hasn't reported for a set time and may be disconnected or out of power.

Advanced options Premium

• Repeat at most every: minimum gap between notifications while a problem continues (1 minute to 12 hours, default 5 minutes).
• Quiet hours: e.g. no alerts from 11 PM to 7 AM; ranges can cross midnight.
• Notify when back to normal: get a notice when the value recovers or the sensor reports again.
• Custom message: use {channel} {field} {value} {threshold} {time}, e.g. {channel}: {field} is {value}.

The paper-plane button next to each rule sends a test notification right away.

🔔 アラートのルール

「アラート設定」で「アラートを追加」をタップし、チャネル・フィールド・条件を選びます：

• より大きい／より小さい：値がしきい値を超えたときに通知（無料版で利用可）。
• 範囲外／範囲内 プレミアム：例：湿度が 35〜70% の範囲外。
• 急激な変化 プレミアム：指定時間内の変化量が設定値を超えたとき。例：10 分で 5°C 上昇。
• データなし（オフライン） プレミアム：センサーが一定時間データを送信していないとき。切断や電池切れの可能性があります。

詳細オプション プレミアム

• 再通知の最短間隔：異常が続く間の通知間隔（1 分〜12 時間、初期値 5 分）。
• おやすみ時間：例：23 時〜7 時は通知しない（日付をまたいで設定可）。
• 復旧通知：値が正常に戻ったり、センサーが再びデータを送信したときに通知。
• カスタムメッセージ：{channel} {field} {value} {threshold} {time} が使えます。例：{channel}：{field} は {value}。

各ルールの紙飛行機ボタンで、テスト通知をすぐに送信できます。

📱 主畫面與鎖定畫面小工具

1. 先打開 SensorDeck 一次，讓 App 把頻道與欄位清單提供給小工具。
2. 長按主畫面空白處 → 左上角「編輯」→「加入小工具」→ 搜尋 SensorDeck，選擇小型或中型尺寸。
3. 長按剛加入的小工具 →「編輯小工具」→ 選擇要顯示的感測器。
4. 鎖定畫面：長按鎖定畫面 →「自訂」→ 點小工具區域 → 選 SensorDeck。

免費版可使用小型主畫面小工具；中型與鎖定畫面小工具需要專業版。觸發警示時，小工具會以醒目的方式標示。

📱 Home & Lock Screen Widgets

1. Open SensorDeck once so it can share your channels and fields with the widget.
2. Touch and hold an empty area of the Home Screen → Edit → Add Widget → search for SensorDeck and pick the small or medium size.
3. Touch and hold the new widget → Edit Widget → choose the sensor to show.
4. Lock Screen: touch and hold the Lock Screen → Customize → tap the widget area → choose SensorDeck.

The small Home Screen widget is free. Medium and Lock Screen widgets require Premium. When an alert rule is triggered, the widget highlights it.

📱 ホーム画面・ロック画面ウィジェット

1. まず SensorDeck を一度開き、チャネルとフィールドの一覧をウィジェットに渡します。
2. ホーム画面の空いている場所を長押し →「編集」→「ウィジェットを追加」→ SensorDeck を検索し、小または中サイズを選びます。
3. 追加したウィジェットを長押し →「ウィジェットを編集」→ 表示するセンサーを選びます。
4. ロック画面：ロック画面を長押し →「カスタマイズ」→ ウィジェット欄をタップ → SensorDeck を選びます。

小サイズのホーム画面ウィジェットは無料です。中サイズとロック画面ウィジェットにはプレミアムが必要です。アラート条件に当てはまると、ウィジェットで強調表示されます。

⌚️ Apple Watch App 與錶面複雜功能

1. 在 iPhone 的「Watch」App 安裝 SensorDeck（通常會自動安裝）。
2. 在 iPhone 上打開 SensorDeck 一次，感測器清單就會同步到手錶。之後手錶會自行向 ThingSpeak 取得最新數值。
3. 在手錶上打開 SensorDeck：警報與離線的感測器排在最前面，點進去可看數值、趨勢與最高／最低值。
4. 完成巡查時，手錶會以震動告訴您結果：成功震動代表全部正常，失敗震動代表有異常。
5. 錶面複雜功能：長按錶面 →「編輯」→ 滑到「複雜功能」→ 選擇位置 → SensorDeck。建議使用「模組化」或「資訊圖表」錶面。

免費版的手錶只顯示最需要注意的一個感測器；完整清單與錶面複雜功能需要專業版。

⌚️ Apple Watch App & Complications

1. Install SensorDeck from the Watch app on your iPhone (it usually installs automatically).
2. Open SensorDeck on your iPhone once so the sensor list syncs to the watch. After that, the watch fetches the latest values from ThingSpeak on its own.
3. Open SensorDeck on the watch: sensors with an alert or that are offline are listed first. Tap one to see its value, trend and high/low.
4. When the patrol finishes, a haptic tells you the result — a success tap means all clear, a failure tap means something needs attention.
5. Complication: touch and hold the watch face → Edit → swipe to Complications → pick a slot → SensorDeck. Modular or Infograph faces work best.

On the free version the watch shows the one sensor that needs attention most. The full list and complications require Premium.

⌚️ Apple Watch アプリと文字盤コンプリケーション

1. iPhone の「Watch」App から SensorDeck をインストールします（通常は自動でインストールされます）。
2. iPhone で SensorDeck を一度開くと、センサーの一覧がウォッチに同期されます。その後はウォッチが ThingSpeak から最新値を直接取得します。
3. ウォッチで SensorDeck を開くと、アラートやオフラインのセンサーが先頭に並びます。タップすると値・推移・最大／最小を確認できます。
4. パトロールが終わると触覚で結果を知らせます。成功の振動は「すべて正常」、失敗の振動は「異常あり」です。
5. コンプリケーション：文字盤を長押し →「編集」→「コンプリケーション」までスワイプ → 位置を選んで SensorDeck を選択。「モジュラー」や「インフォグラフ」がおすすめです。

無料版では、最も注意が必要なセンサー 1 つだけが表示されます。全センサーの一覧とコンプリケーションにはプレミアムが必要です。

專業版

🗣️ 捷徑自動化與 Siri

SensorDeck 在「捷徑」App 提供兩個動作，可以組成自動化，也可以直接對 Siri 說：

• 取得感測器讀數：唸出某個感測器的最新數值和更新時間，超出警示門檻或離線時會補一句提醒。
• 檢查我的感測器：一次檢查全部感測器，告訴您有幾個在警示、幾個離線。在捷徑裡還能取用「有異常」「警報數」「離線數」，方便做判斷。

讓感測器幫您做事：三個自動化範例

「取得感測器讀數」會回傳數值，可以接「如果」判斷，再去控制其他 App 或智慧家電。以下範例都在「捷徑」App 建立。

感測器的名稱怎麼決定？

Siri 認得的感測器名稱是「頻道名稱 + 空格 + 欄位名稱」。例如頻道「客廳」的欄位「溫度」，名稱就是「客廳 溫度」。App 裡顯示什麼名稱，Siri 就用什麼名稱；在「管理頻道」修改頻道或欄位名稱後，Siri 會跟著更新。

使用前的準備

1. 確認已購買專業版。如果剛買或剛換手機，請在 App 內點「恢復購買」。
2. 打開 SensorDeck，等要查詢的頻道圖表都載入完成，然後回到主畫面。App 會在這時把感測器清單交給 Siri。
3. Siri 的語言請設為中文（台灣）、English 或日本語，指令要用 Siri 的語言來說。
4. 確認 SensorDeck 已允許搭配 Siri 使用：「設定」→「Siri」（或「Apple Intelligence 與 Siri」）→「App」→ SensorDeck，開啟相關選項。

語音查詢：直接對 Siri 說

• 「用 SensorDeck 取得感測器讀數」（推薦）— 不說名稱，Siri 會反問「哪一個感測器？」，這時用說的回答名稱的一部分即可，例如「台中溫度」、「溼度」或「PM2.5」。只說頻道名稱（例如「台中總部」）時，會把這個頻道的感測器依序念出來（最多 4 個）。也可以說「在 SensorDeck 讀取感測器」。
• 如果 Siri 常把「SensorDeck」聽錯，可以改說中文名稱：「用感測儀表板取得感測器讀數」。
• 「用 SensorDeck 檢查我的感測器」— 一次檢查全部感測器，也適合用來測試 Siri 是否能找到 SensorDeck。
• 「在 SensorDeck 查詢客廳 溫度」— 一句話說完整名稱，適合名稱短又好念的感測器。
• 請照上面的句子說。換成其他說法（例如「查數值」）時，Siri 可能改去搜尋網路，或當成在問「家庭」App 的裝置。

一句話說完整名稱時，Siri 必須把名稱聽得完全正確。名稱很長，或混合英文、數字、符號（例如「辦公室-PMS PM 2.5」）時，Siri 常常聽不準，建議改用「取得感測器讀數」讓 Siri 反問，或自己建立捷徑。回答 Siri 反問時比較寬鬆：會忽略空格、符號與大小寫，也可以只說頻道名稱的一部分加上欄位名稱。

語音查詢：自己建立捷徑（最穩定）

替捷徑取一個好念的名字，之後說「嘿 Siri，捷徑名稱」就會執行，完全不需要 Siri 聽懂感測器名稱。

1. 打開「捷徑」App，點右上角「＋」。
2. 點「加入動作」，搜尋 SensorDeck，選「取得感測器讀數」。
3. 點動作裡藍色的「感測器」，從清單選擇要查詢的感測器（清單是空的，代表還沒完成上面的準備步驟）。
4. 點畫面最上方的捷徑名稱 →「重新命名」，取一個簡短、純中文的名字，例如「客廳溫度」。
5. 點「完成」。先點一下捷徑確認能正常顯示數值，再對 Siri 說「嘿 Siri，客廳溫度」。

一句話同時查詢兩個數值

例如同時聽 PM2.5 和溫度：

1. 建立新捷徑，加入兩個「取得感測器讀數」動作，第一個選 PM2.5 的感測器，第二個選溫度的感測器。
2. 展開這兩個動作（點右側箭頭），把「執行時顯示」關閉，避免 Siri 各唸一次。
3. 加入「文字」動作，輸入「客廳 PM2.5 是 」，接著點鍵盤上方的變數列，插入第一個動作的「感測器讀數」；再輸入「，溫度是 」，插入第二個動作的「感測器讀數」，最後輸入「度」。（插入變數時，如果兩個選項名稱一樣，請點「選取變數」再點畫面上對應的動作。）
4. 加入「顯示結果」動作。透過 Siri 執行時，結果會被唸出來。
5. 把捷徑命名為「客廳空氣」，然後說「嘿 Siri，客廳空氣」。

讓名稱更好念

在 SensorDeck「管理頻道」點頻道的編輯，可以修改頻道名稱與各欄位名稱。這些名稱只存在您的裝置上，不會改到 ThingSpeak。建議：

• 頻道名稱短一點，例如「台中」而不是「台中總部-PMS」；避免使用 -、_、括號等符號。
• 欄位名稱盡量用中文，例如「溫度」「濕度」；「PM 2.5」這類中英數混合的名稱，Siri 比較難聽準。
• 儲存後 Siri 的清單會立即更新。已建立的捷徑不受影響，不需要重選感測器。

新名稱也會用在小工具、Apple Watch 和警示通知上。

問題排除

排查時建議依序測試：① 在「捷徑」App 手動點一下「取得感測器讀數」，確認能取得資料 → ② 對 Siri 說「用 SensorDeck 檢查我的感測器」，確認 Siri 找得到 App → ③ 再測試說出感測器名稱的指令或自建捷徑。這樣可以知道問題出在資料、Siri 找 App，還是感測器名稱。

Premium

🗣️ Shortcuts Automations & Siri

SensorDeck adds two actions to the Shortcuts app. Build automations with them, or say them to Siri:

• Get Sensor Reading: speaks a sensor's latest value and when it was updated, and adds a warning if it's past an alert threshold or offline.
• Check My Sensors: checks every sensor at once and tells you how many are alerting or offline. In Shortcuts you can also use its Has Problems, Alerting and Offline values in conditions.

Put your sensors to work: three automation recipes

Get Sensor Reading returns a number, so you can test it with an "If" and then control other apps or smart-home devices. Build these in the Shortcuts app.

How sensors are named

Siri knows each sensor as "channel name + space + field name". For example, the "Temperature" field of the "Living Room" channel is "Living Room Temperature". Siri uses the same names the app shows; if you rename a channel or field in Manage Channels, Siri follows.

Before you start

1. Make sure Premium is active. If you just bought it or switched phones, tap "Restore Purchases" in the app.
2. Open SensorDeck, wait until the charts for your channels load, then go back to the Home Screen. This is when the app hands its sensor list to Siri.
3. Siri's language should be English, Chinese (Taiwan) or Japanese. Speak the commands in Siri's language.
4. Make sure SensorDeck is allowed to work with Siri: Settings → Siri (or Apple Intelligence & Siri) → Apps → SensorDeck.

Voice: ask Siri directly

• "Check my sensors in SensorDeck". This one needs no sensor name, so try it first to confirm Siri can find SensorDeck.
• "What is Living Room Temperature in SensorDeck", "Get Living Room Temperature from SensorDeck", "Read Living Room Temperature in SensorDeck"
• "Get a sensor reading from SensorDeck". Without a name, Siri asks "Which sensor?"; say part of the name, such as "Living room temperature" or "PM2.5". Saying just a channel name reads every sensor in that channel (up to 4).

When you say the full name in one sentence, Siri must hear it exactly. Long names, or names that mix languages, numbers and symbols (e.g. "Office-PMS PM 2.5"), are often misheard. Use "Get a sensor reading" and let Siri ask, or build your own shortcut. Answers to "Which sensor?" are matched loosely: spaces, symbols and letter case are ignored, and part of the channel name plus the field name is enough.

Voice: build your own shortcut (most reliable)

Give the shortcut an easy name and just say "Hey Siri, shortcut name". Siri never has to understand the sensor name.

1. Open the Shortcuts app and tap + in the top-right corner.
2. Tap Add Action, search for SensorDeck and choose Get Sensor Reading.
3. Tap the blue Sensor placeholder and pick your sensor. If the list is empty, finish the steps under "Before you start" first.
4. Tap the shortcut name at the top → Rename, and give it a short, simple name such as "Living room temperature".
5. Tap Done. Tap the shortcut once to confirm it shows a value, then say "Hey Siri, living room temperature".

Two readings in one sentence

For example, PM2.5 and temperature together:

1. Create a new shortcut with two Get Sensor Reading actions: the first for the PM2.5 sensor, the second for temperature.
2. Expand both actions (tap the arrow) and turn off Show When Run so Siri doesn't read each one separately.
3. Add a Text action. Type "Living room PM2.5 is ", then use the variable bar above the keyboard to insert the first action's "Sensor Reading". Type ", temperature is " and insert the second action's "Sensor Reading". If both variables have the same name, tap Select Variable and tap the matching action.
4. Add a Show Result action. When run from Siri, the result is spoken.
5. Name it "Living room air" and say "Hey Siri, living room air".

Make names easier to say

In SensorDeck, go to Manage Channels and edit a channel to change the channel name and each field name. These names are stored only on your device and don't change ThingSpeak. Tips:

• Keep channel names short, such as "Office" instead of "Office-PMS". Avoid symbols such as -, _ or brackets.
• Use plain words for fields, like "Temperature" or "Humidity". Names that mix letters and numbers, like "PM 2.5", are harder for Siri.
• Siri's list updates as soon as you save. Shortcuts you already built keep working; you don't need to pick the sensor again.

The new names also appear in widgets, on Apple Watch and in alert notifications.

Troubleshooting

Test in this order: ① In the Shortcuts app, run Get Sensor Reading by hand to confirm the data works → ② Say "Check my sensors in SensorDeck" to confirm Siri finds the app → ③ Try the command with a sensor name, or your own shortcut. This tells you whether the problem is the data, Siri finding the app, or the sensor name.

プレミアム

🗣️ ショートカットのオートメーションと Siri

SensorDeck はショートカット App に 2 つのアクションを追加します。オートメーションに組み込むことも、Siri に話しかけることもできます：

• センサーの値を取得：センサーの最新値と更新時刻を読み上げます。しきい値を超えている場合やオフラインの場合はひとこと添えます。
• センサーをチェック：すべてのセンサーをまとめて確認し、アラート中やオフラインの数を伝えます。ショートカットでは「異常あり」「アラート数」「オフライン数」を条件に使えます。

センサーに仕事をさせる：3 つのオートメーション例

「センサーの値を取得」は数値を返すので、「if」で判定して、ほかの App やスマート家電を操作できます。以下はショートカット App で作成します。

センサー名の決まり方

Siri が認識するセンサー名は「チャネル名 + スペース + フィールド名」です。たとえば「リビング」チャネルの「温度」フィールドは「リビング 温度」になります。アプリに表示される名前がそのまま使われ、「チャネル管理」で名前を変えると Siri にも反映されます。

使う前の準備

1. プレミアムを購入済みか確認します。購入直後や機種変更後は、アプリ内で「購入履歴を復元」をタップしてください。
2. SensorDeck を開き、チャネルのグラフが読み込まれたらホーム画面に戻ります。このときセンサー一覧が Siri に渡されます。
3. Siri の言語は日本語、English、中国語（台湾）のいずれかにし、その言語で話しかけてください。
4. SensorDeck が Siri で使えるようになっているか確認します：「設定」→「Siri」（または「Apple Intelligence と Siri」）→「App」→ SensorDeck。

音声：Siri に直接話しかける

• 「SensorDeck でセンサーをチェック」— センサー名が不要なので、まずこれで Siri が SensorDeck を見つけられるか確認してください。
• 「SensorDeck でリビング 温度を確認」「SensorDeck からリビング 温度を取得」「SensorDeck でリビング 温度を読み取る」
• 「SensorDeck でセンサーの値を取得」— 名前を言わないと Siri が「どのセンサーですか？」と聞き返すので、「リビング温度」や「PM2.5」のように名前の一部を話して答えます。チャネル名だけを言うと、そのチャネルのセンサーを順に読み上げます（最大 4 つ）。

一文で名前まで言う場合、Siri はセンサー名を正確に聞き取る必要があります。長い名前や、英字・数字・記号が混ざった名前（例：「オフィス-PMS PM 2.5」）は聞き間違えやすいため、「センサーの値を取得」で聞き返してもらうか、自分でショートカットを作ってください。聞き返しへの答えはゆるく照合され、スペース・記号・大文字小文字は無視され、チャネル名の一部とフィールド名だけでも見つかります。

音声：自分でショートカットを作る（最も確実）

ショートカットに言いやすい名前を付けて「Hey Siri、ショートカット名」と話しかけるだけ。Siri がセンサー名を聞き取る必要はありません。

1. 「ショートカット」App を開き、右上の「＋」をタップします。
2. 「アクションを追加」で SensorDeck を検索し、「センサーの値を取得」を選びます。
3. 青い「センサー」をタップして、センサーを選びます。一覧が空の場合は、先に「使う前の準備」を済ませてください。
4. 画面上部のショートカット名 →「名称変更」で、「リビングの温度」のような短い名前を付けます。
5. 「完了」をタップ。一度タップして値が表示されることを確認してから、「Hey Siri、リビングの温度」と話しかけます。

2 つの値をまとめて聞く

たとえば PM2.5 と温度を一度に聞く場合：

1. 新しいショートカットに「センサーの値を取得」を 2 つ追加し、1 つ目は PM2.5、2 つ目は温度のセンサーを選びます。
2. 両方のアクションを展開（右の矢印をタップ）し、「実行時に表示」をオフにします（別々に読み上げられるのを防ぎます）。
3. 「テキスト」アクションを追加し、「リビングの PM2.5 は 」と入力してから、キーボード上の変数バーで 1 つ目の「センサーの値」を挿入。続けて「、温度は 」と入力し、2 つ目の「センサーの値」を挿入します。同じ名前の変数が並ぶ場合は「変数を選択」から該当するアクションをタップしてください。
4. 「結果を表示」アクションを追加します。Siri から実行すると結果が読み上げられます。
5. 「リビングの空気」と名付け、「Hey Siri、リビングの空気」と話しかけます。

言いやすい名前にする

SensorDeck の「チャネル管理」でチャネルを編集すると、チャネル名と各フィールド名を変更できます。この名前は端末内だけに保存され、ThingSpeak 側は変わりません。おすすめ：

• チャネル名は短く（「オフィス-PMS」より「オフィス」）。-、_、括弧などの記号は避けます。
• フィールド名は「温度」「湿度」のような言葉にします。「PM 2.5」のように英数字が混ざった名前は Siri が聞き取りにくくなります。
• 保存するとすぐに Siri の一覧に反映されます。作成済みのショートカットはそのまま使え、センサーを選び直す必要はありません。

新しい名前はウィジェット、Apple Watch、アラート通知にも使われます。

トラブルシューティング

確認は次の順番がおすすめです：① ショートカット App で「センサーの値を取得」を手動で実行してデータを確認 → ② 「SensorDeck でセンサーをチェック」で Siri がアプリを見つけられるか確認 → ③ センサー名を含むコマンドや自作ショートカットを試す。これで、原因がデータなのか、Siri がアプリを見つけられないのか、センサー名なのかを切り分けられます。

專業版

🤖 Telegram 警示設定

1. 在 Telegram 搜尋 @BotFather，發送 /newbot 建立機器人。
2. 複製 BotFather 提供的 API Token，並對新機器人按下「開始 (Start)」或傳送任意訊息。
3. 在 App 的「Telegram 警示設定」貼上 Token，點「自動偵測 Chat ID」。
4. 使用 Telegram 設定中的「測試」按鈕，確認 Telegram 聊天室收到訊息；此按鈕不會同時測試 iPhone 本機通知。

App 內也有逐步引導的設定精靈。

Premium

🤖 Telegram Alerts Setup

1. In Telegram, search for @BotFather and send /newbot.
2. Copy the API Token BotFather gives you, then press "Start" in your new bot or send it any message.
3. Paste the Token in the app's Telegram settings and tap Auto-detect Chat ID.
4. Use the Test button in Telegram settings to confirm the message reaches your Telegram chat; it does not also test local iPhone notifications.

The app also includes a step-by-step setup wizard.

プレミアム

🤖 Telegram アラートの設定

1. Telegram で @BotFather を検索し、/newbot でボットを作成します。
2. BotFather から届いた API トークンをコピーし、新しいボットで「開始 (Start)」を押すか、任意のメッセージを送ります。
3. アプリの Telegram 設定にトークンを貼り付け、「チャットIDを自動検出」をタップします。
4. Telegram 設定の「テスト」ボタンでチャットへの到着を確認します。このボタンでは iPhone のローカル通知はテストしません。

アプリ内には手順を案内するセットアップウィザードもあります。

專業版

🔗 什麼是萬用 Webhook？ (新手教學)

簡單來說，Webhook 就是「應用程式之間的自動通知線」。

當您的感測器觸發警示時，SensorDeck 會自動撥打一通「情報電話」到您指定的網址（URL）。您可以利用這條線連接到各種平台：

• Discord / Slack：讓警示訊息直接跳出在您的聊天頻道中。
• 自動化平台 (IFTTT / Make.com)：當這通「電話」打來時，您可以設定後續動作，例如：傳送電子郵件、在 Google 表格記錄資料，甚至讓家裡的智慧燈泡變色！

如何開始？ 您只需要從目標平台取得一串 Webhook URL，貼入 App 即可。無需撰寫任何程式碼！

實戰範例：Discord / Slack 整合

1. 進入 Discord 或 Slack 的設定頁面，建立 Webhook 並複製網址。
2. 貼入 SensorDeck 的「萬用 Webhook 設定」。App 會自動偵測並將 JSON 欄位（Key）設定為正確的格式（Discord 為 content，Slack 為 text）。
3. 點擊「發送測試 Webhook」確認對接成功！

對於自定義 API，您也可以手動修改「JSON 內容欄位」（預設為 message）。SensorDeck 會以 JSON 格式 POST 送出訊息，並附上觸發規則的詳細資料（event 為 triggered 或 recovered）：

{
  "message": "頻道「溫室」的 溫度 (°C) 數值為 29.40，已 大於 臨界值 28.00",
  "source": "SensorDeck",
  "event": "triggered",
  "timestamp": "2026-09-25T08:30:00Z",
  "channel_id": 12397,
  "field_key": "field1",
  "condition": ">",
  "threshold": 28,
  "current_value": 29.4
}

Premium

🔗 What is a Universal Webhook? (Beginner's Guide)

In short, a Webhook is an "Automatic Notification Line" between apps.

When your sensor triggers an alert, SensorDeck "calls" the URL you provided and delivers the news. You can use this line to connect with many platforms:

• Discord / Slack: Have alerts pop up directly in your chat channels.
• Automation Tools (IFTTT / Make.com): When this "call" arrives, you can trigger actions like sending an email, logging to a spreadsheet, or even changing the color of your smart bulbs!

How to start? You just need a Webhook URL from your target platform — no coding required.

Example: Discord / Slack

1. Create a Webhook in your Discord or Slack settings and copy its URL.
2. Paste it into SensorDeck's Webhook settings. The app automatically detects the platform and sets the JSON key (content for Discord, text for Slack).
3. Tap Send Test Webhook to confirm it works.

For a custom API, change the JSON Key (default message). SensorDeck POSTs JSON containing the message plus details about the rule (event is triggered or recovered):

{
  "message": "Channel 'Greenhouse' Temperature (°C) is 29.40, which is greater than threshold 28.00",
  "source": "SensorDeck",
  "event": "triggered",
  "timestamp": "2026-09-25T08:30:00Z",
  "channel_id": 12397,
  "field_key": "field1",
  "condition": ">",
  "threshold": 28,
  "current_value": 29.4
}

プレミアム

🔗 汎用 Webhook とは何ですか？ (初心者ガイド)

簡単に言うと、Webhook は「アプリ間の自動通知ライン」です。

センサーがアラートを検知すると、SensorDeck は指定された URL に「自動電話」をかけ、状況を伝えます。このラインを使って様々なプラットフォームと連携できます：

• Discord / Slack：チャットチャンネルにアラートを直接表示させます。
• 自動化ツール (IFTTT / Make.com)：この「電話」がかかってきた時に、メールを送信したり、Google スプレッドシートに記録したり、スマート電球の色を変えたりといった自動操作が可能です。

始め方は？ 連携したいプラットフォームから Webhook URL を取得して貼り付けるだけです。プログラミングは不要です。

例：Discord / Slack との連携

1. Discord または Slack の設定で Webhook を作成し、URL をコピーします。
2. SensorDeck の Webhook 設定に貼り付けます。アプリがプラットフォームを自動認識し、JSON キーを設定します（Discord は content、Slack は text）。
3. 「テスト Webhook を送信」で連携を確認します。

カスタム API の場合は JSON キー（初期値 message）を変更できます。SensorDeck はメッセージとルールの詳細を含む JSON を POST 送信します（event は triggered または recovered）：

{
  "message": "チャネル '温室' の 温度 (°C) が 29.40 になりました。しきい値 28.00 を超過 しています。",
  "source": "SensorDeck",
  "event": "triggered",
  "timestamp": "2026-09-25T08:30:00Z",
  "channel_id": 12397,
  "field_key": "field1",
  "condition": ">",
  "threshold": 28,
  "current_value": 29.4
}

💾 資料保留與 CSV 匯出

資料保留時間（免費版可用）

在「資料管理」選擇裝置上保留多久的資料：6 小時、24 小時（預設）、3 天或 7 天。更早的資料仍保存在 ThingSpeak，查看或匯出時才會下載；設得越短越省空間，並會立即釋放。

CSV 匯出 專業版

1. 在「資料管理」點「匯出 CSV」。
2. 選擇單一頻道或所有頻道，時間範圍可選 24 小時、7 天、30 天，或自訂範圍（最長 366 天）。
3. SensorDeck 會在匯出時才向 ThingSpeak 下載資料，完成後可存到「檔案」或透過 AirDrop、郵件分享。

「清除快取」只會刪除下載的資料，頻道設定（ID、名稱、欄位）會保留。

💾 Data Retention & CSV Export

Data retention (free)

In Data Management, choose how much data to keep on the device: 6 hours, 24 hours (default), 3 days or 7 days. Older data stays on ThingSpeak and is downloaded only when you view or export it. A shorter setting frees space immediately.

CSV export Premium

1. In Data Management, tap Export CSV.
2. Pick one channel or all channels, and a range: 24 hours, 7 days, 30 days, or a custom range of up to 366 days.
3. SensorDeck downloads the data from ThingSpeak on demand, then lets you save it to Files or share it via AirDrop or Mail.

Clear Cache deletes downloaded data only; channel settings (ID, name, fields) are kept.

💾 データ保持期間と CSV 書き出し

データ保持期間（無料版で利用可）

「データ管理」で、端末に保持するデータの期間を 6 時間・24 時間（初期値）・3 日・7 日から選べます。それより古いデータは ThingSpeak に残り、表示や書き出しのときにダウンロードされます。短くするとすぐに空き容量が増えます。

CSV 書き出し プレミアム

1. データ管理で「CSV書き出し」をタップします。
2. 1 つのチャネルまたはすべてのチャネルと、期間（24 時間・7 日・30 日、または最長 366 日のカスタム期間）を選びます。
3. SensorDeck がその場で ThingSpeak からデータをダウンロードし、「ファイル」への保存や AirDrop・メールでの共有ができます。

「キャッシュをクリア」はダウンロードしたデータのみを削除し、チャネル設定（ID・名前・フィールド）は保持されます。