跳至主要內容

BotFather 手把手教學:建立 Bot 並取得 token

BotFather 手把手教學:依序傳送 /start 和 /newbot,設定顯示名稱與 username,複製 token,並用 getMe 驗證後設定 Bot 資料。

先建立 Bot,取得 token

第一次建立時,依照 /start → /newbot → 顯示名稱 → username → token 操作,再用 getMe 驗證。簡介、歡迎語和歡迎圖可以等 token 驗證成功後再設定。


總覽

BotFather 是 Bot 運營入口。Description 相關 API 管理的是預設(非多語言)資料——見 core.mp.net/bots。

入口

  • 通訊錄 → 已保存的群聊下方【機器人】入口,或

  • 在 MPChat 內搜索 BotFather 打開會話。

在手機上建立 Bot 並取得 token

最短路徑

依序傳送 /start → /newbot → 輸入 Bot 顯示名稱 → 輸入唯一 username → 複製 token。

以下操作都在手機 MPChat 的 BotFather 會話中完成。指令使用英文半形斜線 / 開頭,每條指令單獨傳送,不要一次傳成一整行。

  1. 進入 BotFather。在手機上開啟 MPChat,進入通訊錄,點選「已儲存的群聊」下方的機器人;也可以在 MPChat 內搜尋 BotFather。繼續前先確認會話標題是 BotFather。

  2. 啟動 BotFather。你傳送:點選「開始 / Start」,或單獨傳送 /start。成功後會看到:BotFather 回覆一份英文指令選單。沒有回覆時,檢查是否使用英文半形斜線,以及是否誤傳給自己建立的 Bot。

  3. 開始建立 Bot。你傳送:單獨傳送 /newbot。成功後會看到:類似 How are we going to call it? 的英文提示,意思是「這個 Bot 叫什麼名字」。接著只輸入使用者會看到的顯示名稱,例如 小店客服助手。顯示名稱可以用中文,不是 username。如果沒有進入下一步,回到 BotFather 重新傳送 /newbot;不要把顯示名稱和 username 放在同一則訊息。

  4. 設定 username。成功後會看到:類似 Now let's choose a username 的提示,意思是「請設定帳號名稱」。輸入一個尚未被使用的 username:只用英文字母、數字和底線,不要帶開頭的 @,例如 my_shop_helper_bot;如果頁面要求以 bot 結尾,請依要求填寫。invalid 表示格式不符合要求,請修改字元或結尾;already taken 表示已被別人使用,請加上品牌縮寫或數字後重試。顯示名稱仍是「小店客服助手」,username 只是帳號名稱。

  5. 立即複製 token。username 通過後,BotFather 會回覆建立成功。找到含義為「使用下方 token 存取 HTTP API」的段落,長按並完整複製下一行的 token;不要誤複製 username、t.me/... Bot 連結或前後的標點。token 常見形狀類似 123456789:AA...。看到 token 就表示 Bot 已建立成功。

  6. 先驗證,再開發。如果你目前只需要 token,安全儲存後可以先停在這裡。需要測試時,跟著首次除錯:手機測試與 Windows/macOS 操作選擇 Windows 或 macOS 步驟;熟悉終端機的開發者也可以閱讀開發者快速接入。呼叫 getMe 後,確認 ok 為 true,且 result.username 是剛才設定的 username。若回傳 401 Unauthorized,通常是 token 複製不完整、無效或已撤銷。安全儲存和外洩處理請參閱token 安全與輪替;聯絡客服時也不要提交真實 token。

Token 安全提醒

token 相當於 Bot 的密碼。不要傳送到聊天群組、截圖、原始碼、工單或公開日誌中。若已經外洩,先在 BotFather 撤銷或輪替 token,再繼續使用。

必做步驟到這裡已經完成

下方的簡介、歡迎語和歡迎圖都屬於可選資料設定。第一次建立 Bot 可以先跳過,等 token 通過 getMe 驗證後再回來設定。

about 與 description 語義

欄位

含義

about / 短簡介

資料向簡介(API short description,≤120)。

description

歡迎語:聊天頁頂部居中 +「開始使用」頁(API description,≤512,含換行)。

設定 Description(BotFather + API)

  • BotFather 會話:按提示為所選 Bot 設定 Description。

  • API:setMyDescription 傳 description(省略/空字符串清除);用 getMyDescription 回讀。

  • 短簡介:setMyShortDescription / getMyShortDescription(short_description ≤120)。

  • 本版本不支持按 language_code 本地化資料;非空 language_code 返回 400。

  • 支持純文本 / URL / emoji;未設定則兩處 UI 皆空。

  • 超長時 BotFather 可能提示:Sorry the description you provided is invalid. A description may not exceed 512 characters (line breaks included).

curl --silent --show-error -X POST "https://call.mp.net/bot/setMyDescription" \
-H "Authorization: Bearer ${MPCHAT_BOT_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"description":"A helpful MPChat bot."}'

Description Picture(BotFather)

  • 顯示在歡迎語下方。狀態:has a description GIF / has a description photo / no description picture。

  • 用 Edit Description Picture 上傳或更換;流程中可用 /empty 刪除。

  • 成功提示示例:Success! Description media updated. You will be able to see the changes within a few minutes.

  • 圖片必須 640×360;GIF 為 320×180 / 640×360 / 960×540。尺寸不符會被 BotFather 拒絕。

  • 有圖時歡迎語與圖同一氣泡、圖在文字上方;超長可滾動。

用戶名規則

  • 不合規會看到 Bot_Username_Invalid / Sorry, this username is invalid.(與其它策略錯誤文案分開)。

  • 刪除 Bot 後,用戶名鎖定 30 天再釋放。

保留指令 /start

/start 是平臺保留指令,即使未在 setMyCommands 中聲明也會高亮可點。

相關

權威來源

Description API 與上限以 core.mp.net/bots 為準。

是否回答了您的問題?