绝不重复发送同一条提醒 \
计划任务会被重试。任务也可能被误运行两次。如果没有保护,每次重复都会多发一条推送。 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 请求不接受幂等键,它们通过
activity_id 进行标识。为每种推送设定各自的行为 \
晚到两小时的打扫提醒还不如没有提醒。Kudos 让人开心,但从不紧急。Clean Beans 在一组投递配置中统一描述这些差异,并将合适的配置展开到每个请求中。supabase/functions/_shared/delivery.ts
类型列表中的
member_lapsed 配置属于从 Journey Webhook 发送的推送,本指南不涉及。
各项设置的作用:
ttl是为离线设备保留推送的时长。打扫提醒的内容是“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

应用图标角标显示逾期任务的数量。
SetTo 而不是 Increase,因为角标表示的是任务数量,而不是未读通知数量。下午的提醒会替换早上的数字。
每次打开应用时,OneSignal SDK 都会自动清除角标,因此应用无需编写重置代码。应用处于打开状态时到达的推送不会显示角标。Android 没有可以通过 API 设置的数字角标。
幂等请求
键的工作方式和有效期。
中断级别
专注模式和四种级别。
角标
各平台的角标行为。