1. Visão geral
A integração com o Master Data da VTEX permite sincronizar e enriquecer automaticamente os dados dos clientes na Inngage a partir das informações armazenadas no Master Data.
Com essa integração, os dados do cliente passam a ficar disponíveis na Inngage para:
-
segmentação de audiências,
-
personalização de mensagens,
-
criação de automações baseadas em dados cadastrais.
2. Pré-requisitos
Antes de iniciar a configuração, é necessário garantir que:
-
A loja utilize a plataforma VTEX
-
O Master Data esteja ativo e com os campos de cliente já configurados
-
O cliente possua credenciais de API da VTEX (appKey e appToken) com permissão de leitura do Master Data
-
Os clientes realizem login no site (usuário identificado)
A integração depende da identificação do usuário. Usuários não logados não disparam a sincronização com o Master Data.
3. O que a Integração faz
A integração realiza a consulta dos dados do cliente no Master Data e utiliza essas informações para atualizar ou enriquecer o perfil do usuário na Inngage.
A identificação do cliente é feita a partir de um identificador único, sendo o e-mail o padrão mais utilizado.
A partir desse identificador, a Inngage consegue:
-
localizar o cliente no Master Data,
-
buscar os campos configurados,
-
e sincronizar esses dados com a Estrutura de Dados da Inngage.
3. Como funciona
-
O cliente é identificado (ex: login no site ou no app).
-
A partir dessa chave, é realizada uma consulta ao Master Data da VTEX.
-
Os campos configurados no mapeamento são retornados e utilizados para atualizar ou enriquecer o perfil do usuário na Inngage.

- Com isso, os dados do cliente ficam disponíveis para segmentação, personalização de mensagens e automações.
4. Como Funciona a Integração na Prática
🔹 4.1 Ativação da Integração
-
Acesse a App Store dentro da Inngage → selecione VTEX (Master Data).
1. Ative a flag "Ativar Integração"
2. Preencha os dados:
- Chave de API (credenciais da VTEX).
- App Token
- Nome da Conta
- Ambiente

- Depois clique em "Salvar Dados"
Depois você irá associar as variáveis do template com os Campos Inngage:
1. Clique em "Habilitar Edição": 
2. Depois clique em "Adicionar Campo":

3. Selecione a sua variável com o campo correspondente: 
📍 5. Pontos Importantes
-
Caso a integração com o Master Data esteja ativa e o site já possua o script Web da Inngage instalado, a sincronização dos dados ocorre automaticamente sempre que um cliente estiver logado no site. Nesse cenário, a Inngage identifica o usuário e consulta o Master Data da VTEX para atualizar ou enriquecer o perfil do cliente.
-
Para aplicativos mobile (Android e iOS), a ativação da integração automática não é realizada por padrão. Nesse caso, é necessário solicitar ao time de suporte da Inngage a configuração específica.