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

## Vaihe 1: Backend-konfiguraatio (REST API)

*Tämä vaihe mahdollistaa Kleepin hakea tuoteluettelosi, tilaushistoriasi ja palautus-/hyvitystiedot algoritmin kalibroimiseksi.*

### 1. Luo REST API -avain

1. Kirjaudu sisään **WordPress-hallintapaneeliin**.
2. Siirry kohtaan **WooCommerce > Settings > Advanced > REST API**.
3. Napsauta **"Add key"**.
4. Täytä seuraavat kentät:
   * **Description:** Syötä nimi (esim. "Kleep Integration")
   * **User:** Valitse järjestelmänvalvojakäyttäjä
   * **Permissions:** Valitse **Read**
5. Napsauta **"Generate API key"**.

### 2. Hae ja tallenna tunnistetiedot

Luomisen jälkeen WooCommerce näyttää kaksi tunnistetietoa:

* **Consumer Key** (alkaa `ck_`)
* **Consumer Secret** (alkaa `cs_`)

**⚠️ Tärkeää:** Consumer Secret näytetään vain kerran. Kopioi molemmat arvot välittömästi ja säilytä ne turvallisesti.

### 3. Vaatimukset

* WooCommerce-kauppasi **täytyy käyttää HTTPS**:ää API-avainten turvalliseen toimintaan.
* WooCommerce REST API -versio **v3** vaaditaan (WooCommerce 3.5+).
* Jos käytät **mukautettuja palautus-/RMA-liitännäisiä** (esim. YITH WooCommerce RMA, ReturnGO), ilmoita meille, jotta voimme koordinoida oikean integrointimenetelmän.

### 4. Palomuurikonfiguraatio

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. Lähetä tunnistetiedot Kleepille

Lähetä seuraavat tiedot Kleep-yhteyshenkilöllesi sähköpostitse:

1. **Kauppasi URL** (esim. `https://yourstore.com`)
2. **Consumer Key** (`ck_...`)
3. **Consumer Secret** (`cs_...`)

***

## Vaihe 2: Frontend-integraatio (Widget)

*Tässä vaiheessa lisätään Kleep-skripti tuotesivuillesi (PDP). Yhteensopiva kaikkien WooCommerce-versioiden kanssa.*

Seuraa [**JS Library Widget -opastamme**](/fi/cms/js-library) asentaaksesi ja konfiguroimalla frontend-CTA tuotesivuillesi.

***

## Vaihe 3: Puuttuvien tietojen hallinta (SFTP)

*Tämä osio koskee tilanteita, joissa tietoja ei voida hakea standardien API-päätepisteiden kautta.*

Jos WooCommerce-kauppasi käyttää kolmannen osapuolen palautus-/RMA-liitännäistä, joka ei paljasta palautustietoja standardin WooCommerce REST API:n kautta, etenemme CSV-tiedostonvaihdolla.

Katso alla olevasta dokumentaatiosta. Tämä opas ohjaa sinut puuttuvien tietojen välittämisprosessin läpi askel askeleelta. Keskity erityisesti palautustietoihin.

***

## Evästeet ja tietosuoja

Kleep on täysin kävijän suostumuksen alainen: skripti latautuu vasta **sen jälkeen**, kun suostumus on kerätty CMP:n kautta, ja sinun on ehdollistettava sen lataaminen vastaavasti. Täydellinen luettelo seuraimista, käsitellyistä tiedoista, tarkoituksista ja oikeusperusteista, isännöinnistä, alitoimittajista ja tietoturvasta löytyy täältä: [Evästeet, CMP ja tietosuoja](/fi/cookie-consent).