企业微信通知
FlowMedia 支持企业微信和 Telegram 双渠道通知，也支持企业微信群聊链接自动转存。
通知分两类：
- 任务结果通知：归档、同步、重新整理、历史重链完成后发送。
- 链接转存回调：企业微信群里收到网盘分享链接后自动转存，并给发送者回执。
通知渠道
进入「设置 → 通知渠道」，可以配置企业微信和 Telegram。
企业微信参数
| 字段 | 含义 | 从哪里获取 | 是否必填 |
|---|---|---|---|
| Corp ID | 企业微信企业 ID | 企业微信管理后台「我的企业」 | 使用企业微信通知时必填 |
| Agent ID | 自建应用 ID | 企业微信管理后台「应用管理」 | 使用企业微信应用消息时必填 |
| Corp Secret | 自建应用 Secret | 自建应用详情页 | 使用企业微信应用消息时必填 |
| Token | 消息回调校验 Token | 自建应用「接收消息」页面自定义 | 使用链接转存回调时必填 |
| Encoding AES Key | 消息加密密钥 | 自建应用「接收消息」页面生成 | 使用链接转存回调时必填 |
| Proxy | 企业微信 API 代理 | 如 http://192.168.1.10:7890 | 企业微信接口访问受限时填写 |
配置完成后点击「测试」。测试成功说明 FlowMedia 可以向企业微信发送消息。
Telegram 参数
| 字段 | 含义 | 获取方式 | 是否必填 |
|---|---|---|---|
| Bot Token | Telegram Bot 的访问令牌 | 通过 BotFather 创建机器人获得 | 使用 Telegram 通知时必填 |
| Chat ID | 接收通知的聊天 ID | 给机器人发消息后通过 getUpdates 获取 | 使用 Telegram 通知时必填 |
| Proxy | Telegram 访问代理 | 如系统代理或环境变量代理 | 国内环境通常需要 |
通知事件开关
进入「设置 → 通知设置」，可以控制哪些事件需要推送。
| 事件 | 触发时机 | 建议 |
|---|---|---|
| 视频归档完成 | 视频归档任务执行完毕 | 日常建议开启 |
| 音乐归档完成 | 音乐归档任务执行完毕 | 日常建议开启 |
| 视频链接同步完成 | 视频 STRM 同步完成 | 媒体库自动入库时开启 |
| 音乐链接同步完成 | 音乐软链接同步完成 | Navidrome 自动入库时开启 |
| 视频重新整理 | 从视频归档历史中手动重新整理 | 排查和人工修正时开启 |
| 音乐重新整理 | 从音乐归档历史中手动重新整理 | 排查和人工修正时开启 |
| 视频同步历史重链 | 从视频同步历史重新生成链接 | 需要重建 STRM 时开启 |
| 音乐同步历史重链 | 从音乐同步历史重新生成链接 | 需要重建音乐软链接时开启 |
关闭某个事件只会停止通知，不会停止任务执行。
通知内容
| 渠道 | 格式 | 内容 |
|---|---|---|
| 企业微信 | 图文单卡或文本 | 媒体名称、任务结果、封面、摘要 |
| Telegram | 文本消息 | 任务名称、媒体名称、成功/失败结果 |
| 企业微信点对点回执 | 文本 | 链接转存成功或失败原因 |
企业微信点对点回执不受事件开关控制。用户在群里发链接后，系统会尽量回复“已转存”或“失败原因”。
企业微信链接转存
链接转存用于在企业微信群里发送网盘分享链接后，由 FlowMedia 自动解析并转存。
企业微信后台参数
在企业微信管理后台创建自建应用，然后设置「接收消息」。
| 参数 | 填写内容 | 说明 |
|---|---|---|
| URL | http://<公网地址>:6688/api/wechat/message/?token=flowmedia | 企业微信必须能访问该地址 |
| Token | 与 FlowMedia 通知配置中的 Token 一致 | 用于校验请求来源 |
| EncodingAESKey | 与 FlowMedia 通知配置中的 Encoding AES Key 一致 | 用于解密消息 |
如果 FlowMedia 在内网，需要使用公网反代、端口转发或内网穿透。企业微信服务器必须能访问
6688的回调地址。
FlowMedia 参数
| 参数 | 含义 | 填写建议 |
|---|---|---|
| Token | 和企业微信后台 URL 配置中的 Token 一致 | 两边必须完全相同 |
| Encoding AES Key | 和企业微信后台一致 | 两边必须完全相同 |
| 默认转存目标 | 收到分享链接后保存到哪个云盘目录 | 设置到归档监控目录下 |
| 目标云盘 | 115 / 123 / 阿里 | 根据分享链接类型和账号支持情况选择 |
工作流程
- 群成员发送网盘分享链接到企业微信群。
- 企业微信把消息回调给 FlowMedia。
- FlowMedia 校验 Token 并解密消息。
- FlowMedia 识别分享链接类型。
- FlowMedia 调用对应云盘转存到预设目录。
- 转存成功后触发归档监控。
- 系统给发送者返回成功或失败回执。
Telegram 通知配置步骤
- 在 Telegram 找到
@BotFather创建机器人。 - 保存 Bot Token。
- 把机器人拉入目标群或直接给机器人发消息。
- 获取 Chat ID。
- 在 FlowMedia「通知渠道 → Telegram」填入 Bot Token 和 Chat ID。
- 点击测试，确认能收到消息。
推荐配置
| 场景 | 推荐 |
|---|---|
| 只想收到任务完成提醒 | 配置企业微信或 Telegram 任意一个渠道即可 |
| 想在群里发链接自动转存 | 必须配置企业微信回调 Token 和 Encoding AES Key |
| 国内服务器无法访问 Telegram | 配置代理或只使用企业微信通知 |
| 不想被大量消息打扰 | 关闭不重要的事件开关，例如历史重链通知 |
| 多人共同使用 | 企业微信更适合群聊链接转存和点对点回执 |
常见问题
| 问题 | 原因 | 处理 |
|---|---|---|
| 企业微信测试失败 | Corp ID / Agent ID / Secret 错误 | 回到企业微信后台核对应用信息 |
| 回调验证失败 | URL、Token、Encoding AES Key 不一致 | 确保企业微信后台和 FlowMedia 填写完全一致 |
| 群里发链接没反应 | 企业微信回调地址公网不可达 | 检查公网反代、端口转发或内网穿透 |
| Telegram 收不到消息 | Bot Token 或 Chat ID 错误，或网络无法访问 Telegram | 重新获取 Chat ID 并检查代理 |
| 转存成功但没有归档 | 默认转存目录不在归档监控目录内 | 修改 CloudDrive2 转存目标或归档监控目录 |
下一步
- 网盘接入 — 配置转存目标
- TG 与 TMDB 订阅 — 配置订阅转存
- 归档刮削 — 转存后自动入库