创建机器人与接入教程

【在哪里创建】机器人是在 Telegram 应用里创建的。 ① 在手机或电脑打开 Telegram，登录自己的个人账号；还没有账号时先完成 Telegram 注册。 ② 点击搜索框或放大镜，搜索 @BotFather。核对准确用户名为 @BotFather，不要只看显示名称；也可点击本步骤下方“打开 BotFather”。 ③ 若浏览器询问是否打开 Telegram，选择打开。进入 BotFather 私聊后点击“开始 / Start”；已经开始过可以跳过。 ④ 在它的聊天输入框发送 /newbot，等待它询问机器人名称。

【在 BotFather 中填写名称】 ① 它询问名称时，发送希望别人看到的显示名称，例如“我的群助手”；可以使用中文。 ② 接着询问 username，再发送唯一用户名，例如 msh_demo_2026_bot。使用英文字母、数字或下划线，并以 bot 结尾。 ③ 提示 already taken 表示被占用，换一个再发；示例只是演示，不保证可注册。成功后会收到机器人链接和 Token。

【仍在 BotFather 中复制 Token】 在创建成功回复里找到“Use this token to access the HTTP API”下方的一长串字符，复制完整内容，包括中间的英文冒号。不要复制 t.me 链接或 @用户名。 下方只是格式示例，不能使用。Token 相当于机器人的控制密码，只粘贴到本站接入框，不要发群里或发给客服。它不是 TG 登录验证码或 AI API Key。

【回到 MSH 网站接入】 ① 用邮箱注册并登录 MSH，打开“我的机器人”。 ② 点击“接入机器人”，粘贴刚才复制的完整 Token，再点击“验证并接入”。 ③ 成功后页面显示机器人名称和 @用户名。提示 Token 无效时检查是否漏复制、带空格或已被撤销。此时还需完成主人绑定。

【在自己的机器人私聊中绑定主人】 ① 在 MSH 机器人卡片下生成一次性主人绑定码，复制完整验证码。 ② 自己打开 Telegram，点击 BotFather 回复中的机器人 t.me 链接，或搜索刚创建的 @机器人用户名，进入自己的机器人私聊并点击“开始 / Start”。 ③ 把验证码作为消息发给自己的机器人，不是发给 BotFather，也不能发群里。验证码生成后 10 分钟有效，使用成功立即作废；过期请回网站重新生成。 ④ 回 MSH 查看绑定状态，必要时刷新。获取个人 ID 和群 ID 接入后即可使用；其他功能需有效时长及相应配置。

【加群、授权并启用功能】 ① 在目标 TG 群打开群资料 → 编辑 / 管理群组 → 管理员，添加自己的机器人。不同客户端菜单名称可能略有差异；绑定的个人 TG 账号也须是该群管理员。 ② 按功能授予权限：删广告需要删除消息，禁言需要限制成员，会员入群需要邀请和限制成员。 ③ 用机器人获取群 ID，回 MSH 的“运行与授权群”填写并点击“验证并授权”。 ④ 领取可用的 1 小时体验或购买时长；暂停时点击恢复运行。再私聊机器人，通过按钮和自定义菜单开启、设置需要的功能。所有功能默认关闭，体验不开放商店或会员收款。

【已有机器人 / 常见问题】 已有机器人不用重建：在官方 BotFather 发送 /mybots，选择自己的机器人，点击 API Token 查看，再从第 4 步接入。 不回复时先核对私聊的是自己的机器人并点击了开始，再查看网站的接入、绑定及运行提示；仍有问题用右下角“联系客服”，不要提交 Token。 已在其他平台托管的，先停止旧程序；接入本站会切换消息接收地址。Token 泄露时在 BotFather 撤销并生成新 Token，再处理旧接入。