> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nemu.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# VTEX

> Como conectar a VTEX ao Dashboard da Nemu

## Gerando uma Chave de Integração

1. Entre na sua conta VTEX.

> O nome da conta faz parte da sua URL. Você também pode encontrá-lo no canto superior esquerdo, ao lado do logotipo da VTEX.

![](https://mintcdn.com/nemu/KidzCpESYpocg5v4/assets/pages/integracoes/vtex/1.png?fit=max\&auto=format\&n=KidzCpESYpocg5v4\&q=85\&s=82177bf6b50e550d74df2cd8f4f60d5a)

2. No menu lateral clique em **CONFIGURAÇÕES DA CONTA** > **Gerenciamento da conta** > **Chaves de aplicação**.

3. Clique no botão no canto superior direito **Gerenciar Minhas Chaves**.

![](https://mintcdn.com/nemu/KidzCpESYpocg5v4/assets/pages/integracoes/vtex/2.png?fit=max\&auto=format\&n=KidzCpESYpocg5v4\&q=85\&s=026b0d6e2e4c4bb518b1da34f263c253)

4. Em seguida, clique em **"Gerar Chave"**.

![](https://mintcdn.com/nemu/KidzCpESYpocg5v4/assets/pages/integracoes/vtex/3.png?fit=max\&auto=format\&n=KidzCpESYpocg5v4\&q=85\&s=3212f13d732f82422dc2c13657859cee)

5. Defina um nome *(Rótulo)* para a chave e adicione os usuários que poderão utilizar essa chave e clique no botão **"Gerar"**.

![](https://mintcdn.com/nemu/KidzCpESYpocg5v4/assets/pages/integracoes/vtex/4.png?fit=max\&auto=format\&n=KidzCpESYpocg5v4\&q=85\&s=a8bfbcc315bbdb0f53c6aed8e1183790)

6. Após isso, sua **Chave de Aplicação** e **Token de Aplicação** serão exibidos.

> [!WARNING]
>
> O Token de Aplicação será exibido apenas uma vez. Certifique-se de copiá-lo e
> guardá-lo em um local seguro.

![](https://mintcdn.com/nemu/KidzCpESYpocg5v4/assets/pages/integracoes/vtex/5.png?fit=max\&auto=format\&n=KidzCpESYpocg5v4\&q=85\&s=8930a30ffa293adb93808fc1749d1e95)

> [!TIP]
>
> Copie e salve a **Chave de Aplicação**, o **Nome da Conta** e o **Token** em
> um lugar seguro. Essas informações serão necessárias para a integração com a
> Nemu.

## Conectando a VTEX ao Dashboard da Nemu

Agora que você gerou as credenciais no painel da VTEX, siga o passo a passo abaixo para realizar a integração com o dashboard da Nemu.

1. No painel da Nemu, vá até **Configurações** > **Plataformas**.
2. Pesquise por **VTEX** e clique em **Conectar**.

![](https://mintcdn.com/nemu/tzhIbhg9DQD_EcVc/assets/pages/integracoes/vtex/6.png?fit=max\&auto=format\&n=tzhIbhg9DQD_EcVc\&q=85\&s=0a404a5ea7b78c50b35d53328dd86c0d)

3. Preencha as informações de conexão.

Insira o **Nome da Conta**, a **Chave de Aplicação** e o **Token gerados na VTEX** e clique em **"Salvar"**.

![](https://mintcdn.com/nemu/_OAPj38d66MaM4DI/assets/pages/integracoes/vtex/7.png?fit=max\&auto=format\&n=_OAPj38d66MaM4DI\&q=85\&s=abc357383807e2882016eabd7d86f95e)

## Instalação do Pixel na VTEX

Após conectar a VTEX ao Dashboard da Nemu, é necessário instalar o pixel do Nemu na sua loja VTEX. Siga as instruções abaixo e **atenção especial aos avisos importantes**.

### Considerações Importantes

* **Velocidade de carregamento**: O pixel do Nemu é carregado de forma **assíncrona**, o que significa que não interfere no carregamento do site. Ele não bloqueia a renderização das páginas e não impacta a performance da loja.
* **LGPD e usuários Apple**: O pixel do Nemu está em conformidade com a LGPD. Para questões específicas sobre usuários Apple, consulte nossa [política de segurança e privacidade](https://usenemu.com/br/seguranca-e-privacidade-nemu).

### Requisitos de Instalação

O pixel do Nemu deve ser instalado seguindo estas regras **obrigatórias**:

* ✅ **Sempre na tag `<head>` de todas as páginas**
* ✅ **Presente em todas as páginas da loja** *(não apenas na home)*
* ✅ **Incluído no checkout** *(head do checkout)*
* ✅ **Instalação via Custom Script** *(não via GTM)*

> [!WARNING]
>
> **NÃO instale o pixel via Google Tag Manager (GTM)**. A integração não
> funcionará corretamente se instalada via GTM. Use sempre Custom Script.

> [!TIP]
>
> Se sua loja utiliza **Trinio**, o nome do arquivo onde o Custom Script deve
> ser inserido pode variar de cliente para cliente. Entre em contato com o
> parceiro Trinio para obter o nome exato do arquivo que precisa ser editado.

### Instalação do Pixel no Checkout

Além da instalação do pixel nas páginas da loja, é **obrigatório** instalar esse script no checkout da VTEX. Sem essa etapa, eventos de conversão não serão capturados corretamente.

1. Verifique se a sua loja tem o app **VTEX Checkout UI Custom** instalado. Se não tiver, instale-o via VTEX App Store ou manualmente de acordo com a [documentação](https://developers.vtex.com/docs/apps/vtex.checkout-ui-custom).
2. Acesse `https://accountname.myvtex.com/admin/vtex-checkout-ui-custom`, substituindo `accountname` pelo nome da sua conta VTEX.
3. Abra a aba **JavaScript** e localize o campo **JavaScript personalizado**.

![](https://mintcdn.com/nemu/5KmstZd5QsDHkwYM/assets/pages/integracoes/vtex/11.png?fit=max\&auto=format\&n=5KmstZd5QsDHkwYM\&q=85\&s=1d75494f2a46afb2e4f429703c78aff4)

4. Cole o script abaixo no editor:

```js theme={null}
(function () {
  var TRACKING_ID = "0000000000";
  var SCRIPT_URL =
    "https://trackings.nemu.com.br/trackings/" + TRACKING_ID + "/script.js";

  if (document.querySelector('script[data-tracking-id="' + TRACKING_ID + '"]'))
    return;

  var script = document.createElement("script");
  script.src = SCRIPT_URL;
  script.async = true;
  script.setAttribute("data-tracking-id", TRACKING_ID);
  script.crossOrigin = "anonymous";

  document.head.appendChild(script);
})();
```

> [!WARNING]
>
> Substitua `0000000000` pelo seu **Tracking ID** do Nemu, que pode ser
> encontrado no dashboard da Nemu em **Configurações** > **Pixels**

5. Clique em **"Publicar"** para aplicar as alterações no checkout.

## Permissões Necessárias na Conta VTEX

Para que a integração funcione corretamente, é **essencial** que o usuário da VTEX utilizado na geração das credenciais tenha as permissões adequadas.

1. Verifique o acesso do usuário

Será necessário verificar com o cliente qual conta está sendo utilizada para criar as credenciais de integração. O usuário deve possuir permissões específicas para conseguir consumir os endpoints da API.

Durante a validação, observamos que **diversos endpoints estão retornando erro por falta de permissão**.

2. Permissões obrigatórias

Certifique-se de que o usuário VTEX possui acesso aos seguintes recursos:

* `View order`
* `Feed v3 and Hook Admin`
* `Feed v3 and Hook view only`
* `List Orders`

![](https://mintcdn.com/nemu/ZOXbvAZveOSUsNPO/assets/pages/integracoes/vtex/permissoes.png?fit=max\&auto=format\&n=ZOXbvAZveOSUsNPO\&q=85\&s=0c2537316faa3a78e03302d03406b238)

Essas permissões são necessárias para leitura e gerenciamento dos dados integrados via API.

## Como gerenciar permissões na VTEX

> [!WARNING]
>
> Sem essas permissões, a integração não conseguirá acessar os dados
> necessários, mesmo com a chave e token corretos.

> Você pode ajustar as permissões do usuário seguindo os tutoriais oficiais da VTEX

> [card] Gerenciando funções
>
> [Clique aqui para saber
> mais](https://help.vtex.com/pt/tutorial/roles--7HKK5Uau2H6wxE1rH5oRbc#gerenciar-perfis-de-acesso)

> [card] Recursos de licença
>
> [Clique aqui para saber
> mais](https://help.vtex.com/pt/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.