> ## 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 Macro

## Nesse artigo mostraremos como fazer a integração da sua loja com o +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 - No painel administrativo da Macro, no Menu sanduíche, clique em Módulos.

![](https://storage.crisp.chat/users/helpdesk/website/-/b/9/f/2/b9f22bb261772800/eff2dd2b-3daf-47dd-8c78-198c60_jpyb2u.png)

#### Passo 2 - Em Nome do módulo pesquisar por +Fidelidade.

![](https://storage.crisp.chat/users/helpdesk/website/-/f/a/3/1/fa31d6ba1a5c4800/a3572c6f-d6fe-4f8d-be19-9c7ab4_1a74078.png)

#### Passo 3 - Vá em Configurações.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/2/9/e/e29e66325e147000/e1dcfa2b-a3fe-4ccd-b069-56595b_1cvftm6.png)

#### Passo 4 - Ative o módulo e confirme.

![](https://storage.crisp.chat/users/helpdesk/website/-/b/9/d/b/b9db85c595d38800/658ceae5-0116-489d-926a-f4def7_1n995cv.png)

#### Passo 5 - Para que toda a integração funcione, será necessário Gerar a chave de API e tê-la em mãos.

![](https://storage.crisp.chat/users/helpdesk/website/-/e/a/b/1/eab1f5c8d07f2000/1b7c499a-b022-4a86-836f-c8cf56_crw5hr.png)

#### Passo 6 - No painel do +Fidelidade, vá em Mais > Configurações.

![](https://storage.crisp.chat/users/helpdesk/website/-/3/b/6/3/3b63830dac339200/abde6699-e5eb-4a81-9007-060a51_hh55qp.png)

#### Passo 7 - Clique em Integração, no canto inferior esquerdo, em seguida selecione a plataforma de e-commerce Macro.

![](https://storage.crisp.chat/users/helpdesk/website/-/a/4/3/4/a43434026676c800/10f2d5da-5ca4-474d-a8a5-7ba042_gi27ha.png)

#### Passo 8 - Preencha os campos necessários.

* **Informe sua chave de API (AppKey):** Aqui você cola o Token que copiou na Macro.
* **Informe o site de sua loja:** Coloque o link do site da sua loja, garanta que ele esteja certo, ele será usado nos disparos de e-mail.
* **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 o XML de produtos Google Shopping de sua loja:** Importante para lojas que queiram produtos como prêmios de forma automatizada, ou seja, que os prêmios resgatados virem cupons. Coloque o XML da sua loja com o Google Shopping (obrigatoriamente do Google Shopping, pois é somente esse que o sistema reconhece).
* **Os cupons expiram em quanto tempo?:** Após os clientes resgatarem um prêmio que gere cupom, um novo código é gerado na sua plataforma de e-commerce (_**exceto Jet e Bis2Bis**_). Quanto tempo esse código deve ser válido para a utilização (em dias)? O padrão é 365 dias.
* **Informe os SKU's/IDs dos produtos que deseja como 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.

#### Passo 9 - Ative a integração.

Apenas **ative o cadastro de vendas se você não possui nenhum ERP integrado** no programa.

![](https://suporte.fidelizarmais.com/hs-fs/hubfs/image-png-Jan-28-2025-01-02-24-9565-AM.png?width=670&height=128&name=image-png-Jan-28-2025-01-02-24-9565-AM.png)

A integração buscará os pedidos com status **Pago**, do dia que a integração foi cadastrada em diante.

**💡 Importante:** Se selecionar o botão de Ativar Integração, o sistema irá começar a disparar e-mails aos seus clientes. Por isso só ative depois que concluir todas as configurações do seu programa de fidelidade.

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