Comment connecter Lemon Squeezy à l'Shopify Flow
Lemon Squeezy commercialise des produits numériques et des abonnements, et vous informe de chaque commande, abonnement et modification de licence. « Workflow Webhooks » transforme cet événement en déclencheur « Shopify Flow », afin que votre boutique puisse y réagir : attribuer une balise à un client, ajouter une note à la commande, envoyer un e-mail interne, mettre à jour un métachamp… tout ce qu’Shopify Flow, permet de faire.
Ce guide décrit l'ensemble du processus : Lemon Squeezy envoie les données, Workflow Webhooks les reçoit et les vérifie, puis Shopify Flow exécute les actions. La signature HMAC de Lemon Squeezy est vérifiée à chaque requête, de sorte que seul Lemon Squeezy puisse lancer votre workflow.
Ce que vous pouvez construire
- Marquez le client Shopify qui a également acheté un produit numérique, afin que les offres groupées et les segments correspondent.
- Veuillez indiquer le niveau de licence actif dans la fiche client sous forme de métachamp.
- Envoyez un e-mail à votre équipe lorsqu'un client ayant récemment passé des commandes sur Shopify résilie son abonnement.
Exemples d'événements à envoyer : order_created, subscription_created, subscription_cancelled, license_key_created.
Avant de commencer
- Workflow Webhooks installé sur votre boutique Shopify.
- Shopify Flow installée, disponible gratuitement sur la boutique d'Shopify.
- Un compte sur Lemon Squeezy disposant des autorisations nécessaires pour créer des webhooks.
Étape 1 - Créez le webhook sur Workflow Webhooks
- Accédez à Workflow Webhooks -> Webhooks -> Créer un webhook, puis attribuez-lui un nom que vous pourrez reconnaître dans Shopify Flow, tel que
Lemon Squeezy events. - Dans la section « Authentification », sélectionnez « HMAC ».
- Dans la rubrique « Fournisseur de signature », sélectionnez « Lemon Squeezy ». L'application remplit automatiquement les champs « en-tête », « algorithme », « payload signé » et « fenêtre de relecture » ; vous n'avez rien d'autre à configurer.
- Pour l'instant, ne renseignez pas le champ « Secret » et cliquez sur « Enregistrer ». Copiez l'URL du webhook affichée sur la page.
Consultez la page Authentification pour connaître les autres modes d'authentification, et la page Mappage de la charge utile et variables de flux pour savoir quels champs sont transmis à Shopify Flow.
Étape 2 - Ajoutez le point de terminaison dans Lemon Squeezy
Dans Lemon Squeezy, ouvrez « Paramètres » -> « Webhooks », ajoutez un webhook avec l'URL que vous avez copiée, sélectionnez les événements, puis saisissez une clé de signature.
Comment découvrir votre code secret pour la signature Lemon Squeezy
Le secret de signature que vous avez saisi lors de la création du webhook.
La documentation de Lemon Squeezy consacrée aux signatures de webhooks, disponible à l'adresse, contient le libellé exact et les captures d'écran correspondant à votre compte.
Collez ce secret dans le champ « Secret » du webhook à l'adresse Workflow Webhooks, puis enregistrez. À partir de ce moment, chaque livraison Lemon Squeezy est vérifiée avant d'arriver dans Shopify Flow.
Ce que cette vérification permet de contrôler
| Quoi ? | Valeur |
|---|---|
| En-tête de signature | X-Signature |
| Emplacement de la signature | La valeur complète de l'en-tête |
| Ce qui est signé | {body} |
| Signature | HMAC-SHA256, codé en hexadécimal |
| Horodatage | Non utilisé par cet expéditeur |
| Protection contre la relecture | Aucune - cet expéditeur ne signe pas l'horodatage ; par conséquent, toute signature valide reste valide |
| Le secret | À utiliser sous forme de texte brut. Copiez-collez-le exactement tel que l'expéditeur l'a indiqué. |
Dans la payload signée, {body} correspond au corps brut de la requête, octet par octet.
Toute requête qui ne respecte pas l'une de ces conditions est rejetée avec le message d'erreur 401, est enregistrée dans Historique et dépannage et ne déclenche jamais de workflow.
Étape 3 - Créer le workflow Shopify Flow
- Dans « Shopify Flow », créez un Workflow et sélectionnez le déclencheur «Workflow Webhooks».
- Cliquez sur « Enregistrer les événements », puis envoyez un événement test depuis Lemon Squeezy (ou utilisez l'option « Envoyer un test » dans Workflow Webhooks) afin que Shopify Flow apprenne la structure de vos données.
- Chaque webhook dont vous disposez déclenche le même déclencheur de Shopify Flow ; vous devez donc ajouter une première condition sur l'identifiant du webhook afin de limiter ce workflow à Lemon Squeezy uniquement. L'identifiant est indiqué sur la page du webhook.
- Ajoutez vos actions : identifiez un client, ajoutez une note, envoyez un e-mail interne, mettez à jour un métachamp.
Étape 4 - Testez-le de bout en bout
Déclenchez un événement réel dans Lemon Squeezy. Dans « Workflow Webhooks » -> « History », vous devriez voir l’appel avec le statut « Success ». Si la signature était incorrecte, vous obtiendrez à la place une entrée indiquant un échec avec la raison correspondante, et la page Vérification des webhooks signés explique le fonctionnement de l’outil de vérification de signature qui vous indique précisément quelle étape a échoué.
La signature ne correspond pas▾
Dans cette commande : le secret (la cause la plus courante : un espace supplémentaire ou une clé provenant d'un environnement incorrect), le fait que l'expéditeur utilise le secret d'un autre point de terminaison, et le fait que quelque chose entre Lemon Squeezy et l'application réécrive le corps du message. Les signatures portent sur les octets bruts ; par conséquent, un proxy qui reformate le JSON les invalide. Le testeur de signature disponible sur la page du webhook affiche le texte exact qui a été signé.
Je reçois une erreur 401 à chaque requête▾
Vérifiez que l'authentification du webhook est configurée sur HMAC avec le fournisseur Lemon Squeezy sélectionné, que le secret est renseigné et que Lemon Squeezy envoie ses requêtes à l'URL exactement telle qu'elle apparaît dans l'application, y compris le code à la fin.
Rien n'apparaît dans l'historique▾
La requête n'est jamais arrivée. Vérifiez à nouveau l'URL dans Lemon Squeezy et consultez le journal de livraison de Lemon Squeezy pour connaître la réponse reçue. Un message 404 indique un webhook incorrect ou supprimé, tandis qu'un message 429 signifie que vous avez dépassé la limite d'appels de votre forfait - voir Forfaits et utilisation.
The workflow runs for inappropriate events▾
Chaque webhook de votre boutique déclenche le même déclencheur Flow. Ajoutez une condition sur l'identifiant du webhook comme première étape du workflow, ou limitez les événements que vous envoyez depuis Lemon Squeezy.
Connexes
- Vérification des webhooks signés - tous les prestataires que nous vérifions, et comment décrire ceux que nous ne vérifions pas.
- Mappage de la charge utile et variables de flux - extraire les champs appropriés du payload et les transférer dans Shopify Flow.
- Protection contre les livraisons en double - Que se passe-t-il lorsque Lemon Squeezy effectue une nouvelle tentative de livraison ?
- Historique et dépannage - le journal de chaque requête, avec possibilité de relecture.