> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kleep.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce

## 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**](/pl/cms/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.

***

## Pliki cookie i prywatność danych

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](/pl/cookie-consent).