切换主题
Telegram 与企业微信
消息接入可以远程执行同步、整理和状态查询，也可以接收日常维护通知。配置入口为“设置 → 通知与消息”。
Telegram Bot
配置步骤
- 在 Telegram 创建 Bot，复制 Bot Token；
- 在“设置 → 通知与消息 → Telegram Bot”打开“启用”；
- 填写 Bot Token；
- 填写允许使用 Bot 的用户 ID，多个 ID 用逗号分隔；
- 点击“保存设置”，再点击“发送测试”。
保存后向 Bot 发送 /help，确认菜单可用。没有配置代理时不需要额外设置 Telegram 回调地址。
可用命令
| 命令 | 作用 |
|---|---|
/full 或“全量” | 执行全量同步 |
/incremental 或“增量” | 执行增量同步 |
/organize 或“整理” | 执行自动整理 |
/status 或“状态” | 查看任务状态 |
/help 或“菜单” | 查看命令菜单 |
也可以直接点击 Bot 消息中的按钮。只有允许列表中的用户可以执行任务。
企业微信自建应用
QPlay 设置
在“设置 → 通知与消息 → 企业微信自建应用”填写：
- 企业 ID；
- 应用 AgentId；
- 应用 Secret；
- 允许使用的企业微信用户 ID；
- 回调 Token；
- 回调 EncodingAESKey。
打开“启用”，保存设置后点击“发送测试”。
企业微信设置
在企业微信应用的“接收消息”中填写以下地址：
text
https://你的QPlay域名/api/webhooks/wecom将企业微信后台的 Token 和 EncodingAESKey 填入 QPlay，并完成企业微信页面中的地址验证。
如果地址验证失败，检查域名是否可以访问、Token 是否一致，以及 QPlay 中是否填写了允许使用的用户 ID。
可用命令
可以发送：
text
菜单
全量
增量
整理
状态也可以使用与 Telegram 相同的英文命令。
直接发送下载链接
两个渠道都可以直接发送 115 分享链接、magnet 磁力链接或 ed2k 电驴链接。115 分享链接后可以附带“提取码”“访问码”“接收码”或“密码”。
QPlay 会先提示分享是否已转存、离线下载是否已提交。115 分享转存后会按原流程启动自动整理；磁力或电驴任务不会在提交后立即整理。单条消息在提交后 5 秒第一次查询 115 下载状态；如果同一主账号在这 5 秒内又提交离线链接，尚未查询的批次会改为从最新消息起再等待 5 秒。为避免连续发送导致一直不查询，同一聚合窗口从第一条消息起最多等待 15 秒；已经查询过的任务不会被新消息延后。未完成的任务会逐步延长查询间隔，最长每 5 分钟查询一次，避免频繁访问 115；QPlay 重启后也会继续等待。
离线任务下载成功并保存到网盘后，QPlay 会再等待 2 秒启动一次自动整理，并向原提交用户发送完成数、失败数和整理启动结果。多个任务部分成功时会整理成功内容；全部失败时不会启动整理。若当时有同步或整理任务正在运行，QPlay 会稍后重试，不需要重新发送链接。
日常通知
启用消息接入后，可以收到任务完成通知。从概览页任务按钮或消息命令手动启动全量同步、增量同步或自动整理时，任务结束后会立即发送完成摘要；即使没有媒体变化也会发送。任务有媒体入库时，还会按影片或剧集发送图文通知。每条图文通知会显示入库名称、完成时间、季度集数范围、媒体分类，以及可用的 TMDB 评分、TMDB 类型和剧情简介；没有对应资料时会显示“暂无”或“未知”。同一部剧在同一轮整理的一季或多季剧集只发送一条合并通知。自动整理会附上对应的 TMDB 横版剧照；只同步媒体库并生成 STRM 时，会依次使用 STRM 所在文件夹中的 fanart.jpg、thumb.jpg、poster.jpg，都没有时只发文字。Telegram 和企业微信都会把图片与同一份文案放在一条消息中；图片上传或图文发送失败时会自动改发完整文字，不会丢失通知。任务有失败或待清理旧版本时，还会追加简短原因、任务编号和“运行日志”入口。只有定时任务的所有阶段都没有变化时才不发送通知，避免重复打扰。
所有全量同步（包括首次全量）都只向每个接收用户发送一条包含新增、更新、失败和待处理数量的完成摘要，不按影片或剧集逐条发送图文通知，避免大型媒体库集中刷屏。增量同步和自动整理仍保留上面的入库通知。
连接失败
- 检查 Token、企业 ID、AgentId、Secret 和用户 ID；
- 确认点击了“保存设置”；
- 在右上角用户菜单打开“网络连通性测试”；
- 需要代理时，在“设置 → 系统与安全 → 系统代理”填写代理；
- 再点击对应的“发送测试”。
发送测试会逐个检查允许用户的实际投递结果；部分或全部发送失败时，页面会显示成功数、失败数和第一条失败原因。