알림
Fóir는 사용자에게 이메일, 앱 내, 푸시로 알림을 전달합니다. 알림은 직접 보내거나 이벤트가 보내게 할 수 있으며, 각 사용자의 수신 설정이 어느 채널로 받을지 결정합니다.
세 가지 채널
앱 내 알림은 로그인한 사용자에게 GraphQL 구독으로 실시간 전달되며, 사용자 본인의 알림만 걸러 냅니다. 푸시는 iOS에는 APNs, Android에는 FCM, 브라우저에는 Web Push를 통해 전달됩니다. APNs와 FCM 자격 증명은 직접 CLI로 업로드하며, 자격 증명이 없는 플랫폼으로의 푸시는 버려집니다. 이메일이 세 번째 채널이며, 프로젝트의 앱 기본 URL을 설정하기 전에는 사용자에게 이메일이 발송되지 않습니다.
하나 보내기
sendNotification 호출은 사용자 한 명에게 보내고, 대량 호출은 여러 명에게 보냅니다. 알림에는 제목이 있으며 메시지, 카테고리, 액션 URL, 이미지, 채널별 재정의, 만료, 멱등성 키를 담을 수 있습니다.
이벤트가 발생할 때 라이프사이클 훅으로도 알림을 보낼 수 있습니다. 콘솔의 훅 폼에서 제목과 수신자 규칙(레코드의 소유자, 프로젝트의 팀 또는 지정한 사람 목록)으로 설정합니다.
카테고리별 수신 설정
수신 설정은 사람별, 카테고리별, 채널별로 저장되며, 사용자는 API를 통해 자신의 설정을 읽고 바꿉니다. Fóir는 전달마다 다음 순서로 판단합니다. 필수로 표시된 카테고리는 항상 발송됩니다. 그렇지 않으면 수신자 본인의 설정이 적용되고, 다음으로 카테고리의 기본값이 적용되며, 둘 다 없으면 알림은 발송됩니다. 카테고리는 이메일로 확인하는 옵트인을 요구할 수도 있으며, 이 경우 사용자가 링크를 따라가기 전까지는 아무것도 켜지지 않고 링크는 7일 뒤 만료됩니다.
이메일 수신 거부 링크의 동작
원클릭 수신 거부는 해당 사용자의 모든 카테고리에 걸쳐 이메일 전체를 끕니다. 출처가 표시된 설정으로 저장되며, 훅이 처리할 수 있는 이벤트를 발생시킵니다. 메일 공급자가 보고한 반송과 불만 접수도 같은 종류의 행을 기록합니다.