The Problem
푸시 알림, 왜 어려운가?
FCM 직접 연동의 복잡함
Firebase Admin SDK 설정, 서비스 계정 관리, 토큰 유효성 검증 등 직접 구현할 게 많습니다.
디바이스 토큰 관리
만료된 토큰, 무효화된 토큰, 멀티 디바이스 처리를 직접 관리해야 합니다.
발송 실패 추적 어려움
어떤 알림이 실패했는지, 왜 실패했는지 추적하기 힘듭니다.
Channels
2개 채널, 하나의 API
푸시 알림과 인앱 알림을 통합 API로 간편하게 발송하세요
FCM Push
즉시 도달무료
Firebase Cloud Messaging 기반 모바일/웹 푸시 알림
- iOS & Android 지원
- 웹 푸시 지원
- 우선순위 설정 (HIGH/NORMAL/LOW)
- Bull Queue 기반 안정적 발송
- 토픽 구독/발송
- 멀티캐스트 (최대 500개)
In-App 알림
앱 사용자무료
앱 내 알림 센터로 사용자에게 메시지 전달
- 알림 목록 조회
- 읽음/안읽음 상태 관리
- 전체 읽음 처리
- 안 읽은 알림 개수
- 알림 히스토리 보관
- 배치 삭제 지원
Features
알림에 필요한 모든 기능
단순 발송을 넘어, 스마트한 알림 운영을 지원합니다
디바이스 관리
사용자의 멀티 디바이스를 자동으로 관리합니다.
- FCM 토큰 자동 갱신
- 무효 토큰 자동 정리
- 디바이스별 발송
- 토큰 유효성 검증
Bull Queue 기반 발송
안정적인 메시지 큐로 대량 발송도 문제없이.
- 우선순위 기반 처리
- 자동 재시도 (3회)
- 실패 알림 재발송
- 발송 통계 조회
읽음 상태 관리
인앱 알림의 읽음/안읽음 상태를 추적합니다.
- 개별 읽음 처리
- 전체 읽음 처리
- 안 읽은 개수 조회
- 읽음 시간 기록
사용자 선호도
채널별 수신 동의와 알림 카테고리를 관리하세요.
- 채널별 수신 설정
- 방해금지 시간대
- 알림 카테고리 필터
- 사용자별 설정
토픽 발송
관심사 기반 토픽 구독으로 타겟 발송.
- 토픽 구독/해제
- 토픽별 발송
- 구독자 그룹 관리
- 멀티캐스트 지원
발송 모니터링
알림 발송 결과를 실시간으로 확인하세요.
- 발송 성공/실패
- 큐 상태 조회
- 에러 메시지 추적
- 재시도 현황
Developer Experience
개발자 친화적 API
직관적인 REST API로 빠르게 연동하세요
notification.ts
// FCM 푸시 알림 발송
const result = await notificationApi.send({
userId: 123,
fcmToken: 'device_fcm_token...',
title: '주문 완료',
body: '주문이 정상적으로 접수되었습니다.',
type: 'PUSH',
priority: 'HIGH',
data: {
orderId: 'ORD-2024-001',
action: 'ORDER_DETAIL'
}
});
// 인앱 알림 목록 조회
const notifications = await notificationApi.getMyNotifications({
page: 1,
limit: 20
});
// 안 읽은 알림 개수
const { count } = await notificationApi.getUnreadCount();
// 전체 읽음 처리
await notificationApi.markAllAsRead();Multi-Tenant
테넌트별 완전 격리된 알림 데이터 관리
Queue 기반
Bull Queue로 대량 발송도 안정적으로 처리
JWT 인증
Passport.js 기반 안전한 API 접근 제어
Architecture
안정적인 알림 아키텍처
API 요청
REST API로 알림 발송 요청
DB 저장
PostgreSQL에 알림 기록 저장
Bull Queue
Redis 기반 메시지 큐 처리
FCM 발송
Firebase로 디바이스에 전달
3회
자동 재시도
100/초
발송 처리량
30초
작업 타임아웃
2
알림 채널
99.9%
발송 성공률
<1초
평균 발송 시간
24/7
실시간 모니터링
Use Cases
다양한 서비스에 적용
이커머스
주문부터 배송까지 고객에게 실시간으로 알려주세요.
- 주문 접수 알림
- 배송 출발/도착 알림
- 결제 완료 알림
- 리뷰 요청 푸시
SaaS
시스템 이벤트와 중요 알림을 놓치지 않게 전달하세요.
- 결제 알림
- 사용량 경고
- 기능 업데이트
- 보안 알림
커뮤니티
사용자 활동과 소셜 이벤트를 실시간으로 알려주세요.
- 댓글/좋아요 알림
- 멘션 알림
- 팔로워 알림
- 활동 요약