Como instalar o Service Worker na SalesForce Commerce Cloud.

Como Adicionar o Script da Inngage no worker.js da SFCC.
Written by Inngage
Updated 1 month ago

Passo 1: Localizar o Arquivo worker.js da SFCC

  1. Acesse o Business Manager da SFCC: Faça login na sua conta do Salesforce Commerce Cloud.
  2. Navegue até o Gerenciamento de Código: Busque por seções como "Administração do Site" ou "Desenvolvimento". Dentro desses menus, acesse "Gerenciamento de Código", "Code Deployment" ou equivalentes.
  3. Identifique o Cartucho Ativo: Localize o cartucho responsável pelo tema da loja. É nesse cartucho que geralmente se encontra o arquivo worker.js.
  4. Explore a Estrutura de Pastas: Dentro do cartucho ativo, navegue pelas pastas — como static, js ou até mesmo a raiz — até localizar o arquivo worker.js. A estrutura pode variar dependendo da personalização do tema.

Passo 2: Obter o Script de Integração da Inngage

  1. Acesse o Painel da Inngage: Faça login na sua conta.
  2. Localize a Seção de Integração: Navegue até "Web Push".
  3. Copie o Script do Service Worker: A Inngage disponibilizará um snippet de código JavaScript específico para ser adicionado ao seu Service Worker. Este código normalmente inclui a lógica de registro do push, tratamento das notificações recebidas e sua exibição.

Passo 3: Integrar o Script da Inngage ao worker.js da SFCC

  1. Edite o Arquivo worker.js: Abra o arquivo em um editor de código.
  2. Adicione o Script da Inngage: Cole o script copiado no passo anterior no escopo global do worker.js, de preferência no final do arquivo, antes de qualquer outro código específico da SFCC.

Exemplo:

{
    "your-host": [
        {
            "if-site-path": "/sw.js",
            "pipeline": "InngageServiceWorkerGetFile"
        }
    ]
}

Atenção: Se o script da Inngage utilizar importScripts() para carregar arquivos externos, certifique-se de que esses arquivos estejam acessíveis no contexto do seu Service Worker — via CDN ou hospedagem no servidor da SFCC.

Passo 4: Fazer o Deploy das Alterações na SFCC

  1. Salve o Arquivo worker.js: Certifique-se de que as alterações foram gravadas corretamente.
  2. Faça o Upload do Cartucho: Use o Business Manager da SFCC para enviar a nova versão do cartucho modificado para o servidor. Verifique se o cartucho está ativo em seu site.
  3. Limpe o Cache do Navegador: Após o deploy, limpe o cache e os dados do site no navegador para garantir o carregamento do novo Service Worker.
  4. Teste as Notificações: Acesse o site, aceite o recebimento de notificações (caso ainda não tenha feito isso) e envie uma notificação de teste através do painel da Inngage para validar o funcionamento.

Considerações Adicionais

  • Conflitos de Código: Verifique o console do navegador em busca de erros JavaScript que possam indicar conflitos entre o script da Inngage e o código existente.
  • Atualizações da SFCC: Alterações na plataforma podem sobrescrever o arquivo worker.js. Sempre revise e reaplique as alterações após atualizações significativas.
  • Escopo do Service Worker: O escopo padrão / costuma ser suficiente. No entanto, verifique se está corretamente configurado para abranger as rotas que exigem interceptação de notificações.
  • Registro do Service Worker: Confirme como o Service Worker está sendo registrado no tema. A integração da Inngage não deve interferir nesse processo.
  • Compatibilidade entre Navegadores: Teste o funcionamento das notificações em navegadores como Chrome, Firefox, Safari e Edge para garantir o comportamento consistente.

 

Did this answer your question?