Introduktion till Workflow Webhooks

Introduktion till Workflow Webhooks

Kopiera sidan

Workflow Webhooks erbjuder säkra HTTP-ändpunkter som startar Shopify Flow-arbetsflöden, där data överförs som Shopify Flow-variabler.

Shopify Flow är kraftfullt, men det reagerar endast på händelser inom Shopify. Workflow Webhooks tar bort den begränsningen. Det ger dig en säker URL-ändpunkt som externa system kan skicka POST-förfrågningar till - och när de gör det aktiveras ditt Shopify Flow-arbetsflöde omedelbart, med data från förfrågan som skickas in som användbara variabler.

Workflow Webhooks

Så här fungerar det

  • Ditt externa verktyg skickar en HTTP POST-förfrågan till din webhook-URL med en JSON-datamängd (t.ex. namn, e-postadress, fråga). Fungerar med n8n, Make, Zapier eller vilket verktyg som helst som stöder HTTP.
  • Workflow Webhooks tar emot den, verifierar begäran och loggar den med fullständiga rubriker och nyttolast, varefter den kopplade Shopify Flow-utlösaren aktiveras.
  • Shopify Flow sköter din automatisering - märk en kund, skicka ett e-postmeddelande, uppdatera en metafält - användning av nyttolastdata som namngivna variabler ({{fieldOne}}, {{fieldTwo}}, {{fieldThree}}, {{fieldFour}}). Du kan också skicka ytterligare data om du markerar rutan Säkerhet -> Tillåt anpassad begärantext i webhooken.
  • En enda webhook-ändpunkt kan driva vilken Shopify Flow-automatisering som helst.

Det färdiga arbetsflödet: Webhook-utlösare, ett villkor baserat på webhook-ID:t, följt av att ett internt e-postmeddelande skickas i ”True”-grenen
En förfrågan till din webhook-URL startar ett arbetsflöde i Shopify Flow. Villkoret begränsar det till en enda webhook; åtgärden är vad Shopify Flow kan utföra.

Funktioner

Funktion Beskrivning
Webhook-utlösare för Shopify Flow Säkra HTTP-ändpunkter som startar valfri Shopify Flow-automatisering på begäran
Variabelmappning Koppla fälten i datauppsättningen till Shopify Flow-variabler och hänvisa till dem som {{fieldOne}}, {{fieldTwo}} osv.
Autentisering Statisk token (enkel) eller HMAC SHA256 (manipuleringssäker)
Användningshistorik Fullständig logg över varje förfrågan - tidsstämpel, datainnehåll, rubriker och status
Stöd för CORS Aktivera för webbläsarbaserade eller frontend-integrationer
Anpassad förfrågningstext Stöd för flexibla nyttolaststrukturer från tredjepartsplattformar
Webhook-instrumentpanelen Hantera, övervaka och testa alla enheter på ett och samma ställe
Skydd mot dubbletter Bortse från upprepade leveranser som har ett händelse-ID som du redan har sett

Autentisering

Metod Så här fungerar det Bäst för
Inget Ingen autentisering Endast test, inte produktion
Statisk token ✓ Korrigering av token i rubriken X-Api-Key De flesta integrationerna (n8n, Make, Zapier)
HMAC SHA256 Signatur från nyttolast + hemlig nyckel Hög säkerhet eller efterlevnad

Variabelmappning

Med Workflow Webhooks kan du koppla fält i din inkommande JSON-data till namngivna variabler som Shopify Flow kan använda. Ange upp till fyra fältnamn på fliken Avancerade inställningar. Du kan även skicka ytterligare data om du markerar Säkerhet -> Tillåt anpassad förfrågningstext.

Fält i appen Din nyttolastnyckel Referens i Shopify Flow
Fält 1 name {{fieldOne}}
Fält 2 email {{fieldTwo}}
Fält 3 question {{fieldThree}}
Fält 4 other {{fieldFour}}
Shopify Flow
Vad utlösaren skickar vidare till ditt arbetsflöde: webhook-ID:t och dina fyra mappade fält, visade tillsammans med värdena från en nyligen gjord begäran.

Skydd mot dubbla leveranser

De flesta system gör ett nytt försök med en webhook om de inte får ett snabbt svar. Om det första försöket faktiskt nådde fram körs ditt Shopify Flow-arbetsflöde två gånger för samma händelse - ett andra e-postmeddelande, en andra tagg, en dubbel anteckning.

Om ditt sändningssystem innehåller ett unikt ID per händelse ska du ange det som rubrik under Avancerade inställningar → Detektering av dubbla leveranser i webhooken, så ignoreras upprepningar.

Beteende
Första förfrågan med ett visst ID Vid normal hantering utlöser det Shopify Flow
Upprepa inom 24 timmar 200 OK med duplicate: true - skickas inte till Shopify Flow
Ett annat ID Behandlas på vanligt sätt
Det finns ingen sådan rubrik i förfrågan Behandlas på vanligt sätt

Vanliga rubriknamn: Event-Id, Idempotency-Key, X-Request-Id. Vid matchning beaktas inte storlekar på bokstäver.

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

Vanliga användningsfall

  • Märk eller uppdatera en Shopify-kund när ett formulär skickas in externt
  • Aktivera order eller leveransåtgärder från ett n8n- eller Make-arbetsflöde
  • Synkronisera kontaktuppgifter från ett CRM-system eller en helpdesk till Shopify när en post ändras
  • Starta en Shopify Flow-process när en Zapier-automatisering har slutförts
  • Brandautomatiseringar från ett frontend-formulär (med CORS aktiverat)
  • Ersätt flera integrationer med en enda funktion med en samlad webhook-hanterare

Steg-för-steg-guider för integration

  1. Så här kopplar du ihop n8n med Workflow Webhooks
  2. Så här kopplar du ihop Make med Workflow Webhooks
  3. Så här kopplar du ihop Zapier med Workflow Webhooks

Vad handlarna säger

"Den här appen gör Shopify Flow fem gånger så användbar. Det är väldigt enkelt att få tag på utvecklaren." ”och oerhört hjälpsamma.” - SuperFast Startup, Portugal

"Den saknade pusselbiten för Shopify Flow - du behöver bara en Shopify Flow för att hantera alla "dina webhooks." - Senkels, Österrike

"Precis det jag försökte lösa med hjälp av en rad appar från tredje part. Mycket "rekommenderar." - Aloha Tinyboards, USA

Installera

Installera Workflow Webhooks från Shopify App Store

Support

Behöver du hjälp? Se Support eller använd chattbubblan på valfri sida i appen i din Shopify-admin.