用途：在官方 HTTP Bot API 上构建、扩展或审计 Telegram 机器人，重点处理更新投递、支付、限流与文件等易错环节。资料基于 2026-08-25 阅读的 Bot API 10.3，并提示该 API 约每月更新，引用版本前应查 core.telegram.org/bots/api-changelog。
主要能力：按需加载的深度材料包括 references/updates-and-delivery.md（轮询与 Webhook 的投递契约、顺序、去重与迁移）、references/payments-stars.md（Stars、发票、预结账窗口、退款、订阅）、references/limits-and-files.md（各项已公布限制及应对）、references/frameworks.md（aiogram、grammY、Telegraf、python-telegram-bot 的取舍与隐藏行为）。随附 fixtures/update_delivery.py，含九条正确处理器应满足的不变量及对应失败变体，可用 python3 fixtures/update_delivery.py --self-test 运行，仅用标准库。
必要用法：update_id 是唯一幂等键，应在确认前先写入数据库（主键 INSERT，而非先 SELECT 再 INSERT），工作移出请求路径并由 worker 租约执行；更新仅保留 24 小时。allowed_updates 默认不含 chat_member、message_reaction、message_reaction_count，需显式列出所处理的类型并在新增后重跑 setWebhook。Webhook 需校验 X-Telegram-Bot-Api-Secret-Token 并快速应答；getUpdates 与 Webhook 不可同时使用。429 时按 parameters.retry_after 精确休眠重试，广播需可断点续传。数字商品仅用 Stars（XTR），在 successful_payment 交付，answerPreCheckoutQuery 有 10 秒窗口。getFile 下载上限 20 MB，云 Bot API 上传上限 50 MB。
适用场景与限制：适用于用户添加的机器人；若需读取机器人看不到的历史、以个人身份操作或下载超 20 MB 文件，应改用 MTProto 方案。机器人无法枚举已启动用户，chat_id、user_id、已发消息、Stars 权益、file_id 等均需自行存储。资料未提供具体收费与价格信息。