WaCommerces
⏱️ 20-30 minutes

Guide de configuration

De la création de ton compte à ton premier message WhatsApp piloté par IA, pas à pas.

Partie 1 — Côté WaCommerces

Crée ton compte et configure ta boutique.

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 min., lettres + chiffres + symboles).
  4. Coche la case d'acceptation des CGU (obligatoire).
  5. Clique sur « S'inscrire ».
1.2 Vérification e-mail & connexion

✉️ Un email de confirmation t'est envoyé. Clique sur le lien pour valider ton compte, puis reviens te connecter sur wacommerces.com.

💡 Si l'email n'arrive pas dans 2 min, vérifie les spams / promotions.
1.3 Configurer ta boutique

À la première connexion, va dans Réglages → Boutique et renseigne :

  • Nom de la boutique (visible par les clients)
  • Devise (XOF, EUR, USD…)
  • Adresse (utilisée pour les livraisons)
  • Logo (carré 512×512 px recommandé)
1.4 Ajouter ton catalogue
  1. Va dans Catalogue → Ajouter un produit.
  2. Pour chaque produit : nom, description, prix, stock, photo.
  3. Tu peux importer un fichier CSV si tu as déjà un catalogue.
💡 🤖 Sam peut créer des produits à ta place : envoie-lui un message WhatsApp une fois la connexion établie.
1.5 Déclarer ton numéro admin

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

  1. Va dans Réglages → WhatsApp.
  2. Saisis ton numéro au format international sans le + (ex. 33612345678).
  3. Enregistre.
1.6 Déclarer tes livreurs (optionnel)
  1. Va dans Livreurs → Ajouter un livreur.
  2. Renseigne nom, numéro WhatsApp (sans le +), zone préférée.
  3. Claude leur enverra automatiquement les offres de course.

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

Récupère les clés qui permettent à WaCommerces de parler en ton nom.

Pré-requis : un compte Facebook, l'app WhatsApp Business, et un Business Manager Meta (gratuit).
2.1 Créer une application Meta
  1. Va sur developers.facebook.com/apps.
  2. Clique sur « Créer une app ».
  3. Type d'app : « Entreprise ».
  4. Nomme ton app (ex. Ma Boutique WA) et associe-la à ton Business Manager.
  5. Clique sur « Créer ».
2.2 Ajouter le produit WhatsApp
  1. Dans le tableau de bord, ajoute le produit « WhatsApp ».
  2. Clique sur « Configurer ».
💡 Meta propose un numéro de test gratuit (limité à 5 destinataires). Pour la production, ajoute ton vrai numéro WhatsApp Business via le Business Manager.
2.3 Récupérer le Phone Number ID
  1. WhatsApp → Configuration de l'API.
  2. Sous « Envoyer et recevoir des messages », ouvre le menu « De ».
  3. Sélectionne ton numéro.
  4. Copie « Identifiant du numéro de téléphone » (15-16 chiffres).
2.4 Générer un Access Token permanent
Le token affiché par défaut expire en 24 h. Pour la production, génère un token via un utilisateur système.
  1. Business Manager → Paramètres → Utilisateurs → Utilisateurs système.
  2. Ajouter → crée un utilisateur système avec rôle Admin.
  3. Générer un nouveau token → sélectionne ton app WhatsApp.
  4. Permissions à cocher : whatsapp_business_messaging, whatsapp_business_management.
  5. Expiration : Jamais.
  6. Génère et copie-le immédiatement (non ré-affiché ensuite).
2.5 Récupérer l'App Secret
  1. Dans ton app Meta : Paramètres → De base.
  2. Ligne « Clé secrète » → Afficher.
  3. Saisis ton mot de passe Facebook puis copie la valeur.
💡 🔒 Sert à 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

Colle les clés et fais ton premier test.

3.1 Coller tes clés dans WaCommerces

Va dans Réglages → WhatsApp et remplis :

  • Phone Number ID (étape 2.3)
  • Access Token permanent (étape 2.4)
  • App Secret (étape 2.5) — champ chiffré côté serveur
3.2 Webhook & Verify Token

Dans Réglages → WhatsApp, section « Ton endpoint », copie :

  • Webhook URL : https://wacommerces.com/api/public/whatsapp/webhook/xxxxx
  • Verify Token : chaîne aléatoire générée pour toi

Puis sur developers.facebook.com → ton app → WhatsApp → Configuration, section Webhook → Modifier :

  1. Colle l'URL de callback et le Verify Token.
  2. Vérifier et enregistrer → Meta doit afficher « Webhook vérifié ».
  3. Dans Champs du webhook, abonne-toi à messages (et message_status pour le suivi).
3.3 Premier test
  1. Depuis ton téléphone (numéro admin de 1.5), envoie « bonjour » à ton numéro Business.
  2. Sam doit répondre en quelques secondes.
  3. Demande-lui : « Quels produits ai-je en stock ? » — il liste ton catalogue.
Si Sam répond, ta connexion est opérationnelle. Sinon, va voir la section Dépannage.

Partie 4 — Aller plus loin

Les agents, les crédits et la sécurité.

4.1 Les agents IA disponibles
AgentRôleAvec qui
SamAdministration boutiqueToi (admin)
ElonVendeur — conseille et prend les commandesClients
ClaudeLivraison — dispatch et suiviLivreurs
AmandineMarketing — campagnes & relancesClients (broadcast)
MawenaSupport / SAVClients
4.2 Crédits IA & sécurité
  • Suivi des crédits : Réglages → Crédits. Recharge : Plans & crédits.
  • 🔐 App Secret chiffré AES-256-GCM côté serveur.
  • 🛡️ Tous les webhooks vérifient la signature HMAC de Meta.
  • 🧱 Données strictement isolées entre boutiques.
Dépannage
SymptômeCause probableSolution
Meta refuse de vérifier le webhookURL ou Verify Token mal copiésRecopier sans espace, slug complet
Webhook vérifié mais aucun messagePas abonné au champ messagesÉtape 3.2 dernier point
Sam ne répond pasNuméro admin mal saisi (avec + ou espaces)Réglages → WhatsApp, format 33612345678
Erreur 403 dans les logs MetaApp Secret manquant ou incorrectRéglages → WhatsApp → re-saisir l'App Secret
« Crédit IA épuisé »Solde à 0Plans & crédits → recharger
Token Meta expire à 24 hToken temporaire utiliséGénérer un token utilisateur système (2.4)
Besoin d'aide ? support@wacommerces.com ou ouvre un ticket depuis la page Support.