一句话结论
简介 / 欢迎语既可在 BotFather 配置,也可用 API:setMyDescription / getMyDescription、setMyShortDescription / getMyShortDescription。产品语义:about = 简介;description = 欢迎语(聊天页顶部居中 +「开始使用」页)。欢迎图目前按 BotFather 流程说明。
总览
BotFather 是 Bot 运营入口。Description 相关 API 管理的是默认(非多语言)资料——见 core.mp.net/bots。
入口
通讯录 → 已保存的群聊下方【机器人】入口,或
在 MPChat 内搜索 BotFather 打开会话。
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).
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 中声明也会高亮可点。
相关
用 /newapp 与 /myapps 创建和管理 MiniApp
用户向:开始使用 Bot
鉴权与撤销模型
