跳转到主要内容

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 为准。

这是否解答了您的问题?