Przejdź do głównej treści

​
Faza 1: Konfiguracja backendu (REST API)

Ten krok umożliwia Kleep pobieranie katalogu produktów, historii zamówień oraz danych dotyczących zwrotów/refundacji w celu kalibracji algorytmu.

​
1. Utwórz klucz REST API

  1. Zaloguj się do panelu administracyjnego WordPress.
  2. Przejdź do WooCommerce > Ustawienia > Zaawansowane > REST API.
  3. Kliknij „Dodaj klucz”.
  4. Wypełnij następujące pola:
    • Opis: Wprowadź nazwę (np. „Kleep Integration”)
    • Użytkownik: Wybierz użytkownika administratora
    • Uprawnienia: Wybierz Odczyt
  5. Kliknij „Generuj klucz API”.

​
2. Pobierz i zapisz dane uwierzytelniające

Po wygenerowaniu WooCommerce wyświetli dwa dane uwierzytelniające:
  • Consumer Key (zaczyna się od ck_)
  • Consumer Secret (zaczyna się od cs_)
⚠️ Ważne: Consumer Secret jest wyświetlany tylko raz. Skopiuj obie wartości natychmiast i przechowuj je bezpiecznie.

​
3. Wymagania

  • Twój sklep WooCommerce musi używać HTTPS, aby klucze API działały bezpiecznie.
  • Wymagana jest wersja v3 REST API WooCommerce (WooCommerce 3.5+).
  • Jeśli używasz niestandardowych wtyczek zwrotów/RMA (np. YITH WooCommerce RMA, ReturnGO), poinformuj nas, abyśmy mogli skoordynować właściwe podejście do integracji.

​
4. Konfiguracja zapory sieciowej

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. Wyślij dane uwierzytelniające do Kleep

Wyślij następujące informacje do swojego kontaktu w Kleep pocztą elektroniczną:
  1. Adres URL Twojego sklepu (np. https://yourstore.com)
  2. Consumer Key (ck_...)
  3. Consumer Secret (cs_...)

​
Faza 2: Integracja frontendowa (Widget)

Ten krok polega na dodaniu skryptu Kleep do stron produktów (PDP). Kompatybilny ze wszystkimi wersjami WooCommerce. Postępuj zgodnie z naszym przewodnikiem Widget JS Library, aby zainstalować i skonfigurować CTA frontendowe na stronach produktów.

​
Faza 3: Zarządzanie brakującymi danymi (SFTP)

Ta sekcja dotyczy sytuacji, gdy danych nie można pobrać przez standardowe punkty końcowe API. Jeśli Twój sklep WooCommerce korzysta z wtyczki zwrotów/RMA innej firmy, która nie udostępnia danych dotyczących zwrotów przez standardowe REST API WooCommerce, realizujemy wymianę plików CSV. Zapoznaj się z poniższą dokumentacją. Niniejszy przewodnik przeprowadzi Cię przez proces przekazywania brakujących danych krok po kroku. Skoncentruj się na części dotyczącej danych o zwrotach.
Kleep jest w pełni uzależniony od zgody odwiedzającego: skrypt ładuje się wyłącznie po zebraniu zgody przez Twoją CMP i musisz odpowiednio warunkować jego ładowanie. Pełną listę trackerów, przetwarzanych danych, celów i podstaw prawnych, hostingu, podprzetwórców i zabezpieczeń znajdziesz w Pliki cookie, CMP i prywatność danych.