Shopify'u Shopify Flow'a nasıl bağlayabilirim?

Q: İmza eşleşmiyor

Şu sırayla: gizli anahtar (en yaygın neden - fazladan bir boşluk ya da yanlış ortamdan gelen bir anahtar), gönderenin farklı bir uç noktanın gizli anahtarını kullanıp kullanmadığı ve Shopify ile uygulama arasında gövdeyi yeniden yazan herhangi bir unsur olup olmadığı. İmzalar ham baytları kapsadığından, JSON’u yeniden biçimlendiren bir proxy bunları bozar. Webhook sayfasındaki imza test aracı, imzalanmış olan metnin tam halini gösterir.

Q: Her istekte 401 hatası alıyorum

Webhook’un kimlik doğrulama yönteminin HMAC olarak ayarlandığını, Shopify sağlayıcısının seçili olduğunu, gizli anahtarın girildiğini ve Shopify’ın, sondaki kod da dahil olmak üzere, uygulamanın gösterdiği şekilde tam olarak bu URL’ye veri gönderdiğini kontrol edin.

Sayfayı kopyala

Shopify webhook'larını HMAC ile doğrulayıp Shopify Flow tetikleyicisine dönüştürün; siparişler, ürünler ve müşteriler iş akışı başlatsın.

Shopify, kendi webhook’larını ve uygulamalar arası çağrılarını, uygulamanızın API gizli anahtarıyla imzalar. Bu ön ayar, başka bir Shopify mağazasından veya kendi uygulamanızdan bir webhook almanıza ve bunu Shopify belgelerinde belirtildiği şekilde doğrulamanıza olanak tanır. Workflow Webhooks, bu çağrıyı bir Shopify Flow tetikleyicisine dönüştürür; böylece mağazanız buna tepki verebilir: bir müşteriye etiket ekleyebilir, sipariş notu ekleyebilir, dahili bir e-posta gönderebilir, bir meta alanı güncelleyebilir - kısacası Shopify Flow'un yapabileceği her şeyi yapabilir.

Bu kılavuz, tüm süreci ortaya koymaktadır - Shopify gönderir, Workflow Webhooks alır ve doğrular, Shopify Flow harekete geçer - her istekte Shopify’un HMAC imzası kontrol edildiğinden, iş akışınızı yalnızca Shopify başlatabilir.

Neler yapabileceğiniz

İkinci bir Shopify mağazasından gelen bir siparişi bu mağazaya aktarın: müşteriyi etiketleyin, bir not ekleyin veya sipariş karşılama iş akışını başlatın.
Shopify Flow'un kendisi tarafından tetikleyici olarak sunulmayan bir konuya, kendi uygulamanızdan bu konuya abone olarak Shopify Flow'da tepki verebilirsiniz.
Bir ara yazılım hizmeti yazmadan toptan satış mağazasını ve perakende satış mağazasını birbiriyle uyumlu bir şekilde çalıştırın.

Gönderilebilecek tipik olaylar: orders/create, products/update, customers/create, fulfillments/create.

Başlamadan önce

Shopify mağazanıza yüklenmiş Workflow Webhooks.
Shopify Flow, Shopify Uygulama Mağazasından ücretsiz olarak indirilip kuruldu.
Shopify'da webhook oluşturma iznine sahip bir hesap.

1. Adım - Workflow Webhooks'ta webhook'u oluşturun

Workflow Webhooks'u açın -> Webhooks -> Webhook oluştur seçeneğine tıklayın ve Shopify Flow'da kolayca tanıyabileceğiniz bir ad verin; örneğin Shopify events gibi.
Kimlik Doğrulama bölümünden HMAC'yi seçin.
“İmza sağlayıcısı” bölümünden Shopify’ı seçin. Uygulama, başlığı, algoritmayı, imzalı yükü ve tekrar oynatma süresini sizin için otomatik olarak doldurur; ayarlanacak başka bir şey yoktur.
Şimdilik gizli alanı boş bırakın ve Kaydet'e tıklayın. Sayfada gösterilen webhook URL'sini kopyalayın.

Diğer kimlik doğrulama modları için Kimlik Doğrulama’a, hangi alanların Shopify Flow’a aktarılacağını seçmek için ise Yük haritalama ve Shopify Flow değişkenleri’a bakın.

2. Adım - Shopify'da uç noktayı ekleyin

Kopyaladığınız URL'yi kullanarak gönderen mağazada veya uygulamada webhook aboneliğini oluşturun ve bunu o uygulamanın API gizli anahtarıyla imzalayın.

Shopify’daki imza gizli anahtarınızı nasıl bulabilirsiniz?

Uygulamanızın API gizli anahtarı / webhook imzalama gizli anahtarı.

Webhook imzalarıyla ilgili Shopify'ın kendi belgeleri, hesabınız için tam metni ve ekran görüntülerini içeriyor.

Bu gizli anahtarı, Workflow Webhooks bölümündeki webhook’un “Secret” alanına yapıştırın ve kaydedin. O andan itibaren her Shopify teslimatı, Shopify Flow’a ulaşmadan önce doğrulanır.

Bu kontrolün amacı

Ne	Değer
İmza başlığı	`X-Shopify-Hmac-Sha256`
İmzanın bulunduğu yer	Başlığın tamamı
Neyin imzalandığı	`{body}`
İmza	HMAC-SHA256, base64 ile kodlanmış
Zaman damgası	Bu gönderen tarafından kullanılmamaktadır
Tekrar oynatma koruması	Yok - bu gönderen zaman damgasını imzalamamaktadır; dolayısıyla tüm geçerli imzalar geçerliliğini korur
Sır	Düz metin olarak kullanılır. Göndericinin gösterdiği şekilde aynen yapıştırın.

İmzalı yükte, {body}, bayt bayt ham istek gövdesidir.

Bu şartlardan herhangi birini karşılamayan bir istek, 401 hatasıyla reddedilir, Geçmiş ve sorun giderme bölümüne kaydedilir ve hiçbir zaman bir iş akışını başlatmaz.

3. Adım - Shopify Flow iş akışını oluşturun

Shopify Flow'da bir iş akışı oluşturun ve Workflow Webhooks tetikleyicisini seçin.
Olayları Kaydet seçeneğine basın, ardından Shopify'dan bir test olayı gönderin (ya da Workflow Webhooks'taki Test Gönder seçeneğini kullanın), böylece Shopify Flow verilerinizin yapısını öğrenebilir.
Sahip olduğunuz her webhook aynı Shopify Flow tetikleyicisini çalıştırır; bu nedenle, bu iş akışını yalnızca Shopify ile sınırlı tutmak için webhook kimliğine ilişkin bir ilk koşul ekleyin. Kimlik, webhook sayfasında gösterilir.
İşlemlerinizi ekleyin - bir müşteriyi etiketleyin, bir not ekleyin, şirket içi bir e-posta gönderin, bir meta alanı güncelleyin.

Bir Shopify Flow koşulu: Webhook kimliği, bir webhook’un kimliğine eşittir — Her iş akışının ilk adımı: webhook kimliğine ilişkin bir koşul; böylece iş akışı yalnızca bu webhook için çalıştırılır.

Tamamlanmış iş akışı: Webhook Tetikleyicisi, webhook kimliğine ilişkin bir koşul, ardından “Doğru” dalında dahili e-posta gönderme — Tamamlanmış iş akışı: tetikleyici, webhook kimliğine dayalı koşul ve ardından “True” dalında gerçekleştirilecek eyleminiz.

4. Adım - Uçtan uca test edin

Shopify'da gerçek bir olayı tetikleyin. Workflow Webhooks -> Geçmiş bölümünde, durumu Başarılı olan çağrıyı görmelisiniz. İmza yanlışsa, bunun yerine nedeni belirtilen bir hata kaydı alırsınız ve İmzalı webhook'ların doğrulanması, hangi adımın başarısız olduğunu tam olarak gösteren imza denetleyicisini açıklar.

Tarih bölümünde, istek başlıkları, veri yükü, durum, süre ve tanımlayıcılarıyla birlikte bir çağrı açıldı — Tarih bölümünde gerçekleştirilmiş bir olay: “Başarılı” durumu, Shopify Flow’un bunu kabul ettiği anlamına gelir.

İmza eşleşmiyor

Şu sırayla: gizli anahtar (en yaygın neden - fazladan bir boşluk ya da yanlış ortamdan gelen bir anahtar), gönderenin farklı bir uç noktanın gizli anahtarını kullanıp kullanmadığı ve Shopify ile uygulama arasında gövdeyi yeniden yazan herhangi bir unsur olup olmadığı. İmzalar ham baytları kapsadığından, JSON’u yeniden biçimlendiren bir proxy bunları bozar. Webhook sayfasındaki imza test aracı, imzalanmış olan metnin tam halini gösterir.

Her istekte 401 hatası alıyorum

Webhook’un kimlik doğrulama yönteminin HMAC olarak ayarlandığını, Shopify sağlayıcısının seçili olduğunu, gizli anahtarın girildiğini ve Shopify’ın, sondaki kod da dahil olmak üzere, uygulamanın gösterdiği şekilde tam olarak bu URL’ye veri gönderdiğini kontrol edin.

Geçmiş'te hiçbir şey görünmüyor

İstek hiç ulaşmadı. Shopify'daki URL'yi tekrar kontrol edin ve Shopify'ın kendi teslimat günlüğüne bakarak aldığı yanıtı inceleyin. 404 kodu, webhook'un yanlış veya silinmiş olduğunu; 429 kodu ise planınızın çağrı sınırını aştığınızı gösterir - bkz. Planlar ve kullanım.

İş akışı yanlış olaylar için çalışıyor

Mağazanızdaki her webhook, aynı Shopify Flow tetikleyicisini çalıştırır. İş akışının ilk adımı olarak **webhook **kimliğine bir koşul ekleyin ya da Shopify’dan gönderdiğiniz olayları daraltın.

İlgili

İmzalı webhook'ların doğrulanması - doğruladığımız her sağlayıcı ve doğrulamadığımız bir sağlayıcıyı nasıl tanımlayacağımız.
Yük haritalama ve Shopify Flow değişkenleri - yükten doğru alanları alıp Shopify Flow'a aktarma.
Yinelenen teslimat koruması - Shopify bir teslimatı yeniden denediğinde neler olur.
Geçmiş ve sorun giderme - her isteğin günlüğü; tekrar oynatma özelliği ile.