Webhook 通知：下载完成推送到 Bark、钉钉、Telegram

Webhook 是「下载器主动报告」的通道：任务完成或失败时，它向你指定的地址发一条 HTTP POST。官方文档列的对接对象包括 Gotify、Bark、企业微信、钉钉、Telegram Bot 等通知服务。

开启方法

1. 打开主程序，进入「设置 → 高级 → 开发者」；
2. 找到 Webhook 区域，点击添加 URL；
3. 填入接收通知的 HTTP 地址并确认。

推送格式

POST 请求，内容类型 JSON，核心结构：

{
  "event": "DOWNLOAD_DONE",
  "time": 1712000000000,
  "payload": {
    "task": {
      "id": "task-uuid",
      "protocol": "http",
      "meta": {
        "opts": {
          "name": "file.zip",
          "path": "/downloads"
        }
      }
    }
  }
}

事件类型只有两种

两个实用细节

• 测试按钮：添加 URL 时可点「测试」——它发一条模拟的完成事件，服务端返回 HTTP 200 才算配置成功。对接钉钉/企微机器人时先用它验证签名与格式。
• 多 URL 并行：可以配置多个 Webhook 地址，事件同时推给所有渠道——手机 Bark 一条、自建 Gotify 一条，互不冲突。

常见用途

消息推送之外，Webhook 也是「触发下游自动化」的钩子：完成事件接解压、转码、归档流程；轻量场景则直接用下载完成自动跑脚本。

相关阅读

• 主动查询而非被动接收：JS 与 Python SDK。