CinfologContactRech.

Analyse · Thomas Cadalen · 14 nov. 2026

Kit n8n Shopify → HubSpot : 5 workflows gratuits, avec leurs limites

Cinq workflows n8n gratuits à importer pour envoyer clients et commandes Shopify vers HubSpot : webhooks signés, sans doublon, alertes d'échec, limites documentées.

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-base 2.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, plus crm.schemas.contacts.write et crm.schemas.deals.write pour 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_customers et read_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.com dans le nœud « Signature et boutique valides ? » de chaque workflow à webhook ;
  • YOUR_SHOP dans les URL Shopify du workflow 03 ou 03b ;
  • alertes@YOUR_DOMAIN.tld et vous@YOUR_DOMAIN.tld dans 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 contactinformation et dealinformation sont ceux que la documentation HubSpot utilise en exemple ; si vos propriétés doivent aller ailleurs, changez groupName.

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.

  1. 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).
  2. Crypto : action Hmac, Binary File activé, propriété binaire data, SHA256, encodage base64. Le résultat est écrit dans calculatedHmac.
  3. IF : trois conditions, toutes vraies. calculatedHmac égal à l'en-tête x-shopify-hmac-sha256 ; l'en-tête x-shopify-shop-domain égal à votre boutique ; le sujet (x-shopify-topic) commence par customers/.
  4. Respond to Webhook : 200 sans corps si valide, 401 sinon. La réponse part avant l'appel HubSpot.
  5. Edit Fields « Préparer le contact » : l'e-mail est mis en minuscules ; l'objet properties est 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.
  6. 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).
  7. 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 teste numErrors et 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_id est unique, HubSpot refusera de lui attribuer la même valeur : vous recevrez une erreur (via le 207 dé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 email as the idProperty », 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 un idProperty personnalisé (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/update peut 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.

  1. Mêmes quatre premiers nœuds que le workflow 01, avec le chemin shopify-commande-payee et le sujet orders/paid.
  2. « 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.
  3. « Réglages de la transaction » : deux valeurs à vous, hubspot_pipeline (par défaut default) et hubspot_dealstage (par défaut closedwon). Ce sont des identifiants internes, pas des libellés. closedwon est 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é.
  4. « Préparer » : dealname = « Commande #1042 » (numéro Shopify), amount = total_price, closedate = date de traitement convertie en UTC, plus shopify_order_name.
  5. Upsert du contact par e-mail, puis upsert de la transaction : POST /crm/objects/2026-09/0-3/batch/upsert avec idProperty: shopify_order_id et l'identifiant de commande en id.
  6. 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 erreur 400 (donnée refusée) serait retentée trois fois sans changer de résultat. Contrepartie : un 429 ne 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/create et un ou deux orders/paid peuvent 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.

  1. Entrée identique aux workflows précédents, chemin shopify-segmentation.
  2. « Réglages de segmentation » : deux seuils, seuil_recurrent (2) et seuil_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.
  3. « Shopify : obtenir un jeton (client credentials) » : voir « Le jeton Shopify ». Retry On Fail est activé.
  4. HTTP Request GraphQL : POST https://YOUR_SHOP.myshopify.com/admin/api/2026-10/graphql.json, en-tête X-Shopify-Access-Token fourni par expression, corps JSON avec query et variables.
  5. « 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.
  6. « Préparer » : applique les seuils (fidele, recurrent, sinon nouveau) ; numberOfOrders est renvoyé en chaîne par Shopify, le workflow le convertit.
  7. 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_state est 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

  1. Lancez le workflow 00 et vérifiez les propriétés dans HubSpot.
  2. Remplacez les placeholders, publiez les workflows (04 d'abord), branchez l'Error workflow.
  3. 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.
  4. Faites un essai avec une adresse e-mail à vous, créée dans la boutique.
  5. 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/paid peut porter test: true, et le workflow 02 l'ignore alors sans erreur. Le webhook reçoit un 200 dans tous les cas, donc il ne risque pas la suppression.
  6. Essai du secret faux : modifiez un caractère du secret de la credential Crypto, envoyez un seul Send test (Shopify doit recevoir un 401 et rien ne doit arriver dans HubSpot), puis rétablissez le secret aussitôt : des 401 répétés peuvent faire supprimer le webhook.
  7. 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 429 de 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

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.

Cet arbitrage à poser sur votre cas plutôt que sur un exemple ? Décrivez votre situation en quelques lignes : je réponds sous 24–⁠48 h ouvrées, avec un avis franc sur ce qui vaut la peine d’être fait — y compris si ce n’est pas par moi.

Décrire mon besoin

Recevoir les nouveautés des outils qui vous concernent, chaque lundi.

← Tous les articles

Lien affilié

Ça ne vous coûte rien de plus.

Si vous souscrivez en passant par ce lien, l’éditeur me reverse une petite commission. Pour vous, le prix est exactement le même : pas de surcoût, pas d’engagement en plus.

C’est la façon la plus simple de soutenir le travail que vous venez de lire. La veille, les comparatifs et les guides de ce site sont gratuits, sans publicité, et le resteront.

Les recommandations, elles, ne dépendent pas des commissions : quand un outil gratuit ou une solution plus simple suffit, je le dis — même quand il n’y a rien à gagner.