İlk webhook'unuzu oluşturun

Sayfayı kopyala

Adım adım: Bir webhook uç noktası oluşturun, kimlik doğrulamasını yapın, veri yükünüzü eşleştirin ve bunu bir Shopify Flow iş akışına bağlayın.

Bu kılavuz, boş bir uygulamadan başlayarak, kendi sisteminizin belirlediği zamanda çalışan bir Shopify Flow iş akışına kadar sizi yönlendirir. Yaklaşık on dakika sürer.

1. Bir webhook oluşturun

Webhook'lar -> Webhook oluştur. Sayfa önce bu webhook'u neyin tetikleyeceğini sorar ve buna uygun şekilde ayarlar:

Cevabınız	Elinize ne geçecek?
Bir otomasyon aracı (n8n, Make, Zapier, kendi kodunuz)	Araca yapıştırılmaya hazır, oluşturulmuş bir jeton
Webhook’larını imzalayan bir hizmet (Stripe, GitHub, ...)	Seçtiğiniz hizmet için imza doğrulama - bkz. İmzalı webhook'ların doğrulanması
Bir tarayıcı veya mağaza ön yüzü komut dosyası	CORS etkinleştirildi - bkz. CORS, uygulama proxy URL’si ve tarayıcı çağrıları
Hiçbir şey - zamanlanmış olarak çalıştırın	Zamanlayıcıyla bir URL’yi alan bir webhook; ardından “Zamanlama” sekmesi açılır - bkz. Zamanlanmış URL sorgulama
Başka bir şey mi, yoksa daha sonra mı karar vereceksin?	Kimlik doğrulama yöntemini kendiniz seçersiniz

Daha sonra tanıyabileceğiniz bir ad verin (“Cüzdan kartı hatırlatıcısı”, “İletişim formu”) ve kaydedin. Her ayar daha sonra değiştirilebilir.

Artık, örneğin https://.../webhook/ab12cd34 gibi kısa bir kodla biten bir webhook URL’sine sahipsiniz. Bu URL, sisteminizin POST isteği gönderdiği uç noktadır.

“Bu webhook’u ne tetikleyecek?” sorusunu içeren “Webhook Oluştur” sayfasında, “Hiçbir şey - zamanlamaya göre çalıştır” seçeneği seçili durumdadır ve “Zamanlama” sekmesinin bir sonraki adımda açılacağına dair bir not bulunmaktadır — Bir webhook oluşturmak, onu neyin tetikleyeceği ile başlar. Verilen yanıt, uygun kimlik doğrulama ayarlarını yapar; “Hiçbir şey - zamanlanmış olarak çalıştır” seçeneği, ardından Zamanlama sekmesini açar.

Webhook düzenleyicisi: sol tarafta ad ve kimlik doğrulama; sağ tarafta durum, webhook URL’si ve webhook kimliği bilgilerini içeren Uç Nokta kartı; bunların üstünde ise Canlı Önizleme, Test ve Kullanım seçenekleri yer almaktadır — Webhook düzenleyicisi. Ayarlar sol tarafta yer alır; sağdaki Uç Nokta kartında ise gönderene verilecek webhook URL’si ve Shopify Flow’da kullandığınız webhook kimliği bulunur.

2. Arayanların kimliklerini nasıl doğrulayacaklarını seçin

Webhook'u açın ve bir kimlik doğrulama yöntemi seçin. Tam karşılaştırma için Kimlik Doğrulama bölümüne bakın - kısaca:

Statik jeton - hemen hemen herkes için uygun. Oluştur düğmesine basın, jetonu kopyalayın, X-Api-Key başlığında gönderin.
HMAC SHA-256 - isteklerini imzalayan gönderenler için (Stripe, GitHub ve benzeri).
Yok - sadece test amaçlı. URL’ye sahip olan herkes iş akışınızı başlatabilir.

3. Hangi alanların sizin için önemli olduğunu bize bildirin

Gelişmiş Ayarlar altında, JSON verilerinizden en fazla dört alanı eşleştirebilirsiniz. Sisteminiz şu verileri gönderiyorsa:

"Gelişmiş Ayarlar" sekmesi; burada Alan 1'den Alan 4'e kadar sırasıyla orderId, status, total ve note ile eşleştirilmiştir — Gelişmiş Ayarlar: İstek gövdesinden en fazla dört değeri eşleyin. Bu değerler, Shopify Flow’da fieldOne ile fieldFour olarak gelir.

json

{ "customer": { "email": "someone@example.com" }, "orderId": "1001" }

fieldOne'ı orderId'a, fieldTwo'ı ise customer.email'a eşleştirin - iç içe geçmiş yollarda nokta kullanın. Ayrıntılı bilgi için Yük haritalama ve Shopify Flow değişkenleri bölümüne bakın.

4. Bir test isteği gönderin

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ı — Bir test isteğinin ardından, çağrı, alınan veri yüküyle birlikte Geçmiş bölümünde görünür.

bash

curl -X POST https://your-app-url/webhook/ab12cd34 \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: your-token" \
  -d '{"orderId":"1001","customer":{"email":"someone@example.com"}}'

Geçmiş'i açın. Çağrıyı, durumunu, başlıklarını ve yükünü görmelisiniz. Eğer orada yoksa, Geçmiş ve sorun giderme tüm reddedilme nedenlerini listeler.

5. Shopify Flow iş akışını oluşturun

Shopify Flow'da, Webhook Trigger tetikleyicisiyle başlayan bir iş akışı oluşturun.

Tetikleyiciyi ekleyin ve Olayları Kaydet seçeneğine tıklayın.
Buraya geri dönün, “Geçmiş” bölümündeki çağrıyı açın ve “Tekrar Oynat” düğmesine basın. Shopify Flow’da artık bir üzerinde çalışmak için gerçek bir örnek veri yükü - alan adlarını tahmin etmekten çok daha kolay.
Koşul Ekle: Webhook ID, webhook'unuzun kimliğine (webhook sayfasında gösterilen) eşittir. Her Webhook Tetikleyici iş akışı, tüm webhook'larınızdan olaylar alır; bu nedenle bu Bu koşul, iş akışının yalnızca buna yanıt vermesini sağlayan unsurdur.
{{fieldOne}}'den {{fieldFour}}'e kadar olan alanlara eylemlerinizi ekleyin.
İş akışını etkinleştirin.

“Webhook Tetikleyici” adımının altındaki artı işareti açıldı ve “Eylem” ile “Koşul” seçenekleri görüntülendi — Bir adımın altındaki artı işareti, bir iş akışını oluşturan iki unsuru sunar: bir koşul ve bir eylem.

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.

6. Yayına geç

Gerçek sisteminizi webhook URL’sine yönlendirin. Geçmiş bölümündeki ilk birkaç çağrıyı izleyerek bunların ulaştığını ve başarılı olduğunu doğrulayın.

Göndericiniz zaman aşımı durumunda yeniden deneme yaparsa, Yinelenen teslimat koruması seçeneğini etkinleştirin; böylece yeniden deneme işlemi iş akışınızı iki kez çalıştıramaz.

Altı webhook’un listelendiği Webhooks sayfası; her birinde çağrı sayısı, kimlik doğrulama bilgileri ve “Etkin” veya “Devre Dışı” etiketleri yer almaktadır — Webhook'lar sayfası. Her satırda, webhook'un ne sıklıkla çağrıldığı, çağrı yapanların kimlik doğrulamasını nasıl gerçekleştirdiği ve webhook'un etkin olup olmadığı gösterilir; sağdaki menüden webhook'u etkinleştirebilir, devre dışı bırakabilir veya silebilirsiniz.