Webhook nedir?
Webhook, bir sistemde belirli bir olay gerçekleştiğinde o sistemin önceden tanımlanmış bir adrese otomatik olarak HTTP isteği göndererek başka bir sistemi anında haberdar ettiği bir bildirim mekanizmasıdır. Yeni sipariş, tamamlanan ödeme veya doldurulan form gibi olaylar için karşı sistemi sürekli sorgulamanız gerekmez. Olay olduğunda bilgi size gelir ve akışınız hemen başlar.
Tanım
Webhook, bir sistemde belirli bir olay gerçekleştiğinde o sistemin önceden tanımlanmış bir adrese otomatik olarak HTTP isteği göndererek başka bir sistemi anında haberdar ettiği bir bildirim mekanizmasıdır.
Webhook nasıl çalışır?
Önce alıcı sistemde bir adres (URL) oluşturursunuz. Bu adresi gönderen sistemin ayarlarına kaydeder ve hangi olayları dinleyeceğinizi seçersiniz. Olay gerçekleştiğinde gönderen sistem bu adrese bir HTTP POST isteği yapar. İsteğin gövdesinde olayın ayrıntıları, çoğunlukla JSON biçiminde bulunur.
Alıcı sistem isteği doğrular ve kısa sürede başarılı cevabı döner. Asıl işi arka planda yapmak iyi bir uygulamadır. Aynı olay birden çok kez gelebileceği için işlemin tekrarlandığında sorun çıkarmayacak biçimde tasarlanması gerekir.
Ne zaman webhook kullanılır?
Bir olaya anında tepki vermeniz gerektiğinde. Ödeme onaylandığında siparişi hazırlamaya almak, form doldurulduğunda CRM’e kayıt açmak veya kargo durumu değiştiğinde müşteriye mesaj göndermek tipik örneklerdir.
n8n ve Make gibi araçlarda webhook en yaygın tetikleyicidir. Olay geldikten sonra ayrıntıyı almak veya başka sisteme yazmak için API entegrasyonu devreye girer. Bir yapay zeka ajanını gelen bir olayla başlatmak da aynı yolla yapılır.
Türkiye bağlamında
Ödeme kuruluşları, kargo firmaları, pazaryerleri ve WhatsApp Business gibi mesajlaşma kanalları olayları çoğunlukla webhook ile bildirir. Desteklenen olaylar ve yeniden deneme davranışı sağlayıcıya göre değişir. Kullanmadan önce güncel dokümantasyonu kontrol edin.
Webhook gövdesinde ad, telefon veya adres gibi kişisel veri bulunabilir. Bu veriyi otomasyon aracının kayıtlarında ne kadar süre tuttuğunuzu KVKK açısından gözden geçirin. Aracı kendi sunucunuzda çalıştırmak verinin nerede durduğunu belirlemenizi kolaylaştırır. Kurulum için n8n ve Make otomasyon sayfasına bakabilirsiniz.
İlgili yazılar
e-Fatura verisini ERP'ye otomatik aktarmakGelen e-Fatura, e-Arşiv ve PDF faturaları ERP'ye otomatik aktarmanın yöntemleri, eşleştirme adımları ve hata kontrolleri.
n8n, Make ve Zapier karşılaştırmasın8n, Make ve Zapier'ı barındırma, lisans, faturalama birimi, yapay zeka ve veri konumu açısından karşılaştıran karar rehberi.
WooCommerce ile pazaryeri entegrasyonuWooCommerce ile pazaryerleri arasında stok, fiyat ve sipariş senkronu: doğruluk kaynağı, yöntem seçimi ve aşırı satış kontrolleri.İlgili terimler
- API entegrasyonuAPI entegrasyonu, iki veya daha çok yazılımın birbirinin sunduğu programlama arayüzleri (API) üzerinden veri alışverişi yapmasını ve işlem başlatmasını sağlayan bir bağlantı yöntemidir.
- n8nn8n, uygulamaları ve API'leri görsel düğümlerle birbirine bağlayarak iş akışlarını otomatikleştiren, kendi sunucunuzda da çalıştırabileceğiniz bir iş akışı otomasyon platformudur.
- İş akışı otomasyonuİş akışı otomasyonu, bir iş sürecindeki tekrarlayan adımları (veri aktarımı, onay, bildirim, raporlama) tanımlı kurallara göre yazılımın yürütmesini sağlayan bir yaklaşımdır.
- Yapay zeka ajanıYapay zeka ajanı, bir hedefi gerçekleştirmek için hangi adımları atacağına bir dil modeliyle kendisi karar veren ve araçları (API, veritabanı, e-posta) kullanarak bu adımları uygulayan bir yazılımdır.
Sık sorulan sorular
Webhook ile API arasındaki fark ne?
API'de isteği siz başlatırsınız ve cevabı alırsınız. Webhook'ta yön terstir: olay olduğunda karşı sistem size istek gönderir. Bu yüzden webhook'a 'ters API' de denir. Çoğu entegrasyonda ikisi birlikte kullanılır.
Webhook güvenli mi?
Doğru kurulursa evet. Adres HTTPS olmalı, gelen isteğin imzası veya gizli anahtarı doğrulanmalı ve gönderenin kimliği kontrol edilmelidir. Doğrulama yapılmayan bir webhook adresine herkes sahte olay gönderebilir.
Webhook isteği kaçarsa ne olur?
Sisteminiz o an kapalıysa olay kaybolabilir. Birçok servis başarısız gönderimi bir süre yeniden dener, ama bu servise göre değişir. Kritik akışlarda olayları kaydedin ve belirli aralıklarla API üzerinden mutabakat yapın.
Dönüşümünüzü birlikte konuşalım
Hangi işin her hafta tekrarlandığını anlatın. Otomasyona değip değmeyeceğini açıkça söyleyelim.
Nasıl başlıyoruz?
- Ücretsiz ilk görüşmeSorunu ve hedefi birlikte netleştiriyoruz.
- 2 haftalık keşif programıVeriye, sürece ve araçlara bakıp nereden başlanacağını belirliyoruz.
- Yazılı teklifKapsamı, mimariyi ve takvimi yazılı olarak sunuyoruz.