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. Todo o resto depende de quatro coisas estarem corretas: o SDK está instalado, ele inicia quando o aplicativo inicia, cada dispositivo está vinculado a um usuário e as pessoas podem controlar o que recebem.

Instalar com o plugin do Expo \

O onesignal-expo-plugin configura os projetos nativos de iOS e Android no momento da compilação. Ele adiciona a capability de push, o App Group e a Notification Service Extension de que o OneSignal precisa para imagens, badges e confirmação de entrega.
app.json

Inicializar uma vez, na raiz \

O Clean Beans inicializa o OneSignal no layout raiz, de modo que a inicialização roda uma vez a cada abertura, antes de qualquer tela aparecer.
app/_layout.tsx
Pedir permissão na primeira abertura é a abordagem mais simples. Para explicar o benefício antes, mostre uma mensagem in-app antes do aviso do sistema. O Clean Beans tem uma pronta: consulte Pré-solicitação de permissão de push.

Vincular cada dispositivo a um usuário \

Quando alguém faz login, o aplicativo passa o ID de usuário do Supabase para OneSignal.login(). Esse ID se torna o External ID. Quando a pessoa faz logout, logout() desvincula o dispositivo para que a próxima pessoa a fazer login não herde as mensagens dela.
app/_layout.tsx
Aguarde a sessão salva carregar antes de chamar qualquer um dos métodos. Em uma inicialização a frio, o usuário conectado fica desconhecido por um instante. Se o aplicativo chamar logout() nesse momento e login() logo depois, a Subscription de push do dispositivo pode ficar em um usuário anônimo, e os pushes enviados ao External ID deixam de chegar ao telefone. Chame logout() somente quando alguém realmente sair da conta.
Essa única chamada é o que torna possível cada envio do backend neste guia. Uma função que conhece o ID de um usuário no banco de dados pode enviar mensagens a ele sem saber nada sobre seus dispositivos.

Adicionar o canal de email \

O aplicativo já conhece o endereço de email de cada usuário desde o cadastro, então ele o registra como Subscription de email no login. O OneSignal ignora chamadas repetidas com o mesmo endereço.
src/lib/onesignalSync.ts
O SMS é adicionado da mesma forma com addSms(), mas somente depois que o número é verificado. Consulte SMS: códigos de verificação e convites.

Deixar as pessoas controlarem o que recebem \

A tela de configurações de notificação tem um interruptor principal e um interruptor para cada tipo de mensagem.
A tela de configurações de notificação com um interruptor principal e interruptores por tipo

Configurações de notificação: um interruptor principal, interruptores por tipo e o horário do lembrete diário.

O interruptor principal chama optOut() e optIn() na Subscription de push, então o OneSignal interrompe e retoma a entrega para aquele dispositivo.
app/notification-settings.tsx
Cada interruptor também é salvo na linha de perfil do usuário. O backend lê essas colunas antes de enviar qualquer coisa, e é assim que as preferências por tipo são aplicadas.
src/lib/database.ts
Armazenar as preferências no seu próprio banco de dados e verificá-las antes de cada envio mantém a lógica em um só lugar. A alternativa é armazená-las como tags e filtrar por tag no OneSignal. Isso funciona bem quando você envia para segmentos. O Clean Beans envia para usuários específicos, então verificar o banco de dados é mais simples.

Referência do SDK mobile

Todos os métodos de cliente usados neste guia.

Usuários e External IDs

Como a identidade vincula Subscriptions entre canais e dispositivos.