Requisitos de web push
Seu website deve atender todos os seguintes requisitos para que Web Push funcione: APIs de navegador necessárias Segurança & conexão- ✅ Apenas HTTPS (com certificado SSL válido)
- ✅ Service worker do OneSignal instalado
- ✅ Navegador deve alcançar:
- Servidores push do navegador (ex: FCM, Mozilla)
api.onesignal.com
- ✅ Permissão de notificação concedida pelo usuário
- ❌ Não em modo Anônimo/Privado/Convidado
- ❌ Dados do site não limpos (deleta subscriptions)
Limpar dados do navegador (cookies, armazenamento do site) automaticamente cancela inscrição de usuários de notificações push.
Requisitos iOS/iPadOS
Para receber push no iOS ou iPadOS:- iOS 16.4+ ou iPadOS 16.4+
- Site deve ser adicionado à tela inicial e aberto de lá
- Arquivo
manifest.jsonválido com campos obrigatórios - Usuários devem aceitar permissões de notificação após abrir como web app
Configuração de web push para iOS
Siga passos específicos da Apple para habilitar web push em iPhones e iPads rodando iOS 16.4+.
Suporte de navegador & plataforma
Compatibilidade de navegador por sistema operacional
| Browser | Windows PC | macOS | Android | iOS (iPhone, iPad) |
|---|---|---|---|---|
| Chrome 50+ | Sim | Sim | Sim | Sim ¹ |
| Firefox 47+ | Sim | Sim | Sim | Sim ¹ |
| Safari 10+ | Não | Sim | Não | Sim ¹ |
| Microsoft Edge 18+ ² | Sim | Sim | Sim | Sim ¹ |
| Opera ² | Sim | Sim | Sim | Sim ¹ |
| Samsung Internet ² | Não | Não | Sim | Sim ¹ |
| Yandex ² | Sim | Sim | Sim | Sim ¹ |
| UC Browser ² | Sim | Não | Sim | Sim ¹ |
| Internet Explorer ³ | Não | Não | Não | Não |
| DuckDuckGo | Não | Não | Não | Não |
- ¹ iOS requer instalação de web app (veja requisitos de configuração de web push para iOS acima)
- ² Navegadores baseados em Chromium aparecem como “Chrome” no analytics do OneSignal
- ³ Internet Explorer está descontinuado e não recebe mais atualizações
Modo Anônimo, Modo de Navegação Privada e Modo de Navegador Convidado não suportam Web Push em qualquer plataforma.
Mudanças de domínio & migração
Entendendo política de origem do navegador
Navegadores vinculam subscriptions de web push a uma origem (domínio/URL do site) específica por razões de segurança. Você não pode transferir inscritos entre origens diferentes - esta é uma limitação do navegador, não uma restrição do OneSignal. Origens diferentes incluem:- HTTP vs HTTPS (ex:
http://mysite.com→https://mysite.com) - www vs não-www (ex:
www.mysite.comvsmysite.com) - Domínios/subdomínios diferentes (ex:
domain1.comvsdomain2.comousub1.domain.comvssub2.domain.com)
Opções de migração
Ao mudar a origem do seu site, escolha uma destas abordagens:- Novo App OneSignal (Recomendado)
- Atualizar App & Deletar Inscritos Antigos
Melhor para: A maioria das mudanças de domínio, especialmente quando você quer uma migração limpa
- Crie novo App OneSignal para seu novo domínio
- Estratégia de envio duplo: Continue enviando do app antigo, mas defina “Launch URL” para seu novo domínio
- Transição gradual:
- Remetentes de alta frequência (1+ notificações/dia): 2 semanas de transição
- Remetentes de frequência média (2+ notificações/semana): 2 meses de transição
- Notificações de migração: Envie 1-2 mensagens como “Mudamos! Visite nosso novo site para continuar atualizado” no início e fim da transição
Enviar mensagens idênticas de ambos os apps criará notificações duplicadas para usuários inscritos em ambos.
Upgrade de HTTP para HTTPS
Fazer upgrade de HTTP para HTTPS cria uma nova origem. Siga os passos de migração de domínio acima pois navegadores tratam sites HTTPS como completamente separados de suas versões HTTP.Múltiplos sites & subdomínios
Limitações de app único
Devido à política de mesma origem do navegador, você não pode usar um App OneSignal para múltiplas origens como:https://mysite.comehttps://www.mysite.comhttps://main.comehttps://shop.main.com
Soluções para múltiplas origens
- Estratégia de Origem Única
- Apps Separados
- Inscreva usuários apenas no seu domínio principal
- Redirecione usuários de outras origens para domínio principal para inscrição
- Redirecione de volta para página original após inscrição
Cenários de suporte a idioma
- Mesma Origem (Recomendado)
- Origens Diferentes
- URLs como
https://mysite.com/en/ouhttps://mysite.com/es/ - Use App OneSignal único
- Siga guia de prompts multi-idioma
- Implemente Idioma & Localização
Configuração avançada
Múltiplos apps OneSignal no mesmo site
- Não recomendado - causa conflitos de subscription.
- O que acontece: OneSignal reinscreve automaticamente usuários no App ID visitado mais recentemente, fazendo inscritos saltarem entre apps e criando muitos dispositivos não inscritos.
- Melhor abordagem: Use Data Tags para segmentar usuários dentro de um único app.
Sites em subpasta
Web push opera no nível de origem. Para sites em subpastas (ex:https://example.com/blog), use a origem principal (https://example.com) para configuração.
Auto-hospedagem de arquivos SDK
Fortemente desencorajado. Especificações de push do navegador mudam frequentemente, e o OneSignal atualiza arquivos imediatamente para manter compatibilidade. Use URLs CDN do OneSignal das suas Configurações de Web Push.Código init personalizado
Códigoinit personalizado apenas funciona com Configuração de Código Personalizado.
Usuários de Configuração Típica ou Website Builder: Código init personalizado será ignorado pelo SDK OneSignal. Se você precisa atrasar inicialização, use os métodos de privacidade.
Desenvolvimento & testes
Teste de ambiente local
Veja Configuração do Web SDK > Testes locais para configuração completa de teste local.Integração de service worker
O OneSignal pode trabalhar junto com service workers existentes e PWAs. Veja Integrando Múltiplos Service Workers para detalhes de implementação.Spam de push
Notificações push não são projetadas para serem usadas para anúncios, spam de usuários ou campanhas enganosas. Se seu app for detectado enviando notificações spam, navegadores podem enviar aos seus usuários uma notificação de “Aviso de spam”. Evite enviar notificações que:- Não são relevantes para os usuários
- Usam palavras como “Anúncios” ou linkam para uma página não relacionada ao app
- Não são de uma fonte confiável (ex: uma marca com a qual você não está associado)
Veja Combatendo Notificações Indesejadas com Machine Learning no Chrome para mais informações.
- Revisar seu conteúdo de notificação e remover qualquer coisa que possa ser considerada spam. Isso inclui:
- As palavras “Anúncios” ou “Anúncio” no título ou corpo
- Links para páginas não relacionadas ao app
- Links para páginas que não são de uma fonte confiável (ex: uma marca com a qual você não está associado)
- Continuar enviando e monitorar relatórios adicionais.
Solução de problemas
Tempo de implantação de atualização
- Arquivos de Service Worker: cache de 24 horas
- Web SDK: cache de 3 dias
Problemas de notificação do Chrome no macOS
Para usuários do Chrome no macOS, assegure que notificações estão habilitadas para ambos:- App Google Chrome (Menu Apple > Settings > Notifications)
- App Google Chrome Helper
Próximos passos após configuração
- Teste completamente através dos seus navegadores e dispositivos suportados
- Implemente tratamento de erro adequado para requisições de permissão
- Configure analytics para monitorar taxas de subscription
- Planeje sua estratégia de notificação para evitar fadiga do usuário
- Considere teste A/B do tempo e mensagem de requisição de permissão
Armadilhas comuns de migração
- Limpeza de dados do navegador cancela inscrição de usuários automaticamente
- Notificações duplicadas durante transições de app duplo
- iOS requer instalação de web app antes que push funcione
- Modos Privado/Anônimo nunca suportam notificações push
- Service workers devem ser acessíveis na raiz do seu site ou subdiretório configurado