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

*Este passo permite ao Kleep recuperar o seu catálogo de produtos, histórico de encomendas e dados de devoluções/reembolsos para calibrar o algoritmo.*

### 1. Criar uma Chave de API REST

1. Inicie sessão 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:** Introduza um nome (por exemplo, "Kleep Integration")
   * **User:** Selecione um utilizador administrador
   * **Permissions:** Selecione **Read**
5. Clique em **"Generate API key"**.

### 2. Obter e Guardar as Credenciais

Após a geração, o WooCommerce apresentará duas credenciais:

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

**⚠️ Importante:** O Consumer Secret é mostrado apenas uma vez. Copie ambos os valores imediatamente e guarde-os em segurança.

### 3. Requisitos

* A sua loja WooCommerce **deve utilizar HTTPS** para que as chaves de API funcionem de forma segura.
* É necessária a versão **v3** da REST API do WooCommerce (WooCommerce 3.5+).
* Se utiliza **plugins de devolução/RMA personalizados** (por exemplo, YITH WooCommerce RMA, ReturnGO), informe-nos para que possamos coordenar a abordagem de integração adequada.

### 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 contacto Kleep por e-mail:

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

***

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

*Este passo envolve a adição do script Kleep às suas páginas de produto (PDP). Compatível com todas as versões do WooCommerce.*

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

***

## Fase 3: Gestão de Dados em Falta (SFTP)

*Esta secção aplica-se quando os dados não podem ser recuperados através dos endpoints API padrão.*

Se a sua loja WooCommerce utiliza um plugin de devoluções/RMA de terceiros que não expõe dados de devoluções através da REST API padrão do WooCommerce, procedemos via troca de ficheiros CSV.

Consulte a documentação abaixo. Este guia irá guiá-lo pelo processo de transmissão dos dados em falta passo a passo. Por favor, foque-se na parte relativa aos dados de devoluções.

***

## Cookies e privacidade de dados

O Kleep está totalmente condicionado ao consentimento do visitante: o script só carrega **após** a recolha do consentimento através do seu CMP, e deve condicionar o seu carregamento em conformidade. Para a lista completa de trackers, os dados processados, as finalidades e bases legais, alojamento, subprocessadores e segurança, consulte [Cookies, CMP e Privacidade de Dados](/pt/cookie-consent).