先建立 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 會話中完成。指令使用英文半形斜線 / 開頭,每條指令單獨傳送,不要一次傳成一整行。
進入 BotFather。在手機上開啟 MPChat,進入通訊錄,點選「已儲存的群聊」下方的機器人;也可以在 MPChat 內搜尋 BotFather。繼續前先確認會話標題是 BotFather。
啟動 BotFather。你傳送:點選「開始 / Start」,或單獨傳送
/start。成功後會看到:BotFather 回覆一份英文指令選單。沒有回覆時,檢查是否使用英文半形斜線,以及是否誤傳給自己建立的 Bot。開始建立 Bot。你傳送:單獨傳送
/newbot。成功後會看到:類似How are we going to call it?的英文提示,意思是「這個 Bot 叫什麼名字」。接著只輸入使用者會看到的顯示名稱,例如小店客服助手。顯示名稱可以用中文,不是 username。如果沒有進入下一步,回到 BotFather 重新傳送/newbot;不要把顯示名稱和 username 放在同一則訊息。設定 username。成功後會看到:類似
Now let's choose a username的提示,意思是「請設定帳號名稱」。輸入一個尚未被使用的 username:只用英文字母、數字和底線,不要帶開頭的@,例如my_shop_helper_bot;如果頁面要求以bot結尾,請依要求填寫。invalid表示格式不符合要求,請修改字元或結尾;already taken表示已被別人使用,請加上品牌縮寫或數字後重試。顯示名稱仍是「小店客服助手」,username 只是帳號名稱。立即複製 token。username 通過後,BotFather 會回覆建立成功。找到含義為「使用下方 token 存取 HTTP API」的段落,長按並完整複製下一行的 token;不要誤複製 username、
t.me/...Bot 連結或前後的標點。token 常見形狀類似123456789:AA...。看到 token 就表示 Bot 已建立成功。先驗證,再開發。如果你目前只需要 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 語義
欄位 | 含義 |
| 資料向簡介(API short description,≤120)。 |
| 歡迎語:聊天頁頂部居中 +「開始使用」頁(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 中聲明也會高亮可點。
