Telegram 入群申请机器人:审核、邀请链接与异常验收
把 Telegram 入群申请设计成可核对的审核流程:区分提交与入群,检查共享文件夹入口、人工决定、失败状态和 BotFatherV2 的实现边界。
为读书会做一个“入群机器人”,不一定需要 AI 判断谁值得加入。更重要的问题是:谁作决定、通过哪个入口进入、审批失败时显示什么,以及机器人能否证明操作真的完成。
建议先用 Telegram 原生管理员审核满足基本需要;只有确实需要业务记录、审核说明或统一处理流程时,再评估自定义机器人。下面的流程是设计建议,不是已上线的机器人功能演示。
提交申请,不等于成为成员
Telegram 在 2021 年 11 月 3 日的官方公告中介绍了邀请链接的管理员批准设置:用户提交申请,管理员查看后批准或拒绝。它不是点击邀请链接便自动入群的同义词,也不是近期才出现的新功能。
给读者和运营者的界面应使用不同表述:“申请已提交”“等待审核”“审批操作已完成”,不要在机器人刚收到一条事件时就显示“已成功入群”。若业务还需要确认当前成员状态,应把它列为独立检查,不能用本地记录推断。
原生审核够用时,不必重做一套
先回答三个问题:
- 管理员直接在 Telegram 中审核,是否已经足够?
- 是否确实需要保存业务申请编号、审核人和处理原因?
- 是否有人负责处理无法送达、权限变化和状态不确定的申请?
如果第一项是“是”,后两项都没有明确需求,先保留原生流程更容易维护。机器人适合补上已经确定的业务步骤,不应只为增加一个“AI 审核”标签而接管准入。
Telegram 的 Invite links 文档说明了邀请链接有效期、撤销、入群申请和管理员处理机制,其中也有 MTProto 方法。这些机制说明平台允许什么,不代表 Telegram Serverless 的固定 SDK 暴露了同名接口;不能把文档中的方法直接当成 BotFatherV2 可调用能力。
检查所有入口,而不只是机器人生成的链接
一个容易漏测的入口是共享聊天文件夹。Telegram 的西班牙语共享文件夹说明明确指出,文件夹邀请可以让接收者直接加入其中的聊天,包括通常需要申请批准的聊天。这意味着,“我们有一个审批机器人”不能证明所有入群路径都经过它。
上线前建议盘点:公开入口、仍有效的旧邀请链接、其他管理员创建的链接,以及包含该聊天的共享文件夹。逐项记录谁维护、用于什么人群、是否还应有效。不要为测试一次性撤销生产社群的全部链接;先与管理员确定影响范围。
链接撤销后的验收应是“此入口不再接受新的加入操作”,而不是“此前通过此链接加入的人都被移除”。如果还要清理已有成员,那是另一项高影响操作,必须单独授权和验收,不能混进链接维护。
为申请设计可核对的结果
以下是建议的业务状态,不是 Telegram 官方状态枚举:
- 待审核:保存必要的申请编号、目标群和申请者标识;不要收集身份证件、密码或验证码。
- 已决定,待执行:记录指定审核人的允许或拒绝决定;本地决定不能直接当成平台执行结果。
- 处理完成:只有获得明确执行结果后才记录对应操作已完成;需要确认成员状态时另行检查。
- 需要核对:权限不足、超时或已被另一位管理员处理时,不伪造成功,也不无限重试审批。
若平台无法安全确认现状,保留必要证据并交回原生管理员界面。不要为消除一条错误提示而重新生成邀请、自动放行,或拒绝其他尚未处理的申请。
资料可见范围也要写清:申请者看到自己的进度;指定审核人看到必要记录;公共群不展示个人资料和内部拒绝原因。管理员名单变化后应重新验证执行权限,而不是永久相信首次配置。
一段可修改的需求说明
为读书会设计入群申请辅助流程,由指定管理员作最终决定,不使用模型评分自动批准。先报告当前 SDK 是否能够接收申请事件、核对执行权限、批准或拒绝并确认结果;不支持的步骤保留 Telegram 原生人工处理。申请记录只保存必要标识和处理状态。管理员已经在其他入口处理时,重新核对现状,不覆盖既有结果。任何状态不确定的操作进入待核对列表,不向申请者发送虚假的成功通知。上线前列出旧邀请链接和共享文件夹等旁路入口。
这是需求示例。不要把申请者的简介、名称或一段“我已获批准”的文字当成授权凭据。若将来引入模型做摘要,其输出也只能辅助阅读,不能取得管理员权限。
用六种情况验收
在专用测试群和虚构账号中核对:
- 正常申请:提交、决定、执行结果分别可见,不提前宣布入群。
- 原生界面先处理:机器人识别状态变化或转人工核对,不再盲目执行相反决定。
- 机器人权限被撤销:停止执行,保留待处理记录,并告诉维护者缺少什么。
- 处理请求超时:显示结果待核对,而不是把网络超时当成拒绝。
- 旧链接和共享文件夹:测试实际入群路径,确认审批适用范围没有被夸大。
- 无关用户查询或操作申请:不能读取他人记录,也不能执行审核决定。
还应约定记录保留期限和删除办法,并验证删除业务记录不会意外触发踢人或重新邀请。
与 BotFatherV2 的关系和边界
BotFatherV2支持通过 AI 对话创建和修改 Telegram 机器人。可以先提交上述需求,再根据生成检查和测试群结果决定实现范围。它也支持导入已有 Telegram Serverless 机器人、版本发布与保留当前业务数据的代码回滚;回滚代码并不撤销已经发生的审批决定。
截至 2026-10-16,公开开发文档仍限定固定 SDK,不支持任意 npm 模块或 Node/Bun 运行时 API;首版不新增依赖付费 AI 的机器人运行能力。本文不声称平台内置入群审批器、MTProto 客户端、共享文件夹管理或模型身份判断。若 SDK 不支持必要事件和操作,就使用原生人工审核,不应承诺自动实现。BotFatherV2 与 Telegram 官方 BotFather 无隶属关系。有关基础接收范围,可另看群机器人隐私模式与权限检查。
来源与核验日期
- Telegram Team,Hyper-Speed Scrolling and Calendar View for Shared Media, Join Requests, Global Chat Themes on iOS and More,2021-11-03 发布;查阅于 2026-10-16。
- Telegram,Invite links,页面未标注明确发布日期;查阅于 2026-10-16。
- Telegram,Carpetas de chats compartibles,西班牙语官方说明,功能介绍列于 2023-04-21;查阅于 2026-10-16。
- 产品边界补充核验:BitBear Studio,使用 AI 开发,查阅于 2026-10-16。