AHHA
AHHA › 部落格 › 設定 Telegram Bot 接收訂單通知

設定 Telegram Bot 接收訂單通知

2026年4月19日· AHHA

如何設定 Telegram Bot 接收訂單通知（完整教學）

適用對象：已開啟 AHHA 電商模組，希望新訂單即時推播到 Telegram 的店家。

預計時間：5–10 分鐘

成功後：每次有新訂單、顧客回報匯款時，你的 Telegram 會立刻響起通知。

為什麼要用 Telegram？

相較其他推播方式：

  • 免費：比 SMS 便宜，比 LINE Notify 穩定（LINE Notify 已停用）
  • 即時：新訂單數秒內推到手機
  • 可群組：你和員工、外包出貨人員可以在同一個群組看到訂單

步驟 1：建立你的 Bot

  1. 在 Telegram 搜尋並開啟 @BotFather（官方）
  2. 傳送 /newbot
  3. 依提示輸入：
    • Bot 顯示名稱（如「我的店訂單通知」，顧客看不到，純粹你自己辨識用）
    • Bot username（必須以 _bot 或 bot 結尾，如 mystore_order_bot）
  4. BotFather 會回傳一組 Token，格式像：
    123456789:ABCdefGhIJKlmNoPQRsTUVwxYZ1234567890
  5. 複製這組 Token，等下要貼到 AHHA 後台

⚠️ Token 是密碼等級：不要公開貼在任何網頁或 GitHub。AHHA 後台有加密儲存。

步驟 2：取得 Chat ID

Chat ID 是告訴 Bot「訊息要發給誰」的識別碼。兩種方式：

方式 A：個人接收（推薦，最簡單）

  1. 在 Telegram 搜尋你剛建立的 Bot（用你剛設定的 username）
  2. 開啟對話 → 按「開始 / Start」
  3. 傳任意訊息給 Bot（例如「hi」）
  4. 在瀏覽器開這個網址（把 你的TOKEN 換成剛剛那一串）：
    https://api.telegram.org/bot你的TOKEN/getUpdates
  5. 找到 JSON 裡的 "chat":{"id":123456789,…}，那串數字就是你的 Chat ID

方式 B：群組接收（你和員工共用）

  1. 建立一個 Telegram 群組，把 Bot 加入群組
  2. 在群組裡 @你的Bot 傳一則訊息（必須 @ 觸發，Bot 才看得到）
  3. 同樣打開：
    https://api.telegram.org/bot你的TOKEN/getUpdates
  4. 找 "chat":{"id":-100xxxxxxxxxx,…} — 群組 Chat ID 會是負數開頭（含 -100 前綴）
  5. 整串（含 -100）都要複製

步驟 3：貼到 AHHA 後台

  1. 開啟 /dashboard/ecommerce
  2. 捲到「Telegram 訂單通知」區塊
  3. 打開開關
  4. 貼上：
    • Bot Token：步驟 1 拿到的那串
    • Chat ID：步驟 2 拿到的那串（個人正整數或群組負數）
  5. 按「儲存設定」
  6. 按「發送測試訊息」
  7. 若 Telegram 收到「✅ AHHA 電商通知測試成功」就代表 OK

會收到哪些通知？

事件 訊息內容
🛒 新訂單成立 訂單編號、顧客姓名、品項數、金額
💰 顧客回報匯款 訂單編號、金額、末 5 碼

未來「出貨提醒」「退貨申請」等事件也會推到同一個 Chat。

常見問題

Q：測試訊息失敗，顯示「Telegram API error」？

檢查三件事：

  1. Token 複製完整，沒有前後多餘空白
  2. Chat ID 格式正確：
    • 個人：正整數（如 123456789）
    • 群組：負數開頭（如 -1001234567890，要含 -100）
  3. 如果是群組：確認 Bot 已加入群組，且你已 @Bot 觸發過至少一次

Q：Bot 沒回應 /getUpdates？

Telegram 只記錄最近幾則訊息，試這些：

  • 重新傳訊息給 Bot 後馬上開 URL
  • 群組情境下，確認群組設定沒封鎖 Bot 讀取訊息

Q：我可以讓多個店家共用同一個 Bot 嗎？

不建議。每個站台設獨立 Bot，可以：

  • 顯示不同店名
  • 某店關閉通知不影響其他店
  • 換人時可以撤銷單店 Token 不影響其他店

Q：Telegram 被封鎖的地區可以用嗎？

中國、伊朗地區 Telegram 需要翻牆。若店家主要在這些地區，建議改用 Email 通知（AHHA 訂單信箱通知仍照常運作）。

資安建議

  • 定期輪替 Token：在 BotFather 傳 /revoke 即可換新 Token（舊的立即失效）
  • 不要把 Token 傳給技術客服以外的人
  • 群組成員最小化：只加真正需要看訂單的人
  • Bot 設定 privacy mode：BotFather → /setprivacy → Enable（Bot 在群組只看到 @ 自己的訊息）

相關文章

← 返回部落格