Apprendre mokapen

WooCommerce

Connectez votre boutique WooCommerce (WordPress) à Mokapen pour importer dans le CRM les clients (contacts), les produits (avec variations et stock) et les commandes de la boutique, et pour exporter vers WooCommerce les produits créés ou mis à jour dans Mokapen lorsque la direction de sync le permet. Même objectif que Shopify : unifier e-commerce et gestion commerciale dans le même workspace.

Vue d'ensemble : Intégrations. Les commandes importées deviennent des commandes de vente dans Mokapen (module Commandes), pas des opportunités de pipeline.

Prérequis

• Site WordPress avec WooCommerce actif et accessible en HTTPS.
• Autorisation de Mokapen via le flux WC Auth (administrateur WordPress / WooCommerce).
• Plan Mokapen Premium adapté aux intégrations e-commerce. Sans plan, le bouton de connexion ouvre l'écran d'upgrade.
• Permissions Mokapen sur contacts, produits et commandes dans votre organisation (voir Rôles et permissions).
• Accès aux Intégrations (membre/admin selon white-label et rôle org).

Connecter la boutique WooCommerce

1. Menu utilisateur → Intégrations → WooCommerce.
2. Saisissez l'adresse web de la boutique (URL du site, p. ex. https://votredomaine.com). Vous la trouvez dans la barre d'adresse lorsque vous êtes dans le backend WordPress / vitrine WooCommerce.
3. Lancez l'autorisation : vous êtes redirigé vers WordPress/WooCommerce sur la page WC Auth (/wc-auth/v1/authorize) avec scope read_write.
4. Acceptez de générer les clés API pour Mokapen (consumer key / secret sont enregistrées chiffrées dans Mokapen — pas de formulaire « coller la clé API » manuel).
5. Revenez dans Mokapen : la boutique est connectée. Mokapen enregistre les webhooks WooCommerce (/wp-json/wc/v3/webhooks) pour recevoir les mises à jour en temps réel.

Si vous n'acceptez pas l'autorisation, aucune donnée n'est synchronisée. L'URL doit être valide et en HTTPS : sinon la validation échoue.

Ce que Mokapen demande à WooCommerce

Le flux WC Auth accorde à Mokapen un accès lecture/écriture aux API REST WooCommerce nécessaires pour clients, produits (et variations), commandes et webhooks. Mokapen ne remplace pas le panneau WooCommerce/WordPress pour thèmes, paiements ou plugins : il aligne les données vers (et, pour les produits, depuis) le CRM.

Si vous révoquez les clés ou supprimez l'autorisation côté WordPress, déconnectez et reconnectez depuis Mokapen.

Ce qui est synchronisé

Vers Mokapen (import / webhook)

• Clients → Contacts — clients WooCommerce dans le carnet (et entreprise si les données le permettent). Mises à jour aussi via webhook.
• Produits et variations → Produits — catalogue avec variations ; le stock WooCommerce (stock_quantity) est mappé sur la quantité variante Mokapen.
• Commandes → Commandes — les commandes WooCommerce deviennent des commandes de vente dans Mokapen (avec lignes), pas des deals de pipeline. Webhooks sur les mises à jour.
• Paniers abandonnés / rapports — mentions marketing ou entrées « Bientôt disponible » dans l'UI n'équivalent pas à un import de reporting paniers déjà actif comme sur d'autres flux : ne les considérez pas comme une fonctionnalité complète si la page les affiche encore comme bientôt disponible.

Vers WooCommerce (export)

• Produits — avec direction sync « vers WooCommerce » ou « les deux », Mokapen peut exporter/mettre à jour les produits sur la boutique (sync bulk et sync-out à l'enregistrement produit, si l'intégration est active).
• Contacts et commandes sortants — comme pour Shopify, l'export automatique « sync out » implémenté aujourd'hui concerne en pratique les produits. Les clients arrivent surtout de WooCommerce vers Mokapen (import + webhook). Ne présumez pas d'un export contacts bidirectionnel complet parce que le texte commercial le suggère : vérifiez après connexion.

En config apparaît aussi services, mais il n'y a pas de sync services dédiée : pour le catalogue boutique utilisez Produits.

Paramètres après connexion

Sur la page WooCommerce, boutique connectée :

Direction sync

• Vers Mokapen uniquement — WooCommerce → CRM.
• Les deux — import + export (là où c'est supporté ; aujourd'hui surtout produits sortants).
• Vers WooCommerce uniquement — Mokapen → boutique (produits).

Entités

Contacts, commandes et produits sont les périmètres de sync (souvent présélectionnés et non modifiables depuis l'UI).

Partager la sync

Celui qui a connecté peut partager la connexion avec toute l'organisation ou des utilisateurs sélectionnés.

Doublons et conflits

• Éviter les doublons — généralement reconnaissance des contacts par email.
• En cas de conflit — WooCommerce ou Mokapen l'emporte.

Confidentialité (WooCommerce)

Contrairement à Shopify, sur la page WooCommerce vous pouvez aussi trouver des contrôles de confidentialité et collaborateurs/parties prenantes liés à la visibilité des données synchronisées dans l'org. Configurez-les si l'équipe ne doit pas voir tout le catalogue/clients importés de la même manière.

Sync automatique vs manuelle

Activez la sync automatique pour les mises à jour continues (avec les webhooks) ; utilisez la sync manuelle pour le chargement historique. Cochez l'autorisation des données sur la page avant de synchroniser.

Parcours recommandé

1. Vérifiez HTTPS et WooCommerce à jour sur le site.
2. Connectez la boutique depuis Intégrations → WooCommerce et complétez WC Auth.
3. Définissez direction sync, doublons, conflits, confidentialité (si présent) et partage.
4. Autorisez et lancez la première sync.
5. Contrôlez Contacts, Produits (variations/stock), Commandes dans Mokapen.
6. Laissez les webhooks actifs pour les nouveaux événements sans tout relancer à chaque fois.

Déconnecter

Depuis Intégrations → WooCommerce → déconnecter. Dans le modal choisissez de conserver dans Mokapen contacts, commandes et produits déjà importés. Après déconnexion les webhooks ne mettent plus à jour ; les données déjà dans le CRM restent si vous les avez conservées. Vous pouvez aussi révoquer clés/autorisations depuis le panneau WordPress.

Problèmes fréquents

• URL invalide / pas HTTPS — utilisez l'adresse complète du site avec https://.
• Autorisation échouée — un admin WordPress est requis ; vérifiez que WooCommerce et les permaliens REST fonctionnent (pare-feu/plugins de sécurité peuvent bloquer WC Auth ou les webhooks).
• Bouton bloqué / upgrade — un plan Premium adapté à l'e-commerce est requis.
• Commandes pas dans Opportunités — c'est normal : elles vont dans Commandes (Ventes → Commandes).
• Stock / quantité — provient de stock_quantity des variations ; ce n'est pas un WMS complet.
• Webhooks qui n'arrivent pas — le site doit être accessible depuis internet ; environnements locaux ou avec basic auth ne reçoivent souvent pas les notifications WooCommerce.

Questions fréquentes

Q : Dois-je générer les clés API manuellement dans WooCommerce ?

R : Non. Utilisez le flux WC Auth depuis la page Intégrations Mokapen : les clés sont créées et enregistrées au retour de l'autorisation.

Q : Les commandes WooCommerce deviennent-elles des opportunités ?

R : Non. Dans Mokapen elles deviennent des commandes de vente. Tout texte évoquant des « opportunités » est imprécis par rapport au comportement actuel.

Q : Puis-je mettre à jour les produits WooCommerce depuis Mokapen ?

R : Oui, avec une direction sync incluant l'export et l'intégration active.

Q : Différence avec Shopify ?

R : Même modèle de données (contacts, produits, commandes) et même logique Premium e-commerce. La connexion diffère : Shopify utilise OAuth sur l'app Shopify ; WooCommerce utilise WC Auth sur l'URL de votre site WordPress. Consultez aussi le guide Shopify.

Q : HTTPS est-il requis ?

R : Oui. Sans HTTPS la connexion et les webhooks ne sont pas fiables (et la validation d'URL peut échouer).