As integrações backend da VTEX são os superpoderes da sua implantação: elas fazem os dados de clientes e os eventos de pedido fluírem automaticamente da VTEX para a Inngage, destravando segmentações mais ricas e réguas transacionais completas (pedido faturado, enviado, cancelado...).

São duas integrações distintas na App Store — VTEX Master Data (dados de clientes) e VTEX Status do Pedido (eventos do pedido) — e cada uma é ativada separadamente.

Pré-requisitos: credenciais da conta VTEX

Ambas as integrações precisam dos dados da sua conta VTEX:

  • Chave de API
  • Nome da Conta
  • App Token
  • Ambiente

As permissões necessárias e o passo a passo para gerar as chaves estão em: Configurando a integração VTEX.

Com as credenciais em mãos, vá em App Store e localize VTEX Master Data e VTEX Status do Pedido (são itens distintos na loja). Em cada uma, configure as chaves de API e os dados da integração.

VTEX Status do Pedido

Transforma cada mudança de status do pedido em um disparo automático de mensagem — em qualquer canal.

1. Crie os API Templates. Antes de configurar a integração, crie em API Templates um template de mensagem para cada status que deseja comunicar:

  • Cancelado
  • Faturado
  • Enviado
  • Processado

2. Acesse App Store > VTEX Status do Pedido.

3. Mapeie o De → Para. Abaixo da configuração da conta, clique no botão Adicionar campo. Você verá dois seletores lado a lado:

  • Esquerda: o Status do Pedido da VTEX.
  • Direita: o API Template que você criou.

Selecione o status de um lado e o template correspondente do outro.

4. Repita para todos os status que deseja implementar.

5. Pronto — o resto é com a Inngage. A cada mudança de status na VTEX, o cliente recebe automaticamente a mensagem do template mapeado.

Dica estratégica: trate esses templates como parte da experiência da marca — "pedido enviado" é a mensagem com a maior taxa de abertura de toda a operação. Aproveite para incluir rastreamento e, no pós-entrega, iniciar a régua de avaliação e recompra.

VTEX Master Data

Sincroniza automaticamente os dados de clientes do Master Data da VTEX com os perfis da Inngage.

1. Acesse App Store > VTEX Master Data.

2. Mapeie o De → Para. Abaixo da configuração da conta, clique em Adicionar campo. Você verá dois seletores:

  • Esquerda: o campo oficial do Master Data da VTEX.
  • Direita: o Custom Field correspondente na Inngage.

Selecione o campo da VTEX de um lado e o campo da Inngage do outro.

3. Repita para todo campo da VTEX que deseja mapear.

Sobre os Custom Fields: eles já estarão disponíveis se você fez a importação da estrutura de dados na implantação. Se quiser mapear um campo novo, crie-o antes em Configurações > Estrutura de Dados > Campos customizáveis (veja como) e volte para o mapeamento.

Dica estratégica: priorize os campos que alimentam segmentação e personalização — nome, telefone, cidade, data de nascimento, preferências. Cada campo mapeado vira um critério de audiência e uma variável de mensagem.

O que essas integrações destravam

  • Réguas transacionais completas sem desenvolvimento: status do pedido virando mensagem em push, WhatsApp, e-mail ou SMS.
  • Perfis sempre atualizados com os dados cadastrais da loja — sem importações manuais.
  • Segmentações mais precisas: audiências e matrizes RFV alimentadas pelos dados reais do e-commerce.
  • Jornadas pós-compra: o evento de status alimenta gatilhos de automação (entregou → pedir avaliação → oferecer recompra).