¶ 系统通知
系统运行状态以及发生错误时，会通过系统通知进行提醒，可登录WEB管理界面，在右上角消息提醒中心进行查看。
V2版本变化说明
1、v2.0.0+ 版本后API_TOKEN需要设置16位或以上的复杂字符串 。
2、如果同一类型的消息配置了多个，回调请求地址中还需要加上 &source=配置名称 参数，其中配置名称建议使用英文，如果配置名称为中文或存在特殊字符（如空格），部分平台（如企业微信）可能需要进行URL编码。
3、为了方便识别和管理，建议统一在所有回调地址中添加source参数，以确保各配置间的区分和调用更加清晰。
4、API_TOKEN获取路径：设定 -> 系统 -> 基础设置 -> API令牌
¶ 通知隔离
V2版本支持消息通知按用户隔离，需要在用户个人信息中维护对应通知渠道的ID，同时在设定中按消息类型选择好通知发送范围。
- 使用远程消息或菜单命令交互进行交互时，交互类消息只有操作人才能收到。
- 对于用户主动发起的操作或者有关联到对应用户的通知，比如开始下载、新增订阅、完成订阅等，按设定的通知发送范围设定，可发送给操作人、管理员或全体人员。
- 对于入库、系统通知、各类插件通知等系统自动发起无法关联操作人员的广播类消息，按消息发送范围设定，可指定发送给管理员或者全体人员。
- 如果对应用户没有正常维护个人信息中的相关通知渠道ID，通知将会发送给管理员，如果管理员也没有维护通知渠道ID，通知可能会发送失败。发送给全体的通知不受此限制。
- 对于一些插件会添加订阅的，如果想实现该类订阅通知发送给特定人员，需要在系统中建立一个名称与该插件产生的订阅用户名一致的用户，并设定通知渠道ID。
¶ 微信
在企业微信控制台
我的企业->微信插件找到二维码，使用微信扫码后可直接在微信使用，无需打开企业微信客户端。
- 企业ID：在企业微信管理后台
我的企业－企业信息下查看企业ID。 - 应用Secret： 在企业微信管理后台
应用管理－自建下查看Secret。 - 应用AgentId：在企业微信管理后台
应用管理－自建下查看AgentId。 - 消息推送代理：填写自己可用的
消息代理服务地址，并将消息代理服务器的真实IP填写到企业微信应用IP白名单中。
¶ 微信消息回调
- 在微信企业应用
接收消息设置页面生成Token和EncodingAESKey并填入设定->通知->微信对应项，并保存。 - 在微信企业应用
接收消息页面输入此地址：http(s)://DOMAIN:PORT/api/v1/message/?token=moviepilot（其中moviepilot修改为实际配置中实际的API_TOKEN的值，DOMAIN、PORT替换为本工具的外网访问地址及端口，需要有公网IP域名并做好端口转发），能正常保存即设置成功。 - 会自动生成微信控制菜单，无需手动维护。
¶ 消息代理服务器
2022年6月后新建的企业微信应用需要有固定公网IP的代理才能接收到消息，需要使用有固定IP的VPS搭建代理服务，同时代理添加以下代码：
location /cgi-bin/gettoken {
proxy_pass https://qyapi.weixin.qq.com;
}
location /cgi-bin/message/send {
proxy_pass https://qyapi.weixin.qq.com;
}
location /cgi-bin/menu/create {
proxy_pass https://qyapi.weixin.qq.com;
}
可以使用这个项目直接搭建：wxchat-Docker
感谢 @snnh 提供的教程：使用腾讯云cdn实现企业微信反向代理
或者使用 TCP 中转服务器来实现，以 socat 为例，使用 docker compose 搭建中转服务器
version: "3.5"
services:
wxqyapi-relay:
image: alpine/socat
container_name: wxqyapi-relay
command: "TCP-LISTEN:9090,fork,reuseaddr TCP:qyapi.weixin.qq.com:443"
expose:
- "9090"
ports:
- "443:9090"
restart: unless-stopped
然后添加 hosts 将 qyapi.weixin.qq.com 指向该服务即可
ip_of_your_server qyapi.weixin.qq.com
如果 socat 服务不能使用 443 端口，需要配置 WECHAT_PROXY，比如 socat 监听的 8543 端口，需要设置 WECHAT_PROXY=https://qyapi.weixin.qq.com:8543 并同时配置 hosts
TCP 中转服务也可以通过 Nginx 实现，通常 socat 用不了 443 端口都是因为 443 被 Nginx 占用了，方法参考 https://atpx.com/blog/nginx-tcp-proxy-forward-client-ip/
¶ 管理员白名单
设置后，只有在管理员白名单的用户才可以使用微信应用号的菜单功能。
¶ Telegram
- 采用消息轮循方式接收消息，无需特殊设置即具有Telegram消息交互能力。
- 需要网络能正常连挡Telegram。
¶ 用户白名单
设置后，只有用户白名单中的ID对应用户，才能关注你的机器人发送消息。
¶ 管理员白名单
设置后，只有在管理员白名单的用户才可以关注你的机器人并操作命令功能。
¶ Slack
- https://slack.com/intl/zh-cn/ 创建工作区
- https://api.slack.com/ 创建App应用，打开
Socket Mode。 - 开启
Event Subscriptions、Bots、Permissions。其中Bot Token Scopes赋于chat:write、im:read、im:history、channels:read、commands、groups:read权限；Subscribe to bot events赋于message.im、app_mention权限；按需维护Interactivity & Shortcuts菜单，类型为Global，菜单Callback ID需与项目主页说明一致。 - 创建
App-Level Tokens并赋于connections:write权限。 - Install App 到工作区，登录工作区将App添加到
全体频道。 OAuth & Permissions中 获取Bot User OAuth Token，Basic Information中 获取App-Level Tokens填入相关设置项中，保存。
¶ SynologyChat
- 群晖中安装
Synology Chat。 整合->机器人中创建机器人，机器人勾选启用整合，取消在聊天机器人列表中隐藏，传出URL设置为http://ip:port/api/v1/message/?token=moviepilot，其中moviepilot修改为实际配置中实际的API_TOKEN的值，ip:port为实际MoviePilot的IP地址和端口。记录机器人传入URL和令牌。- 将
机器人传入URL和令牌填入MoviePilot相关设置项，保存。 - Synology Chat界面中左侧机器人，点
+号，添加机器人聊天。
¶ VoceChat
- 参考 https://doc.voce.chat 搭建VoceChat服务，创建机器人，获取
机器人密钥和频道ID连同服务地址填入对应设置项，保存。 - VoceChat机器人Webhook地址设置为：
http://ip:port/api/v1/message/?token=moviepilot，其中moviepilot修改为实际配置中实际的API_TOKEN的值，ip:port为实际MoviePilot的IP地址和端口。
¶ Discord
Discord 通知渠道配置方法
-
建立一个Discord bot
- 打开并登录 https://discord.com/login?redirect_to=%2Fdevelopers%2Fapplications
- 建立一个新应用，比如叫 MoviePilot。
- 进入应用并导航到Bot页面（可以自己配置想用的icon），确保启用
Presence Intent、Server Members Intent以及Message Content Intent
-
安装bot到自己的Discord服务器
- 导航到Installation，按照图示设置好权限。
- 复制打开安装链接，选择需要安装的服务器安装。
-
配置MoviePilot
- 回到Bot页面，点击Reset Token。
- 将这个Token放入MoviePilot通知渠道配置中的Bot Token。
- 打开Discord并选择你想要发送MP通知的频道，右键复制链接，这个链接URL的最后一串数字是频道ID，前一串数字是服务器ID，将这两个ID填入通知渠道配置并保存。
¶ WebPush
WebPush基于PWA实现让网页应用能像App客户端一样发送消息通知，实现客户端级的消息通知使用体验，开启WebPush需要满足以下条件：
- 使用域名访问MoviePilot，并设置启动好
SSL。 - 将MoviePilot网页发送到桌面图标，完成PWA应用安装。
- 在桌面图标启动，完成登录，在提示窗口中点击允许发送消息权限。
- 如果为IOS，需要
16.4以上版本。
建议将插件、站点等消息通过WebPush发送，其余媒体类消息则通知到微信等客户端，实现管理员消息通知和普通使用用户通知分离。