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. A maioria das notificações do Clean Beans é enviada pelo backend, porque elas dependem de um agendamento ou de algo que outra pessoa fez. Todas chamam o mesmo endpoint, Create message, e direcionam as pessoas pelo External ID.
Notificações push do Clean Beans

Um exemplo de alguns dos pushes que o Clean Beans envia.

Envios agendados que respeitam fusos horários \

As pessoas escolhem o horário em que querem receber o lembrete diário. O Clean Beans não agenda um job por usuário. Ele executa um job a cada hora e pergunta: “para quem é esse horário agora?”
1

Um agendamento do banco de dados chama uma função a cada hora

O pg_cron faz uma solicitação HTTP para uma Supabase Edge Function. A chave de serviço de que ele precisa é lida do Supabase Vault, então ela nunca aparece no SQL.
2

A função encontra os usuários cujo horário local corresponde

Ela carrega todos que têm esse lembrete ativado, converte o horário atual para o fuso horário de cada usuário e mantém aqueles cujo horário escolhido é agora.
3

Ela verifica se há algo a dizer

Um usuário sem nada pendente não recebe push.
4

Ela chama o OneSignal uma vez por usuário

Cada push tem seu próprio conteúdo, então cada um é uma solicitação separada.
O agendamento:
supabase/migrations/006_cron_daily_digest.sql
A correspondência de fuso horário:
supabase/functions/send-daily-digest/index.ts
O envio:
supabase/functions/send-daily-digest/index.ts
Os campos ...DELIVERY.daily_digest, idempotency_key e de badge são explicados em Push confiável e bem comportado. O campo data.type é como o aplicativo sabe qual tela abrir quando o push é tocado. Consulte Deep links e cliques em notificações. O título e o corpo são montados a partir das tarefas, então o push diz algo específico.
supabase/functions/send-daily-digest/index.ts

O lembrete de tarefas atrasadas: um segundo aviso, diferente \

O lembrete de tarefas atrasadas reutiliza o mesmo padrão com duas mudanças. Ele dispara seis horas após o horário do resumo do usuário e conta apenas as tarefas que estão de fato atrasadas.
supabase/functions/send-overdue-reminders/index.ts
O job dele roda na meia hora, então nunca concorre com o job do resumo no início da hora. O texto também é diferente. Um segundo lembrete que repete o primeiro é fácil de ignorar.
supabase/functions/send-overdue-reminders/index.ts

O lembrete de limpeza: uma solicitação para muitas pessoas \

O lembrete de limpeza diz a mesma coisa para todos, então não precisa de uma solicitação por pessoa. A função reúne todos os IDs de usuários elegíveis e os envia em lotes.
supabase/functions/send-cleaning-reminder/index.ts
Envie uma solicitação por pessoa quando o conteúdo for diferente. Envie uma solicitação para muitas pessoas quando ele for idêntico. Menos solicitações significam menos pontos de falha e menos risco de ultrapassar os limites de taxa.

Sessão concluída: um push acionado a partir do aplicativo \

Quando alguém termina uma sessão de limpeza, o resto da casa fica sabendo. O aplicativo não pode enviar esse push sozinho, porque não deve guardar uma API key. Ele chama uma função de backend, e a função envia o push.
src/lib/database.ts
A solicitação diz o que foi limpo, mas não quem limpou. A função identifica quem está chamando pelo token de login, verifica se a pessoa é membro ativo da casa e obtém o nome e o avatar dela a partir do perfil. Consulte Verificar quem está chamando. Depois, ela encontra os outros membros da casa e remove quem desativou esse tipo de push.
supabase/functions/session-completed/index.ts
Ela envia um único push para todos eles. O avatar de feijão de quem enviou é anexado como imagem, usando um campo diferente para cada plataforma.
supabase/functions/session-completed/index.ts
Uma notificação push expandida mostrando uma imagem de avatar de feijão

Um push de sessão concluída, expandido para mostrar o avatar de quem enviou.

Kudos: de uma pessoa para outra \

Os kudos funcionam da mesma forma, com um único destinatário. Na tela de atividade, um membro toca em Send Kudos na sessão de um colega de casa, escolhe uma mensagem, e o aplicativo chama a função send-kudos.
A folha inferior de kudos com mensagens predefinidas

Escolhendo uma mensagem de kudos para a sessão de limpeza de um colega de casa.

supabase/functions/send-kudos/index.ts

Entrada aprovada: um push acionado pelo banco de dados \

Quem pede para entrar em uma casa aguarda a aprovação de um administrador. Quando isso acontece, a linha de membro muda de pending para active. Um gatilho do banco de dados nessa mudança chama uma função, e a função avisa a pessoa de que ela entrou. Colocar o gatilho no banco de dados significa que o push é enviado independentemente de como a aprovação acontece, e o aplicativo não precisa de código para isso.
supabase/migrations/027_join_approved_trigger.sql
A função não confia no que recebe. Ela lê a associação novamente e só envia se a aprovação for real e recente.
supabase/functions/join-approved/index.ts
Uma função que envia mensagens sob demanda é algo que outras pessoas podem tentar chamar. Verifique os fatos no seu próprio banco de dados antes de enviar, como esta faz, e nunca aceite conteúdo de mensagem ou destinatários de um chamador que você não verificou.

Verificar quem está chamando \

O Supabase verifica se uma solicitação para uma edge function tem um token válido, mas o token de um usuário conectado é tão válido quanto o do agendador. Sem uma verificação adicional, qualquer usuário poderia acionar o resumo diário para todos ou enviar um push em nome de outra pessoa. Por isso, cada função decide por si mesma quem pode chamá-la. As funções agendadas começam com uma linha:
supabase/functions/send-daily-digest/index.ts
supabase/functions/_shared/auth.ts
A verificação de função depende de o Supabase já ter verificado a assinatura do token. Implante essas funções com a verificação de JWT ativada, que é o padrão. Nunca as implante com --no-verify-jwt.
As funções chamadas a partir do aplicativo identificam o remetente pelo token e depois verificam se o remetente pode alcançar o destinatário. Kudos só podem ir para alguém que compartilha uma casa com o remetente, e o nome mostrado no push é lido do perfil do remetente.
supabase/functions/send-kudos/index.ts

API Create message

Segmentação, conteúdo e agendamento para todos os canais.

Rich media

Imagens em notificações push em cada plataforma.