Inleiding tot Workflow Webhooks

Shopify Flow is krachtig, maar reageert alleen op gebeurtenissen binnen Shopify. Workflow Webhooks heft die beperking op. Het biedt u een beveiligd URL-eindpunt waarnaar externe systemen een POST-verzoek kunnen sturen - en wanneer zij dat doen, wordt uw Shopify Flow-workflow onmiddellijk geactiveerd, waarbij de payload-gegevens worden doorgegeven als bruikbare variabelen.

Workflow Webhooks

Hoe het werkt

  • Uw externe tool verzendt een HTTP POST-verzoek naar de URL van uw webhook met een JSON-payload (bijv. naam, e-mailadres, vraag). Werkt met n8n, Make, Zapier of elke andere tool die HTTP ondersteunt.
  • Workflow Webhooks ontvangt het, verifieert het verzoek en registreert het met de volledige headers in de payload, waarna de gekoppelde trigger Shopify Flow wordt geactiveerd.
  • Shopify Flow zorgt ervoor dat uw automatisering wordt uitgevoerd - een klant taggen, een e-mail versturen, een metaveld - het gebruik van de payload-gegevens als benoemde variabelen ({{fieldOne}}, {{fieldTwo}}, {{fieldThree}}, {{fieldFour}}). U kunt ook aanvullende gegevens versturen door het vakje aan te vinken Beveiliging -> Aangepaste verzoektekst toestaan voor de webhook.
  • Eén webhook-eindpunt kan elke Shopify Flow-automatisering aansturen.

De voltooide workflow: Webhook-trigger, een voorwaarde op basis van de webhook-ID, gevolgd door het verzenden van een interne e-mail in de „True“-tak
Een verzoek aan de URL van uw webhook zet een Shopify Flow-workflow in gang. De voorwaarde zorgt ervoor dat er slechts één webhook wordt gebruikt; de actie is alles wat Shopify Flow kan uitvoeren.

Kenmerken

Functie Beschrijving
Webhook-triggers voor Shopify Flow Beveiligde HTTP-eindpunten waarmee op verzoek automatiseringen van Shopify Flow kunnen worden gestart
Variabele toewijzing Koppel de velden van de payload aan Shopify Flow-variabelen en verwijs ernaar als {{fieldOne}}, {{fieldTwo}}, enz.
Authenticatie Statisch token (eenvoudig) of HMAC SHA256 (manipulatiebestendig)
Overzicht van aanroepingen Volledig logboek van elk verzoek - tijdstempel, payload, headers en status
Support voor CORS Inschakelen voor browsergebaseerde of frontend-integraties
Aangepaste verzoektekst voor klanten Flexibele payload-structuren van platforms van derden accepteren
Webhook-dashboard Beheer, monitor en test alle eindpunten op één plek
Bescherming tegen dubbele invoer Negeer herhaalde verzendingen met een gebeurtenis-ID die u al hebt gezien

Authenticatie

Methode Hoe het werkt Het meest geschikt voor
Geen Geen authenticatie Alleen voor testdoeleinden, niet voor productie
Statisch token ✓ Token in de header X-Api-Key gecorrigeerd De meeste integraties (n8n, Make, Zapier)
HMAC SHA256 Handtekening op basis van de payload en de geheime sleutel Hoge beveiliging of naleving

Variabele toewijzing

Workflow Webhooks Hiermee kunt u velden in uw inkomende JSON-payload koppelen aan benoemde variabelen die Shopify Flow kan gebruiken. U kunt maximaal 4 veldnamen definiëren op het tabblad ‘Geavanceerde instellingen’. U kunt ook aanvullende gegevens verzenden door het vakje bij ‘Beveiliging’ -> ‘Aangepaste verzoektekst toestaan’ aan te vinken.

Veld in de app Uw payload-sleutel Verwijzing in Shopify Flow
Veld 1 name {{fieldOne}}
Veld 2 email {{fieldTwo}}
Veld 3 question {{fieldThree}}
Veld 4 other {{fieldFour}}
Het paneel ‘Een variabele toevoegen’ van Shopify Flow voor de Webhook-trigger, waarin webhookId en fieldOne tot en met fieldFour worden weergegeven met voorbeeldwaarden uit een recent verzoek
Wat de trigger aan uw workflow doorgeeft: de webhook-ID en uw vier toegewezen velden, weergegeven met de waarden van een recent verzoek.

Bescherming tegen dubbele leveringen

De meeste systemen proberen een webhook opnieuw te verzenden wanneer zij geen snel antwoord ontvangen. Als de eerste poging daadwerkelijk is aangekomen, wordt uw Shopify Flow-workflow twee keer uitgevoerd voor dezelfde gebeurtenis - een tweede e-mail, een tweede tag, een dubbele notitie.

Indien uw verzendsysteem per gebeurtenis een unieke ID bevat, dient u die header te benoemen onder ‘Geavanceerde instellingen’ -> ‘Detectie van dubbele verzendingen’ in de webhook; herhalingen worden dan genegeerd.

Gedrag
Eerste verzoek met een bepaalde id Bij normale verwerking ontstaat er een stroom van vlammen
Herhaal dit binnen 24 uur 200 OK met duplicate: true - niet verzonden naar Shopify Flow
Andere ID Normaal verwerkt
Er is geen dergelijke header in het verzoek Normaal verwerkt

Veelvoorkomende koptekstnamen: Event-Id, Idempotency-Key, X-Request-Id. Bij het zoeken wordt geen onderscheid gemaakt tussen hoofdletters en kleine letters.

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"}'

Veelvoorkomende toepassingen

  • Een klant in de Shopify-omgeving taggen of bijwerken wanneer een formulier extern wordt ingediend
  • Acties voor bestellingen of afhandeling activeren vanuit een n8n- of Make-workflow
  • Synchroniseer contactgegevens uit een CRM-systeem of helpdesk met Shopify wanneer er wijzigingen in een record worden aangebracht
  • Start een Shopify Flow wanneer een Zapier-automatisering is voltooid
  • Automatische activeringen vanuit een frontend-formulier (met CORS ingeschakeld)
  • Vervang meerdere integraties voor één specifiek doel door één centrale webhook-manager

Stapsgewijze integratiehandleidingen

  1. Hoe koppelt u n8n aan Workflow Webhooks?
  2. Hoe u Make kunt koppelen aan Workflow Webhooks
  3. Hoe koppelt u Zapier aan Workflow Webhooks?

Wat merchants zeggen

"Deze app maakt Shopify Flow vijf keer zo nuttig. De ontwikkelaar is heel gemakkelijk te bereiken." "en buitengewoon nuttig." - SuperFast Startup, Portugal

"Het ontbrekende stukje voor Shopify Flow - u hebt slechts één Shopify Flow nodig om met alle "uw webhooks." - Senkels, Oostenrijk

"Precies wat ik probeerde op te lossen met behulp van een aantal apps van derden. Zeer "aanbevelen." - Aloha Tinyboards, Verenigde Staten

Installeren

Installeer Workflow Webhooks via de App Store van Shopify

Support

Heeft u hulp nodig? Ga dan naar Support of maak gebruik van het chatballonnetje op een willekeurige pagina van de app in uw Shopify-beheerdersgedeelte.