开发文档

Telegram Bot Webhook、长轮询与部署

选择长轮询、Webhook 或 Telegram Serverless,理解证书、接收确认、重试与业务队列的边界。

GetTGAPI 编辑团队更新于
文档解读核对日期

依据官方资料整理,由 GetTGAPI 独立维护。 文档目录与术语表 →

本页内容
  1. 选择一个更新入口
  2. 收到后先可靠保存
  3. Serverless 是另一种部署选择
  4. 运维验收

选择一个更新入口

Bot 可通过长轮询或 Webhook 接收更新。Webhook 需要可达的 HTTPS 地址、匹配的证书及完整证书链。允许的端口与网络条件应查看当前官方指南;自签证书则需要按接口要求上传公有证书,绝不能上传私钥。

收到后先可靠保存

建议将验签或来源校验、事件去重和入队放在短请求内完成,再由业务处理器执行较慢任务。HTTP 接收成功不等于后续申请、付款或回复已经完成;应分别记录状态。

Serverless 是另一种部署选择

Telegram Serverless 提供模块、数据库和部署工作流,可作为无需自管 VPS 的方案。它与自建 Webhook 的运行约束不同,部署前应核对当前版本、运行限制、数据迁移和回滚方式。

运维验收

测试重复更新、接收后进程退出、发送超时和证书续期。设置队列积压与失败告警;Token 和 Webhook 秘密不进入 URL 访问日志或错误页面。切换入口前先明确未处理更新的去向,避免两个消费者同时竞争或丢弃历史事件。