Setup

E-commerce (Shopify)

Synchronisez les clients et les commandes de votre boutique Shopify vers le CRM en utilisant votre propre boutique (modèle BYO).

L'intégration E-commerce utilise VOTRE boutique Shopify (modèle BYO : vous apportez votre propre boutique). Elle écoute les webhooks de votre boutique et synchronise vers le CRM : chaque client devient un Contact et chaque commande devient une Commande client. Il n'y a aucun coût, aucune marge ni aucune intermédiation de notre côté : les données proviennent directement de votre boutique.

L'intégration démarre inerte : rien ne se passe tant que vous n'avez pas rempli les champs et activé l'intégration. Le secret du webhook et le jeton d'administration sont stockés chiffrés dans le CRM et ne sont jamais réaffichés.

Prérequis

Une boutique Shopify avec un accès administrateur (Shopify Admin) pour créer des webhooks et consulter le secret de signature.
Le domaine .myshopify.com de la boutique.
Dans Sellio, un accès administrateur pour enregistrer les identifiants et activer l'intégration dans Paramètres → Intégrations.

Ce que vous devez remplir

Domaine de la boutique : l'adresse .myshopify.com de votre boutique (par exemple, maboutique.myshopify.com).
Secret du webhook (secret API) : le secret que Shopify utilise pour signer les webhooks. Dans Shopify Admin → Paramètres → Notifications, le « secret de signature » des webhooks apparaît (ou, si vous utilisez votre propre application, son secret API). C'est la valeur que le CRM utilise pour vérifier la signature (HMAC) de chaque appel.
Jeton d'accès à l'API Admin (facultatif) : nécessaire uniquement si, à l'avenir, vous voulez que le CRM lise les données de la boutique via l'API. Pour ne recevoir que les webhooks, laissez ce champ vide.

Comment configurer

Ouvrez Paramètres → Intégrations et trouvez la carte « E-commerce (Shopify) ».
Remplissez le domaine de la boutique et le secret du webhook, puis cliquez sur « Enregistrer les identifiants ».
Copiez l'« URL du webhook (Shopify) » qui apparaît.
Dans Shopify Admin → Paramètres → Notifications → Webhooks, créez un webhook (format JSON) pointant vers cette URL pour CHACUN de ces sujets : customers/create, customers/update, orders/create, orders/paid.
Revenez au CRM et cliquez sur « Activer ».

Ce qui se passe à chaque événement

customers/create et customers/update : le client est créé ou mis à jour en tant que Contact, en faisant correspondre par e-mail. Le CRM stocke l'id client Shopify pour éviter les doublons lors des renvois.
orders/create et orders/paid : la commande est créée ou mise à jour en tant que Commande client (numéro, montant, devise et statut), liée au Contact correspondant lorsqu'il existe. Le statut devient « facturée » quand la commande est payée, « annulée » si elle a été annulée, ou « confirmée » sinon.

💡 La synchronisation est idempotente : si Shopify renvoie le même webhook, le CRM met à jour l'enregistrement existant au lieu d'en créer une nouvelle (il identifie l'enregistrement par l'id Shopify). Seuls les champs provenant de la boutique sont mis à jour, et ce que vous avez modifié manuellement dans le CRM est préservé.

Traitez l'URL du webhook et le secret du webhook comme des secrets. Le CRM vérifie la signature X-Shopify-Hmac-Sha256 de chaque appel avec votre secret de webhook ; les signatures invalides sont refusées. Si vous essayez d'activer sans avoir rempli le secret, l'intégration reste inerte, et rien n'est synchronisé tant que tout n'est pas en place.

Comment tester

Une fois l'intégration activée et les webhooks créés, dans Shopify Admin → Paramètres → Notifications → Webhooks, utilisez « Envoyer une notification de test » sur l'un des webhooks (ou créez une commande/un client de test dans la boutique).
Dans le CRM, vérifiez l'objet Contacts (pour les clients) et Commandes clients (pour les commandes) : l'enregistrement correspondant devrait apparaître.
Renvoyez le même test et confirmez qu'il ne se duplique PAS. Le CRM identifie l'enregistrement par l'id Shopify.

Dépannage

Signature invalide (appel refusé) : le secret du webhook enregistré dans le CRM diffère du secret de signature de Shopify. Copiez à nouveau le secret (Paramètres → Notifications, ou le secret API de votre application) et collez-le dans le CRM.
Rien ne se synchronise : vérifiez que vous avez créé un webhook (format JSON) pour CHAQUE sujet : customers/create, customers/update, orders/create, orders/paid, tous pointant vers l'« URL du webhook (Shopify) ».
404 sur l'URL : l'intégration est désactivée ou le jeton de l'URL a changé. Réactivez et recopiez l'URL vers Shopify.
Commande sans contact lié : le lien se fait par correspondance avec l'e-mail du client ; si le client n'existe pas encore comme Contact, la commande est créée sans lien et vous l'associez plus tard.
Les champs que j'ai modifiés ont été écrasés : seuls les champs provenant de la boutique sont mis à jour ; le reste est préservé. Si un champ de la boutique a changé, cela reflète la boutique, par conception.

Open this article inside the system →