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.
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).
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#
await aura.notify.email({
to: user.email,
template: 'welcome',
locale: 'fr',
vars: { name: user.name, plan: 'Pro' },
})
Proseguire con un edge.job() per disaccoppiare: il trasmettitore si inserisce nella coda notifications, il lavoratore invia in modo asincrono con riprovazione automatica.
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.