같은 알림을 두 번 보내지 않기 \
예약된 작업은 재시도됩니다. 실수로 두 번 실행될 수도 있습니다. 보호 장치가 없으면 반복될 때마다 푸시가 한 번 더 전송됩니다. OneSignal의idempotency_key가 이 문제를 해결합니다. 두 요청이 같은 키를 가지면 두 번째 요청은 전송되지 않습니다. 키는 UUID여야 하며 OneSignal은 이를 30일 동안 기억합니다.
예약된 함수에는 실행 사이에 무작위 키를 보관할 곳이 없으므로, Clean Beans는 전송의 성격, 즉 유형, 수신자, 날짜에서 키를 만듭니다. 같은 전송은 항상 같은 키를 생성합니다.
supabase/functions/_shared/idempotency.ts
배치 전송에서는 키가 배치 전체를 대상으로 합니다.
supabase/functions/send-cleaning-reminder/index.ts
멱등성 키는 Create message 및 Create custom events 엔드포인트에서 동작합니다. Live Activity 요청은 이를 받지 않습니다. Live Activity는
activity_id로 식별됩니다.푸시 유형마다 고유한 동작 부여하기 \
두 시간 늦게 도착한 청소 알림은 알림이 없는 것보다 나쁩니다. Kudos는 받으면 기쁘지만 급하지 않습니다. Clean Beans는 이러한 차이를 전송 프로필 집합에 한 번만 정의하고, 각 요청에 알맞은 프로필을 펼쳐 넣습니다.supabase/functions/_shared/delivery.ts
유형 목록의
member_lapsed 프로필은 Journey 웹훅에서 보내는 푸시용이며, 이 가이드에서는 다루지 않습니다.
각 설정의 역할:
ttl은 오프라인 기기를 위해 푸시를 보관하는 기간입니다. 청소 알림은 “1시간 후”라고 알리므로 1시간이 지나면 폐기됩니다.thread_id와android_group은 관련 푸시를 알림 목록에서 함께 묶습니다.ios_interruption_level은 푸시가 얼마나 강하게 알리는지 제어합니다.time_sensitive는 집중 모드를 뚫고 표시될 수 있습니다.passive는 조용히 도착합니다.ios_relevance_score는 iOS 알림 요약에서 푸시의 순위를 정합니다. Clean Beans는1.0을 중요한 메시지용으로 남겨 두며, 그런 메시지는 보내지 않습니다.
time_sensitive를 적용합니다.
app.json
앱 아이콘에 개수 표시하기 \
두 작업 푸시는 앱 아이콘 배지를 제목에 있는 숫자로 설정합니다.supabase/functions/send-overdue-reminders/index.ts

앱 아이콘 배지는 기한이 지난 작업 수를 보여줍니다.
Increase가 아닌 SetTo를 사용합니다. 오후 알림이 오전의 숫자를 대체합니다.
OneSignal SDK는 앱이 열릴 때마다 배지를 자동으로 지우므로 앱에 재설정 코드가 필요하지 않습니다. 앱이 열려 있을 때 도착한 푸시는 배지를 표시하지 않습니다. Android에는 API로 설정할 수 있는 숫자 배지가 없습니다.
멱등 요청
키의 동작 방식과 유지 기간.
중단 수준
집중 모드와 네 가지 수준.
배지
플랫폼별 배지 동작.