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. Uma notificação só é útil se tocar nela levar você ao lugar certo. O Clean Beans trata quatro formas de entrar no aplicativo: um push tocado, um botão tocado em um push, um link com esquema personalizado e um link web comum.

Rotear um push tocado \

Todo push carrega um campo data.type. O aplicativo escuta os toques, lê o tipo e abre a tela correspondente.
app/_layout.tsx
Dois desses tipos vêm de Journeys, que este guia não aborda. reengagement é definido nos pushes de uma Journey de reconquista criada no painel. member_lapsed é um push para os donos e administradores de uma casa, enviado pelo backend quando essa Journey informa que um membro parou de limpar. Eles são roteados aqui como qualquer outro push.
Rotear por um tipo que você controla é mais robusto do que analisar uma URL. Se uma tela mudar de lugar, você altera uma única instrução switch, e todos os pushes enviados antes da mudança continuam abrindo corretamente.

Botões de ação: mais de uma coisa para tocar \

Um push pode ter botões. Os pushes de tarefas oferecem Start cleaning e Snooze 1h, e o push “um colega de casa terminou a limpeza” oferece Send kudos. As pessoas revelam os botões expandindo a notificação, o que no iOS é um toque longo.
Uma notificação push expandida com os botões Start cleaning e Snooze 1h

Um lembrete expandido com seus dois botões de ação.

O backend adiciona os botões à solicitação. Cada um tem um id e um rótulo.
supabase/functions/_shared/buttons.ts
Tocar em um botão abre o aplicativo, e o listener de clique mostrado acima recebe o id do botão como event.result.actionId. Um toque na própria notificação não tem actionId. O aplicativo verifica primeiro se há um botão e, se não houver, volta ao roteamento normal.
src/lib/pushActions.ts
O adiamento precisa do backend, porque o aplicativo não pode enviar push. Ele chama uma função que agenda outro lembrete com send_after. O OneSignal guarda a mensagem até lá, então nada precisa ficar rodando por uma hora.
supabase/functions/snooze-reminder/index.ts
Todo toque em botão também é registrado como evento personalizado, push_action_clicked. Uma Journey não pode ramificar diretamente com base em um botão, mas pode aguardar esse evento e ramificar pela propriedade action_id.
Tocar em um botão abre o aplicativo por padrão. Tratar um toque sem abrir o aplicativo exige código nativo: uma categoria de notificação no iOS e uma notification service extension no Android.
Links de fora do aplicativo usam caminhos curtos como /clean. O hook de native intent do Expo Router os reescreve para as rotas reais do aplicativo antes da navegação, então nada fora do aplicativo precisa saber como as telas estão organizadas.
app/+native-intent.tsx
Um esquema personalizado como cleaning-rota:// só funciona se o aplicativo estiver instalado, e muitos aplicativos se recusam a torná-lo clicável. Os Universal Links no iOS e os App Links no Android resolvem isso. São links https:// comuns que abrem o aplicativo quando ele está instalado e o site quando não está. Isso os torna a escolha certa para links em emails, SMS e mensagens compartilhadas. Configurá-los exige uma declaração de cada lado: o aplicativo diz a qual domínio pertence, e o site diz qual aplicativo pode abrir seus links.
1

Declarar o domínio no aplicativo

app.json
2

Publicar o arquivo de associação da Apple

Hospede-o em /.well-known/apple-app-site-association, via HTTPS, servido como JSON. O ID do aplicativo é seu Apple Team ID seguido do bundle identifier.
website/.well-known/apple-app-site-association
3

Publicar o arquivo de associação do Android

Hospede-o em /.well-known/assetlinks.json. A impressão digital vem do certificado de assinatura do seu aplicativo. Com o EAS, execute eas credentials -p android para encontrá-la.
website/.well-known/assetlinks.json
4

Usar o link

A tela da casa compartilha um link de convite. Tocar nele abre a tela de entrada com o código já preenchido.
app/household.tsx
app/join-household.tsx
O Clean Beans reivindica apenas os caminhos que o aplicativo consegue mostrar. A página inicial fica de fora, então o site de marketing continua abrindo no navegador. O iOS lê o arquivo de associação quando o aplicativo é instalado ou atualizado, então publique o arquivo antes de lançar a compilação.

Deep linking

Como o OneSignal trata URLs em cada plataforma.

Payload da notificação

Todos os campos disponíveis no listener de clique.

Botões de ação

Limites de cada plataforma, ícones e tratamento de toques.