跳转至

账号与登录

CNBot 支持 Telegram 小程序免密登录、Telegram 网页授权登录和平台账号密码登录。从 Telegram 打开带安全身份的网页登录按钮时，也可以直接识别本次点击的账号。

Telegram 小程序免密登录

当您从 Telegram 的 Mini App 入口打开 CNBot 面板时，Telegram 会提供一份安全的身份数据（initData）。CNBot 验证其签名和有效时间后，自动识别您的 Telegram 身份。它不是密码，也不需要您复制或手动填写。

适合场景：

  • 在 Telegram 内直接管理群组，无需输入账号密码。
  • 快速打开面板查看数据。
  • 首次使用时自动识别身份。

流程说明：

  1. 从 Telegram 内打开 CNBot 面板。
  2. 系统自动读取 Telegram 提供的身份信息。
  3. 如果该 Telegram 已绑定正式平台账号，自动关联该账号。
  4. 如果未绑定，仍然以已验证的 Telegram 身份自动登录，可使用身份所允许的面板功能；不需要先注册平台账号。

绑定平台账号是可选操作，主要方便以后用账号密码登录。能否管理某个群，取决于您当前的 Telegram 身份是否为该群管理员，而不是是否注册或绑定平台账号。

身份过期或旧入口打不开

  • 出现「需要重新授权」时，关闭 Mini App，再从 Telegram 的面板按钮重新打开，获取新的身份数据。
  • 出现「请稍后重试」时，等待页面倒计时结束，再点击「重新尝试」；不要连续刷新或反复点击。
  • 如果页面无法自动关闭，请手动关闭后重新打开。旧消息中的 Mini App 入口同样适用这些恢复步骤。

若重新打开仍失败，请通过反馈入口提供提示文字和出现时间，不要提交带身份参数的完整链接或 initData。

从 Telegram 一键打开网页版

从 Telegram 消息中的网页登录或「打开浏览器验证」按钮进入时，如果 Telegram 附带了本次点击账号的安全签名，CNBot 会验证签名并识别该账号。浏览器之前登录了另一个账号，不会替代这次已验证的点击身份。

有些客户端或打开方式只会访问原始网址，不附带点击者身份。此时会显示「需要 Telegram 授权」，并提供「使用 Telegram 网页登录」或验证页中的授权按钮。请主动点击，并选择本次操作的本人 Telegram 账号。已经授权过网站，不代表每次打开普通链接都会携带身份。

不能只凭链接确认是谁

复制链接、在地址栏直接访问，或浏览器已有登录状态，都不能证明是谁在 Telegram 中点击。网页入群验证还会核对授权账号与待验证成员是否一致；另一个账号即使成功登录，也不能代替本人通过。

入群场景的具体步骤见 入群验证与故障排查。

平台账号密码登录

平台账号适合在普通浏览器中使用。

注册流程：

  1. 打开 CNBot 面板或账号页面（/account）。
  2. 点击「注册」。
  3. 填写用户名、邮箱、密码。
  4. 接收邮箱验证码并填入。
  5. 完成注册后自动登录。

登录流程：

  1. 进入登录页面。
  2. 输入用户名（或邮箱）和密码。
  3. 点击登录。
  4. 如果当前有 Telegram 身份，系统会自动尝试绑定。

Telegram OAuth 登录

在普通浏览器中，您还可以选择「Telegram 登录」按钮。按 Telegram 官方授权页面的提示选择账号并确认后，即可识别您的 Telegram 身份。

普通浏览器中的限制

Telegram 小程序免密登录需要 Mini App 提供有效的身份数据，并非在任意 Telegram 内置网页中都自动生效。

普通浏览器（Chrome、Safari、Firefox 等）即使已登录 Telegram 网页版，也不会因此获得 Mini App 身份数据。普通网页可以通过上文的带签名入口或 Telegram 网页授权登录，两者与 Mini App 登录不是同一种方式。

解决方案：

  • 使用平台账号密码登录。
  • 使用 Telegram OAuth 授权登录。
  • 回到 Telegram 内打开面板。

忘记密码

有两种方式重置密码：

方式一：面板登录页

  1. 在登录页点击「忘记密码」。
  2. 输入注册时使用的邮箱。
  3. 获取邮箱验证码。
  4. 输入验证码和新密码。
  5. 完成重置。

方式二：Telegram 私聊

  1. 打开 CNBot 的私聊。
  2. 发送 /reset_code。
  3. CNBot 会向您绑定的邮箱发送验证码。
  4. 在面板中使用该验证码重置密码。

提示

/reset_code 指令仅在私聊中可用，群组中无法使用。

常见登录问题

问题 解决方案
普通浏览器没有识别点击者 使用页面提供的 Telegram 授权入口，确认选择本人账号
Mini App 提示需要重新授权 关闭后从 Telegram 重新打开；限流时先等待倒计时
显示「权限不足」 确认身份是否有效、是否为目标群管理员；密码登录时检查绑定的 Telegram 是否正确
验证码邮件收不到 检查垃圾邮件文件夹、确认邮箱地址是否正确
登录后提示已绑定其他 Telegram 一个平台账号只能绑定一个 Telegram，请先解绑