如何申请 Telegram Bot 并获取 Token

TG-FF 对接 Telegram Bot API 时，需要你先创建一个 Telegram 机器人，并从 BotFather 获取 Bot Token。

本教程会带你完成：

1. 找到官方 BotFather
2. 发送 /newbot 创建机器人
3. 按提示设置名称和用户名
4. 复制并保存 Bot Token

!!! warning "安全提示" Bot Token 相当于机器人密钥，不要发给他人，也不要提交到公开仓库。Token 泄露后，他人可以控制你的机器人。

开始之前，请先准备好

第一步：找到 BotFather

BotFather 是 Telegram 官方提供的机器人管理工具，所有 Bot 都通过它创建。

1. 打开 Telegram，点击顶部 搜索框
2. 输入 BotFather
3. 在结果中选择带 蓝色认证标记 ✔ 的 BotFather（用户名 @BotFather）
4. 点击进入对话

!!! info "认准官方账号" 请务必选择带认证标记的 @BotFather。不要使用名称相似的非官方账号。

第二步：发送 /newbot 创建机器人

进入 BotFather 对话后：

1. 点击底部 输入框
2. 输入 /，会弹出 BotFather 的命令菜单
3. 选择 /newbot（create a new bot）
4. 发送该命令

发送后，BotFather 会回复并提示你设置机器人的 显示名称：

!!! note "其他常用命令" - /mybots —— 管理已有机器人 - /token —— 重新获取 Bot Token - /revoke —— 撤销当前 Token

第三步：设置名称和用户名

BotFather 会分两步询问：

3.1 设置显示名称

1. BotFather 提示 「How are we going to call it?」 时，输入你想要的 显示名称
2. 显示名称可以包含中文、空格和 emoji，例如 TG-FF Stream Bot
3. 发送消息

3.2 设置用户名

1. BotFather 接着会要求设置 用户名（Username）
2. 用户名规则：
   • 必须 以 bot 结尾（不区分大小写）
   • 只能包含英文字母、数字和下划线
   • 全局唯一，若已被占用需换一个
3. 输入符合规则的用户名并发送，例如 tg_ff_stream_bot

若提示用户名已被占用，换一个名字重试即可。

第四步：复制 Bot Token

用户名设置成功后，BotFather 会返回创建成功的消息，其中包含：

• 机器人链接（形如 t.me/你的用户名）
• HTTP API Token（即 Bot Token）

操作步骤：

1. 找到消息中 「Use this token to access the HTTP API:」 下方的 Token 字符串
2. Token 格式类似 7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3. 点击或长按 Token 后复制
4. 立即粘贴到记事本或密码管理器中保存

!!! warning "Token 请立即保存" 创建成功后请马上复制 Token。若当时没有保存，可向 BotFather 发送 /mybots → 选择你的 Bot → API Token 查看或重新生成。

在 TG-FF 中使用

将复制的 Bot Token 填入 TG-FF 对应配置项并保存即可。

常见问题

用户名必须以 bot 结尾吗？

是的。这是 Telegram 的硬性规则。例如 tg_ff_stream_bot 合法，tg_ff_stream 不合法。

创建时没复制 Token 怎么办？

1. 向 BotFather 发送 /mybots
2. 选择你的机器人
3. 点击 API Token 查看或重新生成

!!! warning "重新生成会使旧 Token 失效" 若旧 Token 已填入 TG-FF 或其他服务，重新生成后需同步更新所有使用处。

Token 泄露了怎么办？

1. 向 BotFather 发送 /revoke，或在 /mybots 中撤销 Token
2. 重新生成新 Token
3. 在 TG-FF 及所有相关服务中更新为新 Token

手机 App 和电脑版操作一样吗？

一样。BotFather 的对话流程在所有 Telegram 客户端上相同，本文以桌面版界面为例，手机端步骤一致。

流程回顾

flowchart LR
    A[搜索 BotFather] --> B[/newbot 创建]
    B --> C[设置名称和用户名]
    C --> D[复制 Bot Token]

按以上步骤操作，你就能完成 Telegram Bot 申请并获取 Token。遇到问题可加入 TG-FF 用户交流群 交流。