Présentation d'Workflow Webhooks

Shopify Flow est puissant, mais il ne réagit qu'aux événements survenant au sein d'Shopify. Workflow Webhooks supprime cette limitation. Il vous fournit un point de terminaison URL sécurisé vers lequel les systèmes externes peuvent envoyer des requêtes POST ; lorsqu'ils le font, votre workflow Shopify Flow se déclenche instantanément, les données du payload étant transmises sous forme de variables exploitables.

Workflow Webhooks

Comment cela fonctionne-t-il ?

  • Votre outil externe envoie une requête HTTP POST à l'URL de votre webhook avec une charge utile au format JSON (par exemple : nom, e-mail, question). Compatible avec n8n, Make, Zapier ou tout autre outil prenant en charge le protocole HTTP.
  • Workflow Webhooks la reçoit, authentifie la requête, l'enregistre avec l'intégralité des en-têtes et la charge utile, puis déclenche le déclencheur associé Shopify Flow.
  • Shopify Flow gère votre automatisation : associez un client à une balise, envoyez un e-mail, mettez à jour un métachamp - utilisation des données de la charge utile en tant que variables nommées ({{fieldOne}}, {{fieldTwo}}, {{fieldThree}}, {{fieldFour}}). Vous pouvez également envoyer des données supplémentaires si vous cochez la case Sécurité -> Autoriser le corps de requête personnalisé sur le webhook.
  • Un seul point de terminaison de webhook peut prendre en charge n'importe quelle automatisation Shopify Flow.

Le workflow final : Déclencheur Webhook, une condition sur l'ID du webhook, puis envoi d'un e-mail interne sur la branche « True »
Une requête adressée à l'URL de votre webhook déclenche un workflow Shopify Flow. La condition limite ce workflow à un seul webhook ; l'action correspond à tout ce que Shopify Flow est en mesure de faire.

Caractéristiques

Fonctionnalité Description
Déclencheurs de webhooks pour Shopify Flow Points de terminaison HTTP sécurisés permettant de lancer à la demande toute automatisation d'Shopify Flow
Mappage des variables Mettez en correspondance les champs de la charge utile avec les variables Shopify Flow, en les désignant par exemple comme {{fieldOne}}, {{fieldTwo}}, etc.
Authentification Jeton statique (simple) ou HMAC SHA-256 (inviolable)
Historique des invocations Journal complet de chaque requête : horodatage, payload, en-têtes et statut
Assistance pour CORS Activer les intégrations via navigateur ou front-end
Corps de la requête personnalisé Prendre en charge les structures de payload flexibles provenant de plateformes tierces
Tableau de bord des webhooks Gérez, surveillez et testez tous les terminaux depuis un seul et même endroit
Protection contre les doublons Ignorez les livraisons en double dont l'identifiant d'événement vous est déjà connu

Authentification

Méthode Comment cela fonctionne-t-il ? Idéal pour
Aucun Aucune authentification À des fins de test uniquement, pas en production
Jeton statique ✓ Correction du jeton dans l'en-tête X-Api-Key La plupart des intégrations (n8n, Make, Zapier)
HMAC SHA-256 Signature à partir de la payload et de la clé secrète Haute sécurité ou conformité

Mappage des variables

Workflow Webhooks vous permet d'associer les champs de votre payload JSON entrant à des variables nommées que Shopify Flow peut utiliser. Définissez jusqu'à 4 noms de champs dans l'onglet « Paramètres avancés ». Vous pouvez également envoyer des données supplémentaires si vous cochez « Sécurité -> Autoriser le corps de requête personnalisé ».

Champ dans l'application Votre clé de payload Référence dans Shopify Flow
Champ 1 name {{fieldOne}}
Champ 2 email {{fieldTwo}}
Champ 3 question {{fieldThree}}
Champ 4 other {{fieldFour}}
Panneau « Ajouter une variable » de Shopify Flow pour le déclencheur Webhook, répertoriant les champs webhookId et fieldOne à fieldFour avec des exemples de valeurs issues d'une requête récente
Ce que le déclencheur transmet à votre workflow : l'identifiant du webhook et vos quatre champs mappés, accompagnés des valeurs d'une requête récente.

Protection contre les livraisons en double

La plupart des systèmes réessaient d'envoyer un webhook lorsqu'ils ne reçoivent pas de réponse rapide. Si la première tentative a bien été reçue, votre workflow Shopify Flow s'exécute deux fois pour le même événement : un deuxième e-mail, une deuxième balise, une note en double.

Si votre système d'envoi inclut un identifiant unique par événement, nommez cet en-tête dans « Paramètres avancés » -> « Détection des doublons » sur le webhook ; les doublons seront alors ignorés.

Comportement
Première requête avec un identifiant donné Traité normalement, les incendies se propagent
Répétez l'opération dans les 24 heures 200 OK avec duplicate: true - non envoyé vers Shopify Flow
Identifiant différent Traité normalement
L'en-tête n'apparaît pas dans la requête Traité normalement

Noms d'en-têtes courants : Event-Id, Idempotency-Key, X-Request-Id. La correspondance ne tient pas compte de la casse.

bash
# Second call with the same Event-Id is accepted but not re-sent to Flow
curl -X POST https://.../webhook/<short> \
  -H "Content-Type: application/json" \
  -H "Event-Id: evt_12345" \
  -d '{"orderId":"1001"}'

Cas d'utilisation courants

  • Marquer ou mettre à jour un client Shopify lorsqu'un formulaire est soumis en externe
  • Déclencher des actions liées aux commandes ou au traitement des commandes à partir d'un workflow n8n ou Make
  • Synchroniser les données de contact depuis un CRM ou un service d'assistance vers Shopify dès qu'une fiche est modifiée
  • Lancer une action Shopify Flow lorsqu'une automatisation Zapier est terminée
  • Déclenchement d'automatisations depuis un formulaire front-end (avec CORS activé)
  • Remplacez plusieurs intégrations à usage unique par un gestionnaire de webhooks unifié

Guides d'intégration étape par étape

  1. Comment connecter n8n à Workflow Webhooks
  2. Comment connecter Make à Workflow Webhooks
  3. Comment connecter Zapier à Workflow Webhooks

Ce qu'en disent les marchands

« Cette application rend Shopify Flow cinq fois plus utile. Le développeur est très facile à joindre. » « et extrêmement utile. » - SuperFast Startup, Portugal

« La pièce manquante d'Shopify Flow : un seul Shopify Flow suffit pour travailler avec tous les... » « vos webhooks. » - Senkels, Autriche

« C'est exactement ce que j'essayais de résoudre à l'aide de plusieurs applications tierces. Vraiment « Je le recommande. » - Aloha Tinyboards, États-Unis

Installer

Installez Workflow Webhooks depuis l'App Store d'Shopify

Assistance

Besoin d'aide ? Consultez la page Assistance ou utilisez la bulle de discussion disponible sur n'importe quelle page de l'application dans votre espace d'Shopify.