很多团队在搭建内部通知系统时，会优先考虑 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 消息吧。
