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

## Phase 1 : Configuration backend (API REST)

*Cette étape permet à Kleep de récupérer votre catalogue produits, l'historique des commandes et les données de retours/remboursements afin de calibrer l'algorithme.*

### 1. Créer une clé API REST

1. Connectez-vous à votre **panneau d'administration WordPress**.
2. Accédez à **WooCommerce > Réglages > Avancé > API REST**.
3. Cliquez sur **« Ajouter une clé »**.
4. Renseignez les champs suivants :
   * **Description :** Saisissez un nom (par exemple, « Kleep Integration »)
   * **Utilisateur :** Sélectionnez un utilisateur administrateur
   * **Permissions :** Sélectionnez **Lecture**
5. Cliquez sur **« Générer la clé API »**.

### 2. Récupérer et enregistrer les identifiants

Après la génération, WooCommerce affichera deux identifiants :

* **Consumer Key** (commence par `ck_`)
* **Consumer Secret** (commence par `cs_`)

**⚠️ Important :** Le Consumer Secret n'est affiché qu'une seule fois. Copiez immédiatement les deux valeurs et conservez-les en lieu sûr.

### 3. Prérequis

* Votre boutique WooCommerce **doit utiliser HTTPS** pour que les clés API fonctionnent de manière sécurisée.
* La version **v3** de l'API REST WooCommerce est requise (WooCommerce 3.5+).
* Si vous utilisez des **plugins de retours/RMA personnalisés** (par exemple, YITH WooCommerce RMA, ReturnGO), veuillez nous en informer afin que nous puissions coordonner la bonne approche d'intégration.

### 4. Configuration du pare-feu

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. Envoyer les identifiants à Kleep

Veuillez envoyer les informations suivantes à votre contact Kleep par e-mail :

1. **URL de votre boutique** (par exemple, `https://yourstore.com`)
2. **Consumer Key** (`ck_...`)
3. **Consumer Secret** (`cs_...`)

***

## Phase 2 : Intégration frontend (Widget)

*Cette étape consiste à ajouter le script Kleep à vos pages produits (PDP). Compatible avec toutes les versions de WooCommerce.*

Suivez notre [**guide Widget Bibliothèque JS**](/fr/cms/js-library) pour installer et configurer le CTA frontend sur vos pages produits.

***

## Phase 3 : Gestion des données manquantes (SFTP)

*Cette section s'applique lorsque des données ne peuvent pas être récupérées via les endpoints API standard.*

Si votre boutique WooCommerce utilise un plugin de retours/RMA tiers qui n'expose pas les données de retours via l'API REST WooCommerce standard, nous procédons par échange de fichiers CSV.

Veuillez vous référer à la documentation ci-dessous. Ce guide vous guidera pas à pas dans le processus de transmission des données manquantes. Concentrez-vous sur la partie relative aux données de retours.

***

## Cookies & confidentialité des données

Kleep est entièrement conditionné par le consentement du visiteur : le script ne se charge **qu'après** que le consentement a été collecté via votre CMP, et vous devez conditionner son chargement en conséquence. Pour la liste complète des traceurs, les données traitées, les finalités et bases légales, l'hébergement, les sous-traitants et la sécurité, consultez [Cookies, CMP & confidentialité des données](/fr/cookie-consent).