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