Introduksjon til Workflow Webhooks

Introduksjon til Workflow Webhooks

Kopier side

Workflow Webhooks gir deg sikre HTTP-endepunkter som setter i gang Shopify Flow-arbeidsflyter, der dataene overføres som Shopify Flow-variabler.

Shopify Flow er kraftig, men reagerer kun på hendelser inne i Shopify. Workflow Webhooks fjerner denne begrensningen. Det gir deg et sikkert URL-endepunkt som eksterne systemer kan sende POST-forespørsler til - og når de gjør det, utløses Shopify Flow-arbeidsflyten din umiddelbart, med dataene fra forespørselen overført som brukbare variabler.

Workflow Webhooks

Slik fungerer det

  • Det eksterne verktøyet ditt sender en HTTP POST-forespørsel til webhook-URL-en din med en JSON-datamengde (f.eks. navn, e-postadresse, spørsmål). Fungerer med n8n, Make, Zapier eller ethvert verktøy som støtter HTTP.
  • Workflow Webhooks mottar den, autentiserer forespørselen og loggfører den med alle overskrifter og nyttelast, og utløser deretter den tilknyttede Shopify Flow-utløseren.
  • Shopify Flow styrer automatiseringen din - merk en kunde, send en e-post, oppdater en metafelt - bruk av nyttedataene som navngitte variabler ({{fieldOne}}, {{fieldTwo}}, {{fieldThree}}, {{fieldFour}}). Du kan også sende tilleggsdata hvis du merker av for Sikkerhet -> Tillat tilpasset forespørselstekst i webhooken.
  • Ett webhook-endepunkt kan drive hvilken som helst automatisering i Shopify Flow.

Den ferdige arbeidsflyten: Webhook-utløser, et vilkår basert på webhook-ID-en, deretter «Send intern e-post» i «True»-grenen
En forespørsel til webhook-URL-en din setter i gang en Shopify Flow-arbeidsflyt. Betingelsen begrenser den til én webhook; handlingen er alt det Shopify Flow kan utføre.

Funksjoner

Funksjon Beskrivelse
Webhook-utløsere for Shopify Flow Sikre HTTP-endepunkter som starter enhver Shopify Flow-automatisering på forespørsel
Variabelkartlegging Tilordne feltene i dataene til Shopify Flow-variabler, og referer til dem som {{fieldOne}}, {{fieldTwo}} osv.
Autentisering Statisk token (enkel) eller HMAC SHA256 (manipulasjonssikker)
Historikk over påkallelser Fullstendig logg over alle forespørsler - tidsstempel, nyttelast, overskrifter og status
Støtte for CORS Aktiver for nettleserbaserte eller frontend-integrasjoner
Tilpasset forespørselstekst Støtte fleksible nyttelaststrukturer fra tredjepartsplattformer
Webhook-oversikten Administrer, overvåk og test alle endepunkter på ett sted
Beskyttelse mot duplikater Ignorer gjentatte leveranser som har en hendelses-ID du allerede har sett

Autentisering

Metode Slik fungerer det Best egnet for
Ingen Ingen autentisering Kun testing, ikke produksjon
Statisk token ✓ Rettet token i X-Api-Key-overskriften De fleste integrasjoner (n8n, Make, Zapier)
HMAC SHA256 Signatur fra nyttelast + hemmelig nøkkel Høy sikkerhet eller samsvar

Variabelkartlegging

Med Workflow Webhooks kan du tilordne felt i den innkommende JSON-dataen til navngitte variabler som Shopify Flow kan bruke. Definer opptil 4 feltnavn under fanen «Avanserte innstillinger». Du kan også sende tilleggsdata hvis du merker av for Sikkerhet → Tillat tilpasset forespørselstekst.

Felt i appen Din nyttelastnøkkel Referanse i Shopify Flow
Felt 1 name {{fieldOne}}
Felt 2 email {{fieldTwo}}
Felt 3 question {{fieldThree}}
Felt 4 other {{fieldFour}}
Shopify Flow
Hva utløseren sender til arbeidsflyten din: webhook-ID-en og de fire tilordnede feltene dine, vist sammen med verdiene fra en nylig forespørsel.

Beskyttelse mot dobbeltlevering

De fleste systemer prøver på nytt med en webhook når de ikke får et raskt svar. Hvis det første forsøket faktisk kom frem, kjører Shopify Flow-arbeidsflyten din to ganger for den samme hendelsen - en ekstra e-post, en ekstra tag, en duplisert notat.

Hvis sendesystemet ditt inneholder en unik ID for hver hendelse, må du oppgi denne i feltet under Avanserte innstillinger → Deteksjon av dupliserte leveranser i webhooken, slik at gjentakelser blir ignorert.

Atferd
Første forespørsel med en gitt ID Behandles som vanlig, utløser Shopify Flow
Gjenta innen 24 timer 200 OK med duplicate: true - sendes ikke til Shopify Flow
Annet ID Behandlet som vanlig
Det finnes ingen slik overskrift i forespørselen Behandlet som vanlig

Vanlige navn på overskrifter: Event-Id, Idempotency-Key, X-Request-Id. Sammenligningen tar ikke hensyn til store og små bokstaver.

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

Vanlige bruksområder

  • Merk eller oppdater en Shopify-kunde når et skjema sendes inn eksternt
  • Utløs ordre- eller oppfyllingshandlinger fra en n8n- eller Make-arbeidsflyt
  • Synkroniser kontaktdata fra et CRM-system eller en helpdesk til Shopify når en oppføring endres
  • Start en Shopify Flow-prosess når en Zapier-automatisering er fullført
  • Brannautomatiseringer fra et frontend-skjema (med CORS aktivert)
  • Erstatt flere integrasjoner med ett enkelt formål med én samlet webhook-administrator

Trinnvise veiledninger for integrasjon

  1. Slik kobler du n8n til Workflow Webhooks
  2. Slik kobler du Make til Workflow Webhooks
  3. Slik kobler du Zapier til Workflow Webhooks

Hva forhandlerne sier

«Denne appen gjør Shopify Flow fem ganger mer nyttig. Det er veldig enkelt å komme i kontakt med utvikleren.» «… og svært nyttig.» - SuperFast Startup, Portugal

«Den manglende brikken i Shopify Flow - du trenger bare én Shopify Flow for å jobbe med alle «webhookene dine.» - Senkels, Østerrike

«Akkurat det jeg prøvde å løse ved hjelp av en rekke apper fra tredjeparter. Veldig «anbefaler.» - Aloha Tinyboards, USA

Installer

Installer Workflow Webhooks fra Shopify App Store

Støtte

Trenger du hjelp? Se Støtte, eller bruk chat-boblen på en hvilken som helst side i appen i Shopify-administrasjonspanelet.