很多團隊在搭建內部通知系統時，會優先考慮 Telegram 或 Discord，但如果你面向的是中文用戶，或者需要更低的連接延遲，Potato 其實是一個被低估的選擇。Potato 的 Bot API 與 Telegram 高度兼容，遷移成本極低，而且它的頻道與群組機制足夠支撐從幾十人到幾萬人的消息分發場景。這篇文章會從實際開發角度，聊聊如何用 Potato Bot 發佈新聞和警報，並給出一些踩坑經驗。
先理清架構：Bot、頻道與群組的職責劃分
在動手寫代碼之前，建議先明確三個概念的分工。Potato 的Bot是消息的發送者，通過 HTTP 請求調用 API 即可；頻道是單向廣播渠道，適合新聞推送、系統警報，訂閱者只能閱讀；群組則適合雙向討論，比如用戶反饋群。如果你的場景是「伺服器宕機了要馬上通知運維」，那麼頻道 + Bot 的組合最合適，因為頻道沒有成員上限，而且消息歷史對新人友好。
一個比較推薦的架構是：用 Bot 同時管理一個「新聞頻道」和一個「警報頻道」。新聞頻道每天推送 2-3 條行業資訊或產品更新，警報頻道則只在異常時觸發。兩個頻道分開的好處是，用戶可以根據需要靜音或屏蔽不關心的頻道，而不會錯過關鍵信息。
- Bot Token 獲取：在 Potato 內搜索 @BotFather，發送 /newbot 按提示創建，會得到一串類似 123456:ABC-DEF 的 token，保存好。
- 頻道 ID 獲取：創建頻道後，將 Bot 添加為管理員，然後在頻道內任意發一條消息，請求 getUpdates 接口即可看到 channel_post 中的 chat id（通常為負數）。
- 權限最小化：Bot 只需要「發送消息」和「編輯消息」權限，不要給刪除或封禁權限，避免誤操作。
實戰：用 Python 寫一個 5 分鐘上手的警報 Bot
假設你已經在伺服器上部署了一個 Node.js 服務，希望當 CPU 使用率超過 90% 時，自動向 Potato 警報頻道推送一條帶 emoji 的消息。以下代碼基於 python-telegram-bot 的兼容層封裝（Potato 支持標準 Bot API 的絕大多數方法），你也可以直接用 requests 庫發送 POST 請求。
import requests
token = "你的_BOT_TOKEN"
chat_id = "你的頻道ID"
def send_alert(text):
url = f"https://api.potato.im/bot{token}/sendMessage"
payload = {"chat_id": chat_id, "text": text, "parse_mode": "HTML"}
resp = requests.post(url, json=payload, timeout=5)
return resp.status_code == 200
# 調用示例
send_alert("⚠️ CPU 過高
當前使用率：95%
時間：2024-03-15 14:32:00")
這段代碼的關鍵點在於 parse_mode 設為 HTML，這樣可以在消息裡使用粗體、斜體或內聯鏈接。如果你要推送的是新聞摘要，建議把正文控制在 200 字以內，並附上「閱讀原文」的鏈接，因為 Potato 的消息在移動端會摺疊長文本。
關於頻率控制，Potato 官方對 Bot 有每秒 1 條消息的默認限制（與 Telegram 類似）。對於突發警報，比如 10 台伺服器同時宕機，你的循環發送會觸發 429 錯誤。解決辦法是加一個簡單的隊列，每 0.5 秒發送一條，或者將多條消息合併成一條帶換行符的文本。實測中，單頻道每天推送 500 條以內不會觸發任何風控，但建議把警報聚合為「每 5 分鐘最多 1 條」，否則用戶會直接屏蔽頻道。
進階技巧：定時發佈與按鈕交互
很多新聞類 Bot 需要定時發送，比如每天早上 9 點推送早報。你可以用 APScheduler 或系統 crontab 來觸發你的腳本。這裡有一個小建議：不要用 while True + sleep 常駐進程，因為 Potato 的 Bot 不需要長連接，HTTP 請求是短連接，所以完全可以用 crontab 每 5 分鐘執行一次腳本，檢查是否有待發送的新聞，這樣既省內存又穩定。
另一個實用功能是 Inline Keyboard 按鈕。比如你在警報消息裡加一個「確認」按鈕，運維點擊後，Bot 可以記錄響應時間，這比單純的通知更有價值。實現方式是通過 sendMessage 的 reply_markup 參數傳入 JSON，例如：
buttons = {"inline_keyboard": [[{"text": "我已處理", "callback_data": "ack_001"}]]}
payload["reply_markup"] = json.dumps(buttons)
當用戶點擊按鈕後，Potato 會向你的 Bot 發送一個 CallbackQuery 更新，你只需要在代碼裡監聽並回覆即可。這個模式很適合工單系統或值班確認。
最後提醒一點：無論你的 Bot 多好用，都要在頻道描述裡寫明「如何退訂」或「如何反饋」。Potato 的頻道支持用戶靜音和退出，但明確的指引能減少投訴。如果你維護的是公開新聞頻道，建議開啟「評論」功能（在頻道設置中開啟），讓讀者可以在評論區互動，而不必加入群組。根據我們的測試，開放評論的頻道，其用戶留存率比純廣播頻道高出約 40%。
以上方案已經在多個中小型團隊中驗證過，整體穩定性不錯。如果你還在猶豫是否要切換到 Potato，可以先創建一個測試頻道，用 Bot API 跑通一條消息，感受一下接口響應速度（通常低於 200ms）。對於開發者來說，與其依賴第三方推送服務（如極光或個推），不如直接把通知邏輯放進自己的代碼裡，這樣可控性更強，也省去一筆 SaaS 費用。Potato 的完整 API 文檔可以在官網開發者中心找到，建議先從 sendMessage 和 getUpdates 兩個接口開始。現在就打開 Potato，創建一個頻道並試試你的第一條 Bot 消息吧。
