向 Slack、Discord 或飞书发送通知
完成后,产品的运营提醒会发到团队群聊频道,每次尝试都记录在投递日志中。
运营通知发到团队群聊,不发给用户。后台内置 Slack、Discord 和飞书三个渠道,每个渠道向你在后台保存的 Incoming Webhook URL 发送消息。
准备工作
- 可以添加 Incoming Webhook 或机器人的 Slack 工作区、Discord 服务器或飞书群。
- 拥有
config.read和config.write的管理员账号。
在群聊服务创建 Webhook
保存 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。
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。