앱 알림 발행
앱 이벤트를 알림함과 이메일 알림으로 전달합니다.
앱 알림 발행
앱은 NotificationContribution으로 알림 분류와 종류를 선언하고, Core가 전달한 이벤트 처리 중 NotificationPublisher로 알림을 요청합니다. 일치하는 Core와 런타임 버전이 필요합니다. 이전 런타임에서 생성한 카탈로그에는 알림 선언이 없으므로 개발 실행을 다시 준비하거나 새 앱 릴리스를 게시해야 합니다. 코드 변경만으로 실행 중인 런타임이 갱신되지는 않습니다.
선언과 발행
Manifest의 contribution 위치에 NotificationContribution 구현을 두고 notificationCategories()와 notificationIntents()를 제공합니다. 분류와 intent 키는 앱 키로 시작해야 하며, 분류의 labelKey는 앱 번역 카탈로그에 포함합니다. 런타임은 intent의 render([], locale) 제목을 설정 화면의 이름으로 사용하므로 빈 매개변수로도 표시 가능한 제목을 반환하세요.
이벤트 핸들러에서 NotificationPublisher::publish($event, $publication)을 호출합니다. NotificationPublication에는 intent 키, 앱 소유 ResourceRef, 이벤트와 같은 법인, 수신자 ID 목록, 표시 매개변수, 안정적인 중복 방지 키를 전달합니다. 발행은 인증된 이벤트 전달 안에서만 허용됩니다. 임의의 HTTP 요청이나 다른 이벤트로 대체할 수 없습니다.
Core는 현재 승인된 카탈로그와 이벤트 권한을 확인하고, 수신자별 리소스 조회 권한과 알림 설정을 적용합니다. 같은 이벤트·intent·소유 리소스·중복 방지 키·수신자 조합을 다시 전달해도 알림을 중복 생성하지 않습니다. 반환값은 특정 사용자의 존재나 조회 권한을 공개하지 않습니다.
표시와 이메일
선택된 앱의 분류와 종류는 기존 알림 설정에 표시됩니다. 본문은 앱 런타임이 언어별로 렌더링한 스냅샷이며, 알림함은 사용자 언어에 맞는 내용을 선택합니다. 링크는 해당 앱의 /apps/{app-key} 경로 안에 있어야 합니다. 알림을 다시 읽거나 이메일로 보낼 때도 소유 리소스의 현재 조회 권한을 확인합니다.
앱 알림은 default_on 또는 default_off 정책과 방해 금지 시간 존중을 사용합니다. 강제 수신과 방해 금지 우회는 허용하지 않습니다. external_channels에 email을 선언하면 기존 이메일 설정·예약·발송 경로를 사용합니다. 실제 이메일 발송에는 호스트의 발신 계정 설정과 큐 처리가 필요합니다. 일반 EmailContribution 템플릿은 이 알림 연결과 별도입니다.
한 번에 최대 100명의 수신자를 지정할 수 있으며, 요청 전체는 64 KiB로 제한됩니다. 알림 발행은 이미 소비 중인 이벤트의 결과를 전달하며 앱 DB 트랜잭션을 Core DB와 하나로 합치지 않습니다. 실패한 이벤트의 재시도에서는 같은 중복 방지 키를 유지하세요. Core 모델 직접 참조나 알림 테이블 직접 쓰기는 지원하지 않습니다.