Files
abot/plugins/trendradar_permission
liuwei 454d45fcc2 refactor(trendradar): 合并说明文档到权限插件目录
- 将 webhook 对接与群权限说明迁移到 plugins/trendradar_permission/README.md

- 删除已无实际职责的 plugins/trendradar_webhook 文档目录内容

- 保持目录职责一致:权限插件目录承载配置与使用说明
2026-04-21 16:39:21 +08:00
..

TrendRadar Webhook + 权限插件说明

1. 组成说明

当前实现分两部分:

  1. 权限插件(本目录)
  • 负责注册群级功能开关:TRENDRADAR_WEBHOOK
  • 你可以在后台按群启用/关闭
  1. webhook 接口Dashboard 蓝图)
  • 路径:POST /webhook/trendradar
  • 文件:admin/dashboard/blueprints/trendradar_webhook.py

2. 接口地址

POST /webhook/trendradar

示例:

http://<你的ABOT地址>:8888/webhook/trendradar

3. ABOT 配置

编辑 config.toml

[trendradar_webhook]
enabled = true
token = "your_secure_token"
default_group_ids = ["xxxx@chatroom"]
allow_payload_target_groups = false
send_timeout_seconds = 20

4. 群权限开关(必做)

请在后台给目标群开启:

📡 TrendRadar Webhook推送 [群级开关]

说明:

  1. webhook 发送前会强制校验该群权限;
  2. 未开启的群会被拦截,并在返回中出现在 blocked_groups

5. TrendRadar 配置Generic Webhook

在 TrendRadar 里设置:

  1. NOTIFICATION_PROVIDER=generic_webhook
  2. GENERIC_WEBHOOK_URL=http://<你的ABOT地址>:8888/webhook/trendradar
  3. GENERIC_WEBHOOK_METHOD=POST
  4. GENERIC_WEBHOOK_HEADERS={"Content-Type":"application/json"}
  5. GENERIC_WEBHOOK_TEMPLATE={"token":"your_secure_token","title":"{title}","content":"{content}","source":"TrendRadar"}

6. 可选:让 TrendRadar 指定目标群

若你希望不同热点推送到不同群:

  1. ABOT 配置 allow_payload_target_groups = true
  2. TrendRadar 模板加目标群字段:
{
  "token": "your_secure_token",
  "title": "{title}",
  "content": "{content}",
  "target_group_ids": ["xxxx@chatroom", "yyyy@chatroom"]
}

7. 返回结果

接口返回 JSON包含

  1. success
  2. sent_groups
  3. blocked_groups
  4. failed_groups