Vai al contenuto principale

​
Fase 1: Configurazione Backend (REST API)

Questo passaggio consente a Kleep di recuperare il tuo catalogo prodotti, la cronologia degli ordini e i dati sui resi/rimborsi per calibrare l’algoritmo.

​
1. Crea una Chiave REST API

  1. Accedi al tuo Pannello di Amministrazione WordPress.
  2. Vai su WooCommerce > Impostazioni > Avanzate > REST API.
  3. Clicca su “Aggiungi chiave”.
  4. Compila i seguenti campi:
    • Descrizione: Inserisci un nome (es. “Kleep Integration”)
    • Utente: Seleziona un utente amministratore
    • Permessi: Seleziona Lettura
  5. Clicca su “Genera chiave API”.

​
2. Recupera e Salva le Credenziali

Dopo la generazione, WooCommerce mostrerà due credenziali:
  • Consumer Key (inizia con ck_)
  • Consumer Secret (inizia con cs_)
⚠️ Importante: Il Consumer Secret viene mostrato una sola volta. Copia immediatamente entrambi i valori e conservali in modo sicuro.

​
3. Requisiti

  • Il tuo negozio WooCommerce deve utilizzare HTTPS affinché le chiavi API funzionino in modo sicuro.
  • È richiesta la versione v3 dell’API REST WooCommerce (WooCommerce 3.5+).
  • Se utilizzi plugin personalizzati per resi/RMA (es. YITH WooCommerce RMA, ReturnGO), comunicacelo in modo da poter coordinare il giusto approccio di integrazione.

​
4. Configurazione 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. Invia le Credenziali a Kleep

Invia le seguenti informazioni al tuo contatto Kleep via email:
  1. L’URL del tuo negozio (es. https://yourstore.com)
  2. Consumer Key (ck_...)
  3. Consumer Secret (cs_...)

​
Fase 2: Integrazione Frontend (Widget)

Questo passaggio prevede l’aggiunta dello script Kleep alle tue pagine prodotto (PDP). Compatibile con tutte le versioni di WooCommerce. Segui la nostra guida al Widget Libreria JS per installare e configurare il CTA frontend nelle tue pagine prodotto.

​
Fase 3: Gestione dei Dati Mancanti (SFTP)

Questa sezione si applica quando i dati non possono essere recuperati tramite gli endpoint API standard. Se il tuo negozio WooCommerce utilizza un plugin di resi/RMA di terze parti che non espone i dati dei resi tramite l’API REST standard di WooCommerce, procediamo tramite scambio di file CSV. Fai riferimento alla documentazione qui sotto. Questa guida ti accompagnerà passo dopo passo nel processo di trasmissione dei dati mancanti. Concentrati sulla parte relativa ai dati sui resi.
Kleep è completamente subordinato al consenso del visitatore: lo script si carica solo dopo che il consenso è stato raccolto tramite la tua CMP, e devi condizionarne il caricamento di conseguenza. Per l’elenco completo dei tracker, i dati trattati, le finalità e le basi giuridiche, hosting, responsabili del trattamento e sicurezza, consulta Cookie, CMP & Privacy dei Dati.