跳到内容
光环标志
光环基地

通知

SMTP 电子邮件、短信、移动推送、传出 webhooks。 i18n 模板、每个通道的速率限制、退回管理、HMAC 签名。一切都从工作边缘开始。

说明5分钟 读取级别 初学者修改于 2026年4月15日

该页面已自动翻译。英文版具有权威性。

四个渠道,一个统一的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)

代码中的四个通道#

functions/send-welcome.tstypescript
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包的自述文件中。

为了走得更远#