다크 모드
알림 규칙
정보
알림 시스템은 룹 관련 주요 이벤트를 푸시 알림과 알림 센터(인앱)를 통해 사용자에게 실시간으로 전달하는 기능입니다.
기능 소개
- 룹 관련 주요 이벤트 발생 시 푸시 알림을 발송합니다.
- 알림 센터(인앱)에서 과거 알림 이력을 확인할 수 있습니다.
- 본인이 수행한 행동에 대해서는 알림을 보내지 않습니다.
- 멀티 디바이스를 지원하여 사용자의 모든 기기에 알림이 전달됩니다.
- 수신자의 언어 설정에 따라 알림 메시지를 다국어로 제공합니다. iOS는 클라이언트 측 로컬라이제이션 키를, Android는 서버 측 번역을 사용합니다.
- 읽음 상태(개별 및 일괄)와 읽지 않은 알림 수를 관리합니다.
동작 규칙
공통 규칙
- 본인 행동 제외: 알림은 이벤트를 발생시킨 본인에게는 발송하지 않습니다. 예를 들어, 미디어를 업로드한 사람은 해당 업로드 알림을 받지 않습니다.
- 멀티 디바이스 지원: 사용자가 여러 기기에 앱을 설치한 경우, 등록된 모든 기기에 푸시 알림이 전달됩니다.
- 다국어 메시지: 알림 메시지는 수신자의 언어 설정에 맞춰 발송됩니다. 같은 이벤트라도 수신자별 언어에 따라 다른 메시지가 전달됩니다.
- 알림 센터 연동: 대부분의 알림은 푸시 알림 발송과 동시에 알림 센터에도 기록됩니다. 단, 연락처 연결 알림은 푸시만 발송되고 알림 센터에는 기록되지 않습니다.
- 읽음 상태 관리: 알림 센터의 각 알림에는 읽음/안읽음 상태가 표시됩니다. 개별 알림을 읽음 처리하거나, 전체 알림을 일괄 읽음 처리할 수 있습니다.
- 읽지 않은 알림 수: 읽지 않은 알림의 개수를 조회할 수 있습니다.
- 딥링크: 각 알림에는 관련 화면으로 이동하는 딥링크가 포함되어 있어, 알림을 탭하면 해당 화면으로 바로 이동합니다.
알림 유형별 발송 조건
룹 관련 알림
| 알림 유형 | 수신자 | 조건 | 알림 센터 기록 |
|---|---|---|---|
| 룹 초대 | 초대받은 사용자 | 호스트가 참여자를 직접 추가했을 때. 초대 링크로 합류하는 경우에는 초대 알림이 발송되지 않음 | O |
| 참여자 합류 | 기존 참여자 (초대한 사람 제외) | 새 참여자가 룹에 합류했을 때 (직접 추가, 초대 링크 합류 모두 해당) | O |
| 날짜 확정 (비회원 참여자) | 비회원 참여자만 | 룹의 날짜가 확정되었을 때. 회원 가입한 비회원은 푸시 알림, 미가입 비회원은 SMS로 발송. 회원 참여자에게는 날짜 확정 푸시 알림이 발송되지 않음 | O (가입 비회원만) |
| 가용 시간 변경 화면 갱신 | 룹 참여자 (응답자 제외) | 참여자가 가능 날짜를 응답하면 다른 참여자의 화면을 자동으로 새로고침. 소리나 배너 없이 백그라운드로 처리됨 | X |
미디어 관련 알림
| 알림 유형 | 수신자 | 조건 | 알림 센터 기록 |
|---|---|---|---|
| 미디어 업로드 | 룹 참여자 (업로더 제외) | 새 사진/영상이 업로드되었을 때 | O |
| 미디어 좋아요 | 미디어 업로더 | 본인의 미디어에 좋아요가 눌렸을 때 | O |
댓글 관련 알림
| 알림 유형 | 수신자 | 조건 | 알림 센터 기록 |
|---|---|---|---|
| 룹 댓글 | 룹 참여자 (작성자 제외) | 룹에 새 댓글이 작성되었을 때 (미디어 댓글, 대댓글이 아닌 경우) | O |
| 미디어 댓글 | 룹 참여자 (작성자 제외) | 미디어에 댓글이 달렸을 때 | O |
| 대댓글 | 룹 참여자 (작성자 제외) | 댓글에 대댓글이 달렸을 때 | O |
| 댓글 좋아요 | 댓글 작성자 | 본인의 댓글에 좋아요가 눌렸을 때 | O |
리캡 관련 알림
| 알림 유형 | 수신자 | 조건 | 알림 센터 기록 |
|---|---|---|---|
| 리캡 완성 | 리캡 생성을 요청한 사용자 | AI 리캡 생성이 완료되었을 때. 룹 참여자 전원이 아니라 요청자 1명에게만 발송 | O |
| 리캡 생성 실패 | 리캡 생성을 요청한 사용자 | AI 리캡 생성이 실패했을 때 | O |
| 리캡 좋아요 | 리캡 생성자 | 본인이 만든 리캡에 좋아요가 눌렸을 때 | O |
ETA 관련 알림
| 알림 유형 | 수신자 | 조건 | 알림 센터 기록 |
|---|---|---|---|
| ETA 공유 | 룹 참여자 (본인 제외) | 참여자가 도착 예정 시간을 공유했을 때. 시간은 룹의 타임존에 맞춰 표시 | O |
| 도착 | 룹 참여자 (본인 제외) | 참여자가 도착했을 때. 수신자의 ETA 상태에 따라 메시지가 달라짐 (ETA 미설정 / ETA 설정 완료 / 이미 도착) | O |
정보
도착 취소(도착 상태에서 ETA 재설정)는 푸시 알림 대신 Live Activity 업데이트만 발생합니다.
리마인더 알림
| 알림 유형 | 수신자 | 조건 | 알림 센터 기록 |
|---|---|---|---|
| 모임 전날 리마인더 | 룹 참여자 | 날짜가 확정된(CONFIRMED) 룹의 모임 전날에 자동 발송 | X |
| 모임 당일 리마인더 | 룹 참여자 | 날짜가 확정된(CONFIRMED) 룹의 모임 당일 아침에 자동 발송 | X |
정보
리마인더는 AI 비서가 채팅방을 통해 전달합니다. 푸시 알림이 아닌 채팅 메시지 형태로 발송되며, EventBridge Scheduler가 트리거합니다.
연락처 관련 알림
| 알림 유형 | 수신자 | 조건 | 알림 센터 기록 |
|---|---|---|---|
| 연락처 연결 | 양쪽 사용자 모두 | 연락처에 있는 사람이 truloop에 가입하여 연결되었을 때. 양쪽 사용자 모두에게 각각 알림 발송 | X |
주의
연락처 연결 알림은 알림 센터에 기록되지 않습니다. 푸시 알림만 발송됩니다.
사용자 흐름
룹 초대 알림 수신
호스트가 참여자를 직접 추가
호스트가 새 룹을 만들면서 참여자를 직접 추가합니다.
초대 알림 수신
초대받은 사용자의 모든 기기에 초대 푸시 알림이 전달됩니다.
합류 알림 수신
기존 참여자에게는 새 참여자가 합류했다는 알림이 전달됩니다. 초대한 사람은 합류 알림을 받지 않습니다.
알림 센터에 기록
푸시 알림과 동시에 알림 센터에도 기록됩니다.
알림 확인
사용자가 푸시 알림을 탭하거나 알림 센터에서 해당 알림을 확인하면, 해당 룹 화면으로 이동하고 알림이 읽음 상태로 변경됩니다.
초대 링크로 합류 시 알림
참여자가 초대 링크로 합류
참여자가 초대 링크를 통해 룹에 합류합니다.
합류 알림만 발송
초대 링크로 합류한 경우 초대 알림은 발송되지 않고, 기존 참여자에게 합류 알림만 전달됩니다.
리캡 완성 알림 수신
AI 리캡 생성 완료
AI가 룹의 미디어를 분석하여 리캡 생성을 완료합니다.
요청자에게 알림
리캡 생성을 요청한 사용자에게 완성 푸시 알림이 전달됩니다.
리캡 확인
사용자가 알림을 탭하면 생성된 리캡 화면으로 이동합니다.
도착 알림 수신
참여자가 도착 완료
한 참여자가 모임 장소에 도착하여 도착을 표시합니다.
수신자별 맞춤 메시지
다른 참여자에게 도착 알림이 전달됩니다. 수신자의 ETA 상태에 따라 메시지가 달라집니다:
- ETA 미설정: ETA 입력을 유도하는 메시지
- ETA 설정 완료: 곧 만날 것이라는 메시지
- 이미 도착: 함께 즐기라는 메시지
관련 문서
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-03-11 | 리마인더 알림 유형 추가 (모임 전날/당일 아침, AI 비서 채팅 메시지 형태) |
| 2026-03-10 | 가용 시간 변경 화면 갱신 알림 유형 추가 |
| 2026-03-10 | 소스 코드 기반으로 알림 유형별 수신자·조건 전면 수정. 리캡 알림 수신 대상 정정(전원→요청자), 리캡 실패·좋아요 알림 추가, 댓글 유형 세분화, 연락처 알림 센터 미기록 명시, 날짜 확정 알림 대상 정정(회원→비회원 참여자만), 초대 링크 합류 분기 추가, 도착 알림 메시지 분기 추가, 일괄 읽음 처리 추가 |
| 2026-03-09 | 최초 작성 |