WhatsApp Groups

👥 自动发现与管理 WhatsApp 群组

自动发现和管理WhatsApp群组,从Baileys会话缓存中读取群组信息,支持列表、搜索和ID获取功能。

收藏
4.3k
安装
1.1k
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

WhatsApp Groups Skill 是一个用于自动发现和管理 WhatsApp 群组的实用工具。它通过读取 Baileys 库生成的会话缓存文件,提取当前 bot 已加入的所有群组信息,无需手动配置群组 ID。

功能特性

1. list: 列出所有已加入的群组,返回包含群组 ID、名称和状态的完整列表
2. search: 按名称关键词搜索特定群组,支持模糊匹配

3. get-id: 通过群组名称获取对应的 WhatsApp 群组 ID(JID 格式)

4. sync: 将发现的群组信息同步到配置文件,便于后续自动化管理

输出格式

所有命令均返回标准化的 JSON 格式,包含群组总数、群组 ID(格式如 5551XXXXXXXX-TIMESTAMP@g.us)、群组名称和活跃状态。

显著优点

  • 零配置发现:自动读取 Baileys 本地缓存,无需手动维护群组列表
  • 标准化输出:JSON 格式便于与其他自动化流程集成
  • 轻量高效:纯 Node.js 脚本执行,无额外依赖
  • 灵活匹配:支持名称搜索和精确 ID 获取

潜在局限

  • 依赖 Baileys:必须与 Baileys WhatsApp Web 库配合使用,无法独立运行
  • 缓存延迟:依赖本地会话文件,新加入的群组可能需要重新登录才会出现在缓存中
  • 无持久化存储:本身不提供数据库功能,sync 命令仅为配置文件更新
  • 权限限制:只能访问 bot 已加入的群组,无法获取外部群组信息

适合人群

  • 使用 Baileys 构建 WhatsApp 自动化系统的开发者
  • 需要动态管理大量群组的工作流场景
  • 希望减少手动配置群组 ID 的 DevOps 团队
  • 客服系统、通知广播等需要群组元数据的业务场景

常规风险

  • 会话文件安全:需要读取 Baileys 的 session 目录,若目录权限配置不当可能导致敏感信息泄露
  • 群组信息暴露:返回的群组 ID 和名称可能包含敏感业务信息,建议在可信环境使用
  • 配置覆盖风险:sync 命令会修改配置文件,操作前建议备份
  • 依赖 Baileys 更新:若 Baileys 缓存格式变更,技能可能需要适配更新

WhatsApp Groups 内容

scripts文件夹
手动下载zip · 4.0 kB
groups.jstext/javascript
请选择文件