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. Um push descartado desaparece. O Clean Beans mantém um histórico de sete dias dentro do aplicativo, com uma contagem de não lidas no cabeçalho de cada tela.
A caixa de entrada de notificações do Clean Beans

A caixa de entrada lista as notificações recentes.

O aplicativo não registra as notificações por conta própria. Isso deixaria de fora tudo o que foi entregue enquanto o aplicativo estava fechado. O OneSignal informa o backend sobre cada push por meio de um Event Stream, e o backend mantém o histórico.
1

O OneSignal envia um evento para cada push

Um Event Stream faz um POST para uma função de backend quando um push é enviado e novamente quando é clicado.
2

A função armazena ou atualiza uma linha

Um evento de envio cria uma entrada na caixa de entrada. Um evento de clique a marca como lida.
3

O aplicativo lê a tabela

A tela da caixa de entrada e o badge do cabeçalho consultam as linhas do próprio usuário.

Configurar o Event Stream \

Configuração do painel. Em Data > Event Streams, crie um stream com:
  • URL: o endereço da sua função.
  • Cabeçalho: um segredo compartilhado, por exemplo X-Webhook-Secret.
  • Eventos: message.push.sent e message.push.clicked.
  • Corpo: um template Liquid que dá forma à solicitação.
Event Stream body
Referencie cada chave de data pelo nome, como acima. {{ message.data }} sozinho renderiza o objeto inteiro como um dict no estilo Python ({'type': 'kudos'}), que não é JSON válido, e a função abaixo rejeitaria a solicitação ao analisar o corpo. O título e o conteúdo são lidos com .en pelo mesmo motivo. A caixa de entrada só precisa de type. Adicione uma linha para cada outra chave que o seu próprio webhook usar.Um valor que contém aspas duplas também quebra o JSON. Os pushes de kudos carregam um texto digitado pelo usuário, então uma mensagem de kudos com " gera um corpo que a função não consegue analisar, e esse push nunca chega à caixa de entrada.
Este stream envia um evento para cada push entregue a cada dispositivo, e cada evento conta para o volume de eventos de mensagens do seu plano. Selecione apenas os eventos que você usa.

Receber os eventos \

A função verifica o segredo antes de fazer qualquer outra coisa.
supabase/functions/inbox-webhook/index.ts
Um evento de envio vira uma linha da caixa de entrada. O ID de evento do OneSignal é a chave única, então um evento entregue duas vezes não cria duas linhas.
supabase/functions/inbox-webhook/index.ts
Um evento de clique marca a linha correspondente como lida.
supabase/functions/inbox-webhook/index.ts
O campo data.type que roteia um push tocado é armazenado com cada linha, para que a caixa de entrada possa mostrar o ícone certo e abrir a tela certa.

Renderizar o Liquid antes de armazenar \

O stream informa a mensagem como foi escrita, antes de o OneSignal personalizá-la para cada destinatário. Um push enviado pelo backend já tem o texto final. Um push de Journey, não. Uma das mensagens de Journey do Clean Beans tem este título:
Journey push
O telefone mostra “Kitchen cleaned ✅”. O webhook recebe a linha acima, e a primeira versão da caixa de entrada a exibia exatamente assim. Agora a função renderiza o título e o corpo por conta própria antes de salvá-los, com um pequeno renderizador que trata consultas de valores e o filtro default. Ela obtém os valores de dois lugares:
  • As tags são lidas do banco de dados. O aplicativo define cada tag a partir de um valor que armazena, então a função lê os mesmos valores. Passar {{ user.tags.user_name }} no corpo do stream também funcionaria, mas um nome com aspas duplas tornaria esse corpo um JSON inválido.
  • As propriedades de eventos da Journey não estão disponíveis no stream. A função as reconstrói a partir da sessão de limpeza que disparou o evento personalizado.
supabase/functions/inbox-webhook/index.ts
Se você criar uma caixa de entrada ou um log a partir de Event Streams, verifique como suas mensagens de Journey e de template chegam. Todo Liquid nelas continua sendo Liquid. Renderize-o você mesmo, como aqui, ou deixe essas mensagens de fora.

Mostrar a caixa de entrada \

A segurança em nível de linha faz com que cada usuário só possa ler as próprias linhas, então as consultas do aplicativo não precisam filtrar por usuário.
app/inbox.tsx
src/components/InboxButton.tsx

Manter as preferências de email alinhadas \

O mesmo stream resolve um segundo problema. Quando alguém toca em Unsubscribe em um email, o OneSignal para de enviar emails para essa pessoa, mas o interruptor “Weekly Email Summary” do próprio aplicativo continuaria ativado. A tela de configurações estaria errada, e o backend continuaria tentando enviar. Adicionar quatro eventos de email ao stream resolve isso. A função trata todos da mesma forma: o OneSignal não enviará mais emails para essa pessoa, então a preferência do aplicativo é desativada para corresponder.
supabase/functions/inbox-webhook/index.ts
Não é preciso mudar o corpo do stream, porque os campos que a caixa de entrada já usa (event_kind, event_id, external_id) são suficientes.
Isso mantém o aplicativo alinhado com o OneSignal, e não o contrário. Se alguém reativar o email no aplicativo, a Subscription no OneSignal continua cancelada. Para inscrever a pessoa novamente, seu backend precisa chamar a API de Subscriptions do OneSignal.
O mesmo padrão de Event Stream pode manter seus próprios sistemas alinhados com qualquer coisa que o OneSignal saiba: aberturas de email, cliques em mensagens in-app, entregas de SMS e mais.

Event Streams

Configure um stream e escolha os eventos.

Dados do Event Stream

Todos os campos disponíveis no template do corpo.