切换主题
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 会分别提示分享是否已转存、离线下载是否已提交，以及自动整理是否已启动。链接全部处理失败时，消息会显示简短原因；较多失败详情请到 QPlay 的“运行日志”中查看。
日常通知
启用消息接入后，可以收到定时同步和自动整理的结果摘要。摘要会使用带时区的时间，分阶段显示新增、更新、失败和待清理旧版本；需要处理时还会显示简短原因、任务编号和“运行日志”入口。所有阶段都没有变化时不会发送通知，避免重复打扰。
连接失败
- 检查 Token、企业 ID、AgentId、Secret 和用户 ID；
- 确认点击了“保存设置”；
- 在右上角用户菜单打开“网络连通性测试”；
- 需要代理时，在“设置 → 系统配置 → 系统代理”填写代理；
- 再点击对应的“发送测试”。
发送测试会逐个检查允许用户的实际投递结果；部分或全部发送失败时，页面会显示成功数、失败数和第一条失败原因。