Passo 1: Localizar o Arquivo worker.js da SFCC
- Acesse o Business Manager da SFCC: Faça login na sua conta do Salesforce Commerce Cloud.
- 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.
- Identifique o Cartucho Ativo: Localize o cartucho responsável pelo tema da loja. É nesse cartucho que geralmente se encontra o arquivo worker.js.
- 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
- Acesse o Painel da Inngage: Faça login na sua conta.
- Localize a Seção de Integração: Navegue até "Web Push".
- 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
- Edite o Arquivo worker.js: Abra o arquivo em um editor de código.
- 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
- Salve o Arquivo worker.js: Certifique-se de que as alterações foram gravadas corretamente.
- 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.
- 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.
- 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.