Nunca enviar o mesmo lembrete duas vezes \
Jobs agendados são executados novamente. Um job também pode rodar duas vezes por engano. Sem proteção, cada repetição envia outro push. Oidempotency_key do OneSignal resolve isso. Se duas solicitações tiverem a mesma chave, a segunda não é enviada. A chave precisa ser um UUID, e o OneSignal a guarda por 30 dias.
Uma função agendada não tem onde guardar uma chave aleatória entre execuções, então o Clean Beans deriva a chave do que o envio é: seu tipo, seu destinatário e sua data. O mesmo envio sempre gera a mesma chave.
supabase/functions/_shared/idempotency.ts
Em um envio em lote, a chave cobre o lote inteiro.
supabase/functions/send-cleaning-reminder/index.ts
As chaves de idempotência funcionam nos endpoints Create message e Create custom events. As solicitações de Live Activity não as aceitam. Elas são identificadas pelo
activity_id.Dar a cada tipo de push seu próprio comportamento \
Um lembrete de limpeza que chega duas horas atrasado é pior do que nenhum lembrete. Kudos são bons de receber, mas nunca urgentes. O Clean Beans descreve essas diferenças uma única vez, em um conjunto de perfis de entrega, e aplica o perfil certo a cada solicitação.supabase/functions/_shared/delivery.ts
O perfil
member_lapsed na lista de tipos pertence a um push enviado a partir de um webhook de Journey, que este guia não aborda.
O que cada configuração faz:
ttlé o tempo que um push fica guardado para um dispositivo offline. O lembrete de limpeza diz “em 1 hora”, então ele é descartado após uma hora.thread_ideandroid_groupagrupam pushes relacionados na lista de notificações.ios_interruption_levelcontrola o quão insistente um push é.time_sensitivepode passar pelos modos de Foco.passivechega silenciosamente.ios_relevance_scoreordena os pushes no resumo de notificações do iOS. O Clean Beans reserva1.0para mensagens críticas e não envia nenhuma.
time_sensitive se o aplicativo declarar a capability.
app.json
Mostrar um número no ícone do aplicativo \
Os dois pushes de tarefas definem o badge do ícone do aplicativo com o número do título.supabase/functions/send-overdue-reminders/index.ts

O badge do ícone do aplicativo mostra quantas tarefas estão atrasadas.
SetTo, não Increase, porque o badge é uma contagem de tarefas, e não de notificações não lidas. O lembrete da tarde substitui o número da manhã.
O SDK do OneSignal limpa o badge automaticamente sempre que o aplicativo é aberto, então o aplicativo não precisa de código para redefini-lo. Um push que chega com o aplicativo aberto nunca mostra seu badge. O Android não tem um badge numérico que possa ser definido pela API.
Solicitações idempotentes
Como as chaves funcionam e quanto tempo duram.
Níveis de interrupção
Modos de Foco e os quatro níveis.
Badges
Comportamento dos badges em cada plataforma.