Sanity'yi Shopify Flow'a nasıl bağlayabilirim?

Sanity, sorgunuzla eşleşen içerik oluşturulduğunda, güncellendiğinde veya silindiğinde GROQ destekli bir webhook gönderir. 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 gerçekleştirebilir.

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

Neler yapabileceğiniz

• Eşleşen CMS girdisi değiştiğinde Shopify meta alanını güncelleyin; böylece mağaza sayfası da buna ayak uydursun.
• Bir açılış sayfası yayınlandığında, pazarlama ekibinize e-posta gönderin.
• İçerik yayınlandıktan sonra önbellek yenileme iş akışını başlatın.

Gönderilebilecek tipik olaylar: bir belgenin yayınlanması, bir belgenin güncellenmesi, bir belgenin silinmesi.

Başlamadan önce

• Shopify mağazanıza yüklenmiş Workflow Webhooks.
• Shopify Flow, Shopify Uygulama Mağazasından ücretsiz olarak indirilip kuruldu.
• Webhook oluşturma iznine sahip bir Sanity hesabı.

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

1. 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 Sanity events gibi.
2. Kimlik Doğrulama bölümünden HMAC'yi seçin.
3. İmza sağlayıcısı bölümünden Sanity’yi seçin. Uygulama, başlığı, algoritmayı, imzalanmış veri yükünü ve tekrar oynatma aralığını sizin için otomatik olarak doldurur; ayarlanacak başka bir şey yoktur.
4. Ş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 - Sanity'ye uç noktayı ekleyin

Sanity'de API → Webhooks bölümünü açın, kopyaladığınız URL ile GROQ destekli bir webhook oluşturun ve Gizli Anahtarı ayarlayın.

Sanity imza gizli anahtarınızı nasıl bulabilirsiniz?

GROQ tarafından desteklenen webhook’ta “The Secret” ayarı.

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

Bu gizli anahtarı, Workflow Webhooks'taki webhook'un Secret alanına yapıştırın ve kaydedin. O andan itibaren her Sanity teslimatı, Shopify Flow'a ulaşmadan önce doğrulanır.

Bu kontrolün amacı

Ne	Değer
İmza başlığı	sanity-webhook-signature
İmzanın bulunduğu yer	Virgülle ayrılmış key=value çiftlerini içeren bu başlığın v1 değerinde
Neyin imzalandığı	{timestamp}.{body}
İmza	HMAC-SHA256, base64url kodlamalı
Zaman damgası	İmza başlığındaki t değeri, Unix milisaniye cinsinden
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övdesi; {timestamp} ise yukarıdaki zaman damgasıdır.

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

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

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

Sanity'de gerçek bir olayı tetikleyin. Workflow Webhooks → History bölümünde, durum Success olarak belirtilen ç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.

İ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ı - Sanity bir teslimatı yeniden denediğinde ne olur?
• Geçmiş ve sorun giderme - her isteğin günlüğü, tekrar oynatma özelliği ile.