入群验证与审核
新成员入群后按钮答题验证:可先禁言、答对自动解禁并发欢迎语,超时按规则处罚。同时支持入群申请自动审核(关键词 / 黑名单 / QQ 等级门槛)。
工作流程(官机)
text
新成员入群(GROUP_MEMBER_ADD)
↓ 可选:立即禁言 N 分钟(先禁言再验证,防止广告刷屏)
机器人发送验证卡片(Markdown + 按钮选项)
↓
点按钮 / 回复正确选项 → 解除禁言 → 发送欢迎语(可 @ 新人、带群人数)
超时未通过 → 按规则禁言(可配时长,43200 分钟 = 30 天封顶)- 题库随机:默认内置题库,可在配置里自定义(每行一题
问题|选项A|选项B|...|答案) - 按钮点不了也能答:直接在群里回复正确选项文本同样算通过
- 分群开关:
分群开关每行一个群;分群覆盖可对单个群覆盖任意配置项
⚠️ 开了验证群里却没反应?先看这里
入群事件没有消息上下文,只能发主动消息。群没开「接收机器人推送」时 QQ 直接拒绝(错误码 40034105),验证卡片发不出去,现场就是"插件开了但毫无动静":
- 手机 QQ → 进群 → 点机器人资料卡 → 打开**「接收机器人推送」**(这个开关只在手机 QQ 里,开放平台网页控制台没有)
- 群里发
群诊断,确认「可主动发消息」为是 - v1.3.0 起,官方发不出时若本群绑定了在线真实号,会自动降级为真实号发纯文本验证题(文案提示"按钮点不了请直接回复选项"),兜底开关
官方发不出时用真实号兜底默认开启
入群审核(入群申请)
入群审核模式 开启后,入群申请按规则自动处理:
| 官机侧规则 | 说明 |
|---|---|
| 自动审核入群申请 | 总开关 |
| 拒绝机器人账号 | 一键拒绝机器人/营销号 |
| 验证消息需包含关键词 | 留空不限 |
| 昵称命中即拒绝 / 验证消息命中即拒绝 | 黑名单,每行一条 |
| 风险标记直接拒绝 | QQ 官方风险标记 |
普通机器人(真实号)侧另有整套规则:QQ 号黑名单、昵称黑名单、最低 QQ 等级门槛、自动通过关键词等。
普通机器人(真实号)验证
真实号管理的群走验证码模式(可配 位数 / 数字或字母),并有独立处罚策略:
- 答错 N 次处罚:禁言(时长可配)或忽略
- 超时处罚:禁言(时长可配)或踢出
- 拒绝后通知 + 自定义拒绝理由
常用配置
| 配置 | 默认 | 说明 |
|---|---|---|
| 入群后开启人机验证 | 开 | 总开关(可分群覆盖) |
| 入群后立即禁言,通过后解除 | 关 | 建议开启,防广告 |
| 验证限时(分钟) | 10 | |
| 超时禁言(分钟) | 60 | |
| 官方发不出时用真实号兜底 | 开 | v1.3.0 新增 |
| 验证通过后发欢迎语 | 开 | 模板支持 {member.at}、{member.name}、{member.count}、{date}、{time}、{weekday}、{bot.name} |
常见问题
为什么新人答对了还没解禁? 机器人需要群管理员权限才能解禁/禁言;先用 群诊断 看机器人角色。
欢迎语里的 @ 是真的 @ 吗? 是,插件用 <qqbot-at-user> 原生标签,会真正提醒到人;不要手写成 <@openid>(只会显示文字)。
能只对某些群开验证吗? 可以,分群开关 每行填一个群,或用 分群覆盖 对单群覆盖配置。
