入群验证与故障排查¶
本页说明新成员如何完成验证，以及管理员如何区分网页授权、订阅检查和加入申请审核。所有结果以挑战卡片、页面状态和群内实际权限为准。
管理员先检查¶
- 确认 CNBot 是目标群管理员，并拥有限制成员、删除消息等所需权限；审核加入申请还需要对应的邀请与审核权限。
- 打开 CNBot 面板 → 管理 → 选择群组 → 群组管理功能 → 入群欢迎与验证，开启群管理并选择验证方式。
- 配置超时时间、失败封禁时长和挑战消息自动删除。请使用一个普通成员账号测试，管理员账号不适合作为一般新成员测试对象。
- 如果开启 Premium 自动通过、自定义自动判定等规则，先检查这些规则是否会让测试成员直接通过或拒绝。
八种方式和完整设置见 群组管理 · 入群验证。
网页验证：两个入口，身份都必须是本人¶
挑战卡片保留「在 App 中验证」与「打开浏览器验证」两个入口。它们都核对待验证成员的 Telegram 身份，区别只是在哪个窗口完成。
在 App 中验证¶
使用申请加入的 Telegram 账号点击「在 App 中验证」，在 Mini App 内保持页面打开。有效身份核验后，页面自动显示结果；通过后机器人恢复发言或同意加入申请。
不需要注册或绑定平台账号。提示重新授权时关闭 Mini App 后重新打开；限流时先等倒计时再手动重试，见 Mini App 使用说明。
打开浏览器验证¶
- 用申请加入的 Telegram 账号点击最新挑战卡中的「打开浏览器验证」。
- 若 Telegram 提供了点击者的安全签名，CNBot 识别本次点击账号并继续验证，不会用浏览器里另一个账号的旧登录状态替代。
- 若只打开了普通链接、没有安全身份，页面会提供「使用 Telegram 账号完成验证」等授权按钮。主动点击，并在 Telegram 官方授权流程中选择本人账号。
- 保持页面打开，等待显示验证结果。通过后可以返回群组，或按页面提供的入口进入 CNBot 面板。
Telegram 客户端是否显示外链确认、是否附带签名，取决于客户端和打开方式。曾经允许网站授权，不代表本次链接一定携带点击身份。完整说明见 账号与登录。
链接不能代替本人身份
验证链接只定位待处理的挑战，不是账号登录凭证。把 B 的链接转给 A，A 即使登录成功也不能替 B 通过；浏览器已有账号会话同样不能证明是谁点击。不要把完整验证链接、授权参数或身份数据发到公开群。
网页提示与下一步¶
| 页面提示或现象 | 如何处理 |
|---|---|
| 需要 Telegram 授权 / 未获得点击者身份 | 点击页面的授权按钮，选择申请加入的本人账号。反复打开同一个无身份链接不会补出身份。 |
| 当前账号与待验证成员不一致 | 关闭错误账号的授权流程，用申请账号重新点击挑战按钮，或重新选择本人账号授权。不要让他人代点。 |
| 已过期、找不到挑战或剩余时间结束 | 回群使用最新挑战；必要时联系群管理员重新发起。历史链接不能延长原验证期限。 |
| Mini App 提示需要重新授权 | 关闭后从 Telegram 重新打开，获取新的身份；不要转到普通浏览器继续使用失效的 Mini App 数据。 |
| 页面白屏、意外关闭或跳到面板登录页 | 从 Telegram 的最新挑战按钮重新进入。仍复现时反馈设备、客户端版本、时间和提示截图，不要提交完整授权链接。 |
| 页面显示通过，但仍无法发言 / 未入群 | 请管理员核对实际成员状态、机器人权限和验证记录；不要只凭浏览器登录成功判断已放行。 |
订阅频道验证：已订阅可以自动通过¶
管理员需要配置目标频道，并让 CNBot 成为该频道管理员，才能可靠核对成员状态。
- 启动验证前，确认用户已经订阅、且恢复群权限或同意申请成功时，会自动通过并记录「已订阅目标频道，自动通过」，不再发送挑战卡。
- 未订阅或无法确认时，保留验证流程：本人先点「打开频道」订阅，再点「我已订阅验证」。Telegram 状态可能短暂延迟，可稍后再次检查。
- 已订阅但放行未成功时，也会保留手动流程，而不是把失败记成成功。
无法核验不代表已订阅
当前手动确认时，若 Telegram 返回无法核验，机器人会警告并自动放行，避免成员卡住。请管理员检查目标和频道权限；不要依赖这种回退来保证付费或私密频道成员筛选。
普通入群、加入申请与通知的区别¶
| 场景 | 对应功能 |
|---|---|
| 用户直接通过普通邀请链接加入群组 | 「入群欢迎」发送欢迎内容；启用验证时，再按规则限制发言并验证。 |
| 用户点击需要审核的邀请链接，提交加入申请 | 「入群请求通知」可私信申请人，说明已收到申请；此时用户尚未正式入群。 |
| 由 CNBot 接管加入申请审核 | 另行开启「通过对话加入请求验证」，按验证模式同意、拒绝或交给管理员。 |
入群请求通知与验证接管是两个独立开关。只开启通知不会自动通过申请，也不会让普通入群事件变成申请通知。通知会尽力通过 Telegram 临时私聊入口发送，首次申请者也可能收到；屏蔽机器人、入口失效或平台限制可能导致未送达。10 分钟内同一群同一用户的重复申请不会重复通知。
接管审核后，各模式怎样处理¶
- 验证关闭：直接尝试同意加入申请。
- 网页、算术、订阅、贴纸或星币：按规则私聊验证，通过后同意；无法提供必要的私聊验证入口时会拒绝申请，可先私聊机器人点击 Start 再重新申请。
- 半自动：在群内管理员审核卡上处理，不要求申请人一定有私聊入口。
- 拒绝新成员：按规则拒绝；启用的自动判定规则也可能影响最终结果。
机器人仍需要 Telegram 对应权限，管理员应核对申请列表和验证记录确认实际结果。
结果记录与管理员处理¶
群管理中的入群验证记录可查看最近 100 条结果，包括用户、方式、时间与通过、失败、超时等原因。挑战卡上的「通过」「拒绝」「拒绝并举报」由本群管理员使用；普通成员不能替其他人裁决。
验证失败后的封禁时长，以挑战消息和本群配置为准。需要恢复时请联系管理员，不要反复打开旧链接、切换无关账号或另行支付已结束的验证。