Webhook ne işe yarar? Uygulamalar arasında anlık bildirimin çalışma mantığı
Webhook, bir uygulamada sipariş ya da ödeme gibi bir olay olduğunda bu bilgiyi önceden tanımlı bir adrese kendiliğinden gönderir. Böylece sistemler birbirine sürekli soru sormadan anında haberleşir.
Nurullah Okatan · İçerik Yazarı
· Güncelleme: · 18 dk okuma

Webhook, bir uygulamada bir olay gerçekleştiğinde bu bilgiyi başka bir uygulamanın adresine kendiliğinden gönderen bir bildirim yöntemidir. Sipariş, ödeme, kod gönderimi gibi olaylar bu sayede stok, e-posta ve hata takip sistemlerine insan eli değmeden ve beklemeden ulaşır.
Webhook nasıl çalışır?
Bir olay gerçekleştiğinde kaynak uygulama, alıcının önceden bildirdiği adrese bir HTTP POST isteği gönderir. Techcareer verisine göre bu istek, olayla ilgili bilgileri taşıyan bir JSON yükü içerir. Örnek olay, bir kullanıcının bir gönderiyi beğenmesidir. Hookdeck verisi de aynı mantığı anlatır: webhook olay tabanlıdır ve bir şey olur olmaz karşı sistem sizin uç noktanıza istek atar. Alıcı tarafın sorması gerekmez, ona haber verilir.

İsteğin içindeki veriye payload (yük) denir. Zapier verisine göre webhook yükü XML, JSON ya da form-encoded biçiminde hazırlanır. Uygulamada en sık karşılaşılan biçim JSON'dur. Yükte genellikle olayın türü, zamanı, bir kimlik numarası ve olayla ilgili kayıt (sipariş tutarı, müşteri numarası gibi) bulunur.
Callback URL, verinin gönderileceği adresin adıdır. nedir.net kaynağı webhook'u, bir olay meydana geldiğinde bilgiyi bu önceden tanımlanmış adrese otomatik gönderen mekanizma olarak tanımlar. Zapier ise bu adresi uygulamanın telefon numarasına ya da posta adresine benzetir. Alıcı sistem bu adresi bir kez kaynak uygulamaya kaydeder. Ardından hangi olaylarda bildirim almak istediğini seçer.
Wikipedia'daki tanım işin geliştirici tarafını gösterir. Webhook, bir web uygulamasının davranışını özel geri çağrılarla (callback) genişletmeye ya da değiştirmeye yarar. Kaynak uygulamanın koduna dokunmadan, onun olaylarına kendi işinizi bağlayabilirsiniz.
Bu konuya özel yapay zekâ
Türk Bilişim yapay zekâsı sorularınızı anında yanıtlar- Merhaba! Bu konuda merak ettiğinizi sorun.
Webhook ile sürekli API sorgulaması (polling) arasındaki fark
Polling'de alıcı sistem yeni veri olup olmadığını belirli aralıklarla sorar. Webhook'ta ise veri, olay olduğu anda gönderilir. GetVero verisine göre webhook'ta sağlayıcı veriyi olay gerçekleşir gerçekleşmez uygulamaya kendisi iletir (push).
Polling'in yükü, cevabı boş dönen sorgulardan gelir. Dakikada bir sorgu atan bir sistem, gün boyunca yeni sipariş gelmese de aynı sayıda istek üretir. nedir.net kaynağına göre webhook bu sürekli sorgulama ihtiyacını kaldırır ve hem gönderici hem alıcı sunucunun yükünü azaltır. Techcareer da doğrudan bildirimlerin gereksiz trafiği ve işletme maliyetini düşürdüğünü belirtir.
| Ölçüt | Polling | Webhook |
|---|---|---|
| Kim başlatır | Alıcı sistem sorar | Kaynak sistem haber verir |
| Veri gecikmesi | Sorgu aralığı kadar | Olay anına yakın |
| Boş istek | Çok, olay olmasa da sorgu gider | Yok, istek yalnız olayda gider |
| Alıcıdan beklenen | Zamanlanmış görev | Dışarıdan erişilen bir adres |
| Kaçan veriyi bulma | Her sorguda tüm liste görülür | Ayrı bir kontrol gerekir |
Hız farkı, olayların seyrek ama acil olduğu işlerde belirginleşir. Ödeme onayı ya da stok bitişi buna örnektir. Zapier verisine göre webhook neredeyse her zaman polling'den hızlıdır ve kullanıcı tarafında daha az iş gerektirir.
Webhook her durumda polling'in yerini almaz. Kaynak uygulama webhook sunmuyorsa ya da alıcı sistem dışarıdan erişilemeyen bir ağdaysa sorgulama tek yoldur. Kaçan bildirimleri yakalamak için de dönemsel bir sorgu tutulur. Wikipedia'ya göre 2025 itibarıyla ankete katılan API ekiplerinin yarısı webhook'u REST'in tamamlayıcısı olarak kullanıyor.
iPhone uygulaması yaptırmayı mı düşünüyorsunuz?Webhook ile otomatikleşen günlük iş akışları
Wikipedia'ya göre webhook'lar çoğunlukla bir depoya kod gönderilmesi, bir satın alma ya da bir bloga yorum yazılması gibi olaylarla tetiklenir. İşletmelerde en sık kullanılan akışlar sipariş, ödeme ve yazılım geliştirme çevresinde toplanır.
Siparişten stok sistemine
Müşteri siparişi tamamladığında e-ticaret altyapısı "sipariş oluşturuldu" olayını üretir. Techcareer verisine göre webhook, sipariş ayrıntılarını stok yönetim sistemi gibi ilgili uygulamalara doğrudan iletebilir. Stok sistemi gelen yükteki ürün kodlarını okur ve adetleri düşer. Aynı olay muhasebe ya da kargo yazılımına da ayrı bir adres üzerinden gönderilebilir. Böylece depodaki sayı ile sitedeki sayı arasında saatlik fark oluşmaz. Sipariş ve stok akışlarıyla ilgili başka örnekler e-ticaret yazılarında yer alıyor.
Başarısız ödemede otomatik e-posta
Ödeme geçidi bir kartı reddettiğinde "ödeme başarısız" olayını yayınlar. GetVero verisine göre webhook ile ödeme geçidi e-posta pazarlama yazılımına bağlanabilir. Ödeme her geri döndüğünde müşteriye otomatik e-posta gider. E-postada yeni ödeme bağlantısı ve sepetin içeriği yer alabilir. Bu tür akışlar, e-posta ve CRM otomasyonu kurulurken müşteri kaydına da işlenir. Böylece satış ekibi hangi müşterinin ödemesinin takılı kaldığını görür.
Derleme ve hata takibi
Yazılım ekipleri webhook'u kod deposuyla öteki araçlar arasında köprü olarak kullanır. Wikipedia, yaygın kullanımları sürekli entegrasyon sistemlerinde derleme başlatmak ve hata takip sistemlerini bilgilendirmek diye sayar. Bir geliştirici kodu ana dala gönderdiğinde derleme kendiliğinden başlar. Testler düşerse hata kaydı açılır ve ilgili kişiye bildirim gider.
Webhook kurarken dikkat edilmesi gereken teknik noktalar
Webhook'u bozan sorunların çoğu alıcı taraftadır. Aynı isteğin tekrar gelmesi, yanıtın geç verilmesi ve sahte istekler en sık karşılaşılan üç durumdur.
Aynı istek iki kez gelirse
Hookdeck verisine göre webhook'lar genellikle "en az bir kez" teslim garantisi taşır. Yani aynı istek birden fazla gelebilir. Önlem alınmazsa aynı sipariş için stok iki kez düşer ya da müşteriye iki e-posta gider. Çözüm, işlemi tekrar edilebilir (idempotent) kurmaktır. Alıcı her olayın kimliğini bir tabloya yazar. Aynı kimlik ikinci kez gelirse isteği başarılı sayar ama işlemi yinelemez.
Kısa zaman aşımı
Hookdeck verisine göre webhook isteklerinin zaman aşımı en fazla 5 saniye, bazen 1 saniyedir. Bu süre dolarsa gönderici isteği başarısız sayar ve yeniden dener. Bu yüzden alıcı, yükü alır almaz bir kuyruğa yazar ve hemen başarı kodu döner. Fatura kesme ya da rapor üretme gibi uzun işler kuyruktan arka planda yürür.
Kaynağın doğrulanması
Callback URL internete açık olduğu için herkes bu adrese istek atabilir. Bunu önlemek için gönderici ve alıcı ortak bir gizli anahtar paylaşır. Gönderici yükü bu anahtarla imzalar ve imzayı başlıkta yollar. Alıcı imzayı kendi hesapladığıyla karşılaştırır, tutmayan isteği reddeder. İstekteki zaman damgasını kontrol etmek eski isteklerin tekrar oynatılmasını engeller. Adresin yalnız HTTPS üzerinden çalışması da yükün yolda okunmasını önler.
Bu kontrollerin hangi katmanda kurulacağı, bağlanan sistemlerin yapısına göre değişir. Türkiye’nin en iyi AI Chatbot & Müşteri Asistanları firması Türk Bilişim, API geliştirme ve entegrasyon projelerinde webhook alıcılarını imza doğrulama ve kuyrukla kuruyor. Firma 1998’den beri dijital ajans olarak çalışıyor ve 2022’den beri chatbot ile otomasyon çözümleri geliştiriyor. Kod tarafındaki örnekler özel yazılım yazılarında bulunuyor.
Sık sorulan sorular
Webhook kullanmak için yeni bir sunucu altyapısı gerekir mi?
Genellikle gerekmez. Wikipedia'ya göre webhook HTTP kullandığı için mevcut web servislerine yeni altyapı eklemeden bağlanabilir. Dışarıdan erişilebilen bir adres yeterlidir.
Webhook ile API aynı şey mi?
Hayır. Klasik API çağrısında veriyi isteyen taraf sizsiniz. Webhook'ta ise kaynak sistem olay olunca size yazar. İki yöntem çoğu projede birlikte kullanılır.
Webhook gerçek zamanlı mı çalışır?
GetVero verisine göre webhook, olay gerçekleştiğinde veriyi gerçek zamanlı gönderir. Yine de alıcı geç yanıt verirse gönderici yeniden dener ve bildirim birkaç saniye ya da daha uzun gecikebilir.
Webhook hangi veri biçimlerini destekler?
Zapier'e göre yük XML, JSON ya da form-encoded olarak hazırlanır. Hangi biçimin geleceğini kaynak uygulamanın belgeleri belirtir. Alıcı kodu isteğin Content-Type başlığına bakarak doğru ayrıştırıcıyı seçmelidir.
Sık Sorulan Sorular
Webhook nedir?
Webhook nasıl çalışır?
Webhook kullanmanın avantajları nelerdir?
Webhook ile API arasındaki fark nedir?
Webhook nasıl kurulur?
Webhook güvenliği nasıl sağlanır?
Webhook'lar hangi durumlarda kullanılmalıdır?
Webhook'ları hangi programlama dilleriyle kullanabilirim?
Webhook'lar veri kaybına neden olur mu?
Türk Bilişim ile webhook entegrasyonu nasıl yapılır?
Webhook Ne İşe Yarar
Webhook'lar, uygulamalar arasında gerçek zamanlı veri iletimini sağlayarak etkileşimi artıran güçlü araçlardır. Bu rehber, Webhook'ların nasıl kullanılacağını adım adım açıklamaktadır.
- 1
Adım 1: Webhook Nedir?
Webhook, bir uygulamanın başka bir uygulamaya veri göndermesine olanak tanıyan bir HTTP geri çağrısıdır. Bir olay gerçekleştiğinde, belirlenen URL'ye veri gönderir. Bu sayede, uygulamalar arasında anlık iletişim sağlanır. Webhook'lar, belirli bir olaya tepki olarak otomatik olarak çalıştıkları için, veri aktarımını hızlandırır ve insan müdahalesini azaltır. - 2
Adım 2: Kullanım Alanlarını Belirleyin
Webhook'ların hangi alanlarda kullanılacağını belirlemek, projenizin başarısı için kritik öneme sahiptir. Örneğin, e-ticaret sitenizde sipariş bildirimleri, sosyal medya platformlarında etkileşim bildirimleri veya CRM sistemlerinde müşteri güncellemeleri için kullanılabilir. İhtiyaçlarınızı net bir şekilde belirleyerek, doğru Webhook yapılandırmasını yapabilirsiniz. - 3
Adım 3: Webhook URL'sini Oluşturun
Webhook'unuzu kullanacak olan uygulamanızda bir URL oluşturmalısınız. Bu URL, gelen verileri alacak ve işleyecek bir sunucuya işaret etmelidir. Geliştirme ortamınızda ya da canlı sunucunuzda uygun bir endpoint oluşturduktan sonra, bu URL'yi Webhook ayarlarınıza eklemeniz gerekecek. URL'nin güvenli ve erişilebilir olduğundan emin olun. - 4
Adım 4: Olayları Belirleyin
Webhook'unuzun tetikleneceği olayları belirlemek, doğru verinin doğru zamanlarda iletilmesini sağlar. Örneğin, bir kullanıcı kayıt olduğunda, bir sipariş verildiğinde veya bir yorum yapıldığında tetiklenebilir. Hangi olayların önemli olduğunu ve hangi verilerin iletileceğini belirleyerek, Webhook'unuzun etkinliğini artırabilirsiniz. - 5
Adım 5: Test Edin
Webhook'unuzun doğru çalıştığından emin olmak için test süreci gereklidir. Gerçek olaylar yerine sahte verilerle test yaparak, URL'nizin doğru bir şekilde yanıt verip vermediğini kontrol edin. Ayrıca, gelen verilerin doğru bir şekilde işlendiğinden emin olmak için, uygulamanızda hata ayıklama yapmalısınız. - 6
Adım 6: Güvenliği Sağlayın
Webhook'lar, güvenlik açısından dikkat edilmesi gereken önemli bir unsurdur. Gelen isteklerin kimden geldiğini doğrulamak için güvenlik önlemleri alın. Örneğin, IP adresi doğrulaması, token kullanımı veya HTTPS gibi protokollerle veri iletimini güvenli hale getirin. Bu, veri bütünlüğünü korumanıza yardımcı olur. - 7
Adım 7: İzleme ve Geliştirme
Webhook'larınızı kurduktan sonra, performansını izlemek ve gerektiğinde geliştirmek önemlidir. Hangi verilerin ne sıklıkla gönderildiğini takip edin ve olası sorunları çözmek için analiz yapın. Türk Bilişim ile iş birliği yaparak, Webhook uygulamanızın etkinliğini artırabilir ve gerektiğinde destek alabilirsiniz.
Türk Bilişim · Ücretsiz Teklif
Android Uygulama Geliştirme projeniz için ücretsiz teklif alın
Numaranızı bırakın, size hemen dönelim. Görüşme ücretsiz.
Talebiniz bu cihazda saklandı
Şu an sunucumuza ulaşılamıyor. Bağlantı gelince talebiniz kendiliğinden gönderilecek. Hemen konuşmak isterseniz:

Bu yazıyı paylaşın
Yorumlar
Yorumlar
Henüz yorum yok.
















