Siirry pääsisältöön

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