Aller au contenu
Logo Aurabase
aurabase

Notifications

Email SMTP, SMS, push mobile, webhooks sortants. Templates i18n, rate-limit par canal, bounce management, signatures HMAC. Tout depuis un job edge.

Explication5 min de lectureNiveau débutantRévisé le 15 avr. 2026

Quatre canaux, un SDK unifié#

Le service aura-notifications expose une surface unique aura.notify.* qui gère email, SMS, push et webhooks. Les appels passent par une queue NATS avec retry, backoff et DLQ — vous envoyez, nous garantissons la livraison (ou remboursons le crédit).

Informations

Les templates, logs et quotas vivent dans project_{uuid}_platform.notifications_*. Rétention 30 jours des logs de livraison (2 ans sur Enterprise).

Ce que chaque canal garantit#

  • Email (SMTP). Templates MJML/HTML avec Liquid, DKIM/SPF/DMARC, rate-limit par domaine, bounces gérés automatiquement.
  • SMS. Providers multiples (Twilio, Vonage, OVH), routage par pays, fallback automatique.
  • Push. APNs (iOS), FCM (Android), Web Push (VAPID). Device tokens auto-validés, purge des invalides.
  • Webhooks sortants. HMAC-SHA256 signing, retry exponentiel (5 tentatives), DLQ, signatures tournantes.

MJML + Liquid, i18n natif#

Créez des templates depuis le Studio ou via CLI. Syntaxe MJML pour l'email (responsive out-of-the-box), Liquid pour le templating. Locales gérées par fichier welcome.fr.mjml, welcome.en.mjml.

  • Email templates: ~12 par projet (en moyenne)
  • Locales supportées: 38 (Liquid + fallback auto)
  • Delivery p99: < 8s (queue → destinataire)
  • Inbox rate: 97.8% (DKIM + IP dédiée)

Quatre canaux en code#

functions/send-welcome.tstypescript
await aura.notify.email({
  to: user.email,
  template: 'welcome',
  locale: 'fr',
  vars: { name: user.name, plan: 'Pro' },
})
Astuce

Enchaînez avec un edge.job() pour découpler : l'émetteur push dans la queue notifications, le worker envoie en asynchrone avec retry automatique.

Informations

Webhook signé : configurez un secret dans Notifications → Réglages → Webhook (ou WEBHOOK_SIGNING_SECRET côté service). Chaque envoi porte alors l'en-tête X-Aurabase-Signature: t={timestamp},v1={hmac-sha256} — vérification côté récepteur documentée dans le README du package @aurabase/notifications.

Pour aller plus loin#