Este guia mostra como hospedar o Service Worker da Inngage no seu ambiente VTEX IO, deixando-o ativo no domínio da loja para o funcionamento do Web Push. O procedimento se baseia no tutorial oficial da VTEX "Como instalar um Service Worker".

Pré-requisitos

  • A loja não pode usar checkout customizado.
  • Acesso ao Admin VTEX com permissão para editar configurações do Checkout.
  • Arquivo sw.js disponível no painel da Inngage.
  • Domínio da loja servindo via HTTPS.

Parte 1: configuração na Inngage

  1. Entre no painel da Inngage.
  2. Vá até Configurações → Plataformas → Web Push.
  3. Na seção Service Worker, preencha:
  4. Caminho do arquivo: /files/
  5. Nome do arquivo: sugerimos inngage-sw.js
  6. Escopo de registro: /files/
  7. Faça o Download do arquivo e renomeie-o exatamente como definido acima.

Parte 2: upload do arquivo na VTEX

  1. No Admin VTEX, acesse Store Settings → Storefront → Checkout (ou busque "Checkout" na barra do topo).
  2. Clique no ícone de engrenagem (⚙️) do site desejado.
  3. Na aba Código (Code), clique em Novo → Arquivo.
  4. Preencha o nome do arquivo exatamente como configurado na Inngage (ex.: inngage-sw.js).
  5. Clique em Criar, cole o conteúdo do arquivo e Salvar.

💡 Mesmo o arquivo ficando em /files/, a VTEX o serve com o header Service-Worker-Allowed: / — o que permite ao Service Worker controlar todo o site.

Testando

O arquivo ficará hospedado no domínio da loja, no formato:

https://SEUDOMINIO/files/inngage-sw.js

Acesse essa URL no navegador: ela deve retornar o conteúdo do arquivo com status 200 OK.

Conclusão

Com a URL configurada na Inngage, o Service Worker é registrado automaticamente nos navegadores dos visitantes da loja — e o Web Push passa a funcionar para envio e recebimento de notificações.