群消息监听机器人使用说明
方案说明版 / 2026.11

TELEGRAM MONITOR · GUIDE

让群消息,
成为有用的线索。

从账号配置到关键词筛选,了解如何接收命中通知,以及按需启用自动私聊。

阅读前请了解当前状态

本说明依据项目已确认需求与现有设计编写。当前代码仅完成部分工程基础,监听、通知、自动私聊、会员及支付尚未完成上线验收。下文描述预定流程;正式菜单、默认值与可用功能以上线验收版本为准。

接收已加入的群消息
筛选关键词与违禁词
通知私聊或通知群
可选自动私聊跟进
01 / 监听

关注需要的群

全部已加入群或手动选群,监听范围由你选择。

02 / 筛选

留下相关消息

包含匹配、精准匹配和违禁词,减少无关通知。

03 / 跟进

推送与私聊分开控制

通知和自动私聊各自启停、各自记录与去重。

02

开始使用

上线后的建议顺序:先跑通监听与通知,再根据需要配置自动私聊。

  1. 进入机器人,查看权益

    在 Telegram 中打开运营方提供的机器人入口,查看试用或会员状态,以及监听账号、发送账号的可用额度。本说明未配置正式机器人链接。

  2. 添加自己的监听账号

    进入“监听账号管理”,按向导填写带区号的手机号、验证码,以及按需提供的二步验证密码。确认账号状态正常。

  3. 选择群范围与筛选规则

    选择全部已加入群或手动选群,再配置关键词和违禁词。建议先用少量群与容易验证的关键词检查结果。

  4. 设置通知目标,开启监听

    选择机器人私聊或通知群,检查通知群权限,开启监听。在选定的测试群发布符合规则的新消息,核对通知内容。

  5. 按需配置自动私聊

    另外添加本人发送账号,配置代理、话术和私聊去重,再打开“开始私聊”。用自己的测试账号验证发送结果。

两个开关分别生效

“开始监听”负责接收与处理群消息;“开始私聊”控制自动联系发言者。仅开启监听,不代表已经开启自动私聊。

03

账号与监听范围

监听账号和发送账号由会员自行提供,按角色分别管理。发送任务只使用本会员自己的发送账号池。

两类账号的用途
类型用途预定添加方式
监听账号接收所在群的新消息手机号、验证码;按需二步验证
发送账号自动私聊命中的发言者手机号登录或导入授权会话

首版会话导入只支持一种明确格式;Telethon .session 是当前设计建议,具体兼容格式尚待样本验证。不能把所有 .session 文件视为通用格式。

两种监听模式

全部模式

账号已加入的群

覆盖账号已经加入、且有权接收消息的群,并应用排除规则。不会自动加入新群,也不代表监听 Telegram 全网。

手动模式

只监听你选中的群

从账号可见群列表中选择来源群。按现有设计,未选择任何群时不处理群消息,也不会自动切回全部模式。

账号数量由后台分别配置。遇到额度不足,先查看当前权益与已添加数量;需要调整时联系运营方。掉线、授权失效与账号受限应按状态提示分别处理。

04

关键词与过滤

先决定想收到什么,再排除不需要的内容。

规则说明与示例
规则含义例子
包含匹配消息中包含任一关键词配置“足球”,可匹配“今晚一起看足球”
精准匹配整条消息等于关键词配置“足球”,不匹配“今晚看足球”
违禁词命中时不推送配置“广告”,过滤含该词的消息
全量模式没有配置任何关键词时,处理范围内通过基础过滤的消息仍受群范围、违禁词和去重影响

配置示例

以下命令来自已整理的参考案例,用于解释规则;本项目命令入口与实际交互尚待上线验证。

包含词/kw 微信 游戏
精准词/jz 足球 篮球
违禁词/wj 广告 推广
留意空参数与规则优先级

参考案例中,不带参数的 /wj 会清空全部违禁词。现有设计采用违禁词优先、精准优先于包含、区分大小写;这些细则仍需实际实现与验证,清空操作前请核对菜单提示。

会员监听关键词上限为 30 个。全量模式只改变筛选条件,不扩大账号可监听的群范围;当前范围不包含 AI 语义匹配或图片 OCR。

05

通知与去重

预定支持推送到你与机器人的私聊,或一个指定通知群。来源群负责提供消息,通知群负责接收结果,两者需要分别配置。

通知内容示意 虚构示例
来源群
示例交流群
发言者
测试用户
命中词
足球
原消息
今晚一起看足球,有人参加吗?

实际通知拟包含来源、发言者、命中词及原消息;原消息链接仅在 Telegram 权限与消息类型允许时提供。

推送去重和私聊去重各自独立

  • 开启后,同一目标在对应流程成功一次后不再重复处理,直到手动重置。
  • 推送成功只记入推送记录,私聊成功只记入私聊记录;一边重置不影响另一边。
  • 设计上同一会员的去重跨群、跨同角色账号生效;轮换发送账号不会清除私聊去重。
  • 设计上关闭开关不清空历史,重新打开后仍按成功记录去重;记录不自动按日重置。
  • 手动重置前核对影响范围,正在执行或结果不明的任务仍需避免重复处理。

发现“有命中却没有再次通知”,先检查是否已对该发言者成功推送,以及当前推送去重是否开启。

06

自动私聊与话术

自动私聊是可选流程,需要本人发送账号、可用连接、有效权益和已配置话术。通知与私聊分别记录成功或失败,收到通知不等于私聊已经发出。

发送账号如何分配

正常新任务拟在本会员的可用发送账号之间轮询分配。忙碌、冷却、失效或受限的账号跳过;没有可用账号时等待。平台要求等待、目标隐私受限或发送结果不明时,按原因暂停或核对。

话术配置

设计支持全量话术和关键词专属话术,并从可用话术中随机选择一条。以下变量沿用现有案例与设计,最终格式以上线版本为准。

话术变量
变量含义
{msg}原消息内容
{kw}命中关键词;全量时显示“全量”
%随机大写字母 A–Z
#随机 emoji
查看具体结果再处理

没有话术、匿名身份、无法解析收件人或目标隐私限制,均可能无法发送。“发送成功”指接口返回成功,不表示对方已经阅读。当前冷却、间隔及话术数量等参数尚待实现验收,不能作为已上线默认值。

07

代理与独立出口

已确认提供平台共享代理池与会员自有代理:配置自有代理时优先使用,未配置时使用平台共享池。共享的是网络资源,发送账号仍由会员自己提供。

自有代理

首版设计采用 SOCKS5,填写服务器、端口及可选的用户名和密码,绑定到对应发送账号。登录、会话导入校验、连接和发送拟使用同一代理绑定;自有代理故障时暂停关联任务并提示。

独立出口开关

开启时

逐号核验出口

为发送账号分配并核验独立出口。资源不足、出口冲突或检测失败时暂停相关账号。

关闭时

允许共用出口

发送账号允许共用出口,仍按账号代理绑定和连接状态运行。

独立出口以平台实际检测与占用记录为依据,无法证明供应商未对外共享 IP。代理供应商、费用与资源数量尚未确定;轮换账号不等于逐条更换 IP,也不保证解除平台限制。

08

会员与支付

已确认的产品规则:3 小时试用,会员最多 30 个监听关键词,两类账号额度由后台分别配置。

周卡20 USDT
月卡70 USDT
季卡200 USDT
年卡365 USDT

以上为已确认的方案价格,尚未开放购买。正式价格、权益与实际应付金额以上线后的套餐和订单页面为准。试用起算点、试用额度及套餐具体天数尚待验收确认。

三种预定收款通道

资产与网络必须一致
通道网络资产
USDT-TRC20TRON 主网指定合约的 USDT
USDT-BEP20BNB Smart Chain 主网指定合约的 USDT
TRXTRON 主网原生 TRX

上线后的预定支付流程

  1. 在机器人内选择套餐及支付通道,创建订单。
  2. 核对订单中的网络、资产、收款地址、完整金额与有效期。
  3. 按订单精确金额转账;TRX 拟按下单报价换算并锁定数量。
  4. 查看订单确认进度,链上最终确认并匹配后开通或续期会员。
  5. 少付、多付、错链、过期后付款或重复付款时,保留订单号和交易哈希,联系运营方核对。
本说明不提供收款地址

目前未启用真实收款,不能通过本文付款。订单有效期 20 分钟、自动认款与续期等属于现有设计,尚未接入验收;正式付款只使用机器人当前订单展示的信息。

到期后拟停止相关任务并提醒。原有配置保留;续费后需检查状态并按需重新启用,避免误以为任务已自动恢复。

09

记录与统计

设计分别提供监听命中、通知结果和私聊结果,便于定位消息停在哪一步。

排查时应查看的记录
记录重点核对
监听命中来源群、时间、原消息、发言者与命中词
通知结果接收目标、成功或失败、推送去重拦截
私聊结果脱敏发送账号、最终话术、任务状态与失败原因
首页统计账号与规则数量、成功次数、触达人数、去重拦截次数

CSV 导出、原消息保留 30 天和发送结果保留 90 天是当前设计值,尚待实现验证。正式保留周期和导出范围以上线说明为准,重要记录请在可用期间及时导出。

会员在 Telegram 内查询与管理;平台管理员另用 Web 后台处理用户、额度、账号状态、套餐与异常订单。

10

常见问题

以下排查顺序依据预定功能设计,供上线后对照实际状态使用。

开启监听后,为什么收不到通知?

依次检查会员或试用是否有效、监听账号是否在线、来源群是否在范围内、消息是否命中规则、是否被违禁词或去重拦截,最后检查通知目标与群权限。手动模式未选群时不会回退全部模式。

收到通知,为什么没有自动私聊?

检查私聊开关、发送账号、代理、话术、私聊去重和任务状态。通知与私聊独立;账号全部冷却、目标不可解析或隐私限制都可能阻止发送。

同一个人在不同群发消息,会重复通知吗?

按当前设计,开启推送去重后,同一会员对同一发言者成功推送一次后持续去重,直到手动重置。私聊有独立的开关和成功记录。

可以监听没加入的群或 Telegram 全网吗?

当前范围是监听账号已加入、且有权接收消息的普通群与超级群;没有全网监听、自动加群或自动拉人的能力承诺。

导入的会话文件不能用,怎么办?

先核对正式支持的格式、文件有效性、账号归属、代理连通与授权状态。首版具体格式尚待验证;授权失效时需要重新登录或导入有效会话,不能仅改文件后缀。

平台限流或发送结果不明时,能直接切号重发吗?

按设计,限流任务应遵守平台返回的等待时间;结果不明先核对是否已经发出。正常新任务的轮询不改变这类异常任务的处理规则。

付款后会员未开通,应提供什么?

正式上线后先核对订单通道、金额、有效期和确认进度。如需人工处理,向机器人内的客服入口提供订单号、交易哈希、支付网络与时间。目前项目尚未开放真实付款。

在哪里登录网页管理账号?

会员全部通过 Telegram 机器人操作,这个站点仅提供说明。平台管理员使用独立 Web 后台;当前没有会员网页登录入口。

11

版本与适用范围

文档更新于 ,依据 2026 年 11 月 9 日的需求确认记录、开发范围确认稿、开发大纲与最新开发进度整理。

已确认需求
两类账号独立、全部与手动群范围、两类独立去重、代理来源、试用及套餐价格、三种支付通道、会员 Telegram 操作端。
方案建议
会话具体格式、部分命令交互、规则优先级、发送间隔与冷却、数据保留期、订单及续费实现细则等。
尚待验证
真实 Telegram 监听与发送、代理连接及出口、链上收款与开通、完整菜单、容量和整体验收。

本次交付是说明站点。网站能访问不代表机器人业务功能已经上线;正式机器人链接、客服入口及运行参数需在上线后补充。