ntfy 通知設定

ntfy（發音為 notify）是一套開源、以「主題（topic）」為單位的推播通知服務。任何裝置只要訂閱同一個主題，就能收到推播，且可使用官方的 ntfy.sh 或自架伺服器。OrderNotify 可以把訂單與事件通知送到指定的 ntfy 主題。本篇說明如何設定 ntfy 主題並在 OrderNotify 中完成設定。

步驟一：決定並訂閱一個主題（Topic）

  1. 在手機安裝 ntfy App（App Store / Google Play），或使用網頁版 https://ntfy.sh/。
  2. 自訂一個不易被猜到的主題名稱（例如 ordernotify-a8f3k2），並在 App 中「訂閱（Subscribe）」該主題。
  3. 你的主題 URL 就是 https://ntfy.sh/你的主題名稱。若使用自架伺服器，請把網域替換成自己的位址。

提醒：ntfy.sh 上的公開主題任何人只要知道名稱都能收發訊息，因此請使用夠隨機、不易被猜到的主題名稱；若有較高的隱私需求，建議搭配下方的 Access Token 或自架伺服器。

步驟二（選填）：取得 Access Token

如果你的主題設定了存取保護（受保護主題），或使用需要驗證的自架伺服器，就需要一組 Access Token。可在 ntfy 帳號的「Access tokens」頁面建立。若是公開主題則可略過此步驟。

步驟三：在 OrderNotify 新增 ntfy 主題

  1. 進入 OrderNotify 外掛設定頁，找到「團隊頻道」區塊中的「ntfy」。
  2. 在「ntfy 主題」欄位點擊「Add New」新增一組主題。
  3. Name：輸入用來辨識這組主題的名稱，例如「訂單推播」。
  4. Topic URL：填入完整的主題 URL，例如 https://ntfy.sh/你的主題名稱。
  5. Access Token：選填。僅在受保護的主題才需要填入，會以 Bearer token 形式送出。
  6. 儲存設定。如需多個主題，可重複「Add New」新增多組。

步驟四：在推播通知中選用 ntfy

建立或編輯一則推播通知時，在「通知類型（Notify Type）」下拉選單中選擇 ntfy。若只設定了一組主題，選項會顯示為「ntfy」；若設定了多組，則會以「ntfy – 主題名稱」的格式分別列出，選擇要送達的主題即可。

注意事項

  • 通知內容以純文字（text/plain，UTF-8）送出，可搭配 OrderNotify 的合併標籤（merge tag）帶入訂單資訊。
  • 支援自架 ntfy 伺服器，只要 Topic URL 指向你的伺服器位址即可。
  • 若通知未送達，請確認裝置已訂閱正確的主題，且受保護主題的 Access Token 填寫無誤。