Workflow WebhooksWorkflow Webhooks

Hoe u WooCommerce kunt koppelen aan Shopify Flow

WooCommerce kan een Webhook verzenden voor bestellingen, producten, klanten en kortingsbonnen vanuit een WordPress-webwinkel. Workflow Webhooks zet die oproep om in een Trigger voor Shopify Flow, zodat uw webwinkel hierop kan reageren: een klant taggen, een opmerking bij een bestelling toevoegen, een interne e-mail versturen, een metaveld bijwerken - alles Shopify Flow kan doen.

Deze handleiding beschrijft het volledige proces - WooCommerce verzendt, Workflow Webhooks ontvangt en verifieert, Shopify Flow voert de actie uit - waarbij bij elk verzoek de HMAC-handtekening van WooCommerce wordt gecontroleerd, zodat alleen WooCommerce uw workflow kan starten.

Wat u kunt bouwen

  • Importeer een bestelling uit een WooCommerce-winkel in Shopify Flow: koppel de bijbehorende klant of voeg een opmerking toe.
  • Zorg ervoor dat uw klantenbestand up-to-date blijft terwijl u van WooCommerce naar Shopify migreert.
  • Reageer in Shopify wanneer een product in WooCommerce niet meer op voorraad is.

Voorbeelden van gebeurtenissen die u kunt doorgeven: order.created, order.updated, product.updated, customer.created.

Voordat u begint

  • Workflow Webhooks geïnstalleerd in uw Shopify-winkel.
  • Shopify Flow geïnstalleerd, dat gratis te downloaden is via de App Store op Shopify.
  • Een account op WooCommerce met toestemming om webhooks aan te maken.

Stap 1 - Maak de webhook aan op Workflow Webhooks

  1. Ga naar Workflow Webhooks -> Webhooks -> Maak een webhook aan en geef deze een naam die u in Shopify Flow zult herkennen, zoals WooCommerce events.
  2. Kies onder „Authenticatie” de optie „HMAC”.
  3. Kies onder ‘Signature provider’ voor WooCommerce. De app vult de header, het algoritme, de ondertekende payload en het replay-venster automatisch voor u in - u hoeft verder niets meer in te stellen.
  4. Laat het veld ‘geheim’ voorlopig leeg en klik op ‘Opslaan’. Kopieer de webhook-URL die op de pagina wordt weergegeven.

Zie Authenticatie voor de overige authenticatiemodi en Toewijzing van payloads en Flow-variabelen voor informatie over welke velden naar Shopify Flow worden verzonden.

Stap 2 - Voeg het eindpunt toe in WooCommerce

Open in WordPress WooCommerce -> Instellingen -> Geavanceerd -> Webhooks, voeg een webhook toe met de URL als ‘Delivery URL’ en stel de ‘Secret’ in.

Hoe u uw WooCommerce-ondertekeningsgeheim kunt vinden

De instelling voor de webhook in The Secret (WooCommerce -> Instellingen -> Geavanceerd -> Webhooks).

In de officiële documentatie van WooCommerce over webhook-handtekeningen vindt u de exacte bewoordingen en schermafbeeldingen voor uw account.

Plak dat geheim in het veld ‘Secret’ van de webhook op Workflow Webhooks en sla het op. Vanaf dat moment wordt elke WooCommerce-levering geverifieerd voordat deze bij Shopify Flow terechtkomt.

Wat hiermee wordt gecontroleerd

Wat Waarde
Handtekeningkoptekst X-WC-Webhook-Signature
Waar de handtekening staat De volledige waarde van de header
Wat is ondertekend? {body}
Handtekening HMAC-SHA256, gecodeerd met Base64
Tijdstempel Wordt niet gebruikt door deze afzender
Bescherming tegen herhaling Geen - deze afzender ondertekent geen tijdstempel, zodat elke geldige handtekening geldig blijft
Het geheim Wordt als platte tekst gebruikt. Plak de tekst precies zoals de afzender deze weergeeft

In de ondertekende payload is {body} de onbewerkte inhoud van het verzoek, byte voor byte.

Een verzoek dat aan een van deze voorwaarden niet voldoet, wordt afgewezen met de foutmelding 401, wordt geregistreerd in Geschiedenis en probleemoplossing en leidt nooit tot het starten van een workflow.

Stap 3 - Stel de workflow Shopify Flow samen

  1. Maak in ‘Shopify Flow’ een workflow aan en kies de trigger ‘Workflow Webhooks’.
  2. Klik op ‘Gebeurtenissen vastleggen’ en verstuur vervolgens een testgebeurtenis vanuit WooCommerce (of gebruik de optie ‘Test verzenden’ in Workflow Webhooks), zodat Shopify Flow de structuur van uw gegevens leert kennen.
  3. Elke webhook die u bezit, activeert dezelfde Shopify Flow-trigger; voeg daarom een eerste voorwaarde toe op basis van de webhook-ID om deze workflow uitsluitend voor WooCommerce te reserveren. De ID wordt weergegeven op de webhook-pagina.
  4. Voeg uw acties toe - markeer een klant, voeg een notitie toe, verstuur een interne e-mail, werk een metaveld bij.
Shopify Flow
Kies in Shopify Flow de optie ‘Select a trigger’, open Workflow Webhooks en selecteer ‘Webhook Trigger’.
Een Shopify Flow-voorwaarde: de webhook-ID is gelijk aan de ID van één webhook
De eerste stap van elke workflow: een voorwaarde op basis van de webhook-ID, zodat de workflow uitsluitend voor deze webhook wordt uitgevoerd.
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
De voltooide workflow: trigger, voorwaarde op basis van de webhook-ID, gevolgd door uw actie in de ‘True’-tak.

Stap 4 - Test het van begin tot eind

Activeer een daadwerkelijke gebeurtenis in WooCommerce. Onder ‘Workflow Webhooks’ -> ‘History’ zou u de aanroep moeten zien met de status ‘Success’. Indien de handtekening onjuist was, krijgt u in plaats daarvan een mislukte vermelding met de reden te zien, en op Gecertificeerde webhooks verifiëren vindt u uitleg over de handtekeningtester die u precies laat zien welke stap is mislukt.

Eén aanroep is geopend in History, met de verzoekheaders, de payload, de status, de duur en de identificatiegegevens
Een voltooide gebeurtenis in History: de status ‘Succes’ betekent dat Shopify Flow deze heeft geaccepteerd.
De handtekening komt niet overeen▾

In deze bestelling: het geheim (de meest voorkomende oorzaak - een extra spatie of een sleutel uit de verkeerde omgeving), of de afzender het geheim van een ander eindpunt gebruikt, en of er iets tussen WooCommerce en de app staat dat de body herschrijft. Handtekeningen hebben betrekking op de ruwe bytes, dus een proxy die JSON opnieuw opmaakt, maakt ze ongeldig. De handtekeningcontrole op de webhook-pagina toont de exacte tekst die is ondertekend.

Bij elk verzoek krijg ik een 401-foutmelding▾

Controleer of de authenticatie van de webhook is ingesteld op HMAC met de WooCommerce-provider geselecteerd, of het geheim is ingevuld en of WooCommerce gegevens naar de URL verstuurt precies zoals deze in de app wordt weergegeven, inclusief de code aan het einde.

Er wordt niets weergegeven in de geschiedenis▾

Het verzoek is nooit aangekomen. Controleer de URL in WooCommerce nogmaals en bekijk het eigen leveringslogboek van WooCommerce om te zien welk antwoord het heeft ontvangen. Een 404 duidt op een onjuiste of verwijderde webhook, een 429 betekent dat u de limiet voor het aantal aanroepen van uw abonnement hebt overschreden - zie Abonnementen en gebruik.

De workflow wordt voor de verkeerde gebeurtenissen uitgevoerd▾

Elke webhook in uw winkel activeert dezelfde Shopify Flow-trigger. Voeg als eerste stap van de workflow een voorwaarde toe op basis van de webhook-ID, of beperk de gebeurtenissen die u vanuit WooCommerce verstuurt.

Gerelateerd