Pular para o conteúdo principal
A maioria dos guias do OneSignal explica um recurso por vez. Este acompanha um único aplicativo do início ao fim e mostra como cada recurso de mensagens foi conectado, com o código que roda em produção. O aplicativo é o Clean Beans, uma escala de limpeza para casas compartilhadas. Ele é construído com Expo (React Native) e usa o Supabase para banco de dados, autenticação e funções de backend. O OneSignal cuida de todas as mensagens que o aplicativo envia.
Três telas do Clean Beans: o painel, uma sessão de limpeza e a escala semanal

Clean Beans: o painel, uma sessão de limpeza e a escala semanal.

O que o Clean Beans faz \

Uma casa adiciona seus cômodos, e o aplicativo os transforma em uma lista de tarefas de limpeza com frequências adequadas. Um gerador de escala distribui essas tarefas ao longo da semana para caber no tempo disponível de cada pessoa. Os membros fazem sessões de limpeza, marcam tarefas, mantêm sequências diárias, enviam kudos uns aos outros e competem em um ranking semanal. A limpeza é compartilhada, recorrente e tem prazos, o que a torna adequada para quase todo tipo de mensagem: lembretes, atualizações sociais, contagens regressivas, resumos e orientações.

Por que este guia existe \

Use-o para responder a três perguntas:
  • Qual recurso do OneSignal serve para qual tarefa? Cada página parte de algo que o aplicativo precisava fazer e depois mostra o recurso que faz isso.
  • Onde fica o código? Parte do trabalho pertence ao aplicativo, parte ao seu backend e parte ao painel do OneSignal. Cada exemplo diz qual.
  • O que pode dar errado? Os avisos e notas de cada página registram o que foi aprendido ao colocar tudo em produção. Uma configuração, collapse_id, foi testada e depois removida, e Push confiável e bem comportado explica por quê.

Como ler \

O guia é um conjunto de páginas, uma por tema. Você não precisa lê-las em ordem. Configuração do SDK e identidade do usuário é a base de todo o resto. Depois disso, cada página é independente. A maioria dos recursos é apresentada da mesma forma:
  1. O que o usuário vê, geralmente com uma captura de tela.
  2. Como funciona, como uma sequência curta de quem faz o quê.
  3. O código, retirado do aplicativo. O título de cada bloco de código é o arquivo de onde ele vem.
  4. Configuração do painel, quando o recurso precisa ser configurado no OneSignal.
Limites e surpresas são destacados em avisos e notas ao lado do recurso que afetam.
O código é real, mas os identificadores foram substituídos por marcadores como YOUR_ONESIGNAL_APP_ID e YOUR_PROJECT_REF. Arquivos longos foram reduzidos às linhas que importam. Uma linha contendo apenas // ... marca onde o código foi omitido.

Como as peças se encaixam \

O External ID conecta os três. O Clean Beans o define como o ID de usuário do Supabase no login, para que o backend possa se dirigir a qualquer pessoa usando um ID que já armazena.
Diagrama de arquitetura mostrando o aplicativo Expo, o backend Supabase e o painel do OneSignal

O aplicativo, o backend e o painel se comunicam com o OneSignal. O External ID os vincula a um único usuário.

Mapa de recursos \

O que você precisa \

  • Um app do OneSignal com push configurado para iOS e Android, e com email e SMS configurados. Consulte Configuração de canais.
  • Um aplicativo Expo compilado com EAS Build. O SDK do OneSignal precisa de código nativo, então o Expo Go não é suficiente. Consulte Configuração do SDK Expo.
  • Seu App ID e uma App API key. Consulte Chaves e IDs.
  • Um backend que possa executar código em um agendamento e em resposta a solicitações. O Clean Beans usa Supabase Edge Functions com pg_cron. Os mesmos padrões se aplicam a qualquer backend.

Princípios que se mostraram válidos \

  • Defina o External ID primeiro. Quase todos os recursos aqui dependem dele. Use um ID que seu backend já armazena.
  • Coloque cada tarefa onde ela pertence. O aplicativo cuida do dispositivo e do usuário conectado. O backend cuida dos agendamentos e das mudanças de dados. O painel guarda tudo o que você quer mudar sem uma nova versão.
  • Verifique antes de enviar. Todo envio do backend verifica as preferências do usuário e confirma que há algo que vale a pena dizer.
  • Torne os envios agendados repetíveis. Uma chave de idempotência construída a partir do tipo, do destinatário e da data transforma uma nova tentativa em uma operação sem efeito.
  • Roteie por tipo, não por URL. Um campo data.type mantém as notificações antigas funcionando quando as telas mudam.
  • Verifique o que os chamadores informam. Uma função que envia mensagens deve primeiro confirmar os fatos no seu próprio banco de dados.

Todos os recursos em resumo \

Segredos \

As funções de backend os leem do seu ambiente. Nenhum deles é incluído no aplicativo.
Sua App API key pode enviar mensagens para todos os usuários. Mantenha-a no seu backend. O aplicativo precisa apenas do App ID.