Como integrar com a VTEX
Introdução
A integração com o VTEX E-Commerce permite o envio automático dos dados MASTERDATA dos clientes para um perfil ICOMMKT, bem como o seu enriquecimento com base nas informações processadas das diversas compras realizadas por cada um deles.
- Entre esses dados podemos encontrar:
• Data da última compra
• Dias desde a última compra
• Data da primeira compra
• Dias desde a primeira compra
• Produtos adquiridos nos últimos 30, 60, 90, 180, 360, 360 ou mais dias
• Categorias de produtos adquiridos nos últimos 30, 60, 90, 180, 360, 360 ou mais dias
• Número de compras feitas nos últimos 30, 60, 90, 180, 360, 360 + dias
• Quantidade de compras feitas nos últimos 30, 60, 90, 180, 360, 360+ dias
• Quantidade média de compras feitas nos últimos 30, 60, 90, 180, 360, 360 + dias
• RFM para compras feitas nos últimos 30, 60, 90, 180, 360, 360 ou mais dias
• Códigos de desconto aplicados nos últimos 30, 60, 90, 180, 360, 360+ dias.
• Marcas de compra mais recentes
• Últimas Categorias de Compra
• Códigos promocionais de última compra
• RFM_Group
• RFM_Segment
Integração passo a passo
Para ativar a integração é necessário gerar previamente User Roles dentro da plataforma VTEX.
- Dentro do VTEX ADMIN
- Acesse Configurações da conta
- Acesse Funções de usuário
- Crie uma nova função de usuário ICOMMKT_Integration com as seguintes características:
- Permissões:
a) Adicionar pedidos de visualização de produto/OMS/atributo (visualizar pedido) e (listar pedidos)
b) Adicionar produto/armazenamento dinâmico/atributo de acesso somente leitura a entidades de dados (documentos somente leitura).
c) Adicione produto/catálogo/atributos:
- Lista de campos
- Lista de campos de valor
- Categoria
- Provedores
- Grupos
- Marcas
- SKU
- a) Insira Configurações da Conta na sua plataforma Vtex
b) Selecione a opção Chaves de Aplicativo
c) Selecione o botão Adicionar chave de aplicativo externo
d) Escreva a senha e clique no botão Adicionar funções
e) Selecione a função Icommkt_Integration e confirme Adicionar função
f) Você acessará a janela Minhas chaves onde deverá selecionar o botão Gerar novo
g) Escreva o nome da etiqueta e clique em Gerar
h) Estas etapas levarão você a uma janela onde o token é exibido apenas uma vez.
i) Compartilhe a chave gerada com a equipe de Customer Success para verificar a integração.
- Configure a integração na plataforma Icomm
- Vá para o menu Configurações
- Entre na opção Integrações
- Selecione a opção VTEX
- Preencha os dados básicos da conta a ser sincronizada (com sua instância VTEX)
- Preencha os campos obrigatórios para sincronizar a integração: Conta, Api Key e Api Token.
- Pressione o botão Verificar para prosseguir para a próxima fase.
Após clicar em “Verificar”, a plataforma informará se a conexão com a VTEX pôde ou não ser realizada.
Não foi possível conectar
Caso a plataforma não consiga sincronizar a conexão, será exibida a seguinte mensagem:
Conexão bem-sucedida
Caso o Icomm consiga se conectar com a plataforma VTEX, será exibida a seguinte mensagem:
- Configure os dados do canal de vendas
Caso a conexão seja bem-sucedida, você poderá continuar configurando a integração.
- Canal de Vendas: visualize a lista e selecione os canais disponíveis na VTEX ou escolha a opção “Selecionar Todos”.
- URL de comércio eletrônico: Preencha o link do seu site.
- Selecione o perfil ICOMMKT no qual os dados serão armazenados
Você pode selecionar um perfil existente ou solicitar a criação de um novo através do botão NOVO PERFIL (opção recomendada).
- Ao utilizar a opção NOVO PERFIL o sistema solicitará um nome.
- Assim que o nome estiver preenchido, clique em OK
• O sistema irá gerar o perfil solicitado com a estrutura de campos base do VTEX MASTERDATA.
- Para finalizar, pressione o botão Salvar
O sistema exibirá uma mensagem de confirmação.
Atualizado em: 24/07/2024
Obrigado!