Workflow Webhooks’a Giriş
Workflow Webhooks, Shopify Flow iş akışlarını başlatan ve yük verilerinin Shopify Flow değişkenleri olarak aktarıldığı güvenli HTTP uç noktaları sunar.
Shopify Flow güçlü bir araçtır, ancak yalnızca Shopify içindeki olaylara tepki verir. Workflow Webhooks((url)) bu sınırlamayı ortadan kaldırır. Harici sistemlerin POST isteği gönderebileceği güvenli bir URL uç noktası sunar; bu istek gönderildiğinde, Shopify Flow iş akışınız anında tetiklenir ve yük verileri kullanılabilir değişkenler olarak aktarılır.
Nasıl çalışır?
- Harici aracınız, JSON verisi içeren bir HTTP POST isteğini webhook URL’nize gönderir (örn. isim, e-posta, soru). n8n, Make, Zapier veya HTTP desteği olan herhangi bir araçla uyumludur.
- Workflow Webhooks, isteği alır, isteğin kimliğini doğrular ve tam başlıklarıyla birlikte günlüğe kaydeder ve yük bilgisini aldıktan sonra, bağlantılı Shopify Flow tetikleyicisini çalıştırır.
- Shopify Flow, otomasyon işlemlerinizi yürütür - bir müşteriye etiket ekler, e-posta gönderir, bir
metafield - yük verilerini adlandırılmış değişkenler olarak kullanma (
{{fieldOne}},{{fieldTwo}},{{fieldThree}},{{fieldFour}}). Ayrıca, işaretlerseniz ek veriler de gönderebilirsiniz Güvenlik -> Webhook'ta Özel İstek Gövdesi'ne izin ver. - Tek bir webhook uç noktası, herhangi bir Shopify Flow otomasyonunu çalıştırabilir.
Özellikler
| Özellik | Açıklama |
|---|---|
| Shopify Flow için webhook tetikleyicileri | İsteğe bağlı olarak herhangi bir Shopify Flow otomasyonunu başlatan güvenli HTTP uç noktaları |
| Değişken eşleme | Yük alanlarını Shopify Flow değişkenlerine eşleştirin ve {{fieldOne}}, {{fieldTwo}} vb. şeklinde referans verin. |
| Kimlik Doğrulama | Statik Jeton (basit) veya HMAC SHA256 (tahrif edilemez) |
| Çağırma geçmişi | Her isteğin tam günlüğü - zaman damgası, veri yükü, başlıklar ve durum |
| CORS desteği | Tarayıcı tabanlı veya ön uç entegrasyonları için etkinleştirin |
| Özel istek gövdesi | Üçüncü taraf platformlardan gelen esnek yük yapılarını kabul et |
| Webhook kontrol paneli | Tüm uç noktaları tek bir yerden yönetin, izleyin ve test edin |
| Yinelenme önleme | Daha önce gördüğünüz bir olay kimliği içeren tekrarlanan teslimatları göz ardı edin |
Kimlik Doğrulama
| Yöntem | Nasıl çalışır? | En uygun olduğu durumlar |
|---|---|---|
| Yok | Kimlik doğrulama yok | Yalnızca test amaçlıdır, üretim ortamı değildir |
| Statik Jeton ✓ | X-Api-Key başlığındaki token düzeltildi |
Çoğu entegrasyon (n8n, Make, Zapier) |
| HMAC SHA256 | Yük + gizli anahtarla imza | Yüksek güvenlik veya uyumluluk |
Değişken eşleme
Workflow Webhooks, gelen JSON verilerindeki alanları Shopify Flow’un kullanabileceği adlandırılmış değişkenlere eşlemenizi sağlar. “Gelişmiş Ayarlar” sekmesinde en fazla 4 alan adı tanımlayabilirsiniz. Ayrıca, “Güvenlik” -> “Özel İstek Gövdesi’ne İzin Ver” seçeneğini işaretlerseniz ek veriler de gönderebilirsiniz.
| Uygulama içi alan | Yük anahtarınız | Shopify Flow’da referans |
|---|---|---|
| Alan 1 | name |
{{fieldOne}} |
| Alan 2 | email |
{{fieldTwo}} |
| 3. Alan | question |
{{fieldThree}} |
| 4. Alan | other |
{{fieldFour}} |
Yinelenen teslimat koruması
Çoğu sistem, hızlı bir yanıt alamadığında webhook'u yeniden dener. İlk deneme aslında ulaşmışsa, Shopify Flow iş akışınız aynı olay için iki kez çalışır; bu da ikinci bir e-posta, ikinci bir etiket veya yinelenen bir not anlamına gelir.
Gönderim sisteminiz her olay için benzersiz bir kimlik içeriyorsa, webhook'taki Gelişmiş Ayarlar -> Yinelenen teslimat algılama bölümünde bu başlığa bir ad verin; böylece yinelenen gönderimler göz ardı edilir.
| Davranış | |
|---|---|
| Belirtilen kimliğe sahip ilk istek | Normal şekilde işlendiğinde, Shopify Flow'u tetikler |
| 24 saat içinde tekrarlayın | 200 OK, duplicate: true ile birlikte - Shopify Flow’a gönderilmedi |
| Farklı kimlik | Normal şekilde işlendi |
| İstekte böyle bir başlık yok | Normal şekilde işlendi |
Yaygın başlık adları: Event-Id, Idempotency-Key, X-Request-Id. Eşleştirme işleminde büyük/küçük harf ayrımı yapılmaz.
# 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"}'Yaygın kullanım örnekleri
- Bir form dışarıdan gönderildiğinde bir Shopify müşterisini etiketleyin veya bilgilerini güncelleyin
- Bir n8n veya Make iş akışından sipariş veya sipariş karşılama işlemlerini tetikleyin
- Bir kayıtta değişiklik olduğunda, CRM veya yardım masasındaki kişi verlerini Shopify ile senkronize edin
- Bir Zapier otomasyonu tamamlandığında bir Shopify Flow'u başlatın
- Ön uç formundan yangın otomasyonları (CORS etkinleştirilmiş halde)
- Birden fazla tek amaçlı entegrasyonu tek bir birleşik webhook yöneticisiyle değiştirin
Adım adım entegrasyon kılavuzları
- n8n’i Workflow Webhooks ile nasıl bağlayabilirim?
- Make'i Workflow Webhooks'a nasıl bağlayabilirsiniz?
- Zapier'i Workflow Webhooks'a nasıl bağlayabilirim?
Tüccarların görüşleri
"Bu uygulama, Shopify Flow'u 5 kat daha kullanışlı hale getiriyor. Geliştiriciye ulaşmak son derece kolay." "ve son derece yararlı." - SuperFast Startup, Portekiz
"Shopify Flow için eksik olan parça - tüm ürünlerle çalışmak için tek bir Shopify Flow yeterlidir" "webhook'larınız." - Senkels, Avusturya
"Tam da bir sürü üçüncü taraf uygulama aracılığıyla çözmeye çalıştığım şeydi. Gerçekten de "tavsiye ederim." - Aloha Tinyboards, Amerika Birleşik Devletleri
Yükle
Shopify App Store'dan Workflow Webhooks'u yükleyin
Destek
Yardıma mı ihtiyacınız var? Destek bölümüne bakın veya Shopify yönetici panelinizdeki uygulamanın herhangi bir sayfasında bulunan sohbet balonunu kullanın.