激活机器人

激活机器人是将您在 Telegram 创建的 Bot 与 TG-Staff 项目绑定的过程。激活后，系统才能代机器人收发消息、执行命令流程。

激活前准备

• 已创建 TG-Staff 项目
• 拥有可登录的 Telegram 账号
• 在 BotFather 中创建机器人并获取 API Token

两步激活流程

第一步：在 Telegram 创建机器人

1. 打开 Telegram，搜索并进入 @BotFather。
2. 发送 /newbot，按提示设置：
   • 机器人显示名称（Display Name）
   • 机器人用户名（必须以 bot 结尾，如 myshop_bot）
3. 创建成功后，BotFather 会返回一串 API Token，格式类似：

   123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

4. 请妥善保存该 Token，后续激活时需要粘贴。

第二步：在 TG-Staff 粘贴 Token

1. 进入项目详情，点击 激活机器人令牌。
2. 将 Token 粘贴到输入框。
3. 点击 激活，系统会验证 Token 并绑定到当前项目。

激活成功后弹出提示，展示：

• 直接链接：用户可直接打开机器人对话
• 魔法链接：跳转前记录访客 IP、浏览器信息与 URL 参数，适合投放追踪

撤销 / 更换 Token

在项目详情中可撤销当前 Token。撤销后机器人将停止服务，需重新激活才能恢复。

若 Token 泄露，建议在 BotFather 中 重置 Token，再在 TG-Staff 中重新激活。

常见问题

激活失败怎么办？

• 确认 Token 完整复制，无多余空格
• 确认该 Token 未被其他项目占用
• 确认 Bot 未被 Telegram 封禁

激活后用户发消息没反应？

• 检查命令是否已 发布
• 确认项目状态为 已激活