Saltar al contenido
Logotipo de Aurabase
aurabase

Notificaciones

Correo electrónico SMTP, SMS, push móvil, webhooks salientes. Plantillas i18n, límite de velocidad por canal, gestión de rebotes, firmas HMAC. Todo desde una perspectiva laboral.

Explicación5 min leerNivel principianteRevisado el 15 abr 2026

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

Cuatro canales, un SDK unificado#

El servicio aura-notifications expone una única superficie aura.notify.* que gestiona correo electrónico, SMS, push y webhooks. Las llamadas pasan por una cola NATS con reintento, suspensión y DLQ: usted envía, nosotros garantizamos la entrega (o le reembolsamos el crédito).

Información

Las plantillas, registros y cuotas se encuentran en project_{uuid}_platform.notifications_*. Retención de 30 días de registros de entrega (2 años en Enterprise).

Qué garantiza cada canal#

  • Correo electrónico (SMTP). Plantillas MJML/HTML con Liquid, DKIM/SPF/DMARC, límite de velocidad por dominio, rebotes gestionados automáticamente.
  • SMS. Múltiples proveedores (Twilio, Vonage, OVH), enrutamiento por país, respaldo automático.
  • Empujar. APN (iOS), FCM (Android), Web Push (VAPID). Tokens de dispositivo autovalidados, eliminando los no válidos.
  • Webhooks salientes. HMAC-Firma SHA256, reintento exponencial (5 intentos), DLQ, firmas rotativas.

MJML + Líquido, i18n nativo#

Cree plantillas desde Studio o mediante CLI. Sintaxis MJML para correo electrónico (responsivo listo para usar), Liquid para creación de plantillas. Configuraciones regionales administradas por el archivo welcome.fr.mjml, welcome.en.mjml.

  • Plantillas de correo electrónico: ~12 por proyecto (en promedio)
  • Apoyo local: 38 (Líquido + respaldo automático)
  • Entrega p99: < 8s (cola → destinatario)
  • Tarifa de inbox: 97.8% (DKIM + IP dedicada)

Cuatro canales en código#

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

Continúe con un edge.job() para desacoplar: el transmisor ingresa a la cola notifications, el trabajador envía de forma asíncrona con reintento automático.

Información

Webhook firmado: configure un secreto en Notificaciones → Configuración → Webhook (o WEBHOOK_SIGNING_SECRET en el lado del servicio). Luego, cada envío lleva el encabezado X-Aurabase-Signature: t={timestamp},v1={hmac-sha256}: verificación en el lado del receptor documentada en el archivo README del paquete @aurabase/notifications.

para ir más lejos#