O novo script de captura instalado no checkout substitui o antigo gatilho (trigger) via MasterData, permitindo capturar carrinhos de todos os visitantes, inclusive usuários não logados — ou seja, também consumidores em primeira compra, caso tenham informado um número de WhatsApp válido no checkout.
Por que migrar para o novo script?
Maior alcance: capture carrinhos de usuários logados e não logados.
Mais disparos e conversões: amplie o volume de campanhas de Carrinho Abandonado.
Pronto para o fim de ano: aumente a taxa de recuperação no período de maior volume de vendas.
Acesso antecipado a novas campanhas: quem utiliza o script terá liberação prioritária para o novo modelo de Pedido Não Pago, que recupera pagamentos falhos via WhatsApp.
Manutenção garantida: o método anterior via trigger da MasterData será descontinuado em 31/12/2025.
Como o novo script funciona?
O funcionamento é semelhante a scripts como o Google Analytics ou Facebook Pixel — ou seja, ele coleta eventos diretamente no checkout da loja. A forma de inserção pode variar conforme a personalização do seu checkout na VTEX:
Checkout padrão: instalação direta via admin da VTEX;
Checkout externo ou VTEX IO: o script pode precisar ser adicionado alternativamente. Se for seu caso, entre em contato com o nosso suporte.
Como instalar o script na VTEX
Para disparar campanhas de Carrinho Abandonado via VTEX, é necessário inserir o script exibido na tela de integração com a OmniChat:
Acesse Configurações → Integrações → E-commerce / ERP → VTEX.
Ative a opção “Utilizar carrinho abandonado” — o script será gerado automaticamente.
Copie o código exibido.
⚠️ Apenas usuários administradores têm acesso a essa área.
Ao selecionar “Utilizar carrinho abandonado”, automaticamente criamos o script para você simplesmente copiar e colar na VTEX.
Agora, siga o passo a passo na VTEX (leva menos de 5 minutos!):
No Admin da VTEX, acesse:
Configurações da loja → Storefront → Checkout.
Clique na engrenagem azul ⚙️ do seu checkout.
No menu superior, selecione Código.
No menu lateral direito, abra o arquivo checkout6-custom.js.
Cole o código da OmniChat no final do arquivo (após qualquer código existente).
Clique em Salvar.
Após salvar, pause o gatilho anterior (trigger na MasterData) para evitar duplicidade.
🚨 Atenção: esse é o processo para uma loja padrão VTEX. Se sua loja tem customizações, o importante é que o script da OmniChat seja carregado na tela do checkout.
Para mais informações, acesse: Configurando sua integração OmniChat<>VTEX
Verificando se a instalação foi feita com sucesso
Após inserir o script no checkout da VTEX, é possível confirmar se a instalação está funcionando corretamente em poucos passos:
Acesse o checkout da sua loja VTEX.
No navegador, pressione F12 para abrir o DevTools.
Clique na aba Console.
Se o script estiver instalado corretamente, você verá o texto abaixo:
Isso confirma que o script está ativo e pronto para capturar eventos de carrinho no checkout.
Caso a mensagem não apareça, revise se o código foi adicionado no lugar correto (checkout6-custom.js) e se as alterações foram salvas. Se ainda tiver dúvidas, entre em contato com o suporte que iremos te auxiliar.
Como desabilitar o gatilho (trigger) anterior
Como explicamos acima, é extremamente importante desabilitar o gatilho na MasterData após instalar o script para que os consumidores da sua marca não sejam impactados duas vezes.
Para isso, siga este passo a passo:
Na VTEX, acesse Configurações da loja → Storefront → Master Data.
Faça login, se solicitado, e vá até Advanced Settings → Settings → Data Structure → Trigger.
Localize o gatilho da OmniChat e clique em Delete.
Prazo para migração
O gatilho (trigger) via MasterData deixará de ter manutenção a partir de 31/12/2025. A partir dessa data, somente o novo método de captura por script continuará ativo.
Ao migrar, você garante:
Continuidade das campanhas de Carrinho Abandonado;
Expansão do público impactado;
Melhor desempenho de vendas durante a Black Friday e Natal.
Perguntas frequentes
O que acontece se eu não migrar?
As campanhas de Carrinho Abandonado com método legado de gatilho deixarão de receber novos eventos após o fim do suporte ao trigger da MasterData.
Migrar significa que dispararei mais?
Depende da configuração da sua campanha. Clientes que migraram observaram até 50% de aumento na ingestão e disparos — variação que depende do volume de carrinhos abandonados no e-commerce e dos filtros aplicados na campanha como ticket médio, tempo de abandono e limite de disparos por horário.
Lembrando: só são impactados os contatos com número de WhatsApp válido, que não concluíram a compra após o abandono e que tenham abandonado um carrinho na tela de checkout após preenchimento da coluna Dados Pessoais.
Preciso reconfigurar minhas campanhas?
Não. Após a instalação do novo script, as campanhas existentes continuarão funcionando automaticamente.
Como posso verificar se estou disparando mais?
Você pode acompanhar o desempenho no Dashboard de Campanhas, que possui atualização a cada 2 horas.
Conclusão
Desejamos ótimas vendas e excelentes resultados com o novo script! 🚀
Realize sua migração quanto antes para aproveitar todo o potencial de recuperação neste fim de ano.
Se tiver dúvidas ou sugestões sobre este artigo, envie seu feedback — ele nos ajuda a manter a Central de Ajuda sempre atualizada e útil para você. 💬