A integração do seu site VTEX com a Inngage é feita via Google Tag Manager (GTM) — e a boa notícia é que a parte técnica pesada fica com a equipe da Inngage. Seu papel é conceder os acessos e fazer algumas configurações simples na plataforma.
O que a integração inclui
- Script inngage.js importado no site.
- Service Worker instalado (o componente que permite receber web push).
- Mapeamento de eventos de usuários anônimos e logados via pixel tracking — navegação, buscas, carrinho e compras viram eventos.
- Web Push Notifications — notificações de navegador, mesmo com o site fechado.
- On-Site Messages — banners e mensagens dentro do site.
- Captura de Formulários — os formulários do site alimentando a base de contatos.
Passo a passo
1. Receba seus dados de acesso via integração.
2. Crie (ou reutilize) o app na plataforma. Se você também tem aplicativo mobile, use o mesmo app na Inngage — app e web compartilham perfis, eventos e jornadas. Só crie um app novo se esta for sua primeira implantação.
3. Importe a estrutura de dados. Em Configurações > Estrutura de Dados > Importar configuração do app:
- Se você tem app + web, use a mesma configuração do fornecedor do app (Lean, Kobe, Eitri).
- Se você é só web, use a estrutura VTEX Sample — idêntica à dos fornecedores.
- Se já importou na ativação do app, não precisa repetir.
4. Conceda os acessos à equipe Inngage. Para que a equipe técnica faça a integração do GTM:
- Dê acesso ao seu app na plataforma para suporte@inngage.com.br.
- Dê acesso ao seu GTM para o e-mail suporte@inngage.com.br.
5. A equipe técnica da Inngage parametriza o Web Push: ícone oficial, URL, ativação das funcionalidades (On-Site, Web Push, Logs, Captura de formulários) e escopo, caminho e nome do Service Worker.
6. Configure a Pré-Permissão. Você define os dados da mensagem de pré-permissão — o convite amigável que o site exibe antes do pedido nativo de permissão de notificações do navegador. Capriche no texto: é ele que determina a taxa de opt-in do web push.
7. A equipe técnica implanta as tags e roda os testes de ponta a ponta: inscrição de usuários, recebimento de eventos, web push e captura de formulários.
8. Escolha como implantar o Service Worker. Existem três caminhos — escolha o que melhor se encaixa na sua operação:
- Subdomínio da Inngage — sem nenhuma necessidade técnica do seu lado (o caminho mais simples).
- VTEX IO — instalação manual no seu domínio: guia de instalação em VTEX IO.
- Cloudflare — instalação via Cloudflare: guia de instalação via Cloudflare.
Pontos de atenção
- Acesso ao GTM é o caminho crítico. A implantação só avança com o acesso concedido — priorize esse passo com o seu time/agência.
- Data layer saudável. Os eventos dependem do data layer do site; se ele tiver problemas, o mapeamento de eventos fica comprometido. Nossa equipe indica o que precisa de ajuste.
- Service Worker próprio da VTEX. A VTEX possui um service worker nativo que pode duplicar as notificações de web push. Na implantação, é necessário remover a parte de leitura dele — nossa equipe orienta o procedimento.
- SW fora do subdomínio da Inngage exige capacidade técnica do seu lado (VTEX IO ou Cloudflare). Se o seu time não conseguir, o subdomínio da Inngage atende plenamente.
Próximos passos recomendados
- Ative as integrações backend VTEX (Master Data e Status do Pedido) — elas dão superpoderes à operação.
- Valide o funil de eventos no Dashboard.
- Configure uma mensagem on-site de captura de leads e a primeira campanha de web push.

