> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://suporte.fidelizarmais.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).

# Integração +fidelidade x VTEX

## Nesse artigo mostraremos como fazer a integração da VTEX com +fidelidade

Uma chave de API é como uma senha que permite que diferentes sistemas se comuniquem entre si de forma segura. Para e-commerces, ela é usada para conectar sua loja online a outros serviços, como plataformas de pagamento, ferramentas de marketing e o **nosso programa de fidelidade**. Com essa chave, automatizamos processos, como o pontuação de clientes e cadastro de clientes, facilitando a administração do seu programa e a experiência do cliente. Para saber como gerar, siga os passos seguintes.

#### Passo 1 - Em sua conta Vtex na seção Segurança, clique em Gerar  appKey e appToken.

* AppKey: **AppKey** e **AppToken** são credenciais de autenticação usadas para acessar as APIs da VTEX. A **AppKey** identifica o aplicativo, enquanto o **AppToken** valida as permissões de acesso. Juntas, elas garantem uma comunicação segura com a plataforma.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/6/4/f/364f8d96e9f24600/c32d8b5f-fe59-40fa-90d8-c73ad2_ami6t7.png)

#### Passo 2 - Insira um nome para o par de appKey e appToken  que você está criando e clique em Gerar novos tokens .

![](https://storage.crisp.chat/users/helpdesk/website/-/1/1/1/0/11101023ed908200/bffe34e6-9daa-46dc-9297-5f4621_1wfhos6.png)

#### Passo 3 - No campo exibido em seguida,  será apresentado o token. Por uma questão de segurança, ele é exibido apenas uma vez! Copie esse token e guarde-o em um local seguro.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/0/e/4/30e49da8fcc0ae00/9f867dcd-dcbe-44dc-808e-d4d151_b5iist.png)

**⚠️Importante**: Não se esqueça de dar permissão para gestão de clientes, pedidos, promoções e cupons para essas chaves. ([Clique aqui para acessar a página](https://help.vtex.com/pt/tutorial/chaves-de-aplicacao--2iffYzlvvz4BDMr6WGUtet)) e vá em Gerenciar permissões de chaves de aplicação, para saber como como dar permissões as chaves.

#### Passo 4 - Após criado o AppToken, agora precisamos do AppKey. Na seção Segurança da aba Contas, copie a appKey desejada, que se encontra na coluna Chave de aplicação.

![](https://storage.crisp.chat/users/helpdesk/website/-/b/a/7/b/ba7b2f1169002000/0b578bb7-3654-4f98-8d96-dd1556_16uhuk3.png)

#### Passo 5 - No painel do program de fidelidade clique em Mais > Configurações.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/4/e/9/f4e9363fb86af800/49c06dc4-c867-403d-9da1-9bc21b_1q2m3pr.gif)

#### Passo 6 - Procure por Integração e selecione sua plataforma de e-commerce que é a VTEX.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/f/9/5/6f95ec6470ec6800/f56e3f0e-504e-467d-b8bb-a8b67f_mlaqsd.gif)

#### Passo 8 - Agora você irá preencher as seguintes informações:

![](https://storage.crisp.chat/users/helpdesk/website/-/9/8/0/6/9806c754d6872000/db2321da-a33a-442c-b892-2d6398_1hcunz5.png)

* Informe sua chave de API (AppKey) e Token (AppToken): Coloque aqui as chaves geradas nos passos anteriores.

* **Linguagem**;
* **Tempo pontuar**:

Estabeleça o período após a atualização do pedido para o status escolhido na integração, no qual os pontos serão creditados aos clientes. Por exemplo: Se definido 30 dias, os pontos dos clientes serão contabilizados somente 30 dias após o pedido ter sido atualizado para o status da integração.

* **Informe o site de sua loja**:

é necessário fornecer a URL do seu domínio personalizado, que direciona para sua loja na plataforma VTEX. Exemplo: https://www.seudominiopersonalizado.com ou https://loja.seudominiopersonalizado.com

* **Subdomínio**:

Indique o nome da sua loja, que precede o domínio da VTEX (myvtex.com). Exemplo: nomedaloja.myvtex.com;

* **Autenticação única**:

Ao ativar esta opção, o cliente que já estiver registrado no programa de Fidelidade poderá acessar os benefícios diretamente ao entrar na loja virtual, sem precisar fazer login novamente no widget/botão.

![](https://storage.crisp.chat/users/helpdesk/website/9e25bebd41b66800/943c1c6c-dff4-4d4f-9850-5601f1_62hmed.gif)

* **Informe a URL (link) para cadastro de clientes de sua loja:** Forneça o URL de cadastro do site da sua loja. Isso é crucial se sua loja estiver no plano que inclui o widget enterprise, pois, se o cliente não conseguir realizar o cadastro no programa, ele será redirecionado para esse link.
* **Informe os SKU's/IDs dos produtos que deseja com o prêmio:** Este campo é para ser utilizado caso não queria que todo o seu catálogo de produtos fique disponível como prêmio.
* **Qual é o último status do pedido após ser entregue ao cliente:** Mencione em qual status o pedido deve estar para nosso sistema pontuar seu cliente.

#### Passo 10 - Para concluir todas as configurações do programa selecione as opções mostradas e salve os dados.

![](https://suporte.fidelizarmais.com/hs-fs/hubfs/image-png-Jan-30-2025-07-15-44-0626-PM.png?width=571&height=133&name=image-png-Jan-30-2025-07-15-44-0626-PM.png)

💡 **Importante:** Ao escolher a opção de Ativar Integração, o sistema importará seus clientes e vendas e iniciará o envio de e-mails para eles. Portanto, ative essa opção apenas após finalizar todas as configurações do seu programa de fidelidade.

* **Ativar integração:** Clique para ativar o programa;
* **Cadastrar clientes:** Clique para importar os seus clientes para o programa de fidelidade;
* **Cadastrar vendas:** Clique para permitir importar as vendas do e-commerce,  dessa maneira sua base de clientes será pontuada;
* **Seus produtos são presentes:** Escolha esta opção se os produtos forem oferecidos como cupons de presente e se você tiver inserido os SKU's no passo anterior;
* **Importar produtos da API:** Escolha esta opção somente se anteriormente tiver marcado "seus produtos são presentes", pois esses produtos serão oferecidos como prêmios aos seus clientes.
* **Resgate de produtos manual (opcional):** Selecione apenas se tiver registrado produtos como prêmios e quiser que sejam enviados diretamente para aprovação.

Por fim, clique em *Salvar dados* para que tudo seja salvo.

💡 Importante: Os presentes são as recompensas que seus clientes ganharão ao atingirem uma certa pontuação. Ao resgatá-los, eles recebem um código de cupom que deve ser inserido no checkout, garantindo assim o recebimento do presente, conforme demonstrado abaixo.

![](https://suporte.fidelizarmais.com/hs-fs/hubfs/image-png-Jan-30-2025-07-25-31-0921-PM.png?width=505&height=137&name=image-png-Jan-30-2025-07-25-31-0921-PM.png)

Pronto! Agora suas vendas e seus clientes serão cadastrados no programa em até 72h após o cadastro no e-commerce.