Gratuit, sans inscription. Ce kit envoie vos clients et vos commandes Shopify vers HubSpot, sans doublon et sans webhook non vérifié. Cinq fichiers JSON à importer dans n8n (plus une variante), et la documentation de chacun : configuration, cas d'erreur, ce qui n'est pas couvert.
Télécharger le kit (zip) · Fichiers un par un sur GitHub · Documentation développeur (en anglais)
Testé avec n8n 2.46.6. API Shopify Admin GraphQL 2026-10, API HubSpot en versionnement par date 2026-09. Dernière vérification : novembre 2026. Notes adhésives et descriptions des workflows en français et en anglais.
À qui ça sert
Ce kit vous concerne si :
- vous vendez sur Shopify et vous utilisez (ou comptez utiliser) HubSpot comme CRM ;
- vous avez déjà n8n, en Cloud ou auto-hébergé, et vous savez importer un workflow et créer une credential ;
- vous voulez comprendre ce que fait chaque nœud plutôt que copier une boîte noire.
Il ne vous concerne pas si :
- l'intégration native HubSpot ↔ Shopify suffit à votre besoin. Testez-la d'abord : elle synchronise sans rien à maintenir. Ce kit commence là où vous voulez maîtriser les champs, les règles et les erreurs ;
- vous cherchez une synchronisation bidirectionnelle (HubSpot vers Shopify) ou une reprise d'historique : ce n'est pas l'objet ici.
Ce que contient le kit
| Fichier | Rôle | Déclencheur |
|---|---|---|
00-proprietes-hubspot.json |
Crée dans HubSpot les propriétés personnalisées utilisées par les autres | Manuel, une seule fois |
01-client-shopify-vers-contact-hubspot.json |
Client Shopify → contact HubSpot, dédoublonné par e-mail | Webhook customers/create et customers/update |
02-commande-payee-vers-transaction-hubspot.json |
Commande payée → transaction HubSpot associée au contact | Webhook orders/paid |
03-segmentation-client-shopify-hubspot.json |
Nombre de commandes, total dépensé, dernière commande, segment sur le contact | Webhook orders/paid + API GraphQL Admin (jeton demandé à chaque exécution) |
03b-segmentation-client-jeton-fixe.json |
Même chose avec un jeton Admin API fixe (ancienne app personnalisée) | Webhook orders/paid |
04-alerte-echec-workflow.json |
E-mail quand un des workflows échoue | Error Trigger |
Chaque workflow contient une note adhésive « lire d'abord », en français puis en anglais, avec ses réglages. Aucun nœud Code : uniquement des nœuds natifs (Webhook, Crypto, IF, Edit Fields, HTTP Request, Respond to Webhook, Stop and Error, Send Email) et des expressions n8n.
Prérequis
- n8n 2.7 ou plus récent. Les workflows utilisent le nœud Crypto en version 2, qui range le secret HMAC dans une credential : il est absent du paquet
n8n-nodes-base2.6.2 et présent à partir de la 2.7.0 (vérifié sur les paquets publiés). Version testée : 2.46.6, qui demande Node.js 24 en auto-hébergement. n8n Cloud ou auto-hébergé, peu importe, mais l'instance doit être joignable en HTTPS depuis Internet pour recevoir les webhooks. - HubSpot : un compte avec accès aux contacts et aux transactions, et une clé de service (Service Key), à créer dans Paramètres > Intégrations > Clés de service (Settings > Integrations > Service Keys en anglais). Les clés de service étaient en bêta publique à la date de vérification. Scopes à cocher, au minimum :
crm.objects.contacts.write,crm.objects.deals.write, pluscrm.schemas.contacts.writeetcrm.schemas.deals.writepour le seul workflow 00 (retirez-les ensuite). - Shopify : accès aux réglages de la boutique pour créer des webhooks. Pour le workflow 03 : une application avec les scopes
read_customersetread_orders(voir « Le jeton Shopify »). - Propriétés personnalisées : le kit en crée 8 (6 sur les contacts, 2 sur les transactions). D'après mon article sur le modèle de données HubSpot, les outils gratuits n'autorisent que dix propriétés personnalisées au total : comptez celles que vous avez déjà.
Quatre choix que je fais, et pourquoi
1. Webhook générique et signature vérifiée à la main, pas le nœud Shopify Trigger. Le code source du nœud (n8n 2.46.6) montre qu'il vérifie la signature et répond tout de suite à Shopify (responseMode: 'onReceived'), ce qui est bien. Mais il ignore silencieusement une requête mal signée (il renvoie {}) au lieu de la refuser, il ne transmet que le corps de la requête (vous perdez les en-têtes, dont X-Shopify-Webhook-Id), et il crée l'abonnement via l'API REST en version 2024-07, qui ne figure plus parmi les versions supportées de la liste de Shopify. Le nœud demande aussi une credential Shopify propre à lui.
Shopify attend une réponse en cinq secondes au total, retente huit fois sur quatre heures : le kit répond 200 dès la signature vérifiée, 401 sinon, puis traite. Le Shopify Trigger reste un bon choix pour un essai rapide. Le kit n'utilise pas X-Shopify-Webhook-Id non plus : l'idempotence repose sur les upserts. L'en-tête reste disponible dans le nœud Webhook si vous voulez journaliser ou dédoublonner vous-même.
2. HubSpot par HTTP Request, version par date. Le code source du nœud HubSpot (n8n 2.46.6) appelle encore des chemins /deals/v1/, /companies/v2/, /contacts/v1/ et /crm/v3/. HubSpot a classé les APIs v1, v2 et v3 « non supportées », avec une migration à terminer avant septembre 2027 (annonce HubSpot). Les workflows appellent donc https://api.hubapi.com/crm/objects/2026-09/.... Le prix : un peu plus de configuration que le nœud prêt à l'emploi.
3. Des propriétés uniques plutôt que des recherches. Pour ne pas créer deux fois la même transaction, je n'interroge pas HubSpot « existe-t-elle ? » avant d'écrire : deux livraisons rapprochées du même webhook passeraient toutes deux le test. J'écris par upsert sur une propriété à valeur unique (shopify_order_id). HubSpot tranche, pas n8n.
4. Une transaction par commande payée : à ne choisir que si vous en avez besoin. Mon site le dit : l'intégration native range les commandes dans l'objet commande de HubSpot et ne crée pas de transactions, ce qui convient au B2C : en faire une transaction, dit l'article sur le modèle de données, « remplit le pipeline de ventes déjà gagnées et fausse tous les rapports commerciaux » (quelle méthode, modèle de données). Une transaction se justifie quand la vente suit un cycle : panier élevé, devis, B2B, pipeline à suivre. Le workflow 02 crée donc des transactions parce que c'est le cas qu'un kit peut couvrir de façon générique (un montant, une date, un contact), pas parce que c'est le bon modèle partout. Si vos clients sont des particuliers qui achètent en un clic, commencez par l'intégration native et son objet commande ; la variante « objet commande » n'est pas fournie dans ce kit.
Mise en place commune (à faire une fois)
1. Importer les workflows
Dans n8n : Workflows > Import from file, un fichier à la fois, ou en ligne de commande : n8n import:workflow --input=fichier.json. Les workflows s'importent inactifs, non publiés. Pour n8n 2.x auto-hébergé : Node.js 24.
2. Créer les credentials
Les fichiers ne contiennent aucun identifiant. Chaque nœud référence une credential par son nom ; à l'ouverture, n8n vous demande de la sélectionner.
| Nom attendu | Type n8n | Contenu |
|---|---|---|
HubSpot - Service Key |
HubSpot App Token | La clé de service dans le champ App Token (c'est ce que la documentation n8n prescrit) |
Shopify - secret de signature des webhooks |
Crypto | Champ Hmac Secret : le secret qui signe vos webhooks Shopify (voir plus bas) |
Shopify - client credentials (Custom Auth) |
Custom Auth | Workflow 03 : voir « Le jeton Shopify » |
Shopify - jeton Admin API (X-Shopify-Access-Token) |
Header Auth | Variante 03b seulement : nom X-Shopify-Access-Token, valeur = le jeton |
SMTP - alertes |
SMTP | Workflow 04 : votre serveur d'envoi |
3. Remplacer les placeholders
YOUR_SHOP.myshopify.comdans le nœud « Signature et boutique valides ? » de chaque workflow à webhook ;YOUR_SHOPdans les URL Shopify du workflow 03 ou 03b ;alertes@YOUR_DOMAIN.tldetvous@YOUR_DOMAIN.tlddans le workflow 04.
Tant que YOUR_SHOP.myshopify.com n'est pas remplacé, toutes les requêtes sont refusées (401) : le kit échoue fermé. C'est voulu, mais lisez l'encart suivant.
4. Publier les workflows
Dans n8n 2.x, publiez chaque workflow (bouton de publication) : c'est la version publiée qui s'exécute, pas le brouillon. Toute modification (placeholders, seuils, pipeline) n'est prise en compte qu'après une nouvelle publication. Publiez en premier le workflow 04, puis les autres.
5. Brancher l'alerte
Dans les workflows 01, 02 et 03 : Paramètres du workflow > Error workflow > « Kit Shopify-HubSpot 04 - Alerte en cas d'échec », puis republiez le workflow modifié. Sans publication du 04, aucune alerte n'est envoyée : n8n n'exécute pas un workflow d'erreur non publié (constaté en 2.46.6).
6. Déclarer les webhooks côté Shopify
Chemin le plus court, sans application : Réglages > Notifications > Webhooks > Créer un webhook. Pour chacun : événement, format JSON, URL, version d'API (la dernière version stable listée, 2026-10 à la date de vérification).
| Workflow | Événement Shopify | URL de production n8n |
|---|---|---|
| 01 | création client et mise à jour client (deux webhooks, même URL) | https://VOTRE-N8N/webhook/shopify-client |
| 02 | paiement de commande (orders/paid) |
https://VOTRE-N8N/webhook/shopify-commande-payee |
| 03 ou 03b | paiement de commande (orders/paid) |
https://VOTRE-N8N/webhook/shopify-segmentation |
Utilisez l'URL de production (/webhook/...), pas l'URL de test (/webhook-test/...). Les libellés exacts des événements dans l'interface Shopify peuvent varier ; le sujet technique est customers/create, customers/update ou orders/paid. Utilisez un seul des deux workflows 03 / 03b.
Le secret de signature. Shopify signe le corps brut de chaque requête avec HMAC-SHA256 et envoie le résultat en base64 dans X-Shopify-Hmac-Sha256. Pour un webhook créé dans l'administration, la clé de signature de la boutique est affichée sur la page des webhooks (vérifiez dans votre interface). Pour un webhook déclaré par une application, c'est le secret client de cette application. Copiez-le dans la credential Crypto.
Si l'e-mail arrive vide. Pour les applications, Shopify masque les données client protégées (nom, e-mail, téléphone, adresse) tant que l'accès n'est pas accordé : les champs arrivent à null, et une requête GraphQL peut renvoyer une erreur. Si cela vous arrive avec le workflow 03, vérifiez l'accès aux données protégées de votre application.
Le jeton Shopify (workflow 03)
Shopify n'autorise plus la création de nouvelles « custom apps » depuis l'administration ; celles qui existent continuent de fonctionner. Une nouvelle application se crée dans le Dev Dashboard (la marche à suivre). Avec le flux client credentials (réservé aux applications de votre propre organisation installées sur vos boutiques), le jeton expire au bout de 24 heures environ (expires_in : 86399).
Le workflow 03 ne stocke donc aucun jeton : à chaque exécution, un premier appel POST https://YOUR_SHOP.myshopify.com/admin/oauth/access_token en demande un, et le nœud GraphQL le passe dans l'en-tête X-Shopify-Access-Token par expression.
Le client_secret ne se met pas dans le nœud. Créez une credential Custom Auth nommée Shopify - client credentials (Custom Auth) avec ce JSON :
{
"headers": { "Content-Type": "application/x-www-form-urlencoded" },
"body": {
"client_id": "VOTRE_CLIENT_ID",
"client_secret": "VOTRE_CLIENT_SECRET",
"grant_type": "client_credentials"
}
}
L'en-tête Content-Type n'est pas décoratif : Shopify documente cet appel en application/x-www-form-urlencoded, et sans lui n8n enverrait le corps en JSON. En observant la requête réellement envoyée par n8n 2.46.6, les options natives donnent ceci : Custom Auth sans en-tête, et Custom Auth combiné au corps « formulaire » du nœud, envoient du JSON ; avec l'en-tête ci-dessus, le corps part en formulaire, exactement comme dans la documentation Shopify. La credential générique OAuth2 API en mode client credentials envoie bien un formulaire, mais place le jeton dans Authorization: Bearer, alors que la documentation Shopify n'indique que X-Shopify-Access-Token pour l'API Admin : elle n'est donc pas retenue.
Un écart assumé avec la recommandation de Shopify. La documentation de Shopify indique que l'application doit stocker le jeton jusqu'à son expiration. Le kit fait un autre choix : redemander un jeton à chaque exécution, parce que le stocker proprement, sans Code node, demanderait un composant de plus à maintenir (table de données ou base) et la gestion de l'expiration. Le prix : un appel de plus à chaque commande payée, et la documentation Shopify consultée ne précise aucune limite de débit pour /admin/oauth/access_token. Surveillez les erreurs de ce nœud en cas de pic de commandes ; si elles apparaissent, revenez à la logique de stockage (ou, pour une ancienne app, au workflow 03b).
Coût. Un appel de plus par commande payée. Confidentialité. Le jeton circule dans les nœuds ; il apparaît donc dans les exécutions en erreur conservées par n8n (les exécutions réussies ne sont pas conservées, voir plus bas), avec une durée de vie de 24 heures.
Ancienne app personnalisée ? Si vous avez encore un jeton shpat_ d'avant l'arrêt, utilisez le workflow 03b, sans nœud de jeton, avec une credential Header Auth.
Workflow 00 : créer les propriétés HubSpot
Ce qu'il fait. Crée par l'API des propriétés les champs qu'écrivent les workflows suivants.
Sur les contacts : shopify_customer_id (valeur unique), shopify_orders_count, shopify_total_spent, shopify_last_order_date, shopify_segment (nouveau / récurrent / fidèle), shopify_email_marketing_state.
Sur les transactions : shopify_order_id (valeur unique), shopify_order_name.
[Lancer à la main] → [HubSpot : propriétés de contact] → [HubSpot : propriétés de transaction]
POST /crm/properties/2026-09/contacts/batch/create
POST /crm/properties/2026-09/deals/batch/create
Configuration. Aucune, hors credential. Lancez-le une fois avec Execute workflow (pas besoin de le publier).
Limites et cas d'erreur.
- Si une propriété existe déjà, HubSpot renvoie une erreur sur le lot. Les nœuds sont réglés pour continuer ; lisez la sortie pour voir ce qui a été créé.
- Une propriété à valeur unique doit être déclarée comme telle à la création : HubSpot indique que ce réglage ne peut plus être changé ensuite. Le plafond est de dix propriétés d'identifiant unique par objet.
- Les groupes
contactinformationetdealinformationsont ceux que la documentation HubSpot utilise en exemple ; si vos propriétés doivent aller ailleurs, changezgroupName.
Workflow 01 : client Shopify → contact HubSpot
Ce qu'il fait. À chaque création ou mise à jour d'un client Shopify, il crée ou met à jour le contact HubSpot correspondant. La clé de dédoublonnage est l'adresse e-mail.
[Webhook] → [Calculer HMAC] → [Signature + boutique + sujet valides ?]
├─ oui → [Répondre 200] → [E-mail présent ?]
│ ├─ oui → [Préparer le contact] → [HubSpot : upsert par e-mail] → [Erreurs ?] → oui → [Stop and Error]
│ └─ non → [Ignoré]
└─ non → [Répondre 401]
Configuration pas à pas.
- Webhook : méthode POST, chemin
shopify-client, réponse « Using Respond to Webhook Node », option Raw Body activée (indispensable : la signature se calcule sur le corps brut, pas sur le JSON déjà lu). - Crypto : action Hmac, Binary File activé, propriété binaire
data, SHA256, encodage base64. Le résultat est écrit danscalculatedHmac. - IF : trois conditions, toutes vraies.
calculatedHmacégal à l'en-têtex-shopify-hmac-sha256; l'en-têtex-shopify-shop-domainégal à votre boutique ; le sujet (x-shopify-topic) commence parcustomers/. - Respond to Webhook :
200sans corps si valide,401sinon. La réponse part avant l'appel HubSpot. - Edit Fields « Préparer le contact » : l'e-mail est mis en minuscules ; l'objet
propertiesest construit par une expression qui retire les valeurs vides (téléphone absent, adresse absente), pour ne pas effacer une donnée déjà saisie dans HubSpot. - HTTP Request :
POST https://api.hubapi.com/crm/objects/2026-09/contacts/batch/upsert, corps{"inputs":[{"id":"<e-mail>","idProperty":"email","properties":{...}}]}. Retry On Fail est activé (3 essais, 2 s d'intervalle). - IF « Erreurs ? » : un lot HubSpot peut répondre
207(succès partiel) ; ce code est un 2xx, donc n8n ne le verrait pas comme une erreur. Le nœud testenumErrorset déclenche un Stop and Error si besoin.
Champs envoyés. firstname, lastname, phone, city, zip, country (depuis l'adresse par défaut), shopify_customer_id.
Limites et cas d'erreur.
- Changement d'e-mail dans Shopify. Le workflow écrit par e-mail ; un client qui change d'adresse arrive donc sur un autre contact HubSpot. Comme
shopify_customer_idest unique, HubSpot refusera de lui attribuer la même valeur : vous recevrez une erreur (via le207détecté plus haut) au lieu d'un doublon silencieux. Ce cas se règle à la main. - Écritures partielles. HubSpot écrit, dans la documentation des contacts : « Partial upserts are not supported when using
emailas theidProperty», et recommande alors une propriété d'identifiant unique personnalisée. La documentation ne définit pas ce qu'est un upsert « partiel ». Les workflows n'envoient pas tous le même jeu de champs : le 01 envoie jusqu'à sept propriétés, le 02 jusqu'à trois (aucune pour un achat sans compte client), le 03 jusqu'à huit. Rien ne dit lequel pose problème, et un faux serveur ne peut pas le trancher. Faites un essai sur un contact existant et vérifiez qu'aucune propriété n'est effacée. Si HubSpot refusait ces écritures, la solution qu'il recommande est unidPropertypersonnalisé (shopify_customer_id) ; le compromis est que l'écriture échoue quand l'e-mail existe déjà dans HubSpot sans cet identifiant. - Consentement. Le workflow n'abonne personne à vos e-mails marketing et ne touche pas au statut marketing HubSpot. C'est volontaire : l'inscription à une communication commerciale ne se déduit pas d'un champ copié.
- Fréquence.
customers/updatepeut arriver souvent. L'upsert est idempotent, donc sans conséquence autre que des exécutions. - Clients sans e-mail (achat par téléphone, données masquées) : ignorés.
Workflow 02 : commande payée → transaction HubSpot
Ce qu'il fait. Quand une commande est payée, il crée (ou met à jour) la transaction HubSpot correspondante, puis l'associe au contact. Le contact est créé au passage s'il n'existe pas. Voir plus haut pourquoi une transaction plutôt que l'objet commande.
[Webhook orders/paid] → [HMAC] → [Valide ?] → oui → [Répondre 200] → [Commande exploitable ?] → oui → [Réglages] → [Préparer]
→ [HubSpot : upsert contact] → [HubSpot : upsert transaction par shopify_order_id] → [Erreurs ?]
→ [Contact disponible ?] → oui → [HubSpot : associer transaction → contact]
→ non → [Stop and Error : transaction créée mais non associée]
Configuration pas à pas.
- Mêmes quatre premiers nœuds que le workflow 01, avec le chemin
shopify-commande-payeeet le sujetorders/paid. - « Commande exploitable ? » : écarte les commandes de test (
test: true) et celles sans e-mail. Pour tester avec une commande de test Shopify, retirez temporairement la première condition. - « Réglages de la transaction » : deux valeurs à vous,
hubspot_pipeline(par défautdefault) ethubspot_dealstage(par défautclosedwon). Ce sont des identifiants internes, pas des libellés.closedwonest l'identifiant interne de l'étape « Closed Won » du pipeline par défaut (confirmé par la communauté HubSpot, la référence API ne le cite pas) ; vérifiez le vôtre si votre pipeline est personnalisé. - « Préparer » :
dealname= « Commande #1042 » (numéro Shopify),amount=total_price,closedate= date de traitement convertie en UTC, plusshopify_order_name. - Upsert du contact par e-mail, puis upsert de la transaction :
POST /crm/objects/2026-09/0-3/batch/upsertavecidProperty: shopify_order_idet l'identifiant de commande enid. - Association :
PUT /crm/objects/2026-09/deal/{id transaction}/associations/default/contact/{id contact}. L'association « par défaut » est la plus générique, sans libellé.
Limites et cas d'erreur.
- Doublons de livraison. Rejouer le même webhook met à jour la même transaction (même
shopify_order_id) et ne crée rien de plus. L'association est elle aussi idempotente. - Contact en erreur : le workflow est découplé. Si HubSpot refuse le contact (conflit sur
shopify_customer_id, par exemple), la transaction est quand même créée ; l'association n'est pas faite et l'exécution s'arrête en erreur, ce qui déclenche l'alerte du workflow 04. À vous d'associer la transaction au bon contact à la main. Le nœud « créer ou mettre à jour le contact » de ce workflow n'a volontairement pas Retry On Fail : une erreur400(donnée refusée) serait retentée trois fois sans changer de résultat. Contrepartie : un429ne serait pas retenté sur ce nœud, et la transaction serait alors créée sans association, avec une alerte. - Devise. Le montant est envoyé tel quel, dans la devise de la boutique, sans conversion. Si la devise de votre compte HubSpot diffère, adaptez avant de produire des rapports.
- Remboursements, annulations, paiements partiels : non traités. Une commande remboursée reste « gagnée » dans HubSpot jusqu'à ce que vous ajoutiez un workflow dédié.
- Pas de lignes d'article ni de produits : la transaction porte le montant total seulement. Propriétaire de la transaction : non renseigné.
- Étape ou pipeline invalide : HubSpot refuse la transaction, l'alerte du workflow 04 vous le dit.
- Rafale d'événements. Pour un nouveau client,
customers/createet un ou deuxorders/paidpeuvent arriver dans la même seconde : jusqu'à trois upserts du même e-mail en parallèle. Ce cas n'a pas été testé sur un vrai compte HubSpot (seulement contre un faux serveur) : si HubSpot signale des conflits, l'alerte vous le dira.
Workflow 03 : segmentation client via l'API GraphQL de Shopify
Ce qu'il fait. À chaque commande payée, il relit le client dans Shopify et écrit sur le contact HubSpot : nombre de commandes, total dépensé, date de dernière commande, statut marketing e-mail lu dans Shopify, et un segment.
La requête GraphQL (version 2026-10) :
query KitSegment($id: ID!) {
customer(id: $id) {
id firstName lastName numberOfOrders
amountSpent { amount currencyCode }
lastOrder { name processedAt }
defaultEmailAddress { emailAddress marketingState }
}
}
Elle utilise defaultEmailAddress, car les champs Customer.email et Customer.emailMarketingConsent sont signalés comme dépréciés dans la documentation Shopify.
[Webhook orders/paid] → [HMAC] → [Valide ?] → [Répondre 200] → [Commande rattachée à un client ?]
→ [Réglages de segmentation] → [Shopify : obtenir un jeton] → [Shopify GraphQL : lire le client] → [Client trouvé ?] ─ non → [Stop and Error]
→ [Préparer les propriétés] → [HubSpot : upsert contact] → [Erreurs ?] → [Stop and Error]
Configuration pas à pas.
- Entrée identique aux workflows précédents, chemin
shopify-segmentation. - « Réglages de segmentation » : deux seuils,
seuil_recurrent(2) etseuil_fidele(4). Ce sont des exemples pour montrer le mécanisme, pas des recommandations : un panier moyen de 30 € et un de 3 000 € ne se segmentent pas pareil. - « Shopify : obtenir un jeton (client credentials) » : voir « Le jeton Shopify ». Retry On Fail est activé.
- HTTP Request GraphQL :
POST https://YOUR_SHOP.myshopify.com/admin/api/2026-10/graphql.json, en-têteX-Shopify-Access-Tokenfourni par expression, corps JSON avecqueryetvariables. - « Client trouvé ? » : une réponse GraphQL peut revenir en HTTP 200 avec un tableau
errors(par exemple si l'application n'a pas accès à l'objet Customer). Le nœud le détecte et arrête avec le message de Shopify. - « Préparer » : applique les seuils (
fidele,recurrent, sinonnouveau) ;numberOfOrdersest renvoyé en chaîne par Shopify, le workflow le convertit. - Upsert du contact par e-mail, comme dans le workflow 01.
Limites et cas d'erreur.
- Recalcul, pas incrément. Les valeurs sont relues dans Shopify à chaque événement. Rejouer un webhook ne fausse rien. Si Shopify n'a pas encore mis à jour ses agrégats au moment de la lecture, la valeur sera corrigée à la commande suivante.
- Accès aux données protégées. Sans accès, la requête renvoie une erreur ou des champs à
null; le workflow s'arrête avec le message d'erreur. - Volume. Trois appels par commande payée (jeton, GraphQL, HubSpot). Dans une boutique fictive à 200 commandes par jour (hypothèse de calcul), les workflows 02 et 03 totalisent au moins 400 exécutions par jour, plus les événements
customers/update. Comptez-les. - Statut marketing.
shopify_email_marketing_stateest une information. Elle ne modifie pas le statut de contact marketing dans HubSpot. - Segmentation d'exemple. Elle ne tient pas compte du montant. Pour un seuil en euros, comparez
amountSpent.amount(chaîne décimale) dans l'expression.
Workflow 04 : alerte e-mail en cas d'échec
Ce qu'il fait. Quand l'un des workflows à webhook échoue, il vous envoie un e-mail avec le nom du workflow, le nœud en cause, le message d'erreur et le lien vers l'exécution.
[Error Trigger] → [Send Email (SMTP)]
Configuration. Credential SMTP, deux adresses à remplacer, publication du workflow 04, puis désignation comme Error workflow dans les paramètres de chaque workflow concerné (et republication de ceux-ci). L'option d'attribution automatique de n8n est désactivée : l'e-mail ne se termine pas par « sent automatically with n8n ».
Limites.
- Le message ne reprend pas le corps du webhook, mais le message d'erreur relaie le texte renvoyé par HubSpot ou Shopify, qui peut citer une valeur (identifiant, e-mail). Traitez la boîte qui reçoit les alertes comme un endroit où peuvent passer des données client.
- Il alerte sur les échecs d'exécution, pas sur les webhooks que Shopify n'a pas pu livrer ou que n8n n'a jamais reçus (instance arrêtée). Shopify retente puis supprime l'abonnement : revérifiez de temps en temps que vos webhooks existent encore.
- Un envoi d'e-mail dépend de votre serveur SMTP ; remplacez-le par Slack ou Teams si c'est votre canal, le principe est le même.
Tester avant de faire confiance
- Lancez le workflow 00 et vérifiez les propriétés dans HubSpot.
- Remplacez les placeholders, publiez les workflows (04 d'abord), branchez l'Error workflow.
- Créez le webhook côté Shopify puis utilisez Send test sur la page des webhooks. Send test envoie un exemple de payload : des données factices, qui seront réellement écrites dans HubSpot (un contact, une transaction). Supprimez-les ensuite.
- Faites un essai avec une adresse e-mail à vous, créée dans la boutique.
- Provoquez une erreur volontairement (remplacez temporairement la clé de service HubSpot par une valeur fausse, déclenchez un Send test) et vérifiez que l'e-mail d'alerte arrive. Remettez la bonne clé (les credentials ne font pas partie de la version publiée : aucune republication n'est nécessaire). Utilisez le webhook client (workflow 01) pour cet essai : l'exemple Send test de
orders/paidpeut portertest: true, et le workflow 02 l'ignore alors sans erreur. Le webhook reçoit un200dans tous les cas, donc il ne risque pas la suppression. - Essai du secret faux : modifiez un caractère du secret de la credential Crypto, envoyez un seul Send test (Shopify doit recevoir un
401et rien ne doit arriver dans HubSpot), puis rétablissez le secret aussitôt : des401répétés peuvent faire supprimer le webhook. - Relancez deux fois le même événement : un seul contact et une seule transaction.
Données personnelles. Les workflows sont réglés pour ne pas conserver les exécutions réussies (saveDataSuccessExecution: none) ; les exécutions en erreur sont conservées, et contiennent le corps du webhook, donc des données client (et, pour le workflow 03, le jeton de 24 h). Réglez la durée de conservation des exécutions de votre instance en conséquence. Pour déboguer, réactivez temporairement la sauvegarde des exécutions réussies.
Ce que le kit ne fait pas
- Pas de comparaison à temps constant de la signature : n8n n'a pas de nœud natif pour cela, la comparaison est une égalité de chaînes. Le risque est théorique à travers Internet, mais c'est une limite que je préfère nommer.
- Pas de réconciliation quotidienne : un webhook perdu reste perdu. L'article sur les webhooks explique pourquoi on en garde une sur les flux critiques.
- Pas de gestion des remboursements, annulations, produits, stocks, paniers abandonnés.
- Pas de file d'attente : en cas de pic, le nœud HTTP Request retente seul les erreurs (y compris les
429de HubSpot) trois fois, à deux secondes d'intervalle, grâce à Retry On Fail, déjà activé sur les nœuds HubSpot et Shopify du kit (sauf l'upsert du contact du workflow 02, voir plus haut) ; au-delà, l'exécution échoue et l'alerte part. Consultez les limites de votre offre HubSpot. - Pas de multi-boutiques : un jeu de workflows par boutique.
Ce que je ferais à votre place
| Votre situation | Ce que je ferais | Premier pas |
|---|---|---|
| Vous voulez l'historique d'achat dans HubSpot, sans règle particulière | L'application officielle, pas le kit : rien à maintenir. | Installez-la et testez-la une semaine. |
| Vous avez n8n et quelqu'un qui sait l'administrer | Le kit, en commençant par les workflows 00, 01 et 04. | Importez-les sur une boutique de test. |
| Vos clients achètent en un clic, sans devis | Pas le workflow 02 : une transaction par commande fausse les rapports commerciaux. | Gardez l'objet commande de l'intégration native. |
| Remboursements, plusieurs boutiques ou une file d'attente à gérer | Le kit ne les couvre pas : il faudra l'adapter. | Listez ce qui manque avant d'importer. |
Licence
Les fichiers JSON du kit sont publiés sous licence MIT et la documentation sous licence CC BY 4.0 : usage libre, y compris commercial et chez vos clients, sans garantie, avec mention de l'auteur. Les textes des deux licences sont dans le dépôt GitHub. Vous restez responsable de la conformité de votre traitement de données (RGPD) et de vos réglages HubSpot et Shopify.
Vérifications et historique
- Import : les six fichiers ont été importés dans n8n 2.46.6.
- Exécution d'essai : les workflows 01, 02, 03, 03b et 04 ont été exécutés contre un faux serveur HubSpot/Shopify local et un faux serveur SMTP, avec signature valide, signature fausse, mauvaise boutique, e-mail absent, commande de test, achat sans compte client, rejeu, réponse HubSpot 207, erreur GraphQL, et demande de jeton à chaque exécution. Ce n'est pas un test contre de vrais comptes HubSpot et Shopify.
- Documentation consultée en novembre 2026 : Shopify (webhooks, versions d'API,
Customer, client credentials), HubSpot (versionnement par date, upsert, associations, propriétés, clés de service), n8n (nœuds Webhook, Crypto, HubSpot). - Version 2.0 — 14 novembre 2026. Historique des versions : changelog.
Aller plus loin
- Webhooks Shopify sans polling : pourquoi, et la vérification quotidienne de rattrapage.
- Connecter Shopify et HubSpot : quelle méthode ? : natif, connecteur, plateforme d'automatisation ou sur mesure.
- Modèle de données HubSpot : contacts, commandes, transactions.
- n8n : mon avis d'intégrateur.
- Un exemple de réalisation : synchronisation Shopify ↔ CRM.
Adapter ces workflows à vos champs, vos pipelines ou vos volumes, c'est mon métier d'intégrateur n8n, et celui d'expert HubSpot.
Votre cas ressemble à ça ?
Vous avez importé le kit, mais vos champs, vos remboursements ou vos volumes n'y rentrent pas ? Dites-moi ce qui bloque. Je vous dis si une adaptation suffit, ou si l'application officielle ferait mieux l'affaire. Réponse sous 24–48 h ouvrées.
Téléchargements
Questions sur cette page
Pourquoi ne pas utiliser le nœud HubSpot de n8n ?
Parce qu'il appelle encore des chemins v1 à v3, que HubSpot déclare non supportés à partir de septembre 2027. Le nœud peut redevenir le bon choix quand n8n l'aura migré ; en attendant, l'appel direct à la version par date évite une réécriture.
Pourquoi une clé de service plutôt qu'une application privée ?
HubSpot ne permet plus de créer de nouvelles applications privées legacy (depuis le 28 septembre 2026 pour les nouveaux comptes, le 26 octobre 2026 pour les comptes existants) ; les applications privées legacy existantes continuent de fonctionner jusqu'à l'échéance annoncée de septembre 2027. Le modèle qui les remplace passe par un projet de développeur HubSpot (CLI), ce qui est disproportionné pour ce kit. HubSpot recommande les clés de service pour les intégrations internes. Elles étaient en bêta publique à la date de vérification, et ne gèrent pas les webhooks HubSpot : ce kit n'en reçoit pas.
Puis-je utiliser seulement un workflow ?
Oui. Le 00 est un préalable pour les propriétés personnalisées (01, 02 et 03 en utilisent). Le 04 est facultatif, mais sans lui vous ne saurez pas quand ça casse.
Ça marche avec Shopify Plus ou plusieurs devises ?
Aucune configuration Plus ni multi-devises n'a été testée. Le montant est envoyé dans la devise de la boutique.
Puis-je modifier les workflows ?
Oui, c'est fait pour. Les expressions de construction des propriétés sont dans les nœuds « Préparer ». Ajoutez un champ en l'ajoutant à l'objet, puis republiez.
Comment savoir que ça marche en production ?
Le workflow 04 vous dit quand ça casse. Pour savoir que ça tourne, regardez la liste des exécutions de n8n et comptez les contacts créés dans HubSpot sur la semaine.