ClouisleClouisle

通知与外部渠道

查看通知、配置投递渠道并选择产生自动通知的事件类型

通知中心集中显示全站、团队和个人通知,支持搜索、按未读筛选和批量标记已读。自动通知由系统事件触发:管理员决定哪些事件类型产生通知、哪些外部渠道负责投递,普通用户只能查看与标记已读。

查看通知

通知分三类范围,可见性按团队成员关系实时计算:

范围谁能看到
全站所有登录用户
团队目标团队的成员
个人指定的单个用户

优先级为低 / 中 / 高。已读状态是每人一份,你标记已读不会影响其他用户。已过期的通知默认不显示,因此「通知突然消失」通常是过期而非被删除。

页面可以按范围、类型、优先级筛选,用搜索框对标题、正文与类型做不区分大小写的匹配,也可以只看未读、按创建时间筛选。列表分页,每页最多 100 条,默认 20 条。

当前版本只支持批量标记已读(全部已读,或勾选后标记),普通用户不能删除单条通知,删除只由管理员执行。想「清掉某一条」的正确做法是筛选后批量标记已读。

配置渠道

在站点设置 > 通知渠道选择并配置渠道。每个渠道都必须同时满足两点才会真正投递:渠道开关已打开,且必填项已填写。所有渠道默认关闭。

渠道需要填写测试方式
邮件SMTP 主机、端口、加密方式(无 / SSL / TLS)、用户名与密码(可选)、发件人名称与地址在邮件渠道输入测试邮箱并发送测试
WebhookWebhook 地址、HTTP 方法(POST / GET)、自定义请求头(JSON)、请求体模板(JSON)、签名密钥(可选)在 Webhook 渠道发送测试
飞书飞书集成已启用并打开通知功能;已保存 App ID 与 App Secret;接收人已通过通讯录同步绑定飞书身份在飞书子页的消息通知标签页选择接收人并发送测试消息

外部通知渠道只有邮件、Webhook 和飞书三种(旧版第三方聊天渠道已移除)。飞书通知必须单独打开通知功能,并且只发送给已通过通讯录同步绑定飞书身份的用户;未绑定或已停用的接收人不会收到消息。微信 iLink 是消息集成,用于 Agent 对话与知识库采集,不是通知渠道。

保存配置后先发测试消息,确认成功再在自动通知里启用。不要把签名密钥放进 URL 查询参数——查询串会出现在代理、网关与浏览器历史里。

Webhook 渠道配置签名密钥后,出站请求会带 X-Webhook-Signature: sha256=<hex> 与 X-Webhook-Signature-256: <hex> 两个签名头,均为对原始请求体计算的 HMAC-SHA256。接收端必须基于未经解析/重排的原始请求体做常量时间比较,否则会漏检或误判。

请求体模板支持 {{title}}、{{content}}、{{link_url}} 三个占位符。接收方解析失败时该次外部发送会记为发送失败,但站内通知已经生成——外部渠道故障不会让消息丢失。

通知渠道设置
通知渠道设置

自动通知

自动通知页控制两类设置:

  • 外部渠道:哪些渠道参与投递(可多选;不选则通知只留在站内)
  • 事件类型:哪些事件产生通知

查看需要站点设置的查看权限,保存需要修改权限。提交未知的事件类型会被拒绝,不会静默丢弃。

共 25 个可用类型,默认启用 19 个:

分组事件类型默认启用
团队成员加入、成员移除、角色变更、所有权转移、模型授权、模型授权撤销是
用户用户激活、用户停用、密码重置、待审批是
知识库文档已索引、文档处理失败是
工作流工作流失败、工作流审批是
工作流工作流成功否
AgentAgent 已发布、Agent 已下线否
API KeyAPI Key 即将过期、API Key 已过期是
安全登录异常、账户锁定、密码已更改是
密码过期密码即将过期、密码已过期否
密码过期强制修改密码否(当前没有触发来源)

关闭类型=永久丢事件

类型一旦未启用,事件发生时通知根本不会创建(判断发生在生成之前),事后启用也补不回来。工作流成功默认关闭是有意的——每次成功运行都通知会迅速淹没通知中心;只有确实需要逐次确认时才打开。Agent 发布与下线同样属于量大、按需开启的类型。

定时检查

以下自动通知由平台按天检查,时区为服务端时区:

检查时间行为
API Key 到期每天 09:00找出 7 天内即将过期的 Key,仅在剩余 7、3、1 天时各提醒一次;已过期的发「API Key 已过期」
密码到期每天 08:00密码已过期发「密码已过期」;进入警告期(默认 7 天)后仅在剩余 7、3、1 天时提醒

「只在 7/3/1 天提醒」是刻意的去重机制——否则每天都会重复轰炸同一个用户。

登录异常检测

登录异常通知不是规则引擎,而是「与历史登录指纹比对」:

  • 每个用户保留最近 30 天、最多 10 个 IP 与 10 个浏览器标识(超出后自动淘汰最旧的)。
  • 出现已知集合之外的 IP 或浏览器标识即判定异常并发出「登录异常」通知。
  • 首次登录永远不会被判为异常(没有历史可比),因此新账号的第一条登录记录是干净的。
  • 登录历史保存在平台中;存储不可用时本次检测被跳过(不会误报)。

单一代理出口 IP 会掩盖真实来源,共享 NAT 出口也会让「新 IP」判断失真。安全要求高的部署应把异常登录通知与审计日志中的「登录成功」「登录失败」记录配合使用,而不是只依赖异常检测。

发送状态

外部发送状态包括待发送、发送中、已发送、发送失败,以及已跳过(没有符合条件的接收人)。失败会记录重试次数;飞书部分成功时,通知详情里会显示成功数与总数(例如「已发送给 2/5 位接收人」)。这些记录与消息集成的投递记录分开,后者见投递记录。

不要只依赖外部渠道。重要安全事件请同时到通知中心与审计日志确认:审计日志是落库的权威记录,外部渠道可能因凭据失效或网络问题静默失败。

管理员操作要点

  • 用户侧:定期查看通知中心;安全类通知立即处理,必要时改密。
  • 管理员侧:先配好渠道并测试成功,再在自动通知里勾选;渠道未配置时勾选不会产生任何外发,只会让人误以为「通知已发」。飞书渠道还需要接收人已通过通讯录同步绑定飞书身份,否则该次发送会记为「已跳过」或部分成功。
  • 启用类型要有取舍:工作流成功与 Agent 发布/下线这类事件量大,只在确实需要时开启。
  • 非全局管理员只能管理自己团队的通知:不能选择全站范围,必须指定团队,并通过该团队的管理员校验,因此看不到、也管不到其他团队的通知。

相关文档

这篇文章对你有帮助吗?

本页目录