通知
SMTP 電子メール、SMS、モバイル プッシュ、送信 Webhook。 i18n テンプレート、チャネルごとのレート制限、バウンス管理、HMAC 署名。すべては仕事上の縁から。
4 つのチャネル、1 つの統合 SDK#
aura-notifications サービスは、電子メール、SMS、プッシュ、Webhook を管理する単一の aura.notify.* サーフェスを公開します。呼び出しは、再試行、バックオフ、および DLQ を使用して NATS キューを通過します。送信すると、配信が保証されます (またはクレジットが返金されます)。
テンプレート、ログ、クォータは project_{uuid}_platform.notifications_*に存在します。配信ログは 30 日間保存されます (Enterprise では 2 年間)。
各チャネルが保証するもの#
- 電子メール (SMTP)。 Liquid、DKIM/SPF/DMARC を使用した MJML/HTML テンプレート、ドメインによるレート制限、バウンスは自動的に管理されます。
- SMS。 複数のプロバイダー (Twilio、Vonage、OVH)、国別のルーティング、自動フォールバック。
- 押します。 APN (iOS)、FCM (Android)、Web プッシュ (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)
コード内の 4 つのチャネル#
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パッケージの README に記載されています。