Уведомления
Электронная почта SMTP, SMS, мобильные push-уведомления, исходящие веб-перехватчики. Шаблоны i18n, ограничение скорости на канал, управление отказами, подписи HMAC. Все, начиная с края работы.
Четыре канала, один унифицированный SDK#
Служба aura-notifications предоставляет единую поверхность aura.notify.*, которая управляет электронной почтой, SMS, push-уведомлениями и веб-перехватчиками. Звонки проходят через очередь NATS с повтором, отсрочкой и DLQ — вы отправляете, мы гарантируем доставку (или возвращаем кредит).
Шаблоны, журналы и квоты находятся в project_{uuid}_platform.notifications_*. 30-дневное хранение журналов доставки (2 года для Enterprise).
Что гарантирует каждый канал#
- Электронная почта (SMTP). Шаблоны MJML/HTML с Liquid, DKIM/SPF/DMARC, ограничением скорости по домену, возвраты управляются автоматически.
- СМС. Несколько провайдеров (Twilio, Vonage, OVH), маршрутизация по стране, автоматический возврат.
- Нажмите. APN (iOS), FCM (Android), Web Push (VAPID). Токены устройств с самопроверкой, удаление недействительных.
- Исходящие веб-перехватчики. HMAC-подпись SHA256, экспоненциальная повторная попытка (5 попыток), DLQ, ротация подписей.
MJML + Liquid, родной i18n#
Создавайте шаблоны из Студии или через CLI. Синтаксис MJML для электронной почты (готовый к использованию), Liquid для шаблонов. Локали управляются файлами welcome.fr.mjml, welcome.en.mjml.
- Шаблоны электронной почты: ~12 на проект (в среднем)
- Локальная поддержка: 38 (Жидкость + автоматический возврат)
- Доставка p99: < 8s (очередь → получатель)
- Ставка входящих: 97.8% (DKIM + выделенный IP)
Четыре канала в коде#
await aura.notify.email({
to: user.email,
template: 'welcome',
locale: 'fr',
vars: { name: user.name, plan: 'Pro' },
})
Продолжайте с помощью edge.job() для разъединения: передатчик помещает сообщение в очередь notifications, исполнитель отправляет асинхронно с автоматической повторной попыткой.
Подписанный вебхук: настройте секрет в разделе «Уведомления» → «Настройки» → «Вебхук» (или WEBHOOK_SIGNING_SECRET на стороне сервиса). Затем каждая отправка содержит заголовок X-Aurabase-Signature: t={timestamp},v1={hmac-sha256} — проверка на стороне получателя, описанная в README пакета @aurabase/notifications.