Ao configurar uma notificação Push com link externo na Inngage Context Cloud, o esperado é que o clique na mensagem leve o usuário à URL definida. Em alguns cenários, porém, o clique apenas abre o aplicativo, sem redirecionar. Este guia lista o que validar para identificar onde o comportamento é interrompido.
O que validar primeiro
Antes das análises técnicas, confirme:
- O Push foi configurado com um link válido.
- O link foi salvo corretamente na campanha.
- O comportamento ocorre em todos os dispositivos ou apenas em alguns.
- O problema acontece tanto no Android quanto no iOS.
- O aplicativo está atualizado com a versão mais recente da SDK da Context Cloud.
Se todas as configurações estiverem corretas e o redirecionamento ainda não acontecer, siga com as validações abaixo.
Causa 1 — A SDK não está tratando o clique do Push
Em alguns casos, o clique na notificação não é tratado corretamente pelo aplicativo, e o app apenas abre sem executar a ação configurada. Faça testes unitários nos três estados do aplicativo:
- Aplicativo totalmente fechado.
- Aplicativo em background.
- Aplicativo já aberto.
Ao clicar na notificação, o comportamento esperado é: a SDK captura o clique, o payload do Push é processado, o link configurado é executado e o usuário é direcionado ao destino correto.
Causa 2 — Leitura incorreta das informações enviadas pela SDK
As SDKs da Context Cloud disponibilizam callbacks que entregam informações especiais da notificação, como links externos, deep links e dados personalizados da campanha. Se o aplicativo lê essas informações incorretamente, o redirecionamento pode não acontecer. A equipe de desenvolvimento deve verificar:
- Se os callbacks da SDK estão implementados corretamente.
- Se o app captura os dados enviados pela notificação.
- Se o link recebido está sendo tratado corretamente.
- Se existe alguma regra interna sobrescrevendo a navegação.
Deep links e navegação do aplicativo
Alguns aplicativos trabalham com deep links, URLs externas e metadados internos de navegação. Por isso, o comportamento do Push pode variar conforme a implementação. Mesmo com a campanha configurada corretamente na plataforma, o redirecionamento final depende de como o app interpreta as informações recebidas pela SDK.
Checklist de validação
Se o Push abre apenas o aplicativo e não executa o link configurado:
- Faça os testes nos cenários fechado, background e aberto.
- Confirme se a SDK processa corretamente o clique.
- Revise a implementação dos callbacks da SDK.
- Valide com o time de desenvolvimento como o app trata links e deep links.
- Confirme se existe alguma regra interna impedindo o redirecionamento.
Conclusão
Na maioria dos casos, o problema não está na configuração da campanha, mas na forma como o aplicativo trata as informações recebidas no clique do Push. A validação conjunta entre a configuração da campanha, a SDK e a implementação do aplicativo é o que garante o redirecionamento correto para links externos.
