功能使用手册
验证超时处理
新人未在限定时间内完成验证时，可自动禁言或踢出。
怎么用
操作目标
新人未在限定时间内完成验证时，可自动禁言或踢出。
- 进入验证设置 打开「进群验证」，找到超时时间和超时处理。 不同验证模式对超时处理支持不同。
- 设置处理动作 选择不处理、禁言或踢出，并配置禁言时长。 强风控群建议选择踢出或禁言。
- 等待超时验证 使用测试账号不完成验证，等待后台任务处理。 如果未处理，检查调度任务和机器人权限。
开始前
前置条件
- 新人验证已开启。
- 后台超时任务正常运行。
实际使用
按用户实际体验操作
在 Telegram 私聊机器人发送 /start，先确认当前群组，再点击「验证超时」。
进入后首先看到「验证超时」。- 进入验证设置：打开「进群验证」，找到超时时间和超时处理。
- 设置处理动作：选择不处理、禁言或踢出，并配置禁言时长。
- 等待超时验证：使用测试账号不完成验证，等待后台任务处理。
- 设置验证封面：发送图片、视频或 /clear （image.jpg）
- 设置验证文本：发送验证提示文案 （请点击下方按钮完成验证。）
- 设置数学验证文案：发送数学验证提示文案 （请完成下方算术题，通过后解除限制。）
- 设置数学验证封面：发送图片、视频或 /clear （image.jpg）
- 新人验证已开启。
- 后台超时任务正常运行。
- 格式不符合要求时，Bot 会停留在输入态并提示重新输入。
- 格式不符合要求时，Bot 会停留在输入态并提示重新输入。
- 格式不符合要求时，Bot 会停留在输入态并提示重新输入。
- 如果页面提示权限、未开启或无效，先回到当前功能页补齐配置，再重新点击同一个按钮。
Telegram 操作流
跟着真实按钮操作
入口：私聊 /start 后点击「验证超时处理」 页面：13 个 输入：4 处需要填写 群内：需要回到群内验证效果
第 1 / 13 页
@TgGroupRobot
管理员主菜单
发送 /start 后点击管理入口，按按钮选择当前群组。
点击「验证超时」进入配置页。
当前群组：演示群
13:41 第 2 / 13 页
@TgGroupRobot
选择配置群组
私聊配置前先确认目标群组，后续按钮都会写入这个群。
可管理群：演示群、测试群
13:41 第 3 / 13 页
@TgGroupRobot
主菜单
这里展示机器人后台的真实功能入口。
13:41第 4 / 13 页
@TgGroupRobot
验证超时
设置验证超时时间和超时后的禁言或踢出动作。
所有模式配置通过 adm:vfy_home 回调分发。
当前群组：演示群
13:41 第 5 / 13 页
@TgGroupRobot
验证规则总览
规则总览展示当前启用模式和超时处理。
13:41第 6 / 13 页
@TgGroupRobot
按钮验证
按钮验证会发出入群确认按钮，新成员点击后解除限制。
13:41第 7 / 13 页
@TgGroupRobot
数学验证
数学验证会要求新成员回答题目。
13:41第 8 / 13 页
@TgGroupRobot
入群垃圾防护
刷号、可疑新号和入群频率在这里配置。
13:41第 9 / 13 页
@TgGroupRobot
设置验证封面
请按照 Bot 提示在私聊发送内容。
发送图片、视频或 /clear
13:41 image.jpg
清空方式：/clear
- 格式不符合要求时，Bot 会停留在输入态并提示重新输入。
第 10 / 13 页
@TgGroupRobot
设置验证文本
请按照 Bot 提示在私聊发送内容。
发送验证提示文案
13:41 请点击下方按钮完成验证。
清空方式：/clear
- 格式不符合要求时，Bot 会停留在输入态并提示重新输入。
第 11 / 13 页
@TgGroupRobot
设置数学验证文案
请按照 Bot 提示在私聊发送内容。
发送数学验证提示文案
13:41 请完成下方算术题，通过后解除限制。
清空方式：/clear
- 格式不符合要求时，Bot 会停留在输入态并提示重新输入。
第 12 / 13 页
@TgGroupRobot
设置数学验证封面
请按照 Bot 提示在私聊发送内容。
发送图片、视频或 /clear
13:41 image.jpg
清空方式：/clear
- 格式不符合要求时，Bot 会停留在输入态并提示重新输入。
第 13 / 13 页
@TgGroupRobot
设置结果
Bot 保存配置后会重新渲染当前功能页。
请在群内用测试账号触发一次，确认权限和运行结果。
13:41点击上方 Telegram 按钮开始；手机端按页面顺序往下点即可。
常见问题
常见问题
超时处理是否适用于直接禁言模式？
直接禁言模式本身就是处理动作，不依赖普通验证超时链路。