> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.icommkt.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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

| Saiba mais sobre os campos RFM: [O que são e para que servem os campos RFM_Group e RFM_Segment?](/pt-br/article/o-que-sao-e-para-que-servem-os-campos-rfmgroup-e-rfmsegment-10oz56e/)

# Integração passo a passo

Para ativar a integração é necessário gerar previamente **User Roles** dentro da plataforma VTEX.

1. Dentro do VTEX ADMIN
* Acesse **Configurações da conta**
* Acesse **Funções de usuário**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/1_hhmvfr.jpg)

2. 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)

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/vtex-2translated_ewcre9.jpg)

  b) Adicionar produto/armazenamento dinâmico/atributo de acesso somente leitura a entidades de dados (documentos somente leitura).

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/vtex-3translated_1t776fe.jpg)

c) Adicione produto/catálogo/atributos:

            * Lista de campos
            * Lista de campos de valor
            * Categoria
            * Provedores
            * Grupos
            * Marcas
            * SKU

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/vtex-4translated_17qcgla.jpg)

3. a) Insira **Configurações da Conta** na sua plataforma Vtex

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/5_b23jd4.jpg)

b) Selecione a opção **Chaves de Aplicativo**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/6_8k61gy.jpg)

c) Selecione o botão **Adicionar chave de aplicativo externo**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/7_pmyvf6.jpg)

d) Escreva a senha e clique no botão **Adicionar funções**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/8_h4r6i9.jpg)

e) Selecione a função **Icommkt_Integration** e confirme **Adicionar função**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/9_1assg68.jpg)

f) Você acessará a janela **Minhas chaves** onde deverá selecionar o botão **Gerar novo**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/10_r9s5c.jpg)

g) Escreva o nome da etiqueta e clique em **Gerar**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/11_ix4dek.jpg)

h) Estas etapas levarão você a uma janela onde o token é exibido apenas uma vez.

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/12_e4nvgp.jpg)

i) Compartilhe a chave gerada com a equipe de Customer Success para verificar a integração.

| Caso tenha dúvidas adicionais sobre esta etapa, consulte a documentação da VTEX na seguinte URL: https://help.vtex.com/es/tutorial/application-keys--2iffYzlvvz4BDMr6WGUtet

4. Configure a integração na plataforma **Icomm**

* Vá para o menu **Configurações**
* Entre na opção **Integrações**
* Selecione a opção **VTEX**

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/13_402uld.jpg)

5. 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**.

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/image-25translated_1hc9lxb.jpg)

 * Pressione o botão **Verificar** para prosseguir para a próxima fase.

||| O botão “Verificar” ficará desabilitado até que todos os campos possuam dados.

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:

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/image-26translated_1av4n13.jpg)

**Conexão bem-sucedida**

Caso o Icomm consiga se conectar com a plataforma VTEX, será exibida a seguinte mensagem:

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/image-29translated_ice42o.jpg)

6. Configure os dados do canal de vendas

Caso a conexão seja bem-sucedida, você poderá continuar configurando a integração.

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/image-30translated_1gsjyqa.jpg)

* **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.

7. 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.

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/15_td83tl.jpg)

* Assim que o nome estiver preenchido, clique em **OK**
 
![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/16_r5h8o6.jpg)

• O sistema irá gerar o perfil solicitado com a estrutura de campos base do **VTEX MASTERDATA**.

![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/17_18tblwv.jpg)
![](https://storage.crisp.chat/users/helpdesk/website/e4b41ef8ae96c800/18_q0e61y.jpg)

6. Para finalizar, pressione o botão **Salvar**

O sistema exibirá uma mensagem de confirmação.

|| Nota: A atualização dos dados do dashboard ocorre a cada 4 horas, enquanto o perfil de dados processados ​​e enriquecidos é calculado e importado a cada 24 horas.

| Consulte outros artigos sobre [Icomm Integrações](https://help.icommkt.com/pt-br/category/integracoes-10wgnlc/).