
수신함에 최근 알림이 표시됩니다.
1
OneSignal이 푸시마다 이벤트를 보냅니다
Event Stream은 푸시가 전송될 때와 클릭될 때 백엔드 함수로 POST 요청을 보냅니다.
2
함수가 행을 저장하거나 업데이트합니다
전송 이벤트는 수신함 항목을 만듭니다. 클릭 이벤트는 그 항목을 읽음으로 표시합니다.
3
앱이 테이블을 읽습니다
수신함 화면과 헤더 배지는 사용자 본인의 행을 조회합니다.
Event Stream 구성하기 \
대시보드 설정. Data > Event Streams에서 다음과 같이 스트림을 만드세요.- URL: 함수의 주소.
- 헤더: 공유 시크릿. 예:
X-Webhook-Secret. - 이벤트:
message.push.sent와message.push.clicked. - 본문: 요청 형태를 정하는 Liquid 템플릿.
Event Stream body
이 스트림은 모든 기기에 전달된 모든 푸시마다 이벤트를 하나씩 보내며, 각 이벤트는 요금제의 메시지 이벤트 사용량에 포함됩니다. 사용하는 이벤트만 선택하세요.
이벤트 받기 \
함수는 다른 작업보다 먼저 시크릿을 확인합니다.supabase/functions/inbox-webhook/index.ts
supabase/functions/inbox-webhook/index.ts
supabase/functions/inbox-webhook/index.ts
data.type 필드도 각 행에 저장되므로, 수신함은 올바른 아이콘을 표시하고 올바른 화면을 열 수 있습니다.
저장하기 전에 Liquid 렌더링하기 \
스트림은 OneSignal이 수신자별로 개인화하기 전, 작성된 그대로의 메시지를 보고합니다. 백엔드에서 보낸 푸시는 이미 최종 텍스트를 가지고 있지만, Journey 푸시는 그렇지 않습니다. Clean Beans의 Journey 메시지 중 하나는 다음 제목을 사용합니다.Journey push
default 필터를 처리하는 작은 렌더러로 제목과 본문을 저장하기 전에 직접 렌더링합니다. 값은 두 곳에서 가져옵니다.
- 태그는 데이터베이스에서 읽습니다. 앱은 저장해 둔 값으로 각 태그를 설정하므로 함수는 같은 값을 읽습니다. 스트림 본문에
{{ user.tags.user_name }}을 전달하는 방법도 동작하지만, 이름에 큰따옴표가 있으면 본문이 유효하지 않은 JSON이 됩니다. - Journey 이벤트 속성은 스트림에서 사용할 수 없습니다. 함수는 커스텀 이벤트를 발생시킨 청소 세션에서 이를 다시 구성합니다.
supabase/functions/inbox-webhook/index.ts
수신함 표시하기 \
행 수준 보안 덕분에 각 사용자는 자신의 행만 읽을 수 있으므로, 앱의 쿼리에서 사용자별로 필터링할 필요가 없습니다.app/inbox.tsx
src/components/InboxButton.tsx
이메일 설정 동기화하기 \
같은 스트림으로 두 번째 문제도 해결할 수 있습니다. 누군가 이메일에서 Unsubscribe를 탭하면 OneSignal은 그 사람에게 이메일 보내기를 중단하지만, 앱 자체의 “Weekly Email Summary” 스위치는 여전히 켜져 있습니다. 설정 화면이 틀리게 되고, 백엔드는 계속 전송을 시도합니다. 스트림에 이메일 이벤트 네 가지를 추가하면 이 문제가 해결됩니다. 함수는 이들을 모두 같은 방식으로 처리합니다. OneSignal이 이 사람에게 더 이상 이메일을 보내지 않으므로, 앱 설정도 그에 맞춰 끕니다.supabase/functions/inbox-webhook/index.ts
event_kind, event_id, external_id)로 충분하므로 스트림 본문을 바꿀 필요가 없습니다.
이는 앱을 OneSignal에 맞추는 것이지 그 반대가 아닙니다. 누군가 앱에서 이메일을 다시 켜도 OneSignal 구독은 여전히 수신 거부 상태입니다. 다시 구독시키려면 백엔드에서 OneSignal의 구독 API를 호출해야 합니다.
Event Streams
스트림을 설정하고 이벤트를 선택하세요.
Event Stream 데이터
본문 템플릿에서 사용할 수 있는 모든 필드.