Geplande URL-controle

Een webhook wacht normaal gesproken tot iemand deze aanroept. Met een schema neemt de app het aanroepen voor haar rekening: zij haalt met een vaste frequentie een door u opgegeven URL op en stuurt het antwoord naar dezelfde webhook, zodat uw Shopify Flow-workflow op basis van een timer wordt uitgevoerd vanuit elke API die JSON, formuliergegevens of XML retourneert.

Typische toepassingen: elke 15 minuten de voorraadgegevens van een leverancier ophalen, elk uur in een ERP-systeem controleren of er nieuwe bestellingen zijn, of één keer per dag een status-eindpunt uitlezen en Shopify Flow hierop laten reageren.

Een systeem opzetten

Voor een nieuwe webhook kiest u ‘Webhook aanmaken’ en beantwoordt u de vraag ‘Wat activeert deze webhook?’ met ‘Niets - volgens een schema uitvoeren’. De webhook wordt aangemaakt met een geheim token, zodat niemand anders de URL ervan kan aanroepen, en wordt geopend op het tabblad ‘Schema’. Voor een webhook die u al hebt, opent u deze en gaat u naar het tabblad ‘Schema’. Vul vervolgens het volgende in:

Veld	Wat het doet
Ingeschakeld	Hiermee wordt het schema ingeschakeld. De webhook-URL blijft in beide gevallen functioneren.
URL	Het adres dat moet worden opgehaald. Uitsluitend `http` en `https`, en het moet bereikbaar zijn via het openbare internet.
Interval	Om de 5, 15 of 30 minuten, om de 1, 3, 6 of 12 uur, of één keer per dag.
Modus	Elke fetch-aanroep activeert Shopify Flow bij elke uitvoering. Alleen wanneer het antwoord verandert, wordt Shopify Flow geactiveerd, en wel uitsluitend wanneer de inhoud afwijkt van die van de vorige uitvoering.
Verzoekheaders	Optioneel, voor een API-sleutel of een bearer-token. Wordt versleuteld opgeslagen en wordt daarna nooit meer weergegeven.

De eerste uitvoering vindt plaats binnen een minuut nadat de functie is ingeschakeld.

De pagina ‘Webhook aanmaken’ met de vraag ‘Wat zal deze webhook activeren?’, waarbij de optie ‘Niets - volgens een schema uitvoeren’ is geselecteerd en de opmerking dat het tabblad ‘Schema’ vervolgens wordt geopend — Een nieuwe geplande webhook: antwoord met „Niets - volgens schema uitvoeren“ en het tabblad „Schema“ wordt geopend nadat u hebt opgeslagen.

Het tabblad ‘Schema’ met een op te halen URL, een interval van om de 6 uur en de optie ‘Alleen wanneer het antwoord verandert’ geselecteerd — Het tabblad ‘Schema’: de op te halen URL, de frequentie en of Shopify Flow bij elke opvraging wordt uitgevoerd of alleen wanneer het antwoord is gewijzigd.

De reactie in kaart brengen

De opgehaalde body doorloopt de webhook op precies dezelfde manier als een verzoek dat iemand u heeft gestuurd: deze wordt op inhoudstype geparseerd, uw veldtoewijzing selecteert de waarden die Shopify Flow ontvangt en er vindt een array-splitsing plaats indien deze is ingesteld.

Aangezien de API zelf de structuur van het antwoord bepaalt, wordt bij geplande uitvoeringen de controle op „onverwachte velden” overgeslagen, die wel van toepassing is op JSON-gegevens die door uw eigen systemen worden verzonden. U hoeft alleen de waarden toe te wijzen die voor u van belang zijn.

Example responsejson

{
  "updated_at": "2026-09-17T08:00:00Z",
  "items": [
    { "sku": "ABC-1", "stock": 4 },
    { "sku": "ABC-2", "stock": 0 }
  ]
}

Koppel updated_at aan een Shopify Flow-veld om het in uw workflow te gebruiken. Om elk item afzonderlijk te verwerken, stelt u het splitsingspad in op items onder ‘Geavanceerde instellingen’ - elk element start dan zijn eigen Shopify Flow-run. Zie Body-formaten en het opsplitsen van arrays.

Start nu

Met** ‘Nu uitvoeren’** wordt onmiddellijk een daadwerkelijke uitvoering gestart: de URL wordt opgehaald, u krijgt de HTTP-status, een voorbeeld van het antwoord en een overzicht van wat er is gebeurd (geactiveerd, ongewijzigd of een foutmelding) te zien, en Shopify Flow wordt geactiveerd als het antwoord bruikbaar is. Gebruik deze functie nadat u de URL of de headers hebt gewijzigd, in plaats van te wachten tot het volgende interval.

Pas wanneer de reactie verandert

In deze modus vergelijkt de app de opgehaalde body met de vorige en activeert Shopify Flow alleen wanneer er een verschil is. Gebruik deze modus voor eindpunten die hetzelfde document retourneren totdat er daadwerkelijk iets verandert, zoals een aandelen- of statusfeed. De vergelijking heeft betrekking op de volledige body, dus een API die in elk antwoord een tijdstempel of verzoek-ID opneemt, zal er elke keer anders uitzien.

Wanneer een planning mislukt

Het blok ‘Status’ op het tabblad toont de laatste uitvoering, de laatste HTTP-status, de volgende uitvoering en de laatste foutmelding.

Een netwerkfout, een statuscode anders dan 2xx of een body die niet kan worden geparseerd, wordt beschouwd als een mislukte uitvoering en leidt niet tot het activeren van Shopify Flow.
Na 20 mislukkingen op rij wordt de taak automatisch onderbroken en wordt dit gemeld, in plaats van dat er eindeloos een ongeldige URL wordt aangeroepen. Corrigeer de URL of de inloggegevens en schakel de taak vervolgens weer in.
Het bereiken van de limiet van uw abonnement wordt niet als een mislukking beschouwd. Die runs worden geblokkeerd en weergegeven op het dashboard.

Wat de app niet ophaalt

Alleen openbare adressen. Interne en privéadressen (localhost, privébereiken, eindpunten voor cloudmetadata) worden geweigerd, ook wanneer een omleiding naar een dergelijk adres verwijst. Reacties zijn beperkt tot 1 MB en 10 seconden, en er worden maximaal 3 omleidingen gevolgd. Uw headers worden verwijderd als een omleiding naar een andere site leidt.

Waar geplande ritten worden weergegeven

In History, met de bron ‘Scheduled’. Al het overige werkt zoals gewoonlijk: de payload, het resultaat van de Shopify Flow-trigger, herhalingspogingen en het opnieuw afspelen.