Web Push Webhooks
O OneSignal fornece Web Push Webhooks dedicados para lidar com eventos de notificação. Veja Web Push Webhooks para detalhes completos de implementação. Importante: Web Push Webhooks são uma implementação separada de Event Webhooks e não podem ser usados de forma intercambiável.Configuração de Service Worker
O OneSignal verifica automaticamente o escopo raiz para service workers por padrão. No entanto, recomendamos fortemente personalizar sua integração para usar um escopo não-raiz para melhor segurança e para evitar conflitos com service workers existentes. Siga nosso guia de Configuração de Service Worker OneSignal para implementar uma configuração de escopo personalizado. Por que usar um escopo não-raiz?- Previne conflitos com service workers existentes
- Melhora a segurança limitando o escopo do OneSignal
- Fornece melhor controle sobre a arquitetura de service worker do seu site
Desenvolvimento Local e Testes
Para propósitos de desenvolvimento e testes, veja nosso guia abrangente de Testes Locais que cobre:- Configuração de ambientes localhost
- Teste de notificações sem certificados SSL
- Depuração de problemas comuns de desenvolvimento
Comportamento de Clique em Notificação
O OneSignal suporta múltiplos comportamentos de navegador quando usuários clicam em notificações. Para manipulação avançada de URL e opções como desabilitar ações de clique inteiramente, veja Deep-links e URLs.Comportamento Padrão
Quando usuários clicam em uma notificação e não têm seu site aberto, o navegador abre uma nova aba e navega para a URL da notificação.Quando o Site Já Está Aberto
Quando usuários têm seu site aberto em uma ou mais abas do navegador, você pode configurar como o navegador responde: Exact Navigate (Padrão)- Corresponde a URL exata da notificação (ex:
example.com/product) a uma aba aberta - Navega para a URL da notificação naquela aba correspondente
- Melhor para direcionamento de página específica
- Corresponde a origem da notificação (ex:
example.com) a qualquer aba aberta do seu site - Navega para a URL da notificação na aba correspondida
- Útil para navegação geral do site
- Corresponde a URL exata da notificação a uma aba aberta
- Foca naquela aba sem atualizar a página
- Ideal quando você não quer interromper o estado atual da página do usuário
- Corresponde a origem da notificação a qualquer aba aberta do seu site
- Foca naquela aba sem atualizar a página
- Melhor para trazer atenção ao seu site sem navegação
Persistência de Notificação
Por padrão, notificações exibem por aproximadamente 5 segundos antes de mover para o Histórico de Notificações, onde permanecem por 1 semana antes da remoção automática pelo sistema operacional.Habilitando Notificações Persistentes
Você pode fazer notificações persistirem na tela até interação do usuário para inscritos dos navegadores Chrome e Edge.Nem todos os navegadores e sistemas operacionais suportam notificações persistentes. Quando habilitado, apenas afeta usuários elegíveis e pode impactar a aparência da notificação reduzindo contagem de caracteres e afetando exibição de imagem/botão.
- Inscritos atuais devem revisitar seu site após habilitar esta configuração para ver mudanças
- Notificações persistentes podem incomodar usuários se usadas em excesso
- Recomendado apenas para notificações de alta importância (ex: apps de gerenciamento de tarefas)
- Usuários podem passar o mouse sobre notificações para mantê-las visíveis para leitura
Métodos de Implementação
1
Configuração do Dashboard
Use o toggle “Persistence” no seu dashboard OneSignal para habilitar/desabilitar este recurso.
Toggle de Persistência de Notificação
2
Implementação com Código Personalizado
Adicione a propriedade Inclua isso no seu código init do OneSignal para habilitar persistência para navegadores e sistemas operacionais suportados.
persistNotification à sua inicialização do Web Push SDK:Compatibilidade de Navegador
Navegadores Suportados:- Chrome (suporte completo)
- Edge (suporte completo)
- Firefox (configuração não tem efeito)
- Safari (configuração não tem efeito)
Melhores Práticas
- Use com moderação: Apenas habilite para notificações verdadeiramente importantes para evitar frustração do usuário
- Teste completamente: Verifique comportamento através de diferentes navegadores e dispositivos
- Monitore feedback do usuário: Observe taxas de opt-out aumentadas que podem indicar fadiga de notificação
- Considere contexto: Notificações persistentes funcionam melhor para conteúdo sensível ao tempo ou acionável
- Revise sua estratégia de notificação para determinar se persistência é apropriada
- Teste o recurso com um pequeno segmento de usuários antes de implantação completa
- Monitore métricas de engajamento após implementação
- Considere implementar diferentes configurações de persistência para diferentes tipos de notificação