Ir para o conteúdo
Aura Logo
aurabase

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.

Explicação5 min lidoNível inicianteRevisado em 15 de abr. de 2026

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

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).

Informações

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#

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

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.

Informações

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.

Para ir mais longe#