Aviso: Não existe documentação legada disponível para este item, pelo que está a ver a documentação atual.
Queremos que a instalação do PushEngage no WordPress seja simples, mas ainda assim poderá encontrar problemas. O service worker é o ficheiro fundamental na recolha de subscritores de push e no envio de campanhas de push.
Compilámos um guia com vários problemas comuns relacionados com o ficheiro Service Worker durante a instalação do PushEngage e como pode resolver estes problemas.
Antes de Começar
- Deve evitar redirecionamentos; o ficheiro service-worker.js deve ser publicamente acessível (https://www.oseusite.com/service-worker.js). Se houver algum redirecionamento ao tentar aceder ao ficheiro service-worker.js, a sua instalação está incorreta e a subscrição também falhará.
- Se vir um erro 403 ou 404 após tentar subscrever o seu site, algo está a impedir que os ficheiros do Service Worker do PushEngage sejam abertamente acessíveis. Pode verificar isto acedendo ao seu Painel PushEngage ou à Consola do seu Navegador. Estes ficheiros devem ser escritos em maiúsculas, não como redirecionamentos. Estas páginas devem ser acessíveis para si sem quaisquer problemas.
- É necessário fundir service workers se estiver a integrar o PushEngage num site que já tem um service worker (como um PWA) para que o PushEngage funcione corretamente. Este guia ajuda-o a fundir o service worker do PushEngage com o service worker existente no seu site.
Problemas com o Service worker e as suas soluções
Erro 1: URL incorreta do ficheiro Service Worker
TypeError: Falha ao registar um ServiceWorker para o âmbito (https://xxxx) com o script (https://www). Um código de resposta HTTP incorreto (404) foi recebido ao obter o script.
Solução: Verifique se o nome e a localização do ficheiro 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 ficheiro Service Worker
TypeError: Falha ao registar um ServiceWorker para o âmbito ('https://xxx') com o script ('https://xxxx'): Um código de resposta HTTP incorreto (403) foi recebido ao obter o script.
Solução: Verifique a configuração do servidor web com o fornecedor do serviço de alojamento web para garantir que a configuração permite o acesso de leitura ao ficheiro Service Worker e que o ficheiro é publicamente acessível a partir da internet.
A equipa PushEngage não pode ajudá-lo a alterar permissões, apenas a sua empresa de alojamento ou equipa de desenvolvimento pode ajudá-lo a corrigir estas 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://www).
Solução: O ficheiro Service Worker utiliza um nome de subdomínio incorreto na instrução importScripts (https://xxxx.pushengage.com) dentro do ficheiro Service Worker. Assim, certifique-se de que a instrução importScript utiliza o subdomínio PushEngage correto atribuído ao site.
O valor do parâmetro de consulta de domínio no URL do Service Worker está incorreto. Isto aplica-se apenas a sites que utilizam o plugin WordPress.
Erro 4: Falha ao registar um Service Worker
DOMException: Falha ao registar um Service Worker para o âmbito (https://www) com o script (https://xxxxxxxx). O caminho do âmbito fornecido ('xxx') não está sob o âmbito máximo permitido ('xxxxxxx'). Ajuste o âmbito, mova o script do Service Worker ou utilize o cabeçalho HTTP Service-Worker-Allowed para permitir o âmbito.
Solução: Mova o ficheiro do service worker para o diretório raiz e atualize o caminho do service worker através de este guia.
Depois de o ter feito, defina o valor do cabeçalho HTTP Service-Worker-Allowed para ‘/’ para os pedidos ao ficheiro do Service Worker.
Se encontrar algum problema, por favor contacte-nos clicando aqui. A nossa equipa de suporte poderá ajudá-lo.
