跳至主要內容

BotFather 指南:簡介、歡迎語、歡迎圖與用戶名規則

說明如何通過 BotFather 以及 setMyDescription / getMyDescription、setMyShortDescription / getMyShortDescription 等 API 配置簡介、歡迎語、短簡介與歡迎圖,並覆蓋用戶名規則與 /start 保留指令。

一句話結論

簡介 / 歡迎語既可在 BotFather 配置,也可用 API:setMyDescription / getMyDescriptionsetMyShortDescription / getMyShortDescription。產品語義:about = 簡介;description = 歡迎語(聊天頁頂部居中 +「開始使用」頁)。歡迎圖目前按 BotFather 流程說明。


總覽

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

入口

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

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

about 與 description 語義

欄位

含義

about / 短簡介

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

description

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

設定 Description(BotFather + API)

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

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

  • 短簡介:setMyShortDescription / getMyShortDescriptionshort_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).

POST https://call.mp.net/bot/bot<token>/setMyDescription
{
"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 為準。

是否回答了您的問題?