Apprendre mokapen

Shopify

Connectez votre boutique Shopify à Mokapen pour importer dans le CRM les clients (contacts), les produits (avec variantes et quantités) et les commandes de la boutique, et pour exporter vers Shopify les produits créés ou mis à jour dans Mokapen lorsque la direction de sync le permet. L'objectif est d'unifier e-commerce et gestion commerciale : données maîtres, catalogue et historique d'achats 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

• Boutique Shopify active (URL se terminant par .myshopify.com).
• Autorisation de l'app Mokapen sur Shopify (OAuth) avec un compte administrateur de la boutique.
• Plan Mokapen Premium adapté aux intégrations e-commerce. Sans plan, le bouton de connexion ouvre l'écran d'upgrade ; dans certains parcours Shopify, un prélèvement récurrent lié à l'app peut aussi être proposé.
• 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 Shopify

1. Menu utilisateur → Intégrations → Shopify.
2. Saisissez le nom de la boutique (comme dans Shopify Admin ; l'URL complète se termine par myshopify.com). En cas de doute, ouvrez le tableau de bord Shopify et consultez la barre d'adresse du navigateur.
3. Lancez l'autorisation : vous êtes redirigé vers Shopify pour accepter les permissions.
4. Acceptez les scopes demandés (lecture/écriture clients et produits, lecture commandes — voir ci-dessous).
5. Revenez dans Mokapen : la boutique apparaît connectée. Si vous arrivez depuis l'App Store Shopify, vous devrez peut-être choisir l'organisation Mokapen sur laquelle installer la connexion.

Si vous n'acceptez pas sur Shopify, aucune donnée n'est synchronisée. Après la connexion Mokapen enregistre les webhooks sur la boutique : les mises à jour clients, produits et commandes peuvent ainsi arriver en temps réel, en plus de la sync bulk que vous lancez.

Ce que Mokapen demande à Shopify

Lors de l'autorisation OAuth Mokapen demande généralement :

• read_customers / write_customers — lire (et éventuellement écrire) les clients Shopify.
• read_products / write_products — lire et mettre à jour produits/variantes.
• read_orders — lire les commandes de la boutique.

Mokapen ne remplace pas le panneau Shopify pour checkout, thèmes ou paiements : il aligne les données vers (et, pour les produits, depuis) le CRM. Si vous révoquez l'app depuis Shopify ou si le token expire, déconnectez et reconnectez depuis Mokapen. Shopify exige aussi des endpoints GDPR (demande de données / redact) : Mokapen les gère via webhook.

Ce qui est synchronisé

Vers Mokapen (import / webhook)

• Clients → Contacts — les données maîtres Shopify entrent dans le carnet ; si des données entreprise sont présentes, l'entreprise peut aussi être créée/liée. Webhooks sur create/update/delete clients.
• Produits et variantes → Produits — catalogue avec variantes ; la quantité d'inventaire Shopify de la variante est mappée sur le champ quantité de la variante Mokapen (ce n'est pas un module entrepôt séparé).
• Commandes → Commandes — les commandes Shopify deviennent des commandes de vente dans Mokapen (avec lignes articles), pas des deals de pipeline. Webhooks sur les mises à jour de commande.
• Checkouts abandonnés — la sync peut inclure un parcours d'import des checkouts abandonnés Shopify (comme commandes/données associées). Les rapports dédiés aux paniers abandonnés / analytics e-commerce sur la page apparaissent encore comme Bientôt disponible : ne les considérez pas comme une fonctionnalité déjà active.

Vers Shopify (export)

• Produits — avec direction sync « vers Shopify » ou « les deux », Mokapen peut exporter/mettre à jour les produits sur la boutique (sync bulk et sync-out à l'enregistrement d'un produit lié, si l'intégration est active).
• Contacts et commandes sortants — malgré les scopes write_customers, l'export automatique « sync out » implémenté aujourd'hui concerne en pratique les produits. Ne présumez pas d'un export bidirectionnel complet des contacts ou commandes : les clients arrivent surtout de Shopify vers Mokapen (import + webhook). Si un texte marketing parle de « bidirectionnel contacts uniquement », vérifiez dans votre environnement ce que fait réellement la sync après connexion.

En config l'intégration liste aussi les services, mais il n'y a pas de sync services e-commerce dédiée comme pour les produits : utilisez Produits pour le catalogue boutique.

Paramètres après connexion

Sur la page Shopify, boutique connectée, vous configurez généralement :

Direction sync

• Vers Mokapen uniquement — les données partent de Shopify et entrent dans le CRM.
• Les deux — import + export (là où c'est supporté ; aujourd'hui surtout produits sortants).
• Vers Shopify uniquement — envoi depuis Mokapen vers la boutique (produits).

Entités

Contacts, commandes et produits apparaissent comme périmètres de sync (souvent déjà sélectionnés et non modifiables depuis l'UI). La sync historique et les webhooks couvrent ces trois blocs.

Partager la sync

Celui qui a connecté la boutique peut laisser d'autres membres utiliser la même connexion (organisation entière ou utilisateurs sélectionnés), pour que tous n'aient pas à refaire OAuth.

Doublons et conflits

• Éviter les doublons — option typique : contacts reconnus par email, pour ne pas créer de doublons dans le carnet.
• En cas de conflit — choisissez si Shopify ou Mokapen l'emporte lorsque le même enregistrement a été modifié des deux côtés.

Sync automatique vs manuelle

Avec la sync automatique active, les mises à jour (et les webhooks) maintiennent les données alignées ; vous pouvez toutefois lancer une synchronisation manuelle pour le chargement historique initial. Avant de synchroniser, cochez l'autorisation de traitement/partage des données requise sur la page.

Parcours recommandé

1. Connectez la boutique et vérifiez Compte connecté.
2. Définissez la direction sync (dans la plupart des cas : Vers Mokapen uniquement ou Les deux si vous voulez mettre à jour les produits Shopify depuis Mokapen).
3. Configurez doublons/conflits et partage.
4. Autorisez et lancez la première sync (peut prendre du temps sur de grands catalogues).
5. Contrôlez dans Mokapen : Contacts, Produits (variantes/qté), Commandes.
6. Laissez les webhooks actifs : les nouvelles commandes et mises à jour clients/produits arriveront sans tout relancer à chaque fois.

Déconnecter

Depuis Intégrations → Shopify → déconnecter. Dans le modal vous pouvez choisir de conserver dans Mokapen les contacts, commandes et produits déjà importés, ou les gérer selon les options proposées. Après déconnexion les webhooks cessent de mettre à jour ; les données déjà dans le CRM restent si vous avez choisi de les garder. Vous pouvez aussi révoquer l'app depuis le panneau Shopify.

Problèmes fréquents

• Nom de boutique invalide — utilisez le sous-domaine *.myshopify.com, pas seulement le domaine personnalisé de vitrine.
• Bouton bloqué / upgrade — un plan Premium adapté à l'e-commerce est requis.
• Commandes pas dans Opportunités — c'est normal : elles vont dans Commandes. Ouvrez Ventes → Commandes.
• Quantité produit — provient de la quantité variante Shopify ; ce n'est pas un WMS complet.
• Rapports paniers / analytics — s'ils apparaissent « Bientôt disponible » sur la page, ils ne sont pas encore opérationnels.
• Token expiré / sync arrêtée — déconnectez et reconnectez ; vérifiez que l'app n'a pas été désinstallée depuis Shopify.

Questions fréquentes

Q : Où trouver l'URL de la boutique ?

R : Dans la barre d'adresse du tableau de bord Shopify Admin : elle se termine par myshopify.com.

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

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

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

R : Oui, avec une direction sync incluant l'export et l'intégration active : les produits (variantes) peuvent être envoyés/mis à jour sur la boutique.

Q : Les contacts se mettent-ils aussi à jour de Mokapen vers Shopify ?

R : L'import et les webhooks amènent les clients Shopify dans le CRM. L'export automatique des contacts n'est pas le parcours principal aujourd'hui (contrairement aux produits) : vérifiez sur votre plan/environnement après connexion.

Q : Faut-il WooCommerce en plus de Shopify ?

R : Non : ce sont deux intégrations e-commerce alternatives. Utilisez Shopify si la boutique est sur Shopify ; consultez le guide WooCommerce si vous utilisez WordPress/Woo.