Telegram Bot
Telegram Bot — 用于消息、邮件和语音的通信平台。
通讯中等
技术栈组成
ChatTelegram
SDKtelegraf
APIREST
为什么
可编程通信，用于大规模事务性和营销性消息。Twilio 和 SendGrid 驱动 SaaS 90% 的事务性邮件/短信。
Resend 2024 年作为 React Email 友好 API 出现，上线一年内达 1 亿以上邮件/月。
何时使用
用于短信、邮件、推送和应用内聊天。简单联系表单用 Resend。
如何做
1. 创建 Telegram Bot 账户
2. 获取 API 凭证
3. 安装 SDK
4. 发送消息
5. 添加环境配置 — cp .env.example .env && 编辑值
6. 运行测试 — npm test 或 pnpm test 验证设置
7. 部署 — git push 触发 CI/CD 或手动部署
示例
// Telegram Bot 发送
await telegram.messages.create({
to: '+1234567890',
body: 'Hello from Telegram Bot',
});
常见问题
- ⚠Telegram Bot 触发速率限制 — 实现退避和队列
- ⚠投递失败静默 — 设置 {ne} 状态 webhook
- ⚠环境间配置漂移 — 使用基础设施即代码（Terraform/Pulumi）保持 dev/staging/prod 一致
最佳实践
- ✓用 Telegram Bot 模板保持消息一致
- ✓记录 {ne} 消息 ID 以便审计和调试
- ✓设置健康检查和优雅关闭 — 处理 SIGTERM 以在退出前排空进行中的请求
常见问题解答
什么是Telegram Bot？适合做什么项目？
Telegram Bot — 用于消息、邮件和语音的通信平台。 它通过分层组合提供端到端类型安全与开箱即用的部署体验，适合从 MVP 到生产 SaaS 的快速迭代。
如何用Telegram Bot在 10 分钟内跑通一个 demo？
两步起步：① 创建 Telegram Bot 账户；② 获取 API 凭证。先跑通本地 dev server，再接一个真实数据源验证端到端链路。
Telegram Bot 最常见的坑是什么？怎么避免？
最高频的坑是：Telegram Bot 触发速率限制 — 实现退避和队列。避免方法：在 PR 模板里加入对应 checklist，CI 中跑类型检查 + lint + 单测，三重把关再合并。
Telegram Bot 的最佳实践有哪些？
Telegram Bot 的最佳实践包括：用 Telegram Bot 模板保持消息一致；记录 {ne} 消息 ID 以便审计和调试；设置健康检查和优雅关闭 — 处理 SIGTERM 以在退出前排空进行中的请求。其中首条「用 Telegram Bot 模板保持消息一致」应在项目初始化时就落地，避免后期返工。
什么情况下不该选Telegram Bot？
三种情况另选他栈：① 团队对该栈核心框架零经验且工期紧张（学习曲线风险）；② 项目是纯内容/营销站（选 Astro 更轻）；③ 需要极高吞吐（>1 万 RPS）或强一致微服务（选 Go/Rust）。Telegram Bot 的强项是中高复杂度全栈与 API，别在简单静态页上过度工程。