# Notice de configuration WaCommerces

Bienvenue sur **WaCommerces** — la plateforme qui transforme ton numéro WhatsApp Business en boutique pilotée par IA (Sam, Elon, Claude, Amandine, Mawena).

Cette notice te guide **de A à Z** :
1. Création de ton compte WaCommerces et configuration de ta boutique.
2. Création et configuration de ton application Meta (Facebook Developers) pour connecter WhatsApp.
3. Liaison des deux et premiers tests.

⏱️ Temps total estimé : **20 à 30 minutes**.

---

## Partie 1 — Côté WaCommerces

### 1.1 Créer ton compte

1. Rends-toi sur **https://wacommerces.com**.
2. Clique sur **« Créer un compte »**.
3. Saisis ton email professionnel et un mot de passe fort (12 caractères minimum, mélange de lettres, chiffres et symboles).
4. **Coche la case d'acceptation des CGU** (obligatoire).
5. Clique sur **« S'inscrire »**.
6. ✉️ **Vérifie ta boîte mail** : tu reçois un email de confirmation. Clique sur le lien pour valider ton compte.
7. Reviens sur wacommerces.com et connecte-toi.

> 💡 Si tu ne reçois pas l'email dans 2 min, vérifie les **spams / promotions**.

### 1.2 Configurer ta boutique

À la première connexion, tu arrives sur le **Dashboard**.

1. Va dans **Réglages → Boutique**.
2. Renseigne :
   - **Nom de la boutique** (visible par tes clients).
   - **Devise** (XOF, EUR, USD…).
   - **Adresse** (utilisée pour les livraisons).
   - **Logo** (carré, 512×512 px recommandé).
3. Enregistre.

### 1.3 Ajouter ton catalogue

1. Va dans **Catalogue → Ajouter un produit**.
2. Pour chaque produit, saisis : nom, description, prix, stock, photo.
3. Tu peux aussi importer un fichier CSV si tu as déjà un catalogue.

> 🤖 Sam (agent administratif) peut créer des produits à ta place : envoie-lui simplement un message WhatsApp une fois la connexion établie (voir Partie 3).

### 1.4 Déclarer ton numéro admin

C'est **ton** numéro WhatsApp personnel — celui depuis lequel tu pilotes la boutique par message.

1. Va dans **Réglages → WhatsApp**.
2. Dans le champ **« Numéro WhatsApp admin »**, saisis ton numéro **au format international sans le +** (ex. `33612345678` ou `22507000000`).
3. Enregistre.

### 1.5 Déclarer tes livreurs (optionnel mais recommandé)

1. Va dans **Livreurs**.
2. Clique sur **« Ajouter un livreur »**.
3. Renseigne : nom, numéro WhatsApp (sans le +), zone de livraison préférée.
4. Claude (agent livraison) leur enverra automatiquement les offres de course.

---

## Partie 2 — Côté Meta (Facebook Developers)

C'est ici que tu obtiens les **clés** qui permettent à WaCommerces d'envoyer et recevoir des messages WhatsApp en ton nom.

### 2.1 Pré-requis

- Un **compte Facebook** personnel.
- Un **compte WhatsApp Business** (l'app mobile WhatsApp Business installée et configurée).
- Un **Business Manager Meta** (gratuit) : https://business.facebook.com.

### 2.2 Créer une application Meta

1. Va sur **https://developers.facebook.com/apps**.
2. Clique sur **« Créer une app »**.
3. Type d'app : choisis **« Entreprise »** (Business).
4. Donne un nom à ton app (ex. *Ma Boutique WA*) et associe-la à ton Business Manager.
5. Clique sur **« Créer »**.

### 2.3 Ajouter le produit WhatsApp

1. Dans le tableau de bord de l'app, cherche le produit **« WhatsApp »**.
2. Clique sur **« Configurer »**.
3. Meta te propose un **numéro de test gratuit** : utile pour démarrer, mais limité à 5 destinataires. Pour la production, ajoute ton **vrai numéro WhatsApp Business** via le Business Manager.

### 2.4 Récupérer le `Phone Number ID`

1. Dans le menu de gauche : **WhatsApp → Configuration de l'API**.
2. Sous **« Envoyer et recevoir des messages »**, tu vois un menu déroulant **« De »**.
3. Sélectionne ton numéro.
4. Juste en dessous, copie la valeur **« Identifiant du numéro de téléphone »** (15-16 chiffres).
5. Garde-la — c'est le **Phone Number ID** à coller dans WaCommerces.

### 2.5 Générer un Access Token permanent

⚠️ Le token affiché par défaut est **temporaire (24 h)**. Pour la production, génère un token permanent :

1. Va dans **Business Manager → Paramètres de l'entreprise → Utilisateurs → Utilisateurs système**.
2. Clique **« Ajouter »** → crée un utilisateur système avec rôle **Admin**.
3. Sur cet utilisateur, clique **« Générer un nouveau token »**.
4. Sélectionne ton app WhatsApp.
5. Coche les permissions :
   - `whatsapp_business_messaging`
   - `whatsapp_business_management`
6. Choisis **Expiration : Jamais**.
7. Clique **« Générer le token »** et **copie-le immédiatement** (il ne sera plus jamais affiché).

### 2.6 Récupérer l'App Secret

1. Dans ton app Meta : **Paramètres → De base**.
2. Sur la ligne **« Clé secrète »** (App Secret), clique sur **« Afficher »**.
3. Saisis ton mot de passe Facebook.
4. Copie la valeur affichée.

> 🔒 Ce secret sert à WaCommerces pour **vérifier que les messages reçus viennent bien de Meta** (signature HMAC). Sans lui, les webhooks sont rejetés.

---

## Partie 3 — Connecter Meta à WaCommerces

### 3.1 Coller tes clés dans WaCommerces

1. Connecte-toi à **wacommerces.com**.
2. Va dans **Réglages → WhatsApp**.
3. Remplis :
   - **Phone Number ID** → la valeur copiée à l'étape 2.4.
   - **Access Token** → le token permanent de l'étape 2.5.
   - **App Secret** → la valeur de l'étape 2.6 (champ dédié, chiffré côté serveur).
4. Clique sur **« Enregistrer »**.

### 3.2 Récupérer ton URL de Webhook et ton Verify Token

Toujours dans **Réglages → WhatsApp**, dans la section **« Ton endpoint »** :

- **Webhook URL (production)** : `https://wacommerces.com/api/public/whatsapp/webhook/xxxxx`
- **Verify Token** : une chaîne aléatoire (ex. `wa_abc123…`)

Clique sur l'icône **📋 Copier** à côté de chaque.

### 3.3 Configurer le Webhook côté Meta

1. Retourne sur **developers.facebook.com → ton app → WhatsApp → Configuration**.
2. Section **« Webhook »** → clique **« Modifier »**.
3. Colle :
   - **URL de callback** : l'URL copiée à l'étape 3.2.
   - **Verify Token** : la chaîne copiée à l'étape 3.2.
4. Clique **« Vérifier et enregistrer »**. ✅ Meta doit afficher *« Webhook vérifié »*.
5. Une fois vérifié, dans **« Champs du webhook »**, clique **« Gérer »** et **abonne-toi à `messages`** (minimum). Tu peux aussi cocher `message_status` pour le suivi de livraison.

### 3.4 Premier test

1. Depuis ton téléphone (ton numéro admin déclaré en 1.4), envoie un message WhatsApp à ton numéro Business : `bonjour`.
2. **Sam** doit te répondre dans les secondes qui suivent.
3. Demande-lui : *« Quels produits ai-je en stock ? »* — il liste ton catalogue.

> ✅ Si Sam répond, **la connexion est opérationnelle**.
> ❌ Si rien ne se passe, voir le dépannage ci-dessous.

---

## Partie 4 — Aller plus loin

### 4.1 Les agents IA disponibles

| Agent | Rôle | Avec qui il parle |
|---|---|---|
| **Sam** | Administration boutique (produits, promos, stats, commandes) | Toi (numéro admin) |
| **Elon** | Vendeur : conseille les clients, prend les commandes | Tes clients |
| **Claude** | Livraison : dispatch et suivi des courses | Tes livreurs |
| **Amandine** | Marketing : campagnes, relances | Tes clients (broadcast) |
| **Mawena** | Support / SAV : réclamations, retours | Tes clients |

### 4.2 Crédits IA

Chaque message traité par un agent consomme des **crédits IA**.
- Suivi : **Réglages → Crédits**.
- Recharge : **Réglages → Plans & crédits**.

### 4.3 Sécurité

- 🔐 Ton App Secret est **chiffré AES-256-GCM** côté serveur ; il n'est jamais relu en clair par le navigateur.
- 🛡️ Tous les webhooks vérifient la **signature HMAC** de Meta avant traitement.
- 🧱 Tes données (commandes, clients, conversations) sont **strictement isolées** des autres boutiques.

---

## Dépannage

| Symptôme | Cause probable | Solution |
|---|---|---|
| Meta refuse de vérifier le webhook | URL ou Verify Token mal copiés | Recopie sans espace ; vérifie que le slug est complet |
| Webhook vérifié mais aucun message ne déclenche de réponse | Tu n'es pas abonné au champ `messages` | Étape 3.3 point 5 |
| Sam ne répond pas à ton message | Numéro admin mal saisi (avec `+` ou espaces) | Réglages → WhatsApp → format `33612345678` |
| Erreur 403 dans les logs Meta | App Secret manquant ou incorrect | Réglages → WhatsApp → re-saisir l'App Secret |
| « Crédit IA épuisé » | Solde à 0 | Réglages → Plans & crédits → recharger |
| Le token Meta expire après 24 h | Tu utilises le token temporaire | Génère un token utilisateur système (étape 2.5) |

---

## Récapitulatif des éléments à transférer

| Depuis Meta | Vers WaCommerces (Réglages → WhatsApp) |
|---|---|
| Phone Number ID | Champ **Phone Number ID** |
| Access Token (permanent) | Champ **Access Token** |
| App Secret | Champ **App Secret** |

| Depuis WaCommerces | Vers Meta (WhatsApp → Configuration) |
|---|---|
| Webhook URL (production) | Champ **URL de callback** |
| Verify Token | Champ **Verify Token** |

---

**Besoin d'aide ?** Écris à support@wacommerces.com ou ouvre un ticket dans **Support** depuis ton dashboard.

Bonne vente ! 🚀