Integração Inngage VTEX Master Data

Written by Inngage

Updated 2 weeks ago

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.

Esse processo acontece automaticamente, sem necessidade de ações manuais após a configuração inicial.

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"

A Inngage buscará a lista de campos disponíveis no Master Data e apresentará para você mapear esses campos com os campos customizáveis da Inngage.

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.

Did this answer your question?