Zendesk'i Shopify Flow'a nasıl bağlayabilirim?

Zendesk, bir bilet değiştiğinde bir tetikleyici veya otomasyon aracılığıyla bir webhook’u çağırabilir. 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, şirket içi 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 kurar - Zendesk gönderir, Workflow Webhooks alır ve doğrular, Shopify Flow harekete geçer - her istekte Zendesk’in HMAC imzası kontrol edildiğinden, iş akışınızı yalnızca Zendesk başlatabilir.

Neler yapabileceğiniz

• Yukarıya iletilen bir biletin arkasındaki Shopify müşterisini etiketleyin, böylece ekibiniz bunu yönetici panelinde görebilsin.
• Söz konusu siparişle ilgili bir destek talebi çözüldüğünde, sipariş notu ekleyin.
• Yüksek değerli bir müşteriden düşük bir memnuniyet puanı geldiğinde bir yöneticiye e-posta gönderin.

Gönderilebilecek tipik olaylar: bir bilet oluşturulur, bir bilet çözülür, bir memnuniyet değerlendirmesi alınır.

Başlamadan önce

• Shopify mağazanıza kurulan Workflow Webhooks.
• Shopify Flow, Shopify Uygulama Mağazasından ücretsiz olarak indirilip kuruldu.
• Webhook oluşturma iznine sahip bir Zendesk 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 Zendesk events gibi.
2. Kimlik Doğrulama bölümünden HMAC'yi seçin.
3. Signature provider (İmza sağlayıcısı) altında Zendesk’i seçin. Uygulama, başlık, algoritma, imzalı yük ve tekrar oynatma süresini sizin için otomatik olarak doldurur; yapılandırmanız gereken 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 - Zendesk'te uç noktayı ekleyin

Zendesk Yönetim Merkezi'nde Uygulamalar ve entegrasyonlar → Webhook'lar bölümünü açın, kopyaladığınız URL'yi hedefleyen bir webhook oluşturun, bunu bir tetikleyiciye bağlayın ve ardından Gizli anahtarı göster seçeneğini kullanın.

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

Webhook’un imza gizli anahtarı (Yönetici Merkezi → Uygulamalar ve entegrasyonlar → Webhook’lar → Gizli anahtarı göster).

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

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

Bu kontrolün amacı

Ne	Değer
İmza başlığı	X-Zendesk-Webhook-Signature
İmzanın bulunduğu yer	Başlığın tamamı
Neyin imzalandığı	{header:x-zendesk-webhook-signature-timestamp}{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ı imzalamadığından, 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; {header:x-zendesk-webhook-signature-timestamp} ise x-zendesk-webhook-signature-timestamp istek başlığıdır.

Bu koşullardan 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 Zendesk’ten 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 Zendesk 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

Zendesk’te gerçek bir olayı tetikleyin. Workflow Webhooks → History bölümünde**,** durumu Success olan çağrıyı görmelisiniz. İmza yanlışsa, bunun yerine nedeni belirtilen bir hata kaydı görü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ı - Zendesk bir iletimi yeniden denediğinde ne olur?
• Geçmiş ve sorun giderme - her isteğin günlüğü; tekrar oynatma özelliği ile.