Visão Geral
Este guia orienta você na solução de problemas da configuração do Web SDK do OneSignal. Antes de continuar, revise a Configuração do Web SDK para garantir que você concluiu todas as etapas. Os motivos mais comuns pelos quais o web push parece não estar funcionando estão realmente relacionados às configurações de notificação do seu navegador e dispositivo:Compatibilidade de navegadores
Os usuários podem ver solicitações de permissão da web, mas não podem se inscrever em notificações push nos modos de navegação anônima, privada ou convidado.Compatibilidade de navegadores por sistema operacional
Compatibilidade de navegadores por sistema operacional
Configurações de notificação do dispositivo
As configurações de notificação e modos de foco do seu dispositivo (Não perturbe, Bateria fraca, etc.) podem estar bloqueando a exibição de notificações. Você também pode ter as notificações desativadas para aplicativos específicos, como os navegadores. Verifique o seguinte para garantir que seu dispositivo esteja configurado para receber notificações.- 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 em 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 exibição de solicitação
A seguir estão os motivos comuns pelos quais a solicitação de notificação push da web pode não ser exibida conforme esperado.Confirme se uma solicitação está configurada
Verifique a compatibilidade do navegador, modo de navegação anônima, privado ou convidado
Verifique as Configurações de Notificação do seu navegador
chrome://settings/content/notifications
Configurações de notificações do Chrome
- O usuário selecionou “Não permitir que sites enviem notificações”, o que impedirá a exibição da solicitação de permissão nativa. Deve mostrar “Os sites podem solicitar o envio de notificações” para permitir a exibição da solicitação de permissão nativa.
- O usuário adicionou
https://yoursite.comà lista “Não permitido enviar notificações”, o que impedirá a exibição da solicitação de permissão nativa. Isso deve ser removido da lista para permitir a exibição da solicitação de permissão nativa.
- Chrome - Esta página explica como gerenciar notificações no Chrome acessando Configurações > Privacidade e segurança > Configurações do site > Notificações, onde você pode controlar o comportamento padrão e gerenciar permissões para sites individuais.
- Firefox - Este guia cobre as notificações Web Push do Firefox, explicando como gerenciar permissões de notificação através de Configurações > Privacidade e Segurança > Notificações, e como controlar permissões para sites específicos através do ícone de informações do site na barra de endereços.
- Safari - Este guia da Apple explica como personalizar notificações do Safari no Mac através de Safari > Preferências > Sites > Notificações, onde você pode gerenciar quais sites podem enviar notificações e controlar o comportamento das notificações através das Preferências do Sistema.
- Edge - Este artigo detalha como gerenciar notificações do Edge navegando para Configurações > Privacidade, pesquisa e serviços > Permissões do site > Notificações, ou clicando no ícone de informações do site na barra de endereços.
Os requisitos do iOS/iPadOS não foram atendidos
Etapas de solução de problemas
Depois de verificar o acima, siga estas etapas para solucionar problemas da configuração do Web SDK do OneSignal.Abra o console das ferramentas de desenvolvedor do navegador
- Desktop
- Android
- iOS
- Chrome: Clique com o botão direito na página, clique em Inspecionar e clique na aba Console da janela popup que se abre.
- Firefox: Clique com o botão direito na página, clique em Inspecionar elemento e clique na aba Console da janela popup que se abre.
- Safari: Vá para Safari → Preferências → Avançado e certifique-se de que Mostrar menu Desenvolver na barra de menus esteja marcado. Em seguida, em sua página da web, clique com o botão direito, clique em Inspecionar elemento e clique na aba Console da janela popup que se abre.

Console das Ferramentas de Desenvolvedor do Desktop
Verifique se o OneSignal foi carregado e inicializado em sua página
true✅ - OneSignal está inicializado e pronto. Continue para a próxima etapa.false⚠️ - OneSignal carregou, mas ainda não terminou de inicializar. Aguarde um momento e tente novamente.Uncaught ReferenceError: OneSignal is not defined❌ - Verifique se o snippet JavaScript do OneSignal está na seção<head>do seu site. Verifique se o script carrega antes de tentar usar os métodos do OneSignal. Revise o guia de Configuração do Web SDKOneSignal is already definedO SDK está sendo inicializado mais de uma vez na mesma página. Remova um método de inicialização. Se estiver usando o plugin WordPress, remova qualquer código OneSignal manual dos arquivos de tema.
Habilite o log do Web SDK
- Você deve ver
undefinedcomo resultado. - Feche a aba e abra uma nova para a mesma página. Apenas atualizar não acionará todos os eventos de inicialização do SDK.
- Você começará a ver os logs do SDK do OneSignal no Console.

Console com logs detalhados do SDK
Erros de configuração
Você pode encontrar os seguintes erros após a inicialização do OneSignal:
Erro de inicialização duplicada do SDK
init do Web SDK do OneSignal está sendo chamado mais de uma vez, frequentemente causado pela combinação da configuração do plugin WordPress com código manual ou pela adição acidental do código init do OneSignal várias vezes.
Como corrigir: Remova quaisquer chamadas init duplicadas. Se estiver usando o plugin WordPress, remova qualquer código OneSignal manual dos arquivos de tema.

O exemplo mostra que a URL definida no painel do OneSignal `http://127.0.0.1:5501` não é a origem do site atual que você está visitando.
- Protocolo: Deve ser
https://(para testes locais, consulte Configuração Localhost) - Domínio:
example.comvswww.example.com - Subdomínio:
app.example.comvsexample.com
Erros de instalação do service worker
Se você receber a Solicitação de permissão nativa e clicar em “Permitir”, poderá encontrar os seguintes erros de instalação do service worker:https://your-site.com/’) com o script (‘https://your-site.com/...’): Um código de resposta HTTP ruim (404) foi recebido ao buscar o script.https://www.yoursite.com/’) com o script (‘https://www.yoursite.com/...’): Um código de resposta HTTP ruim (403) foi recebido ao buscar o script.
Exemplo de erro de instalação do service worker

Erro de tipo MIME no service worker

Erro de redirecionamento no console
Encontre o caminho do seu service worker
OneSignalSDKWorker.js no diretório raiz do seu site, a menos que você especifique um nome de arquivo ou local personalizado, conforme descrito no Guia de Configuração do Service Worker.Certifique-se de ter configurado o nome do arquivo, local e escopo corretos para que nosso SDK encontre o arquivo do service worker.Visite o arquivo do service worker diretamente no seu navegador
- Se você não configurou um local personalizado, então você deve ver o código JavaScript do arquivo do service worker na raiz do seu site:
https://yoursite.com/OneSignalSDKWorker.js - Se estiver usando WordPress, você deve vê-lo aqui:
https://yoursite.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.js - Se estiver usando um local personalizado, você deve vê-lo aqui:
https://yoursite.com/your-custom-location/OneSignalSDKWorker.js
Verifique se o arquivo carrega
- Você deve ver o seguinte código JavaScript:
JavaScript
- Este arquivo deve ser servido com um
content-typedeapplication/javascript. - Não pode haver redirecionamentos para este arquivo. Os arquivos devem ser hospedados no mesmo domínio do seu site (sem CDN ou domínios proxy)
Notificações não exibidas
Esta seção assume:- Você revisou o guia Notificações Não Exibidas: Web Push para conhecer os motivos comuns pelos quais as notificações podem não estar aparecendo no seu dispositivo.
- Você viu a Solicitação de permissão nativa e clicou em “Permitir”. Consulte Problemas de exibição de solicitação acima se você não se inscreveu através da solicitação de permissão nativa.
Obtenha seu ID de Assinatura
- A URL da página em que você está, caso haja alguma confusão.
-
Se o navegador atual que você está usando suporta notificações push.
truesignifica que o navegador suporta notificações push.falsesignifica que o navegador não suporta notificações push.
-
Se você está inscrito em notificações no navegador.
truesignifica que você permitiu permissões push para esta URL.falsesignifica que você não permitiu ou negou permissões push para esta URL.
-
Se você optou por participar com o OneSignal.
truesignifica que sua Assinatura está inscrita em notificações push no OneSignal.falsesignifica que sua Assinatura não está inscrita em notificações push no OneSignal. Verifique se o métodooptOut()está sendo chamado no seu site.
-
Seu ID de Assinatura do OneSignal.
- Salve isso para a próxima etapa. Este é o ID que você usará para enviar uma notificação push para você mesmo.

Exemplo de informações do usuário
Envie uma notificação para você mesmo
Teste com o Chrome
- Em uma nova aba, abra
chrome://gcm-internals. - Clique no botão “Start Recording” no canto superior esquerdo. Certifique-se de ver “Connection State: CONNECTED”.
- Deixe isso aberto e envie outra notificação push para sua Assinatura de web push do Chrome.
- Você deve ver algo no “Receive Message Log” se recebeu.

Log de internos do GCM
- Se você não ver um “Data msg received”, então seu navegador Chrome não está recebendo a notificação. Por favor, nos informe sobre isso no suporte.
- Se você ver “Data msg received” mas ainda não recebeu uma notificação, continue para a próxima etapa.
- Abra uma nova aba para
chrome://serviceworker-internals - Pesquise por
Scope: https://your-site.com(substituayour-site.compelo domínio real do seu site). - Clique em Inspect, ou Start -> Inspect. Um popup das Ferramentas de Desenvolvedor do Chrome aparecerá.

Inspecionando o service worker
- No popup das Ferramentas de Desenvolvedor do Chrome para o nosso service worker, clique na aba Console e execute
OneSignalWorker.log.trace();. Deve retornarundefined. Quaisquer mensagens do nosso service worker devem agora aparecer neste popup.
[email protected]Por favor inclua:- Detalhes do problema que você está enfrentando e passos para reproduzir se disponível
- Seu OneSignal App ID
- O External ID ou Subscription ID se aplicável
- A URL para a mensagem que você testou no Dashboard OneSignal se aplicável
- Quaisquer logs ou mensagens de erro relevantes