Pular para o conteúdo principal
Esta página faz parte de Aplicativo de exemplo: uma integração completa do OneSignal, que acompanha um aplicativo real do início ao fim. O aplicativo é o Clean Beans, uma escala de limpeza para casas compartilhadas, construído com Expo (React Native) e um backend Supabase. Fazer um push chegar é o primeiro passo. Esta página trata das decisões menores que tornam os pushes confiáveis: nunca enviar o mesmo duas vezes, deixar os desatualizados expirarem e fazer cada tipo se comportar de um jeito adequado.

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. O idempotency_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_id e android_group agrupam pushes relacionados na lista de notificações.
  • ios_interruption_level controla o quão insistente um push é. time_sensitive pode passar pelos modos de Foco. passive chega silenciosamente.
  • ios_relevance_score ordena os pushes no resumo de notificações do iOS. O Clean Beans reserva 1.0 para mensagens críticas e não envia nenhuma.
Configuração do aplicativo. O iOS só respeita time_sensitive se o aplicativo declarar a capability.
app.json
Uma lição aprendida: collapse_id. O Clean Beans deu primeiro o mesmo collapse_id ao resumo e ao lembrete de tarefas atrasadas, para que o lembrete substituísse o resumo. No iOS, um push que substitui outro ainda presente na lista de notificações é trocado no lugar, sem banner e sem som. O lembrete passava despercebido, o que anulava seu propósito, então a configuração foi removida. Use collapse_id somente quando quiser uma atualização silenciosa, como um placar ao vivo.

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 ícone do aplicativo Clean Beans com um número no badge

O badge do ícone do aplicativo mostra quantas tarefas estão atrasadas.

É usado 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.