Benachrichtigungen
SMTP-E-Mail, SMS, Mobile Push, ausgehende Webhooks. i18n-Vorlagen, Ratenbegrenzung pro Kanal, Bounce-Management, HMAC-Signaturen. Alles von einem Job Edge.
Vier Kanäle, ein einheitliches SDK#
Der Dienst aura-notifications stellt eine einzelne aura.notify.*-Oberfläche bereit, die E-Mail, SMS, Push und Webhooks verwaltet. Anrufe durchlaufen eine NATS-Warteschlange mit Wiederholung, Backoff und DLQ – Sie senden, wir garantieren die Zustellung (oder erstatten das Guthaben).
Vorlagen, Protokolle und Kontingente leben in project_{uuid}_platform.notifications_*. 30-tägige Aufbewahrung von Lieferprotokollen (2 Jahre bei Enterprise).
Was jeder Kanal garantiert#
- E-Mail (SMTP). MJML/HTML-Vorlagen mit Liquid, DKIM/SPF/DMARC, Ratenbegrenzung nach Domäne, automatisch verwaltete Bounces.
- SMS. Mehrere Anbieter (Twilio, Vonage, OVH), Routing nach Land, automatisches Fallback.
- Drücken. APNs (iOS), FCM (Android), Web Push (VAPID). Selbstvalidierte Geräte-Tokens, Löschung ungültiger Token.
- Ausgehende Webhooks. HMAC-SHA256 Signierung, exponentielle Wiederholung (5 Versuche), DLQ, rotierende Signaturen.
MJML + Liquid, natives i18n#
Erstellen Sie Vorlagen aus dem Studio oder über die CLI. MJML-Syntax für E-Mail (responsiv sofort einsatzbereit), Liquid für Vorlagen. Von der Datei welcome.fr.mjml, welcome.en.mjml verwaltete Gebietsschemas.
- E-mail-vorlagen: ~12 pro Projekt (im Durchschnitt)
- Lokal unterstützt: 38 (Liquid + Auto-Fallback)
- Lieferung p99: < 8s (Warteschlange → Empfänger)
- Inbox-preis: 97.8% (DKIM + dedizierte IP)
Vier Kanäle im Code#
await aura.notify.email({
to: user.email,
template: 'welcome',
locale: 'fr',
vars: { name: user.name, plan: 'Pro' },
})
Fahren Sie mit einem edge.job() zum Entkoppeln fort: Der Sender schiebt in die notifications-Warteschlange, der Worker sendet asynchron mit automatischem Wiederholungsversuch.
Signierter Webhook: Konfigurieren Sie ein Geheimnis unter Benachrichtigungen → Einstellungen → Webhook (oder WEBHOOK_SIGNING_SECRET auf der Dienstseite). Jeder Versand trägt dann den X-Aurabase-Signature: t={timestamp},v1={hmac-sha256}-Header – eine Überprüfung auf der Empfängerseite, die in der README-Datei des @aurabase/notifications-Pakets dokumentiert ist.