Guide · n8n
Webhook n8n : automatiser vos conversions
Subtraq sait d'où vient chaque conversion. Votre base, votre canal, votre facturier ne le savent pas encore. n8n attend exactement ce que Subtraq envoie : une adresse, et un JSON.
Tout le guide tient là-dedans
Subtraq
Installation → Brancher d'autres outils → Webhooks sortants
n8n
Nœud Webhook → POST → adresse de production
L'adresse est celle de n8n : vous la copiez sur le nœud Webhook, vous la collez dans Subtraq. À partir de là, chaque prospect ou chaque vente déclenche le workflow — sans nœud Subtraq à installer, sans communauté à attendre.
À lire avant de coller l'adresse
Un n8n auto-hébergé doit être joignable depuis l'extérieur
La raison n'est pas cosmétique : un webhook transporte des adresses email et des montants. Les envoyer en clair, ou vers une adresse que nous ne pouvons pas prouver, reviendrait à faire fuiter les données d'un client par confort de réglage.
n8n Cloud n'a pas ce problème. Sur une instance à vous, il faut un nom de domaine et un certificat — un serveur mandataire devant n8n suffit. Les redirections, elles, ne sont pas suivies : l'adresse enregistrée doit être celle qui répond.
Deux refus possibles, avant même le premier envoi
L'adresse d'un webhook sortant doit être en HTTPS, et elle ne peut pas viser un hôte privé. Une adresse en http, une adresse en 192.168.x.x ou en localhost sont refusées à l'enregistrement — et revérifiées avant chaque envoi.
Dans n8n, 6 étapes
Six étapes, et une adresse à ne pas confondre
n8n existe en version auto-hébergée et en offre infonuagique ; le nœud Webhook et le nœud HTTP Request sont des nœuds de base, présents dans les deux.
Dans n8n, posez un nœud « Webhook »
C'est le nœud qui reçoit un appel HTTP entrant. Méthode POST. Il affiche deux adresses : une de test et une de production — et la confusion entre les deux est la première cause de « ça ne se déclenche pas ».
Écoutez l'événement de test
Le bouton « Listen for test event » ouvre l'adresse de test pendant cent vingt secondes, d'après la documentation n8n, et montre les données reçues dans l'éditeur. C'est le moment de provoquer une conversion pour voir la forme du JSON.
Dans Subtraq, ajoutez le webhook sortant
Installation → Brancher d'autres outils → Webhooks sortants. Collez l'adresse de production de n8n, choisissez ce qui part — les prospects, les ventes, ou les deux — et si le webhook vaut pour un seul espace client ou pour toute l'agence.
Notez le secret de signature
Il s'affiche une seule fois, à la création. Chaque envoi porte l'en-tête X-Subtraq-Signature de la forme t=HORODATAGE,v1=SIGNATURE, où la signature est le HMAC-SHA256 de HORODATAGE point CORPS. Un nœud « Code » suffit à le vérifier.
Activez le workflow
L'adresse de production ne répond que sur un workflow publié. Un workflow laissé en brouillon renvoie une erreur à chaque envoi, et Subtraq la consigne à côté du webhook, avec sa date et son message.
Enchaînez ce que vous voulez derrière
Le JSON arrive découpé : l'email vers le CRM, le libellé du lien d'origine vers une colonne, le montant vers un message. C'est tout l'intérêt d'un workflow plutôt que d'une intégration figée.
Chemins relevés dans la documentation n8n le 12 septembre 2026 — le nœud Webhook et ses deux adresses. Une interface change : si ce que vous voyez ne correspond plus, la source fait foi.
Ce que reçoit le workflow
Un JSON signé, et un champ qui peut être vide
Un placement à null n'est pas un oubli : c'est une conversion que Subtraq n'a pas pu rattacher, et il le dit plutôt que d'inventer une origine. Prévoyez la branche : un nœud « If » qui sépare les deux cas évite d'écrire « undefined » dans la colonne d'un client.
Le montant arrive en centimes — 4 300 € s'écrivent 430000 — et il est nul sur un prospect. Divisez par cent au moment de l'afficher, jamais au moment de le stocker.
Les champs, tels que le code les écrit
event (lead ou sale) · at · space (slug et nom de l'espace) · person (email, identifiant externe) · placement (slug et libellé du lien d'origine, ou null si la conversion n'est pas attribuée) · amountMinor et currency pour une vente · eventId.
Dans l'autre sens
n8n sait aussi envoyer une vente à Subtraq
C'est le service que rendent peu d'outils : poser un en-tête d'autorisation. Shopify, WooCommerce et PrestaShop ne savent pas le faire sur leurs webhooks natifs. n8n, lui, en fait un type d'identifiants.
Le nœud « HTTP Request », en POST
Adresse https://subtraq.co/api/v1/sales. C'est le nœud qui émet une requête sortante, par opposition au nœud Webhook qui en reçoit une.
Des identifiants de type « Header auth »
n8n les liste parmi ses authentifications génériques. Nom de l'en-tête : Authorization. Valeur : Bearer suivi de la clé serveur Subtraq, celle qui commence par stq_sk_ et porte le droit events:write.
Cinq champs dans le corps
space, amount en centimes, currency, invoiceId, et au moins un moyen de retrouver la personne — email, externalId ou clickId. Subtraq répond 201 pour une vente nouvelle, 200 si l'identifiant de facture est déjà passé.
Le réglage qui vous évitera une nuit blanche
Sur le nœud, Settings puis « Retry On Fail », avec « Max Tries » et « Wait Between Tries ». Une API momentanément indisponible n'est pas une vente perdue si le nœud réessaie — et l'identifiant de facture garantit qu'un second passage ne compte pas deux fois.
Relevé dans la documentation du nœud HTTP Request et la page sur la gestion des erreurs, le 12 septembre 2026.
Les cas pénibles, traités franchement
Un automatisme se juge le jour où il tombe, pas le jour où on l'installe.
Un événement est perdu. Comment le rejouer ?
Deux réponses, et il faut les deux. Côté n8n : la liste des exécutions permet de relancer une exécution échouée, avec le workflow enregistré ou celui d'origine. Côté Subtraq : il n'y a pas de file d'attente — deux tentatives par envoi, puis l'échec est consigné à côté du webhook, avec sa date et son message. Un destinataire indisponible plusieurs minutes perd les envois de cette période ; la conversion, elle, reste enregistrée.
Mon workflow met vingt secondes. C'est un problème ?
Oui. L'envoi est abandonné au-delà de cinq secondes. Faites répondre le nœud Webhook immédiatement et travaillez ensuite : n8n sait renvoyer la réponse dès la réception et poursuivre le workflow derrière. Un workflow qui répond vite n'est pas un workflow qui fait peu.
Le workflow se déclenche deux fois sur la même conversion.
C'est possible : la seconde tentative part quand la première a échoué après avoir été traitée. Servez-vous du champ eventId, qui est stable : une étape qui refuse un identifiant déjà vu rend le workflow idempotent, exactement comme invoiceId le fait dans l'autre sens.
Faut-il vérifier la signature ?
Ce n'est pas obligatoire, c'est recommandé. Sans vérification, n'importe qui connaissant l'adresse de votre workflow peut lui envoyer de faux chiffres. L'horodatage entre dans le calcul : refusez ce qui est trop vieux et un envoi capturé ne pourra pas être rejoué indéfiniment.
Questions fréquentes
Faut-il un nœud Subtraq dans n8n ?
Non. n8n attend une adresse et un JSON dans un sens, et sait poser un en-tête dans l'autre. Rien à installer, rien à attendre d'un dépôt communautaire.
Cela marche-t-il sur n8n auto-hébergé ?
Oui, à une condition : l'adresse du workflow doit être en HTTPS et joignable depuis l'extérieur. Une adresse locale ou un réseau privé sont refusés.
Pourquoi mon adresse de test ne reçoit rien ?
Parce qu'elle n'est ouverte que cent vingt secondes après avoir cliqué « Listen for test event ». Pour brancher durablement, c'est l'adresse de production qu'il faut coller dans Subtraq, sur un workflow activé.
Peut-on n'envoyer que les ventes ?
Oui. Le webhook se règle sur les prospects, les ventes, ou les deux, et peut être limité à un seul espace client au lieu de toute l'agence.
Zapier, Make : même chose ?
Oui, le même JSON à l'adresse d'un déclencheur « recevoir un webhook ». Les deux ont leur guide, avec le chemin dans leur interface.
Une boutique à brancher, et pas d'en-tête à disposition ?
C'est exactement le travail de n8n : recevoir le webhook de la boutique, et appeler Subtraq avec l'autorisation que la boutique ne sait pas poser.
Le guide ShopifyCollez l'adresse dans votre workflow
Créez le compte, ajoutez le webhook sortant, collez l'adresse de production de n8n. Le premier prospect attribué déclenche le premier workflow.
Créer un compte gratuit