Siparişin Oluşması ve Bildirimin Ulaşması
WooCommerce webhook, mağazada belirli bir olay gerçekleştiğinde başka bir adrese bildirim gönderilmesini sağlar. Siparişin panelde bulunması, dış sistemin bu bildirimi aldığını kanıtlamaz. Olayın oluşması, gönderim denemesi ve alıcı sistemin işlemesi ayrı sonuçlar olarak izlenir.
Örneğin depo yazılımına aktarılması beklenen yeni sipariş mağazada görünürken depoda bulunmuyor olsun. İnceleme önce ilgili olay için gönderim kaydı olup olmadığını araştırır. Kayıt yoksa webhook konusu ve durumu, gönderim kaydı varsa hedef yanıtı değerlendirilir. Böylece mağaza verisiyle dış sistemdeki eksik sipariş arasında açıklanabilir bir ilişki kurulur.
Etkin, Duraklatılmış ve Devre Dışı
Webhook durumunun etkin, duraklatılmış veya hata nedeniyle devre dışı olması farklı anlamlar taşır. Art arda başarısız teslimler otomatik devre dışı kalmaya neden olabilir. Bu yüzden bildirimleri yeniden açmak kadar neden durduğunu anlamak da gerekir.
Kurgusal bir bakım çalışmasında alıcı adres bir süre hata vermiş olsun. Mağaza sipariş almaya devam etse de bildirim mekanizması kapanmış olabilir. Hedef sistem onarıldıktan sonra durum ve yeni gönderim denemesi birlikte kontrol edilir. Yalnızca durumu etkin yapmak, kesinti sırasında oluşan kayıtların eksiksiz aktarıldığını göstermez; eksik dönem ayrıca karşılaştırılır.
Webhook Durumu, Konusu ve Hedefi
Webhook formunda Status, Topic ve Delivery URL alanları görülür. Etkinlik durumu bildirimin gönderilip gönderilmeyeceğini, konu ise hangi olayın izleneceğini belirler. Hedef adresin varlığı, gelen isteği başarıyla işlediğini tek başına göstermez.
Hedefin Yanıtı Ne Anlatır?
Teslim kayıtları hedef adresin verdiği yanıtı incelemeyi sağlar. Yetkilendirme hatası, bulunamayan adres veya sunucu hatası aynı soruna işaret etmez. Genel bir başarısızlık mesajı yerine ilgili yanıtın hangi sistemden geldiği belirlenmelidir.
Örneğin entegrasyon adresi değiştiği hâlde webhook eski adrese gidiyor olabilir. Başka bir durumda adres doğrudur, ancak güvenlik kuralı isteği engelliyordur. Alıcı sunucunun isteği kabul etmesi de iş kaydının başarıyla tamamlandığını tek başına açıklamaz. Dış sistemin kendi işlem sonucu, sipariş kimliği üzerinden takip edilir. Başarılı HTTP yanıtı ile doğru hazırlanmış depo kaydı birlikte değerlendirilir.
Günlüklerde Gereken Bilgi
WooCommerce günlükleri kaynaklarına göre incelenebilir. Araştırmada olayın yaklaşık zamanı, webhook kimliği, sipariş kimliği ve alıcı yanıtı yararlıdır. Tek bir belirsiz ekran görüntüsü yerine bu bilgilerin ilişkilendirilmesi sorunun hangi adımda oluştuğunu gösterir.
Ancak günlük dosyaları müşteri verisi veya entegrasyon ayrıntıları içerebilir. Destek amacıyla paylaşılacak örneklerde gizli anahtarlar ve gereksiz kişisel bilgiler ayıklanır. Sorunun tekrarlandığı küçük bir örnek, bütün günlük arşivini paylaşmaktan daha kullanışlı olabilir. Günlükte hata bulunamaması da tek başına başarı kanıtı sayılmaz; ilgili kaynağın gerçekten kayıt üretip üretmediği doğrulanır.
Webhook Teslimat Günlüğü
Günlük kaynağı olarak webhooks-delivery seçildiğinde bildirim denemeleri incelenebilir. Doğru olayın gönderimi ile hedef sunucunun yanıtı birlikte okunur. Sipariş kaydının oluşması ve karşı sistemin aynı siparişi işlemesi ayrı aşamalardır.
Kesinti Sonrası Kayıt Karşılaştırması
Bildirim yeniden çalıştığında kesinti sırasında oluşan siparişler mağaza ve dış sistem arasında karşılaştırılır. Aynı kaydı tekrar göndermek gerekirse alıcı sistemin tekrarları nasıl ele aldığı bilinmelidir. Aksi hâlde eksik aktarımı düzeltme girişimi çift sipariş oluşturabilir.
Deneme için tek bir sipariş seçilerek mağaza kaydı, teslim yanıtı ve dış sistemde oluşan sonuç eşleştirilir. Ardından eksik kalan dönem kontrollü biçimde ele alınır. Webhook konusu, hedefi ve sorumlu uygulama kayıt altında tutulduğunda ilerideki değişiklikler daha kolay izlenir. Sağlıklı sonuç, yeni bildirimin ulaşması ve eski eksiklerin tutarlı biçimde kapatılmasıyla birlikte değerlendirilir.
Bu Yazıdaki Terimler 1 Kavram
Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.
- Webhook
- Webhook, bir sistemde sipariş oluşması ya da ödeme tamamlanması gibi bir olay gerçekleştiğinde olay bilgisini önceden kaydedilmiş bir adrese HTTP isteğiyle kendiliğinden gönderen bildirim yöntemidir.
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.
WooCommerce