向 Slack、Discord 或飞书发送通知

完成后,产品的运营提醒会发到团队群聊频道,每次尝试都记录在投递日志中。

运营通知发到团队群聊,不发给用户。后台内置 Slack、Discord 和飞书三个渠道,每个渠道向你在后台保存的 Incoming Webhook URL 发送消息。

准备工作

  • 可以添加 Incoming Webhook 或机器人的 Slack 工作区、Discord 服务器或飞书群。
  • 拥有 config.read 和 config.write 的管理员账号。

在群聊服务创建 Webhook

厂商适用场景
Slack发送到工作区频道
Discord发送到服务器文字频道
飞书发送到群机器人

保存 Webhook URL

创建 Incoming Webhook

在 Slack 应用中启用 Incoming Webhooks,在 Discord 频道的 整合 设置中新建 Webhook,或在飞书群中添加自定义机器人。复制 URL。

粘贴到邮件配置

进入 设置 → 邮件配置(/admin/config/email),在 通知 Webhook 中把 URL 粘贴到 Slack Webhook URL、Discord Webhook URL 或 飞书 Webhook URL。字段显示已保存的地址,清空某一项即删除对应的 Webhook。

保存

点击 保存 provider。这个按钮同时保存所选的邮件卡片,所以如果当前在启用中邮件服务商的卡片上,请保持 设为当前邮件 provider 勾选,否则会关闭邮件发送。

URL 就是凭证

每条通知都是不带签名头的 JSON POST。请妥善保管 Webhook URL,也不要在接收端机器人上开启签名校验,否则请求会被拒绝。

发送测试通知

打开通知

进入 设置 → 通知(/admin/notifications)。

填写测试内容

在 测试通知 中选择 渠道,按需修改 事件 key 和 消息,点击 发送通知。表单显示 通知投递已记录: 及结果。

在代码中发送通知

模板本身不会自动发送运营通知。在产品需要提醒的地方调用 service。用渠道 key 指定渠道:slack-alerts、discord-alerts 或 feishu-alerts。

src/server/services/example.service.ts
import { sendNotificationTest } from "@/server/services/email-notifications.service";

await sendNotificationTest({
  channelKey: "feishu-alerts",
  eventKey: "billing.refund.requested",
  message: "订单 ord_123 申请退款",
  metadata: { orderId: "ord_123" },
});

调用返回投递日志记录,状态为 sent、failed、not_configured 或 disabled。只有渠道 key 不存在时才抛出错误。

分类

Prop

Type

每次投递无论成功失败都会写入记录和审计条目,所以发送失败的通知也能在投递日志中查到。

验证

  • 消息出现在群聊频道中。
  • 投递日志(/admin/notifications/deliveries)中这次尝试为 sent,失败时 错误 列显示群聊服务返回的信息。
  • /admin/notifications/channels 显示每个渠道的状态,状态来自 邮件配置 中保存的 URL。

pnpm validate:email 会检查通知日志和后台路由。

常见问题

投递日志显示 not_configured

该渠道的 Webhook URL 为空。在 邮件配置 中保存 URL,然后再发送一次测试。

投递日志显示 failed

群聊服务拒绝了请求,错误 列显示它的响应。确认 URL 完整且仍然有效,并确认飞书机器人没有开启签名校验。

投递日志显示 disabled

该渠道在数据库中被关闭,即使保存了 URL 也不会发送。

保存 Webhook 后邮件停止发送

Webhook 是在启用中邮件服务商的卡片上保存的,且 设为当前邮件 provider 未勾选。打开该卡片,勾选后点击 保存 provider。

参考

下一步