跳转到主要内容

BotFather 手把手教程:创建 Bot 并获取 token

BotFather 手把手教程:依次发送 /start 和 /newbot,设置显示名称与 username,复制 token,并用 getMe 验证后配置 Bot 资料。

先创建 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 会话中完成。指令使用英文半角斜杠 / 开头,每条指令单独发送,不要一次发成一整行。

  1. 进入 BotFather。在手机上打开 MPChat,进入通讯录,点击「已保存的群聊」下方的机器人;也可以在 MPChat 内搜索 BotFather。继续前先确认会话标题是 BotFather。

  2. 启动 BotFather。你发送:点击“开始 / Start”,或单独发送 /start。成功后会看到:BotFather 回复一份英文指令菜单。没有回复时,检查是否使用英文半角斜杠,以及是否误发给了自己创建的 Bot。

  3. 开始创建 Bot。你发送:单独发送 /newbot。成功后会看到:类似 How are we going to call it? 的英文提示,意思是“这个 Bot 叫什么名字”。接着只输入用户会看到的显示名称,例如 小店客服助手。显示名称可以用中文,不是 username。如果没有进入下一步,回到 BotFather 重新发送 /newbot;不要把显示名称和 username 合在一条消息里。

  4. 设置 username。成功后会看到:类似 Now let's choose a username 的提示,意思是“请设置账号名”。输入一个没有被占用的 username:只用英文字母、数字和下划线,不要带开头的 @,例如 my_shop_helper_bot;如果页面要求以 bot 结尾,请按要求填写。invalid 表示格式不符合要求,请修改字符或结尾;already taken 表示已被别人使用,请加上品牌缩写或数字后重试。显示名称仍然是“小店客服助手”,username 只是账号名。

  5. 立即复制 token。username 通过后,BotFather 会回复创建成功。找到含义为“使用下面的 token 访问 HTTP API”的段落,长按并完整复制它下一行的 token;不要误复制 username、t.me/... Bot 链接或前后的标点。token 常见形状类似 123456789:AA...。看到 token 就表示 Bot 已创建成功。

  6. 先验证,再开发。如果你现在只需要 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 语义

字段

含义

about / 短简介

资料向简介(API short description,≤120)。

description

欢迎语:聊天页顶部居中 +「开始使用」页(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 中声明也会高亮可点。

相关

权威来源

Description API 与上限以 core.mp.net/bots 为准。

这是否解答了您的问题?