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 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.