Deskgram 2 中的 Telegram 用户采集

本指南说明如何在 Deskgram 2 中使用用户采集模块：如何选择来源、过滤条件如何影响结果，以及怎样为后续模块准备可用的数据。

这个模块的作用

用户采集模块负责从 Telegram 来源中收集用户数据。它本身不会发消息，也不会邀请用户加入群组。它的核心任务是先准备一份干净、可用的目标数据集。

启动前需要准备什么

• 可以访问目标来源的账户。
• 相关的频道、群组或链接列表。
• 明确的筛选逻辑，知道自己要收集什么样的用户。
• 后续模块能使用的导出格式。

推荐的配置顺序

1. 添加来源

先导入需要采集的频道、群组或链接。来源列表决定了整体数据质量。

2. 配置过滤器

设置哪些用户应该进入结果集。过滤器是提高数据相关性的主要工具。

3. 先跑一轮小批量测试

不要一开始就全量采集。先做一次小批量测试，更容易看出来源和过滤器是否设置正确。

4. 检查日志和导出结果

采集完成后，查看日志和导出结果，确认这些数据是否真的适合后续外呼或邀请流程。

主要设置分组

来源列表

这个部分决定从哪里采集用户。来源不相关，结果自然也不会相关。

过滤器

过滤器决定哪些用户留下、哪些用户被排除，是提高结果质量的关键。

账户

账户必须能访问来源社区，否则采集质量会立刻下降。

导出逻辑

导出格式决定后续模块能否方便使用这些数据。

如果效果不好，先检查什么

• 来源列表是否太杂或不够精准。
• 过滤条件是否过松，导致噪音太多。
• 账户是否真的能访问这些来源。
• 是否在首轮结果不检查的情况下就直接放大量。

常见错误

• 从和后续场景不匹配的来源采集用户。
• 不设置过滤器直接运行。
• 第一次运行后不看日志。
• 不验证结果质量就直接开始外呼。

可以和哪些模块配合

• Direct Messaging：后续做私信触达。
• Invite Tool：后续把用户导入群组。
• Join Groups：如果账户还需要先进入目标社区。

FAQ

安装前可以先看模块界面吗？

可以。你可以先通过交互式 web preview 在浏览器中查看这个模块。

这个模块会直接联系用户吗？

不会。这个模块只负责采集和整理数据；消息发送和邀请需要由其他模块完成。