Configurações do dispositivo
As configurações de notificação do dispositivo são a causa mais comum de notificações web push não aparecerem. Verifique as seguintes configurações, incluindo modos de foco (Não perturbe, Bateria fraca, etc.), antes de investigar outras causas.- Windows
- macOS
- Android
- iOS
Configurações de notificação do Windows 10
Configurações de notificação do Windows 10
- Selecione Iniciar > Configurações > Notificações e Ações > Receber notificações de aplicativos e outros remetentes
- Certifique-se de que seu site e navegador também estejam ativados.

Configurações de notificação do Windows 10
- Selecione Iniciar > Configurações > Sistema > Notificações

Configurações de notificação do Windows 11
- Ative Notificações
- Desative Não perturbe (durante os testes, as notificações serão exibidas quando esta opção estiver desativada)
- Role para baixo até Notificações de aplicativos e outros remetentes

Windows 11 Notificações de aplicativos e outros remetentes
- Certifique-se de que seus navegadores estejam ativados.

Lista de navegadores nas configurações de notificação do Windows 11
Problemas de rede - sem internet
Os dispositivos devem estar online para receber notificações push. Se seu dispositivo estiver desligado, em modo avião, tiver uma conexão instável ou sem internet, o push não será exibido até que uma conexão adequada seja estabelecida. Você pode definir o período de tempo que o FCM e o APNs aguardarão uma conexão com o parâmetro Time To Live (TTL) (o padrão é 3 dias). Se o dispositivo estiver em uma rede WiFi com firewall ou VPN, essa rede pode estar bloqueando a conexão com os servidores da Apple ou Google. Teste alternando para dados celulares. Se você estiver gerenciando o tráfego de rede por meio de um firewall, configure-o para permitir o seguinte:- FCM (Chrome, Android): portas TCP de saída 5228, 5229 e 5230. Consulte a documentação do FCM para os requisitos completos.
- APNS (Safari, iOS): porta TCP de saída 5223 e porta TCP 443 ou 2197. Consulte a documentação da Apple para os requisitos completos.
Configurações do navegador
Seu navegador tem suas próprias configurações de permissão de notificação, independentes das configurações do sistema operacional. Um site pode ser bloqueado no nível do navegador mesmo que as notificações do SO estejam habilitadas para o navegador.- Chrome: Acesse
chrome://settings/content/notificationse confirme que seu site está listado em “Permitido enviar notificações”, não em “Não permitido enviar notificações”. - Firefox: Acesse
about:preferences#privacy, role até Permissões > Notificações e clique em Configurações para verificar o status do seu site. - Edge: Acesse
edge://settings/content/notificationse verifique se seu site está permitido. - Safari: Acesse Safari > Configurações > Sites > Notificações e confirme que seu site está definido como Permitir.
Navegador está fechado
Os navegadores não mostrarão notificações push, a menos que estejam em execução. Se você abrir o navegador antes que o Time To Live(TTL) expire em uma notificação enviada, ela aparecerá.Navegador não suportado
Os usuários devem se inscrever para notificações em seu desktop ou dispositivo móvel para receber notificações e deve ser um navegador que suporte notificações push. Consulte FAQ de Web Push para Plataformas Web Suportadas.Dados do aplicativo do navegador móvel cheios
Se o aplicativo do seu navegador móvil atingiu seu limite de dados ou seus dados estão cheios, você precisará limpar os dados no aplicativo. Se o aplicativo do seu navegador móvil tiver muitas notificações push não lidas e/ou muitas abas abertas, isso pode fazer com que as notificações não apareçam.Assinatura do usuário
Certifique-se de que seu dispositivo ainda está inscrito e é alvo de notificações push.Elegibilidade de assinatura
Verifique a audiência da mensagem para confirmar que sua Assinatura web push está incluída:- Segmentos: Verifique se sua Assinatura atende a todas as condições de filtro de audiência.
- Envio direto: Confirme se o ID que você está direcionando está correto:
- A Assinatura ainda está inscrita para push.
- Tem uma data de última sessão recente — você pode estar enviando para uma Assinatura antiga ou inativa.
Base de código do site
Cancelando o registro do service worker ou adicionando pwa
Verifique a base de código do seu site para o método.unregister(). Chamar este método excluirá Service Workers. Consulte este guia para detalhes sobre este método.
Se você tiver outro service worker como para seu PWA, precisará seguir nosso guia de Service Worker sobre integração de múltiplos service workers.
Depurando notificações push web
Siga estas etapas para obter uma Assinatura web push limpa e confirmar que o web push está funcionando de ponta a ponta.Abrir seu site no navegador
Depuração em dispositivo móvel
Depuração em dispositivo móvel
- Chrome: Abra
chrome://inspect/#devicesno desktop, depois siga os passos abaixo no seu dispositivo móvel. - Firefox: Consulte about:debugging.
- No seu iPhone ou iPad, vá para Ajustes > Safari > Avançado e ative o Web Inspector.
- Conecte seu dispositivo ao Mac com um cabo USB.
- Abra o Safari no Mac e vá para Desenvolver > [nome do seu dispositivo] > [página do seu site].
- Siga as etapas abaixo usando seu dispositivo móvel.
Redefinir permissões do navegador e limpar dados do site
- Clique no ícone de informações do site ao lado da sua URL.
- Se você vir Notificações, selecione Redefinir permissão (você quer ver “Pode pedir para enviar notificações”).
- Clique em Cookies e dados do site.

Painel de configurações do site Chrome mostrando a redefinição de permissões de notificações e opções de cookies
- Clique em Gerenciar dados do site no dispositivo.

Painel de Cookies e dados do site Chrome com botão para gerenciar cookies e dados do site
- Clique no Ícone de Lixeira ao lado de:
- A URL do seu site
onesignal.com

Lista de cookies Chrome com ícone de lixeira para remover dados do site
- Feche a aba e abra seu site novamente em uma nova aba.
Abrir o Console e se inscrever para notificações push
- Quando você retornar ao seu site em uma nova aba, clique com o botão direito na página e selecione Inspecionar para abrir o Console.
- Siga as etapas que você configurou para acionar o prompt de permissão nativo do navegador e permitir notificações. Consulte Prompts de permissão web para mais detalhes.

Prompt de permissão de notificação do navegador pedindo para permitir ou bloquear notificações
- Clique em Permitir para se inscrever para notificações push.
- Verifique o Console para erros. Se você vir algo em vermelho relacionado ao OneSignal, consulte nossa documentação de solução de problemas do Web SDK.
Obter seu ID de Assinatura e definir como assinatura de teste
- No Console, execute o seguinte código para obter seu ID de Assinatura:

Console JavaScript mostrando OneSignal.User.PushSubscription.id retornando um ID de Assinatura
- Copie o ID sem aspas.
- No painel do OneSignal, navegue até Público > Assinaturas, cole o ID de Assinatura (sem aspas) na barra de pesquisa, clique no botão Opções e selecione Adicionar como assinatura de teste.

Painel do OneSignal mostrando a barra de pesquisa de Assinaturas com o ID de Assinatura colado
Enviar uma mensagem de teste para você mesmo
- Navegue até Mensagens > Novo Push e escreva uma mensagem no campo Mensagem.
- Em Teste e Visualização, selecione sua assinatura de teste e envie o push para você mesmo.

Painel do OneSignal mostrando o formulário de nova mensagem push com assinatura de teste selecionada
support@onesignal.comPor favor, inclua:- Seu OneSignal App ID
- O ID de Assinatura ou ID Externo
- A URL da mensagem que você testou no Painel do OneSignal
- A URL do seu site com o código do Web SDK do OneSignal




