Telegram 通知設定

Telegram 是一款跨平台的即時通訊軟體，可以透過 Bot（機器人）自動發送訊息。OrderNotify 使用 Telegram Bot API，把訂單與事件通知送到指定的使用者、群組或頻道。本篇說明如何建立 Bot、取得 Bot Token 與 Chat ID，並在 OrderNotify 中完成設定。

步驟一：透過 BotFather 建立 Bot 並取得 Bot Token

  1. 在 Telegram 中搜尋官方帳號 @BotFather 並開始對話。
  2. 輸入指令 /newbot，依提示輸入 Bot 的顯示名稱與使用者名稱（使用者名稱必須以 bot 結尾）。
  3. 建立成功後，BotFather 會回傳一組 Bot Token，格式類似 123456789:ABC-DEF1234ghIkl-zyx57W2v1u123ew11。請複製並妥善保存。

步驟二：取得 Chat ID

Chat ID 是通知要送達的目標（可以是個人、群組或頻道）。取得方式如下：

  • 送給個人：先與你的 Bot 開始對話並傳送任意訊息，接著在 Telegram 搜尋 @userinfobot 取得你的個人數字 ID。
  • 送到群組：先把 Bot 加入該群組，於群組中傳送一則訊息，再以瀏覽器開啟 https://api.telegram.org/bot<你的Token>/getUpdates，在回傳的 JSON 中找到 chat 的 id（群組 ID 通常為負數）。
  • 送到頻道：把 Bot 設為頻道的管理員，同樣可用 getUpdates 取得頻道 ID。

重要：Bot 必須是該對話（個人 / 群組 / 頻道）的成員，否則無法發送訊息。

步驟三：在 OrderNotify 新增 Telegram 帳號

  1. 進入 OrderNotify 外掛設定頁，找到「團隊頻道」區塊中的「Telegram」。
  2. 在「Telegram 帳號」欄位點擊「Add New」新增一組帳號。
  3. Name：輸入用來辨識這組帳號的名稱，例如「營運群組」。
  4. Bot Token：貼上步驟一取得的 Bot Token。
  5. Chat ID：貼上步驟二取得的 Chat ID。
  6. 儲存設定。如需多個目的地，可重複「Add New」新增多組帳號。

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

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

注意事項

  • 通知內容以純文字形式送出，可搭配 OrderNotify 的合併標籤（merge tag）帶入訂單資訊。
  • Bot Token 等同於操作該 Bot 的鑰匙，請妥善保管，勿公開於前台或版本控制中。
  • 若通知未送達，最常見的原因是 Chat ID 填錯，或 Bot 尚未加入該對話。