配置通知渠道
通知功能让平台向企业微信、飞书、钉钉等IM渠道发送异常告警和使用汇总，帮助你及时了解平台运行状态。
什么时候用
- 需要实时接收系统异常告警时
- 需要每日/每周收到平台使用汇总时
- 需要在团队群中同步平台运行状态时
- 需要查看通知发送历史和失败原因时
你需要准备
- 企业微信、飞书或钉钉的群聊机器人Webhook地址
- （可选）部分平台需要签名密钥用于安全验证
操作步骤
第 1 步：进入通知配置
左侧菜单 -> 系统设置 -> 滚动到「通知配置」区域。
页面分为两部分：
- 上方：IM渠道配置（企业微信/飞书/钉钉）
- 下方：汇总配置（每日/每周）
第 2 步：配置IM渠道
在标签页中选择要配置的IM渠道：
2.1 企业微信
- 点击「企业微信」标签
- 开启「启用」开关
- 输入Webhook地址（从企业微信群聊机器人获取）
- （可选）输入签名密钥
- 点击「测试发送」验证连通性
- 点击「保存通知配置」
2.2 飞书
- 点击「飞书」标签
- 开启「启用」开关
- 输入Webhook地址（从飞书群聊机器人获取）
- （可选）输入签名密钥
- 点击「测试发送」验证连通性
- 点击「保存通知配置」
2.3 钉钉
- 点击「钉钉」标签
- 开启「启用」开关
- 输入Webhook地址（从钉钉群聊机器人获取）
- （可选）输入签名密钥
- 点击「测试发送」验证连通性
- 点击「保存通知配置」
可以同时启用多个渠道，通知会发送到所有已启用的渠道。
第 3 步：配置每日汇总
- 开启「每日汇总」开关
- 在「推送时间」下拉框中选择推送时间（00:00 - 23:00）
- 点击「保存通知配置」
每日汇总包含：
- 当日对话量
- Token使用统计
- 活跃用户数
- 异常事件（如有）
第 4 步：配置每周汇总
- 开启「每周汇总」开关
- 在「推送星期」下拉框中选择星期几（周一到周日）
- 在「推送时间」下拉框中选择推送时间
- 点击「保存通知配置」
每周汇总包含：
- 当周整体使用趋势
- 模型使用分布
- 用户活跃情况
- 异常事件汇总
第 5 步：查看通知日志
左侧菜单 -> 通知日志（如该页面存在）。
查看所有通知的发送记录：
- 发送渠道
- 通知类型
- 发送状态（成功/失败）
- 错误信息（如有）
第 6 步：查看站内通知
点击页面顶部导航栏右侧的通知铃铛图标，查看站内通知：
- 支持按通知类型筛选
- 标记已读
- 全部标为已读
站内通知与IM渠道通知内容同步，但仅对当前用户可见。
怎么验证成功了
- 配置IM渠道后，点击「测试发送」，能在对应群聊中收到测试消息
- 保存配置后刷新页面，配置内容正确保留
- （可选）等待汇总推送时间，能在群聊中收到汇总消息
- 在通知日志中能看到成功的发送记录
常见问题
测试发送失败
检查：
- Webhook地址是否正确
- 机器人是否已加入对应群聊
- 签名密钥是否正确（如启用）
- 网络是否能访问IM平台API
收不到汇总通知
检查：
- 至少一个IM渠道已启用
- 每日/每周汇总开关已开启
- 系统任务中的「通知汇总」任务未被禁用
- 通知日志中是否有失败记录
如何获取Webhook地址
- 企业微信：群聊 -> 添加群机器人 -> 复制Webhook地址
- 飞书：群设置 -> 群机器人 -> 添加机器人 -> 复制Webhook地址
- 钉钉：群设置 -> 智能群助手 -> 添加机器人 -> 复制Webhook地址
通知汇总的定时任务在哪里
通知汇总作为系统任务存在，可在「定时任务」->「系统任务」标签页中查看和启用/禁用。
深入
三种渠道
平台支持三种第三方通知渠道，可同时启用多个：
| 渠道 | 说明 |
|---|---|
| 企业微信 | 使用Markdown格式 |
| 飞书 | 使用纯文本格式 |
| 钉钉 | 使用Markdown格式 |
每个渠道的配置项相同：
- 启用开关
- Webhook地址
- 签名密钥（可选）
通知类型
| 类型 | 说明 |
|---|---|
| 异常告警 | 系统异常时触发发送 |
| 每日汇总 | 固定时间发送当天使用汇总 |
| 每周汇总 | 固定时间发送本周使用汇总 |
| 系统消息 | 平台管理员发送的公告 |
定时汇总
每日/每周汇总由系统定时任务（任务类型为notification_digest）触发执行，由通知汇总执行器生成内容并通过已启用的渠道推送。
汇总执行规则：
- 渠道必须已启用才发送
- 企业微信和钉钉使用Markdown格式，飞书使用纯文本格式
站内通知
站内通知直接显示在控制台顶部通知区域，关联到具体用户：
- 每条通知可包含链接字段，点击后跳转到相关页面
- 支持异常告警/每日汇总/每周汇总/系统消息四种类型
权限边界
| 操作 | 谁可以 |
|---|---|
| 查看/修改通知配置 | 租户 admin |
| 发送通知 | 租户 admin |
| 查看发送日志 | 租户 admin |
| 查看站内通知 | 该通知所属用户 |
| 标记已读 | 该通知所属用户 |
| 查看其它用户站内通知 | 不可以 |
注意事项
- 通知配置修改是全量替换，前端操作时应该先获取当前配置，修改后再提交
- 发送测试通知时测试模式和渠道都是必填的
- 正式发送不传渠道时会遍历所有已启用渠道发送
- 站内通知只能看自己的
- 汇总依赖系统定时任务
排错速查
| 症状 | 可能原因 |
|---|---|
| 发送测试消息失败 | Webhook地址错误、渠道配置未完成 |
| 发送成功但没收到 | 机器人未加入群聊、Webhook被限制 |
| 未收到每日汇总 | 每日汇总未启用或定时任务未启用 |
| 站内通知显示0未读 | 通知不是发给你的 |
| PUT配置后丢失渠道 | 全量替换没有包含所有字段 |