Aviso: Não há documentação legada disponível para este item, portanto, você está vendo a documentação atual.
Queremos que sua instalação do PushEngage WordPress seja tranquila, mas você ainda pode encontrar problemas. O service worker é o arquivo chave na coleta de assinantes de push e no envio de campanhas de push.
Compilamos um guia com vários problemas comuns relacionados ao arquivo Service Worker durante a instalação do PushEngage e como você pode corrigir esses problemas.
Antes de Começar
- Você deve evitar redirecionamentos; o arquivo service-worker.js deve ser publicamente acessível (https://www.seusite.com/service-worker.js). Se houver algum redirecionamento ao tentar visitar o arquivo service-worker.js, sua instalação estará incorreta e a assinatura também falhará.
- Se você vir um erro 403 ou 404 após tentar se inscrever em seu site, algo está impedindo que os arquivos do service worker do PushEngage sejam abertos. Você pode verificar isso visitando seu Painel PushEngage ou o Console do seu Navegador. Esses arquivos devem ser escritos em letras maiúsculas, não como redirecionamentos. Essas páginas devem ser acessíveis a você sem problemas.
- É necessário mesclar service workers se você estiver integrando o PushEngage a um site que já possui um service worker (como um PWA) para que o PushEngage funcione corretamente. Este guia ajuda você a mesclar o service worker do PushEngage com o service worker existente em seu site.
Problemas com o Service worker e suas correções
Erro 1: URL incorreta do arquivo Service Worker
TypeError: Falha ao registrar um ServiceWorker para o escopo (https://xxxx) com o script (https://www). Um código de resposta HTTP inválido (404) foi recebido ao buscar o script.
Solução: Verifique se o nome e a localização do arquivo Service Worker correspondem ao valor do seu painel PushEngage navegando para Configurações do Site » Configurações Avançadas » Configurações do Service Worker
Erro 2: O navegador não tem permissão para ler o arquivo Service Worker
TypeError: Falha ao registrar um ServiceWorker para o escopo ('https://xxx') com o script ('https://xxxx'): Um código de resposta HTTP inválido (403) foi recebido ao buscar o script.
Solução: Verifique a configuração do servidor web com o provedor de serviços de hospedagem para garantir que a configuração permita o acesso de leitura ao arquivo Service Worker e que o arquivo seja publicamente acessível pela internet.
A equipe do PushEngage não pode ajudá-lo a alterar permissões, apenas sua empresa de hospedagem ou equipe de desenvolvimento pode ajudá-lo a corrigir essas permissões.
Erro 3: Falha ao executar ‘importScripts’
Uncaught DOMException: Falha ao executar 'importScripts' em 'WorkerGlobalScope'. O script em (https://xxxxxx) falhou ao carregar em (https://xxxx).
Solução: O arquivo Service Worker usa um nome de subdomínio incorreto na instrução importScripts (https://xxxx.pushengage.com) dentro do arquivo Service Worker. Portanto, certifique-se de que a instrução importScript usa o subdomínio PushEngage correto atribuído ao site.
O valor do parâmetro de consulta de domínio na URL do Service Worker está incorreto. Isso se aplica apenas a sites que usam o plugin WordPress.
Erro 4: Falha ao registrar um Service Worker
DOMException: Falha ao registrar um Service Worker para o escopo (https://xxxx) com o script (https://xxxxxxxx). O caminho do escopo fornecido ('xxx') não está sob o escopo máximo permitido ('xxxxxxx'). Ajuste o escopo, mova o script do Service Worker ou use o cabeçalho HTTP Service-Worker-Allowed para permitir o escopo.
Solução: Mova o arquivo do service worker para o diretório raiz e atualize o caminho do service worker através deste guia.
Depois de fazer isso, defina o valor do cabeçalho HTTP Service-Worker-Allowed como ‘/’ para solicitações ao arquivo do Service Worker.
Se você encontrar algum problema, por favor entre em contato conosco clicando aqui. Nossa equipe de suporte poderá ajudá-lo.
