跳轉至

如何申請 Telegram Bot 並獲取 Token

TG-FF 對接 Telegram Bot API 時，需要你先創建一個 Telegram 機器人，並從 BotFather 獲取 Bot Token。

本教程會帶你完成：

  1. 找到官方 BotFather
  2. 發送 /newbot 創建機器人
  3. 按提示設置名稱和用戶名
  4. 複製並保存 Bot Token

安全提示

Bot Token 相當於機器人密鑰，不要發給他人，也不要提交到公開倉庫。Token 泄露後，他人可以控制你的機器人。

開始之前，請先準備好

準備項 說明
Telegram 賬號 手機 App、桌面版或 Telegram Web 均可
可聯網環境 需能正常訪問 Telegram
記事本或密碼管理器 用於保存 Bot Token

第一步：找到 BotFather

BotFather 是 Telegram 官方提供的機器人管理工具，所有 Bot 都通過它創建。

  1. 打開 Telegram，點擊頂部 搜索框
  2. 輸入 BotFather
  3. 在結果中選擇帶 藍色認證標記 ✔ 的 BotFather（用戶名 @BotFather）
  4. 點擊進入對話

搜索並打開 BotFather

認準官方賬號

請務必選擇帶認證標記的 @BotFather。不要使用名稱相似的非官方賬號。

第二步：發送 /newbot 創建機器人

進入 BotFather 對話後：

  1. 點擊底部 輸入框
  2. 輸入 /，會彈出 BotFather 的命令菜單
  3. 選擇 /newbot（create a new bot）
  4. 發送該命令

選擇 /newbot 命令

發送後，BotFather 會回覆並提示你設置機器人的 顯示名稱：

發送 /newbot 後設置名稱

其他常用命令

  • /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. 用戶名規則：
  3. 必須 以 bot 結尾（不區分大小寫）
  4. 只能包含英文字母、數字和下劃線
  5. 全局唯一，若已被佔用需換一個
  6. 輸入符合規則的用戶名併發送，例如 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. 立即粘貼到記事本或密碼管理器中保存

複製 Bot Token

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 查看或重新生成

重新生成會使舊 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 用戶交流羣 交流。