Saltar al contenido principal

Fase 1: Configuración del backend (API REST)

Este paso permite a Kleep recuperar tu catálogo de productos, historial de pedidos y datos de devoluciones/reembolsos para calibrar el algoritmo.

1. Crear una clave de API REST

  1. Inicia sesión en tu Panel de administración de WordPress.
  2. Ve a WooCommerce > Settings > Advanced > REST API.
  3. Haz clic en “Add key”.
  4. Rellena los siguientes campos:
    • Description: Introduce un nombre (por ejemplo, «Kleep Integration»)
    • User: Selecciona un usuario administrador
    • Permissions: Selecciona Read
  5. Haz clic en “Generate API key”.

2. Recuperar y guardar las credenciales

Tras la generación, WooCommerce mostrará dos credenciales:
  • Consumer Key (comienza con ck_)
  • Consumer Secret (comienza con cs_)
⚠️ Importante: El Consumer Secret solo se muestra una vez. Copia ambos valores inmediatamente y guárdalos de forma segura.

3. Requisitos

  • Tu tienda WooCommerce debe usar HTTPS para que las claves de API funcionen de forma segura.
  • Se requiere la versión v3 de la API REST de WooCommerce (WooCommerce 3.5+).
  • Si usas plugins personalizados de devoluciones/RMA (por ejemplo, YITH WooCommerce RMA, ReturnGO), indícanoslo para que podamos coordinar el enfoque de integración adecuado.

4. Configuración del cortafuegos

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 las credenciales a Kleep

Envía la siguiente información a tu contacto de Kleep por correo electrónico:
  1. La URL de tu tienda (por ejemplo, https://yourstore.com)
  2. Consumer Key (ck_...)
  3. Consumer Secret (cs_...)

Fase 2: Integración frontend (Widget)

Este paso consiste en añadir el script de Kleep a tus páginas de producto (PDP). Compatible con todas las versiones de WooCommerce. Sigue nuestra guía del Widget de la Biblioteca JS para instalar y configurar el CTA de frontend en tus páginas de producto.

Fase 3: Gestión de datos faltantes (SFTP)

Esta sección se aplica cuando los datos no pueden recuperarse a través de los endpoints estándar de la API. Si tu tienda WooCommerce usa un plugin de devoluciones/RMA de terceros que no expone los datos de devoluciones a través de la API REST estándar de WooCommerce, procedemos mediante intercambio de archivos CSV. Consulta la documentación a continuación. Esta guía te llevará paso a paso por el proceso de transmisión de datos faltantes. Concéntrate en la parte de datos de devoluciones.

Cookies y privacidad de datos

Kleep está completamente condicionado por el consentimiento del visitante: el script solo se carga después de que se recopile el consentimiento a través de tu CMP, y debes condicionar su carga en consecuencia. Para la lista completa de rastreadores, los datos tratados, las finalidades y bases legales, el alojamiento, los subencargados y la seguridad, consulta Cookies, CMP y privacidad de datos.