先创建 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 中声明也会高亮可点。
