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

# WooCommerce

## Fase 1: Configuração do Backend (REST API)

*Esta etapa permite que o Kleep recupere seu catálogo de produtos, histórico de pedidos e dados de devoluções/reembolsos para calibrar o algoritmo.*

### 1. Criar uma Chave de API REST

1. Faça login no seu **Painel de Administração do WordPress**.
2. Navegue até **WooCommerce > Settings > Advanced > REST API**.
3. Clique em **"Add key"**.
4. Preencha os seguintes campos:
   * **Description:** Insira um nome (ex.: "Kleep Integration")
   * **User:** Selecione um usuário administrador
   * **Permissions:** Selecione **Read**
5. Clique em **"Generate API key"**.

### 2. Recuperar e Salvar Credenciais

Após gerar, o WooCommerce exibirá duas credenciais:

* **Consumer Key** (começa com `ck_`)
* **Consumer Secret** (começa com `cs_`)

**⚠️ Importante:** O Consumer Secret é exibido apenas uma vez. Copie ambos os valores imediatamente e armazene-os com segurança.

### 3. Requisitos

* Sua loja WooCommerce **deve usar HTTPS** para que as chaves de API funcionem com segurança.
* A versão **v3** da API REST do WooCommerce é necessária (WooCommerce 3.5+).
* Se você usa **plugins personalizados de devoluções/RMA** (ex.: YITH WooCommerce RMA, ReturnGO), informe-nos para que possamos coordenar a abordagem de integração correta.

### 4. Configuração de Firewall

If your store is behind a firewall or uses IP-based access restrictions, please whitelist the following Kleep IP addresses to ensure uninterrupted API access:

* `34.1.4.3`
* `82.66.252.201`
* `176.148.67.162`

### 5. Enviar Credenciais ao Kleep

Por favor, envie as seguintes informações ao seu contato Kleep por e-mail:

1. **URL da sua loja** (ex.: `https://yourstore.com`)
2. **Consumer Key** (`ck_...`)
3. **Consumer Secret** (`cs_...`)

***

## Fase 2: Integração de Frontend (Widget)

*Esta etapa envolve adicionar o script Kleep às suas páginas de produto (PDP). Compatível com todas as versões do WooCommerce.*

Siga nosso [**guia de Widget da Biblioteca JS**](/pt-BR/cms/js-library) para instalar e configurar o CTA de frontend nas suas páginas de produto.

***

## Fase 3: Gerenciamento de Dados Ausentes (SFTP)

*Esta seção se aplica quando os dados não podem ser recuperados por endpoints de API padrão.*

Se sua loja WooCommerce usa um plugin de devoluções/RMA de terceiros que não expõe dados de devolução pela API REST padrão do WooCommerce, procedemos via troca de arquivos CSV.

Consulte a documentação abaixo. Este guia o guiará pelo processo de transmissão de dados ausentes passo a passo. Por favor, concentre-se na parte de dados de devolução.

***

## Cookies e privacidade de dados

O Kleep é totalmente controlado pelo consentimento do visitante: o script só carrega **após** a coleta do consentimento pela sua CMP, e você deve condicionar o carregamento de acordo. Para a lista completa de rastreadores, os dados processados, as finalidades e bases legais, hospedagem, suboperadores e segurança, consulte [Cookies, CMP e Privacidade de Dados](/pt-BR/cookie-consent).