适合谁
适合第一次接触 Fly Bot 的开发者，也适合只拿到公开资料就要生成接入代码的 AI Agent。
用最短路径把 Fly Bot 跑起来。
从创建 Bot 到第一条回复，只保留开发者真正需要的内容。
当前站点聚焦首轮接入主路径：创建 Bot、获取 token、选择 Polling 或 Webhook、接收 Update、发送消息、完成排障。
你能做什么
创建 Bot，使用 Polling 或 Webhook 接收消息事件，调用发送接口回消息，理解群聊和权限边界。
本期站点范围
当前以纯静态文本网站承载文档内容，不提供控制台、在线调试、在线 token 管理或日志面板。
推荐接入路径
优先从 Polling 开始，本地更容易跑通首轮接入链路；Webhook 适合已有公网 HTTPS 服务的开发者。
你会在这里得到什么
- 最短接入主线，不需要先读产品总纲或验收文档。
- 核心接口的请求示例、字段语义和限制条件。
- Polling 与 Webhook 两条路径的取舍说明。
- Webhook 签名、幂等、群聊默认规则的统一口径。
- 面向陌生开发者和 AI Agent 的可执行示例。
接入前先知道
- Bot 创建、配置和自检的主入口在 App 内的 BotFather。
- Webhook 和 Polling 不是并行主路径，启用 Webhook 后 Polling 可能拿空数组。
- 群聊默认不是全量监听；通常只有 @Bot 或指定命令才会投递。
- 发送接口建议总是带上
client_msg_id，否则排查重复发送会很痛苦。
接入主线
- 在 App 内通过 BotFather 创建 Bot，拿到 `bot_token`。
- 先用 Polling 跑通首次 Echo 回复。
- 需要公网回调时再切到 Webhook。
- 阅读 API Reference 和协议页面，确认字段、幂等和限制条件。
- 如果遇到空更新、群里不触发、发送失败，先看排障中心。
当前覆盖能力
| 能力 | 当前站点提供什么 | 开发者应如何使用 |
|---|---|---|
| Bot 创建 | 说明通过 BotFather 创建、拿 token、保管 token 的流程。 | 先在 App 内创建，再回来读快速开始。 |
| Polling | 提供拉取 Update 的请求形态、offset 语义和 Python 示例。 | 优先用它完成第一次联调。 |
| Webhook | 提供签名、重放窗口、最小服务端示例和排障说明。 | 已有公网 HTTPS 时再切换。 |
| 消息发送 | 提供 s/bot/send 的最小入参和幂等建议。 |
总是带 client_msg_id。 |
| 治理边界 | 明确 private/public、mention_only、门禁和签名校验的口径。 | 不要把默认限制误判成接口故障。 |
首批页面
| 页面 | 作用 |
|---|---|
| 快速开始 | 带你在 10 分钟内跑通第一次 Echo 回复。 |
| API Reference | 提供 `s/bot/updates`、`s/bot/send` 等核心接口的请求与响应示例。 |
| Webhook / Update 协议 | 说明事件结构、签名、去重和关键字段。 |
| 示例中心 | 集中提供 Polling / Webhook / 验签的可运行脚本入口。 |
| 排障中心 | 集中说明互斥关系、门禁、常见错误和排查顺序。 |