알림
SMTP 이메일, SMS, 모바일 푸시, 발신 웹후크. i18n 템플릿, 채널당 속도 제한, 반송 관리, HMAC 서명. 직업상의 모든 것.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.
4개 채널, 하나의 통합 SDK#
aura-notifications 서비스는 이메일, SMS, 푸시 및 웹후크를 관리하는 단일 aura.notify.* 표면을 노출합니다. 통화는 재시도, 백오프 및 DLQ가 포함된 NATS 대기열을 통과합니다. 보내면 배송이 보장됩니다(또는 크레딧 환불).
정보
템플릿, 로그 및 할당량은 project_{uuid}_platform.notifications_*에 있습니다. 전송 로그 30일 보존(Enterprise의 경우 2년)
각 채널이 보장하는 것#
- 이메일(SMTP). Liquid, DKIM/SPF/DMARC가 포함된 MJML/HTML 템플릿, 도메인별 속도 제한, 자동으로 반송 관리됨.
- SMS. 여러 공급자(Twilio, Vonage, OVH), 국가별 라우팅, 자동 대체.
- 푸시. APN(iOS), FCM(Android), 웹 푸시(VAPID). 자체 검증된 장치 토큰, 잘못된 토큰 제거
- 발신 웹훅. HMAC-SHA256 서명, 지수 재시도(5회 시도), DLQ, 서명 순환.
MJML + 액체, 기본 i18n#
Studio 또는 CLI를 통해 템플릿을 생성하세요. 이메일용 MJML 구문(즉시 반응형), 템플릿용 Liquid. welcome.fr.mjml, welcome.en.mjml파일로 관리되는 로케일.
- 이메일 템플릿: 프로젝트당 ~12개 (평균적으로)
- 현지 지원: 38 (Liquid + 자동 대체)
- 배달 p99: < 8s (대기열 → 수신자)
- 받은편지함 비율: 97.8% (DKIM + 전용 IP)
코드의 4개 채널#
typescript
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} 헤더가 전달됩니다. @aurabase/notifications패키지의 README에 문서화된 수신자 측 확인입니다.