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

# Conectar a Loja Integrada

> Ligar a sua loja da Loja Integrada à Cliqo: produtos e pedidos, com o catálogo atualizado sozinho de hora em hora.

Ligar a Loja Integrada à Cliqo traz três coisas: o **catálogo de produtos** (para usar nos e-mails com vitrine), o **histórico de pedidos** (que alimenta o RFM e a receita atribuída) e o catálogo **atualizado sozinho**, sem você fazer nada.

## Antes de começar

Você vai precisar de duas credenciais, e uma delas depende do seu plano.

**Chave para API.** Gere no painel da Loja Integrada em **Configurações → Chave para API → Cadastrar nova chave**. Essa opção **só existe em plano pago** da Loja Integrada — se ela não aparece no seu painel, é o plano, não a Cliqo.

**Chave de aplicação.** É solicitada à equipe técnica da Loja Integrada. Uma única chave de aplicação vale para todas as lojas, então se você já usa a Cliqo em outra loja, é a mesma.

## Conectar

Em **Configurações → Integrações**, clique em **Conectar nova loja**, escolha **Loja Integrada**, cole as duas chaves — *Chave de API da loja (chave\_api)* e *Chave de Aplicação (Cliqo)* — e clique em **Conectar**. As chaves são conferidas na hora. A partir daí a Cliqo consegue ler o seu catálogo e os seus pedidos.

Conectar não traz o catálogo sozinho: no cartão da loja conectada, clique em **Sincronizar tudo**. Depois, **Apenas novidades (delta)** traz só o que mudou.

## Puxar os pedidos

Na mesma tela, o botão **Atualizar pedidos agora** **puxa os pedidos da Loja Integrada** para dentro da Cliqo. É o que popula o RFM — a classificação que separa quem compra sempre de quem sumiu. Além do botão, a Cliqo puxa os pedidos novos sozinha uma vez por dia.

A primeira execução varre o **histórico inteiro** e pode levar várias passadas: ela vai lendo em blocos e guardando onde parou. Enquanto essa primeira varredura acontece, **nenhum cliente é matriculado em fluxo por essas compras** — seria disparar mensagem de pós-compra por um pedido de meses atrás. Só os pedidos que chegarem depois, no dia a dia, entram nos gatilhos.

## Manter o catálogo em dia

A Cliqo atualiza o catálogo sozinha, **de hora em hora**: traz os produtos criados ou alterados desde a última vez. Não há nada para configurar no painel da Loja Integrada.

Se você mudou um produto e quer vê-lo na Cliqo na hora, use **Apenas novidades (delta)** no cartão da loja, em **Configurações → Integrações**.

## Se preferir sem integração

Dá para trazer o catálogo por arquivo, sem conectar nada: em **Configurações → Produtos**, a importação aceita o **export oficial da Loja Integrada** (XLSX) ou um CSV simples. A Cliqo reconhece o formato da Loja Integrada sozinha e avisa na tela quando o detecta.

É o caminho para quem está em plano sem acesso à API, ou para uma carga única antes de decidir integrar.

## O que a conexão não faz

* **Não sincroniza estoque em tempo real.** O catálogo entra quando você sincroniza, pela importação de arquivo e pela atualização de hora em hora; não há consulta a cada envio.
* **Não altera nada na sua loja.** A conexão é de leitura — a Cliqo não cria, edita nem cancela pedidos.
* **Não substitui o pixel.** Pedido conta o que foi comprado; o pixel conta o que foi olhado e não comprado. As duas coisas alimentam segmentos diferentes.

## Quando algo não bate

Se o catálogo veio incompleto, o motivo mais comum é produto sem SKU — a Cliqo grava por SKU e ignora linhas sem ele. Confira no export da Loja Integrada se a coluna está preenchida.

Se os pedidos não aparecem, confirme que a chave para API foi gerada no plano pago e ainda está ativa no painel da Loja Integrada.

Persistindo, fale com a gente em [contato@cliqo.io](mailto:contato@cliqo.io).


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