Notificações
E-mail SMTP, SMS, push móvel, webhooks de saída. modelos i18n, limite de taxa por canal, gerenciamento de rejeição, assinaturas HMAC. Tudo, desde uma vantagem de trabalho.
Quatro canais, um SDK unificado#
O serviço aura-notifications expõe uma única superfície aura.notify.* que gerencia email, SMS, push e webhooks. As chamadas passam por uma fila NATS com nova tentativa, espera e DLQ – você envia, nós garantimos a entrega (ou reembolsamos o crédito).
Modelos, logs e cotas residem em project_{uuid}_platform.notifications_*. Retenção de logs de entrega por 30 dias (2 anos no Enterprise).
O que cada canal garante#
- E-mail (SMTP). Modelos MJML/HTML com Liquid, DKIM/SPF/DMARC, limite de taxa por domínio, rejeições gerenciadas automaticamente.
- SMS. Vários provedores (Twilio, Vonage, OVH), roteamento por país, fallback automático.
- Empurre. APNs (iOS), FCM (Android), Web Push (VAPID). Tokens de dispositivo autovalidados, eliminando os inválidos.
- Webhooks de saída. HMAC-SHA256 assinatura, nova tentativa exponencial (5 tentativas), DLQ, assinaturas rotativas.
MJML + Líquido, i18n nativo#
Crie modelos no Studio ou via CLI. Sintaxe MJML para e-mail (responsivo pronto para uso), Liquid para modelagem. Localidades gerenciadas pelo arquivo welcome.fr.mjml, welcome.en.mjml.
- Modelos de e-mail: ~12 por projeto (em média)
- Suportado local: 38 (Líquido + substituto automático)
- Entrega p99: < 8s (fila → destinatário)
- Taxa de caixa de entrada: 97.8% (DKIM + IP dedicado)
Quatro canais em código#
await aura.notify.email({
to: user.email,
template: 'welcome',
locale: 'fr',
vars: { name: user.name, plan: 'Pro' },
})
Continue com um edge.job() para desacoplar: o transmissor entra na fila notifications, o trabalhador envia de forma assíncrona com nova tentativa automática.
Webhook assinado: configure um segredo em Notificações → Configurações → Webhook (ou WEBHOOK_SIGNING_SECRET no lado do serviço). Cada envio carrega o cabeçalho X-Aurabase-Signature: t={timestamp},v1={hmac-sha256} - verificação no lado do receptor documentada no README do pacote @aurabase/notifications.