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 e mais oportunidades de conversão: capture carrinhos de usuários logados e não logados.
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 em beta, 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.
⚠️ 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.
🚨 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
Após ativar o script, é extremamente importante desabilitar o gatilho na MasterData 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 Edit.
Em Status, selecione Disabled.
Agora é só salvar e o gatilho está desabilitado.
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.
Ajuste necessário na campanha após migrar do trigger para o script
Após a migração, é importante revisar a configuração da sua campanha de Carrinho Abandonado, especialmente o Tempo de abandono.
O que muda
Antes, com o gatilho via MasterData, a opção “Imediato” equivalia a 30 minutos de espera — esse era o tempo mínimo de idade do carrinho enviado pelo gatilho da VTEX.
Com o script, a ingestão dos carrinhos é quase instantânea (assim que o usuário abandona o checkout e os dados estão completos). Isso significa que, se o tempo de abandono continuar configurado como Imediato, o disparo da mensagem será realmente imediato — podendo não estar alinhado à sua estratégia de abordagem.
O que fazer
Se sua campanha estiver configurada com Tempo de abandono: Imediato, altere o valor para pelo menos 1 hora. Assim, você mantém uma janela adequada entre o abandono e o envio da mensagem, evitando abordagens excessivamente rápidas para o consumidor.
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. Entre os clientes que já migraram, observamos até 50% de aumento na ingestão e no volume de disparos. Essa variação depende de fatores como:
Volume de carrinhos abandonados no seu e-commerce
Filtros aplicados na criação da campanha (valor dos carrinhos, tempo de abandono)
Limite de mensagens por período definido na campanha
Em geral, quanto menos restritivos forem os filtros e maior o tráfego no checkout, maior tende a ser o ganho em alcance e disparos.
Lembre-se:
As mensagens são enviadas somente para contatos que:
Informaram um número de WhatsApp válido no checkout;
Abandonaram o carrinho na tela de checkout após preencher a seção Dados Pessoais;
Não concluíram a compra posteriormente;
E atendem aos filtros configurados na sua campanha.
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ê. 💬