우편함
'우편함'은 앱에서 우편으로 메시지와 첨부 아이템을 전달하고, 우편 본문 읽음 상태와 첨부 아이템 확인 상태, 만료, 회수, 삭제 상태를 함께 관리하는 기능입니다. 앱 보상을 우편으로 지급하거나 운영 우편 발송을 자동화할 때 우편함을 사용합니다.
Hive Axyl의 역할과 앱의 역할
-
Hive Axyl이 제공하는 기능
Hive Axyl은 우편함을 구현할 때 아래 기능을 제공합니다.
- 우편 발송, 삭제, 회수
- 우편 정보 조회
- 우편 읽음 처리 등 우편 상태 관리
-
앱이 직접 구현해야 하는 작업
Hive Axyl과 별개로 앱이 직접 구현해야 하는 대표적인 작업은 아래와 같습니다.
- 우편함 UI 구현
- 우편 상태를 우편함 UI에 반영
- 첨부 아이템 확인, 다운로드, 소진, 회수, 수령 검증
- 고객 문의 대응, 우편함 운영 정책 수립, 우편함 운영 정책에 따른 고객 대응
사용 방식: Hive 콘솔 또는 Hive Axyl SDK
우편 발송과 회수는 Hive 콘솔과 Hive Axyl SDK 두 가지 방식으로 처리합니다. 콘솔에서는 운영자가 수동으로, SDK에서는 앱이 자동으로 처리합니다.
-
Hive 콘솔
- 운영자 우편 수동 발송과 회수
- 즉시 발송, 예약 발송, 반복 발송 중심 운영 작업
-
Hive Axyl SDK
- 로그인 완료 사용자 기준 우편 발송, 수신, 삭제, 회수
- 랭킹 보상, 업적 보상 등 시스템 조건 기반 즉시 우편 전송 작업
발송 주체: 운영자 우편과 사용자 우편
우편 발송 주체에 따라 운영자 우편과 사용자 우편으로 나뉩니다.
-
운영자 우편
- 운영자 발송 우편
- 즉시 발송, 예약 발송, 반복 발송 지원
- 운영 이슈 대응과 기간 한정 보상 운영을 위한 Hive 콘솔 발송
-
사용자 우편
- 사용자 간 송수신 우편
- Hive 콘솔의 발송 이력 조회 전용, 우편 회수와 발송 취소 미제공
제공 기능
-
우편 발송
우편 발송은 메시지와 첨부 아이템, 만료일, 수신 대상을 함께 설정해 우편을 생성하고 전송하는 기능입니다. 반송 기능은 제공하지 않으며, 우편을 전송할 때 만료 시각을 지정합니다.
-
우편 읽음 처리
우편 읽음 처리는 우편 상세 내용을 확인한 뒤 본문 읽음 상태와 첨부 아이템 수령 상태를 갱신하는 기능입니다. 첨부 아이템이 있는 우편은 열람해도 첨부 아이템 수령 상태가 자동으로 바뀌지 않습니다. 앱이 첨부 아이템 확인 또는 다운로드 완료를 판단한 뒤 그 결과를 상태로 반영해야 합니다.
-
우편 회수
우편 회수는 이미 발송한 우편을 수신자 우편함에서 강제로 제거하는 기능입니다. 이미 읽음 처리되었거나 첨부 아이템 수령 상태가 반영된 우편은 회수하지 않습니다. 회수한 뒤에는 앱에서 수신 우편과 발신 우편 상태를 함께 갱신해야 합니다. 회수된 우편도 삭제 메서드를 별도로 호출하지 않아도 90일 뒤에 자동으로 완전 삭제(HARD DELETE)됩니다.
-
우편 만료와 보관
우편 만료는
ExpiresAt기준 시각이 지난 우편을 만료 상태로 관리하는 기능입니다. 운영자 우편과 사용자 우편 모두 발송할 때 지정한ExpiresAt(UTC) 시각을 만료 기준으로 사용합니다. 만료된 우편은 별도로 삭제 요청을 하지 않아도 90일 뒤에 자동으로 완전 삭제(HARD DELETE)됩니다. -
우편 삭제 수명주기
우편 삭제는 먼저 우편함 또는 콘솔 UI에서 보이지 않도록 임시 삭제(SOFT DELETE) 상태로 전환합니다. 임시 삭제 상태의 우편은 90일 보관 정책에 따라 유지되다가 완전 삭제(HARD DELETE)됩니다. 첨부 아이템을 수령한 뒤 우편 자체를 감추려면 삭제 메서드를 별도로 호출하는 것을 권장합니다.
-
첨부 아이템
Hive Axyl SDK가 제공하는 첨부 아이템 기능은 우편과 함께 전달된 첨부 아이템의 수령 상태를 표시하는 기능입니다. 실제 첨부 아이템의 저장, 보관, 수령, 다운로드 처리와 회수는 모두 앱에서 직접 구현해야 합니다. 따라서 첨부 아이템이 있는 우편은 본문 확인과 첨부 아이템 수령 상태 반영을 분리해 처리해야 합니다.