Conectar VTEX

Este guia acompanha a tela Integrações → Lojas e apps → VTEX.

Para que serve

1. Receber carrinhos abandonados via webhook do Master Data — o painel grava o evento e atualiza Contatos (tags vtex e abandoned_cart).
2. E-mail automático de carrinho — Automação → Carrinho abandonado (template, métricas, cooldown e teste).
3. Sincronizar clientes da loja para Contatos (tags vtex e vtex_customer) — botão Sincronizar clientes.

Credenciais

No Admin VTEX, crie um App Key / App Token com permissão de leitura da loja. No painel Br Envio informe:

• Nome da conta (accountName) — só o nome, sem .myvtex.com
• App Key
• App Token

Use Testar conexão para validar antes de configurar o trigger.

Sincronizar clientes

Com a loja conectada, clique em Sincronizar clientes. O painel acompanha até terminar e mostra quantos contatos foram novos, atualizados ou pulados. Na tela também aparece quantos clientes VTEX já estão na base — com link para Contatos filtrados pela tag vtex_customer.

Newsletter opt-in

O sync só importa quem tem isNewsletterOptIn verdadeiro (ou ausente, conforme o payload). Se a sincronização terminar com zero clientes, confira no Master Data VTEX se o campo existe e está marcado para os clientes de teste — depois rode Sincronizar clientes de novo.

Checklist no painel

Na tela VTEX há um checklist: credenciais, teste, secret, URL e JSON. Ao copiar URL/JSON/secret, o item fica marcado neste navegador — ajuda a não esquecer um passo.

Quando o trigger da VTEX disparar com sucesso, aparece um aviso verde com a data/hora do último carrinho recebido.

Webhook de carrinho (Master Data) — passo a passo

1. No Admin VTEX: Master Data → triggers na entidade Cliente.
2. Condição típica: última sessão alterada + carrinho preenchido + checkout não concluído (+ newsletter quando fizer sentido).
3. Ação positiva: Enviar HTTP Request (método POST).
4. URL = a URL mostrada no painel Br Envio (botão Copiar).
5. Headers (também há botão Copiar no painel):

Content-Type: application/json
Accept: application/json
X-Brenvio-Vtex-Secret: SEU_SEGREDO_AQUI

O segredo aparece só uma vez ao conectar (ou ao gerar novo). Guarde como senha.

6. Corpo JSON (botão Copiar no painel):

{
  "email": "{!email}",
  "firstName": "{!firstName}",
  "lastName": "{!lastName}",
  "rclastcart": "{!rclastcart}",
  "rclastcartvalue": "{!rclastcartvalue}",
  "isNewsletterOptIn": "{!isNewsletterOptIn}",
  "rclastsession": "{!rclastsession}"
}

7. Salve o trigger e teste abandonando um carrinho na loja (a sessão VTEX costuma esperar ~30 minutos antes do trigger).

Opt-in e higiene

• Se isNewsletterOptIn vier como falso, o Br Envio não cria/atualiza o contato para marketing.
• Contatos já descadastrados, na lista de bloqueio ou suprimidos não são reativados.
• Carrinho: tags vtex e abandoned_cart. Sync em lote: tags vtex e vtex_customer.

O que ainda pode vir depois

• Cancelar o e-mail se o pedido for fechado na VTEX
• Sequência com 2º e-mail (drip)
• Relatório de conversão

Relacionado

• Carrinho abandonado
• Importar contatos