通知
SMTP 电子邮件、短信、移动推送、传出 webhooks。 i18n 模板、每个通道的速率限制、退回管理、HMAC 签名。一切都从工作边缘开始。
该页面已自动翻译。英文版具有权威性。
四个渠道,一个统一的SDK#
aura-notifications 服务公开一个 aura.notify.* 表面,用于管理电子邮件、短信、推送和 Webhooks。呼叫通过 NATS 队列进行重试、退避和 DLQ — 您发送,我们保证送达(或退款)。
信息
模板、日志和配额位于 project_{uuid}_platform.notifications_*中。交付日志保留 30 天(企业版为 2 年)。
每个渠道保证什么#
- 电子邮件 (SMTP)。 MJML/HTML 模板,带有 Liquid、DKIM/SPF/DMARC、按域进行速率限制、自动管理退回邮件。
- 短信。 多个提供商(Twilio、Vonage、OVH)、按国家/地区路由、自动回退。
- 推。 APNs (iOS)、FCM (Android)、网络推送 (VAPID)。自我验证的设备令牌,清除无效的设备令牌。
- 传出 webhook。 HMAC-SHA256 签名、指数重试(5 次尝试)、DLQ、轮换签名。
MJML + Liquid,原生 i18n#
从 Studio 或通过 CLI 创建模板。用于电子邮件的 MJML 语法(开箱即用的响应式),用于模板的 Liquid。由文件 welcome.fr.mjml、 welcome.en.mjml管理的区域设置。
- 电子邮件模板: 每个项目约 12 个 (平均而言)
- 本地支持: 38 (液体+自动回退)
- 交付 p99: < 8s (队列→接收者)
- 收件率: 97.8% (DKIM + 专用 IP)
代码中的四个通道#
typescript
await aura.notify.email({
to: user.email,
template: 'welcome',
locale: 'fr',
vars: { name: user.name, plan: 'Pro' },
})
提示
继续使用 edge.job() 进行解耦:发送器推入 notifications队列,工作器异步发送并自动重试。
信息
签名的 Webhook:在通知 → 设置 → Webhook(或服务端的 WEBHOOK_SIGNING_SECRET)中配置密钥。然后,每次发送都会携带 X-Aurabase-Signature: t={timestamp},v1={hmac-sha256} 标头 - 接收方的验证记录在 @aurabase/notifications包的自述文件中。