Vai al contenuto
Logo Aurabase
aurabase

Notifiche

E-mail SMTP, SMS, push mobile, webhook in uscita. Modelli i18n, limite di velocità per canale, gestione dei rimbalzi, firme HMAC. Tutto da un bordo di lavoro.

Spiegazione5 min lettoLivello principianteRevisionato il 15 apr 2026

Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.

Quattro canali, un SDK unificato#

Il servizio aura-notifications espone un'unica superficie aura.notify.* che gestisce email, SMS, push e webhook. Le chiamate passano attraverso una coda NATS con nuovo tentativo, backoff e DLQ: tu invii, noi garantiamo la consegna (o rimborsiamo il credito).

Informazioni

Modelli, log e quote risiedono in project_{uuid}_platform.notifications_*. Conservazione dei registri di consegna per 30 giorni (2 anni su Enterprise).

Cosa garantisce ogni canale#

  • E-mail (SMTP). Template MJML/HTML con Liquid, DKIM/SPF/DMARC, rate-limit per dominio, rimbalzi gestiti automaticamente.
  • SMS. Più fornitori (Twilio, Vonage, OVH), routing per paese, fallback automatico.
  • Spingere. APN (iOS), FCM (Android), Web Push (VAPID). Token del dispositivo autoconvalidati, eliminazione di quelli non validi.
  • Webhook in uscita. HMAC-Firma SHA256, nuovo tentativo esponenziale (5 tentativi), DLQ, firme rotanti.

MJML + Liquido, i18n nativo#

Crea modelli da Studio o tramite CLI. Sintassi MJML per e-mail (responsive out-of-the-box), Liquid per i modelli. Locali gestite dal file welcome.fr.mjml, welcome.en.mjml.

  • Modelli di e-mail: ~12 per progetto (in media)
  • Supportato locale: 38 (Liquido + fallback automatico)
  • Consegna p99: < 8s (coda → destinatario)
  • Tariffa di posta: 97.8% (DKIM + IP dedicato)

Quattro canali in codice#

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

Proseguire con un edge.job() per disaccoppiare: il trasmettitore si inserisce nella coda notifications, il lavoratore invia in modo asincrono con riprovazione automatica.

Informazioni

Webhook firmato: configura un segreto in Notifiche → Impostazioni → Webhook (o WEBHOOK_SIGNING_SECRET sul lato servizio). Ogni invio porta quindi l'intestazione X-Aurabase-Signature: t={timestamp},v1={hmac-sha256}: verifica sul lato destinatario documentata nel README del pacchetto @aurabase/notifications.

Per andare oltre#