Pular para o conteúdo principal

​
Problemas comuns de configuração

​
Verificar sua configuração do dashboard OneSignal

Certifique-se de ter completado cada passo no guia de configuração do WordPress:
  • Selecione a opção WordPress Plugin ao criar seu app OneSignal
  • Sua URL do Site deve corresponder exatamente à URL do navegador
    • Por exemplo, https://example.com não é o mesmo que https://www.example.com. Use uma versão consistentemente.
    • Apenas uma origem de site é suportada para push. Veja Same-origin policy.
  • Certifique-se de ter adicionado pelo menos um prompt de permissão.

​
Não adicione o código OneSignal manualmente

O plugin WordPress OneSignal automaticamente inclui o script de inicialização e Service Worker. ✅ Isto significa:
  • Você não deve adicionar manualmente código JavaScript OneSignal no seu tema, rodapé ou outros plugins.
❌ Se você quiser usar Configuração de Código Personalizado, desinstale o plugin WordPress primeiro para evitar conflitos.

​
Como solucionar problemas do seu site

1

Verificar se o plugin está ativo e abrir ferramentas do desenvolvedor

Carregue seu site em uma janela de navegador normal (não anônimo) com o plugin habilitado.

Clique com o botão direito no seu site, clique em Inspecionar e abra a aba Console.

2

Verificar o console para erros OneSignal

Abra a aba Console, atualize a página e procure por quaisquer erros relacionados ao OneSignal em vermelho ou amarelo. Veja Erros comuns do Console OneSignal para ajuda.
3

Verificar status de assinatura no navegador

Cole isto no console:
OneSignal.User.PushSubscription.id
Se assinado, retorna uma string (seu Subscription ID).

Encontre seu OneSignal Subscription ID no console.

4

Verificar Subscription ID no dashboard OneSignal

Vá para OneSignal.com > Audience > Subscriptions e procure pelo ID retornado acima.

Procure no seu dashboard OneSignal pelo Subscription ID.

5

Enviar uma notificação push de teste

Se a assinatura existe e o status é Subscribed, siga o guia Push para enviar uma notificação. Se nada aparecer, veja Notificações não mostradas para correções específicas do navegador.

​
Erros comuns do console OneSignal

​
SdkInitError: OneSignal: This web push config can only be used on … Your current origin is …

Erro de incompatibilidade de URL do site.

Sua URL do site no dashboard OneSignal não corresponde ao seu domínio real. Certifique-se de que corresponde exatamente ao domínio que você vê no navegador.

​
PushPermissionNotGrantedError: The user dismissed the permission prompt.

O visitante recusou o prompt do navegador. Não aparecerá novamente até que um período de espera expire. Veja Prompts de permissão web para regras do navegador ou limpe os dados do site para tentar novamente imediatamente.

​
The OneSignal web SDK can only be initialized once.

Erro de inicialização duplicada do OneSignal.

Você está carregando OneSignal duas vezes. Remova código OneSignal adicionado manualmente se você está usando o plugin.

​
Installing service worker failed.. 403 or 404 error

Arquivo Service Worker ausente (403/404).

Certifique-se de que este arquivo está acessível: https://your-site.com/wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/OneSignalSDKWorker.js Se não, veja Suporte comum de plugin para corrigir problemas de CDN ou cache.

​
Suporte comum de plugin

CDNs e plugins de cache podem bloquear os arquivos necessários do OneSignal. Use estas configurações específicas de plugin:

​
Autoptimize

Em Excluded scripts, adicione: 
wp-content/plugins/onesignal-free-web-push-notifications/sdk_files/(.*)

​
WP Rocket

Em CDN > Exclude Files From CDN, adicione: 
(.*)/onesignal-free-web-push-notifications/sdk_files/(.*)

​
LiteSpeed Cache

Em CDN > Exclude Path, adicione: 
(.*)/onesignal-free-web-push-notifications/sdk_files/(.*)
Então pressione salvar.

​
WP Super Cache

  1. Vá para Settings > WP Super Cache > CDN
  2. Em Exclude if substring, inclua: onesignal-free-web-push-notifications
  3. Clique em Contents > Delete Cache

​
WP Engine

No WP Engine plugin > General Settings > HTML Post-Processing, adicione estes, substituindo YOURSITEHERE:
text
#https?://(www\.)?(YOURSITEHERE\.com|mywpenginehandleHere.wpengine.com|wpengineCDNpathHere.wpengine.netdna-(ssl|cdn).com)/wp-(content|includes)#
=> https://wpengineCDNpathHere-wpengine.netdna-ssl.com/wp-$4
#https://wpengineCDNpathHere-wpengine.netdna-ssl.com/plugins/onesignal-free-web-push-notifications/#
=> https://mywebsiteHere.com/wp-content/plugins/onesignal-free-web-push-notifications/
#https://wpengineCDNpathHere-wpengine.netdna-ssl.com/wp-content/plugins/onesignal-free-web-push-notifications/#
=> https://mywebsiteHere.com/wp-content/plugins/onesignal-free-web-push-notifications/

​
W3 Total Cache

  1. Vá para Performance > CDN
  2. Em Rejected files, adicione:
{plugins_dir}/onesignal-free-web-push-notifications/sdk_files/*

Configurações de exclusão W3 Total Cache.

​
BunnyCDN

Exclua onesignal nos CDN Excluded Paths do plugin.

Exemplo de exclusão BunnyCDN.

​
CDN Enabler

Em Settings > CDN Enabler, adicione isto a “Exclusions”: 
onesignal-free-web-push-notifications

​
PressCDN

Em Exclude Directories, adicione: 
/wp-content/plugins/onesignal-free-web-push-notifications/

​
Breeze

Em Settings > CDN > Exclude Content, adicione: 
/onesignal-free-web-push-notifications/sdk_files/

Exemplo de exclusão Breeze.

​
Hummingbird Pro

Vá para Asset Optimization, encontre o arquivo OneSignal SDK e remova-o da otimização.

Asset Optimization do Hummingbird Pro.

​
Sucuri

Siga o guia de Whitelist do Sucuri para permitir arquivos OneSignal.

​
iThemes Security plugin

Desabilite a opção “Disable PHP in Plugins” em System Tweaks.

Configuração de plugin PHP iThemes.

​
Defender Security plugin

Não habilite “Prevent PHP execution”. Vá para Defender Plugin > Security Tweaks e verifique se a configuração está desabilitada.

​
Exemplo .htaccess para acesso Service Worker

html
<Files *.php>
Order allow,deny
Deny from all
</Files>
<Files OneSignalSDKWorker.js.php>
Allow from all
ForceType 'application/javascript; charset=UTF-8'
</Files>
<Files OneSignalSDKWorker.js>
Allow from all
ForceType 'application/javascript; charset=UTF-8'
</Files>

​
Lentidão do servidor ou site inacessível após enviar notificações

Se seu servidor experimenta lentidão ou fica inacessível após enviar notificações, frequentemente é devido ao aumento de carga de recursos de notificação ou recursos limitados do servidor.

​
Não hospede seus próprios ícones de notificação

Evite auto-hospedar imagens usadas em notificações. Quando você hospeda seus próprios ícones ou imagens de notificação, seu servidor pode ficar sobrecarregado já que o navegador de cada destinatário tenta buscar a imagem ao mesmo tempo que uma notificação é enviada. Para reduzir a carga do servidor, use soluções de hospedagem de imagem ou serviços CDN otimizados para acesso de alta concorrência.

​
Considere atualizar recursos de hospedagem

Se problemas de servidor persistirem, você pode precisar:
  • Atualizar seu plano de hospedagem: Maior largura de banda ou hospedagem mais poderosa pode ser necessária para lidar com envios de notificação em larga escala.
  • Consultar seu provedor de hospedagem: Seu provedor pode oferecer insights ou otimizações específicas para seu ambiente de hospedagem.